​

Funciones públicas

​

Funciones de sincronización

​

thi_sync_now()

function thi_sync_now(): bool

​

thi_detect_sync_context()

function thi_detect_sync_context(): array

• is_syncing (bool) - Si hay sincronización activa
• progress (int) - Porcentaje de progreso (0-100)
• last_sync_time (string) - Timestamp de última sincronización
• last_sync_status (string) - Estado: ‘success’, ‘error’, ‘warning’
• current_batch (int) - Lote actual procesado
• total_batches (int) - Total de lotes
• error_count (int) - Errores encontrados
• warning_count (int) - Advertencias generadas

​

thi_intelligent_sync()

function thi_intelligent_sync(): array

• success (bool) - Si la sincronización fue exitosa
• created (int) - Propiedades creadas
• updated (int) - Propiedades actualizadas
• deleted (int) - Propiedades eliminadas
• images_processed (int) - Imágenes procesadas
• errors (array) - Lista de errores ocurridos
• execution_time (float) - Tiempo total en segundos

​

thi_get_cached_properties()

function thi_get_cached_properties(?int $limit = null): array

​

thi_get_cached_developments()

function thi_get_cached_developments(?int $limit = null): array

​

thi_detect_changed_properties()

function thi_detect_changed_properties(): array

• new (array) - IDs de Tokko para propiedades nuevas
• modified (array) - IDs de Tokko para propiedades modificadas
• deleted (array) - IDs de Tokko para propiedades eliminadas
• timestamp (string) - Momento de detección

​

Funciones de API

​

thi_check_api_key()

function thi_check_api_key(): bool

​

thi_get_tokko_properties()

function thi_get_tokko_properties(
    ?int $limit = null,
    ?int $offset = 0
): array

​

thi_get_tokko_developments()

function thi_get_tokko_developments(
    ?int $limit = null,
    ?int $offset = 0
): array

​

thi_get_development_count()

function thi_get_development_count(): int

​

thi_get_development_sync_limits()

function thi_get_development_sync_limits(): array

• limit (int) - Total permitido por plan
• synced (int) - Desarrollos ya sincronizados
• available (int) - Desarrollos disponibles para sincronizar
• plan (string) - Plan actual (‘standard’, ‘professional’)

​

Funciones de agentes

​

thi_sync_agent()

function thi_sync_agent(array $data): int|false

​

thi_delete_agent()

function thi_delete_agent(
    int $id,
    ?int $reassign = null
): bool

​

thi_update_agent()

function thi_update_agent(int $id, array $data): bool

​

thi_sync_agents_from_properties()

function thi_sync_agents_from_properties(
    array $properties
): array

• created (int) - Agentes nuevos creados
• updated (int) - Agentes actualizados
• skipped (int) - Agentes sin cambios
• errors (array) - Errores ocurridos

​

thi_get_agent_by_tokko_id()

function thi_get_agent_by_tokko_id(int $id): ?WP_Post

​

thi_assign_agent_to_property()

function thi_assign_agent_to_property(
    int $agent_id,
    int $property_id
): bool

​

thi_get_properties_by_agent()

function thi_get_properties_by_agent(int $agent_id): array

​

Funciones de mapeo

​

thi_map_tokko_to_houzez()

function thi_map_tokko_to_houzez(
    array $property
): array

• title (string) - Título de propiedad
• content (string) - Descripción formateada
• meta (array) - Metadatos para Houzez
• status (string) - Estado del post

​

Funciones de imágenes

​

thi_normalize_image_url()

function thi_normalize_image_url(string $url): string

​

thi_get_quality_aware_image_url()

function thi_get_quality_aware_image_url(
    array $photo
): string

​

Funciones de utilidad

​

tp_fs()

function tp_fs(): FS_SDK

​

thi_log()

function thi_log(string $msg, string $type = 'info'): void

​

thi_is_development_environment()

function thi_is_development_environment(): bool

​

Funciones de timestamps

​

thi_create_timestamps_table()

function thi_create_timestamps_table(): bool

​

thi_get_property_timestamp()

function thi_get_property_timestamp(
    string $tokko_id
): ?string

​

thi_update_property_timestamp()

function thi_update_property_timestamp(
    int $post_id,
    string $tokko_id,
    string $timestamp,
    string $status = 'synced'
): bool

​

Mejores prácticas

if (function_exists('thi_sync_now')) {
    thi_sync_now();
} else {
    echo 'Plugin Tokko no está activo';
}

// ✅ EFICIENTE
$properties = wp_cache_get('tokko_properties');
if (!$properties) {
    $properties = thi_get_cached_properties();
    wp_cache_set('tokko_properties', $properties, '', 1 * HOUR_IN_SECONDS);
}

// ❌ INEFICIENTE
$properties = thi_get_cached_properties(); // En cada llamada