Documentation Index
Fetch the complete documentation index at: https://docs.tokkoplugins.com/llms.txt
Use this file to discover all available pages before exploring further.
Hooks
Esta página documenta los puntos de extensión disponibles del plugin organizados en tres grupos:
- Acciones disparadas con
do_action — las puedes escuchar con add_action y se ejecutan en el momento que documentan.
- Eventos WP-Cron / Action Scheduler — tareas programadas que el plugin registra; puedes engancharte para ejecutar código en paralelo con la rutina del plugin.
- Acciones AJAX (
wp_ajax_...) — endpoints del panel de administración; documentados solo como referencia porque sus handlers viven en includes/ajax/ajax-handlers.php.
Todas las acciones listadas aquí están verificadas contra el código fuente. Si un hook no aparece aquí, el plugin no lo dispara.
Acciones disparadas por el plugin (do_action)
thi_sync_report_saved
Se dispara inmediatamente después de que un reporte de sincronización se guarda en la base de datos.
do_action('thi_sync_report_saved', string $sync_id, array $report);
| Parámetro | Descripción |
|---|
$sync_id | Identificador único del reporte guardado |
$report | Array completo con contadores, errores, warnings, duración, etc. |
includes/sync/class-thi-sync-report-store.php
tp_fs_loaded
Se dispara cuando el SDK de Freemius se inicializa. Es el punto seguro para leer la licencia del plugin desde tu propio código.
do_action('tp_fs_loaded');
tokko-houzez-integration.php
Eventos WP-Cron / Action Scheduler
Estos no son do_action clásicos: son tareas programadas registradas con wp_schedule_event / wp_schedule_single_event / as_schedule_*. Puedes engancharte con add_action para correr código junto con la tarea del plugin. Usa una prioridad distinta de 10 si quieres ejecutar tu callback antes o después del callback por defecto del plugin.
thi_scheduled_sync
Sincronización automática completa programada (feature premium). La frecuencia se controla con la opción thi_sync_option.
add_action('thi_scheduled_sync', function() {
error_log('Sincronización programada arrancó');
}, 20);
thi_sync_option o thi_custom_interval_value.
Listener del plugin: thi_premium_property_sync() en tokko-houzez-integration.php.
thi_force_background_sync
Sincronización disparada manualmente desde el botón Force Sync cuando WP-Cron local está deshabilitado — corre en segundo plano.
add_action('thi_force_background_sync', function() {
set_transient('last_force_sync_started', time(), DAY_IN_SECONDS);
}, 20);
includes/ajax/ajax-handlers.php.
thi_cron_sync_continue
Evento que reanuda una sincronización cuando el motor unificado la pausó por timeout, carga alta o para ceder CPU. Se reprograma a sí mismo hasta completar.
add_action('thi_cron_sync_continue', function() {
error_log('Reanudando sincronización tras pausa');
}, 20);
includes/sync/class-thi-unified-sync-engine.php, includes/sync/cron-handler.php.
thi_continue_image_sync
Evento por lotes que continúa la descarga y procesamiento de imágenes mientras queden pendientes.
add_action('thi_continue_image_sync', function() {
// Registrar métrica por lote
update_option(
'thi_custom_image_batch_count',
(int) get_option('thi_custom_image_batch_count', 0) + 1,
false
);
}, 20);
includes/sync/sync-functions.php.
thi_retry_failed_images
Evento recurrente (cada hora) que reintenta la descarga de imágenes que fallaron previamente.
add_action('thi_retry_failed_images', function() {
error_log('Intentando recuperar imágenes fallidas');
}, 20);
thi_image_sync group.
thi_regenerate_thumbnails
Tarea de fondo (single event) que regenera miniaturas cuando se cambia la configuración correspondiente.
add_action('thi_regenerate_thumbnails', function() {
error_log('Regenerando miniaturas');
}, 20);
includes/ajax/ajax-handlers.php.
thi_delete_thumbnails
Tarea de fondo que elimina miniaturas generadas cuando el usuario desactiva esa función.
add_action('thi_delete_thumbnails', function() {
error_log('Limpiando miniaturas generadas');
}, 20);
includes/ajax/ajax-handlers.php.
thi_cleanup_orphaned_files
Tarea puntual que borra archivos huérfanos de propiedades que ya no existen.
Ubicación: includes/ajax/ajax-handlers.php.
thi_bulk_update_titles_batch
Evento por lotes para actualizar masivamente los títulos de propiedades al activar/desactivar “Usar dirección como título”.
Ubicación: includes/sync/sync-functions.php.
thi_daily_sync_reports_cleanup
Evento diario que purga reportes de sincronización viejos. El filtro thi_sync_reports_retention_days controla cuántos días se conservan.
Ubicación: includes/sync/cron-handler.php.
thi_send_periodic_report
Evento recurrente que envía el resumen periódico por email (feature premium — requiere thi_email_periodic_enabled).
Ubicación: includes/notifications/notification-functions.php.
Acciones AJAX del plugin
Estas acciones se registran con wp_ajax_<action> y se invocan desde la interfaz de administración del plugin. Todos los handlers del plugin viven en includes/ajax/ajax-handlers.php o includes/ajax/system-status-handlers.php.
El plugin ya tiene su propio handler registrado para cada acción. Si agregas uno con add_action('wp_ajax_<accion>', ...), usa una prioridad distinta de 10 para no interferir.
Sincronización unificada
| Acción AJAX | Propósito |
|---|
thi_unified_sync_detect | Paso 1: detecta cambios desde el último sync |
thi_unified_sync_execute_batch | Paso 2: procesa el siguiente lote |
thi_unified_sync_archive | Paso 3: archiva propiedades que ya no están en Tokko |
thi_unified_sync_finalize | Paso 4: finaliza el sync y guarda el reporte |
thi_unified_sync_pause / thi_unified_sync_resume / thi_unified_sync_cancel | Control del sync en progreso |
thi_sync_heartbeat | Heartbeat mientras el sync está activo |
Sincronización puntual
| Acción AJAX | Propósito |
|---|
thi_sync_single_property | Sincroniza una propiedad específica |
thi_sync_single_development | Sincroniza un emprendimiento específico |
thi_sync_developments_only | Sincroniza solo emprendimientos |
thi_force_sync_cronjob | Programa el sync en WP-Cron manualmente |
thi_force_reprocess_properties | Fuerza reprocesamiento completo |
thi_sync_agents | Sincroniza sólo agentes |
thi_sync_development_relationships | Relaciona emprendimientos con propiedades |
thi_sync_property_images_frontend | Solicita reintento de imágenes desde el frontend |
Estado y diagnóstico
| Acción AJAX | Propósito |
|---|
thi_heartbeat / thi_check_session | Ping ligero del estado de sesión |
thi_check_sync_readiness / thi_check_sync_requirements / thi_check_sync_status | Chequeos previos a sincronización |
thi_get_health_indicators | Indicadores de salud del servidor |
thi_get_api_status_table | Estado de la conexión con Tokko |
thi_test_api_connection | Test manual de la API Key |
thi_get_sync_estimation | Estimación de tiempo del próximo sync |
thi_get_image_sync_status / thi_get_title_update_status | Estado de subprocesos |
thi_get_sync_performance / thi_get_sync_timeline | Métricas históricas |
Dashboard & reports
| Acción AJAX | Propósito |
|---|
thi_get_dashboard_stats / thi_get_enhanced_stats | Estadísticas del dashboard |
thi_get_sync_report / thi_get_sync_report_by_id | Lee el reporte del sync actual/histórico |
thi_download_sync_report_csv | Descarga reportes en CSV |
thi_get_changelog | Entradas del changelog |
thi_properties_last_report / thi_properties_archived_count | Datos del tab Properties |
Gestión de datos
| Acción AJAX | Propósito |
|---|
thi_load_properties / thi_properties_list | Listado con paginación |
thi_properties_sync_by_id / thi_properties_sync_selected | Sync selectivo desde el tab Properties |
thi_properties_force_image_resync / thi_properties_diagnose | Diagnóstico y resync de una propiedad |
thi_retry_property_sync | Reintenta el sync de una propiedad |
thi_delete_all_properties | Borra todas las propiedades |
thi_cleanup_orphaned_agents | Limpia agentes huérfanos |
thi_assign_agent_to_properties / thi_save_auto_assign_agent | Auto-asignación de agentes |
thi_save_agent_toggle | Activa/desactiva sync de agentes |
thi_get_agents_list | Lista de agentes |
Sistema & herramientas
| Acción AJAX | Propósito |
|---|
thi_export_support_metrics | Exporta métricas para soporte |
thi_clear_error_history | Limpia el historial de errores |
thi_create_timestamps_table | Crea (o re-crea) la tabla de timestamps |
thi_acquire_sync_lock / thi_release_sync_lock | Locks del motor de sync |
thi_update_last_sync_time / thi_update_sync_state | Actualización explícita de estado |
thi_update_whatsapp_fields | Migración de campos WhatsApp |
thi_bulk_update_titles | Dispara la actualización masiva de títulos |
thi_upload_json_test_file / thi_remove_json_test_file / thi_switch_test_json | Modo test con JSON local (Dev Mode) |
thi_inject_error / thi_clear_injections / thi_get_injection_status | Herramientas de debugging (Dev Mode) |
thi_test_cleanup / thi_test_timestamps | Tests internos (Dev Mode) |
thi_get_properties_for_image_sync / thi_get_developments_for_sync | Lista de candidatos |
thi_record_developments_sync_result | Registra el resultado del sync de devs |
thi_dismiss_update_notice | Descarta el aviso de actualización |
Buenas prácticas
- Mantén los callbacks ligeros. Los hooks de sincronización pueden ejecutarse muchas veces durante un sync.
- Para llamadas a sistemas externos, usa
wp_remote_post() con timeout pequeño o, mejor, encola con Action Scheduler.
- Si necesitas estado entre invocaciones del mismo hook (por ejemplo
thi_continue_image_sync), usa update_option(..., false) con autoload false.
- Siempre valida capacidades (
current_user_can('manage_options')) cuando te enganches a acciones AJAX.
