Opciones de WordPress

El plugin Tokko almacena todas sus configuraciones en las opciones de WordPress (wp_options). Esta referencia documentan todas las opciones disponibles, sus valores, tipos y cómo accederlas.

Configuración de API

Estas opciones contienen los detalles de conexión con Tokko Broker.

thi_api_key

Clave de autenticación para la API de Tokko Broker.

$api_key = get_option('thi_api_key');

update_option('thi_api_key', 'tu-clave-api-aqui');

Propiedad	Valor
Tipo	string
Valor predeterminado	” (vacío)
Requerido	Sí
Sensible	Sí - No mostrar en formularios públicos
Descripción	Clave de autenticación de TokkoBroker API. Se obtiene en panel de control de Tokko.

Esta es una clave sensible. No la expongas en código público o repositorios Git.

thi_language

Idioma usado al consumir la API de Tokko Broker. Afecta principalmente a cómo se muestran campos localizables que entrega Tokko (ej. nombres de operaciones).

$language = get_option('thi_language', 'es_ar');

update_option('thi_language', 'es_ar');

Propiedad	Valor
Tipo	string
Valor predeterminado	`'es_ar'`
Descripción	Locale que se envía a la API de Tokko Broker.

thi_plugin_language

Idioma de la interfaz administrativa del plugin (menús, tabs, mensajes).

$lang = get_option('thi_plugin_language', 'en_US');

update_option('thi_plugin_language', 'es_MX');

Propiedad	Valor
Tipo	string
Valor predeterminado	`'en_US'` (desde la UI de configuración)
Valores válidos	`'en_US'`, `'es_MX'`
Descripción	Locale para traducción del panel del plugin (no afecta el frontend de Houzez).

Configuración de sincronización

thi_sync_option

Tipo de sincronización configurado.

$sync_type = get_option('thi_sync_option', 'daily');

update_option('thi_sync_option', 'hourly');

Propiedad	Valor
Tipo	string
Valor predeterminado	`'daily'`
Valores válidos	`'disabled'`, `'hourly'`, `'every_6_hours'`, `'every_12_hours'`, `'daily'`, `'weekly'`, `'biweekly'`, `'monthly'`, `'custom'`
Descripción	Frecuencia de sincronización automática (feature premium). En plan Starter permanece en `disabled` y sólo soporta sincronización manual.

thi_custom_interval_value

Valor personalizado en minutos para sincronización custom.

$interval = get_option('thi_custom_interval_value', 60);

update_option('thi_custom_interval_value', 120);

Propiedad	Valor
Tipo	int
Valor predeterminado	`60`
Rango válido	5 – 43200 (minutos)
Unidad	Minutos
Descripción	Se usa solo cuando `thi_sync_option` es `'custom'`. Va desde 5 minutos (máxima frecuencia) hasta 30 días (43200 minutos).

thi_sync_developments

Habilita sincronización de desarrollos.

$sync_devs = get_option('thi_sync_developments', false);

update_option('thi_sync_developments', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descrición	Si está habilitado, también sincroniza desarrollos además de propiedades.

Configuración de visualización

thi_default_map_enabled

Muestra mapa por defecto en páginas de propiedad.

$map_enabled = get_option('thi_default_map_enabled', true);

update_option('thi_default_map_enabled', false);

Propiedad	Valor
Tipo	bool
Valor predeterminado	true
Descripción	Controla si los mapas de ubicación se muestran automáticamente.

thi_generate_thumbnails

Genera miniaturas de imágenes al sincronizar.

$thumbnails = get_option('thi_generate_thumbnails', true);

update_option('thi_generate_thumbnails', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	true
Descripción	Si está activo, crea miniaturas de imágenes para mejor rendimiento.

thi_enable_secondary_url

Habilita URL secundaria para propiedades.

$secondary = get_option('thi_enable_secondary_url', false);

update_option('thi_enable_secondary_url', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Permite URLs alternativas para propiedades.

thi_enable_tokko_broker_url

Enlaza a Tokko Broker en lugar de mostrar en sitio.

$tokko_url = get_option('thi_enable_tokko_broker_url', false);

update_option('thi_enable_tokko_broker_url', false);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Si está activo, las propiedades redirigen a Tokko Broker.

thi_use_address_as_title

Usa dirección como título de propiedad.

$address_title = get_option('thi_use_address_as_title', false);

update_option('thi_use_address_as_title', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Si está habilitado, las direcciones se usan como títulos principales.

thi_hide_property_address

Oculta la dirección completa de propiedades.

$hide_address = get_option('thi_hide_property_address', false);

update_option('thi_hide_property_address', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Oculta la dirección completa por privacidad.

Configuración de búsqueda avanzada

thi_enhanced_search_enabled

Activa búsqueda mejorada de propiedades.

$search_enabled = get_option('thi_enhanced_search_enabled', false);

update_option('thi_enhanced_search_enabled', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Habilita filtros avanzados y búsqueda personalizada.

thi_enhanced_search_fields

Campos habilitados para búsqueda avanzada.

$fields = get_option('thi_enhanced_search_fields', []);

update_option('thi_enhanced_search_fields', [
    'precio',
    'dormitorios',
    'baños',
    'área',
    'tipo_propiedad'
]);

Propiedad	Valor
Tipo	array
Valor predeterminado	[] (vacío)
Descripción	Lista de campos disponibles en búsqueda avanzada.

thi_age_range_slider_color

Color personalizado del control deslizante “Edad de la propiedad”.

$color = get_option('thi_age_range_slider_color', '');

update_option('thi_age_range_slider_color', '#e74c3c');

Propiedad	Valor
Tipo	string
Valor predeterminado	`''` (sin override; usa el color del tema)
Formato	Código hexadecimal de color (ej. `'#007bff'`)
Descripción	Color personalizado del slider de edad; si queda vacío, se usa el color por defecto del tema.

thi_age_range_slider_label

Etiqueta del slider de edad de la propiedad.

$label = get_option('thi_age_range_slider_label', 'Edad de la propiedad');

update_option('thi_age_range_slider_label', 'Antigüedad');

Propiedad	Valor
Tipo	string
Valor predeterminado	`'Edad de la propiedad'`
Descripción	Etiqueta visible encima del slider en el formulario de búsqueda.

thi_age_range_slider_half_map_enabled

Muestra slider a mitad de mapa.

$half_map = get_option('thi_age_range_slider_half_map_enabled', false);

update_option('thi_age_range_slider_half_map_enabled', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Posiciona el slider al lado del mapa en lugar de arriba.

Configuración de agentes

thi_enable_agent_sync

Habilita sincronización de agentes desde Tokko.

$agent_sync = get_option('thi_enable_agent_sync', false);

update_option('thi_enable_agent_sync', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Si está activo, sincroniza agentes de Tokko como posts en WordPress.

thi_agent_mobile_is_whatsapp

Trata números móviles de agentes como WhatsApp.

$whatsapp = get_option('thi_agent_mobile_is_whatsapp', false);

update_option('thi_agent_mobile_is_whatsapp', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Convierte números móviles a enlaces de WhatsApp.

thi_download_agent_images

Descarga imágenes de agentes localmente.

$download_imgs = get_option('thi_download_agent_images', true);

update_option('thi_download_agent_images', false);

Propiedad	Valor
Tipo	bool
Valor predeterminado	true
Descripción	Si está habilitado, descarga y almacena imágenes de agentes en el servidor.

thi_auto_assign_agent_id

ID de agente para asignación automática de propiedades.

$agent_id = get_option('thi_auto_assign_agent_id', 0);

update_option('thi_auto_assign_agent_id', 123);

Propiedad	Valor
Tipo	int
Valor predeterminado	0 (ninguno)
Descripción	ID de WordPress del agente que recibe propiedades sin agente asignado.

Configuración de imágenes

thi_image_quality

Perfil de calidad usado para descargar imágenes de propiedades.

$quality = get_option('thi_image_quality', 'optimized');

update_option('thi_image_quality', 'original');

Propiedad	Valor
Tipo	string
Valor predeterminado	`'optimized'`
Descripción	Controla qué variante de la imagen se baja desde Tokko. Valores soportados por la API típicamente incluyen `original` y `optimized`.
Impacto	Afecta directamente el tamaño de disco y la velocidad de carga del frontend.

Configuración de contacto

thi_enable_contact_integration

Habilita integración de formularios de contacto.

$contact_enabled = get_option('thi_enable_contact_integration', false);

update_option('thi_enable_contact_integration', true);

Propiedad	Valor
Tipo	bool
Valor predeterminado	false
Descripción	Si está activo, conecta formularios de contacto con Tokko y CRM.

Notificaciones por email

Las notificaciones por email son una característica premium (Professional / Pro+). En el plan Starter el filtro thi_notifications_enabled las desactiva por defecto.

thi_email_error_alert_enabled

Habilita el envío de alertas por email cuando el plugin registra errores.

$enabled = get_option('thi_email_error_alert_enabled', 'yes');

update_option('thi_email_error_alert_enabled', 'no');

Propiedad	Valor
Tipo	string (`'yes'` / `'no'`)
Valor predeterminado	`'yes'`
Descripción	Conmutador principal de alertas por email.

thi_email_error_alert_level

Nivel mínimo de severidad para disparar una alerta por email.

$level = get_option('thi_email_error_alert_level', 'critical');

update_option('thi_email_error_alert_level', 'warning');

Propiedad	Valor
Tipo	string
Valor predeterminado	`'critical'`
Valores típicos	`'warning'`, `'error'`, `'critical'`
Descripción	Solo los errores iguales o superiores a este nivel disparan email.

thi_email_error_alert_recipients

Destinatarios de las alertas de error (uno o varios, separados por comas o saltos de línea).

$recipients = get_option('thi_email_error_alert_recipients', '');

update_option('thi_email_error_alert_recipients', "admin@example.com\nops@example.com");

Propiedad	Valor
Tipo	string
Valor predeterminado	`''` (vacío)
Formato	Una dirección por línea o separadas por coma.

thi_email_periodic_enabled

Habilita el reporte periódico por email (resumen de sincronización).

$enabled = get_option('thi_email_periodic_enabled', 'no');

update_option('thi_email_periodic_enabled', 'yes');

Propiedad	Valor
Tipo	string (`'yes'` / `'no'`)
Valor predeterminado	`'no'`

thi_email_periodic_frequency

Frecuencia del reporte periódico.

$frequency = get_option('thi_email_periodic_frequency', 'weekly');

Propiedad	Valor
Tipo	string
Valor predeterminado	`'weekly'`
Valores válidos	`'daily'`, `'weekly'`, `'monthly'`

thi_email_periodic_recipients

Destinatarios del reporte periódico (mismo formato que las alertas).

$recipients = get_option('thi_email_periodic_recipients', '');

Propiedad	Valor
Tipo	string
Valor predeterminado	`''`

thi_email_from_name

Nombre que aparece como remitente en los emails enviados por el plugin.

$from_name = get_option('thi_email_from_name', '');

update_option('thi_email_from_name', 'Inmobiliaria Ejemplo');

Propiedad	Valor
Tipo	string
Valor predeterminado	`''` (usa el default de WordPress)

Estado y rastreo

Estas opciones son actualizadas automáticamente por el plugin y generalmente no deben modificarse manualmente.

thi_last_sync_time

Timestamp de la última sincronización completada.

$last_sync = get_option('thi_last_sync_time', null);

// Esta opción se actualiza automáticamente

Propiedad	Valor
Tipo	string (ISO 8601)
Valor predeterminado	null
Descripción	Registro automático de cuándo se completó la última sincronización.

thi_last_sync_metadata

Información detallada de la última sincronización.

$metadata = get_option('thi_last_sync_metadata', []);

// Estructura típica:
echo $metadata['properties_created']; // int
echo $metadata['properties_updated']; // int
echo $metadata['images_processed'];    // int
echo $metadata['duration'];            // float (segundos)
echo $metadata['status'];              // 'success', 'error', 'warning'

Propiedad	Valor
Tipo	array
Estructura	Array con claves: created, updated, deleted, images_processed, duration, status
Descripción	Metadatos detallados de la última sincronización.

thi_recent_sync_results

Historial de últimas sincronizaciones (máximo 10).

$results = get_option('thi_recent_sync_results', []);

foreach ($results as $sync) {
    echo $sync['timestamp'] . ': ' . $sync['status'];
}

Propiedad	Valor
Tipo	array
Descripción	Array de objetos con resultados de últimas sincronizaciones.

thi_sync_error_history

Historial de errores de sincronización.

$errors = get_option('thi_sync_error_history', []);

foreach ($errors as $error) {
    echo 'Fecha: ' . $error['timestamp'];
    echo 'Error: ' . $error['message'];
    echo 'Código: ' . $error['code'];
}

Propiedad	Valor
Tipo	array
Descripción	Lista de errores ocurridos durante sincronización.
Retención	Últimos 50 errores

thi_plugin_version

Versión actual del plugin instalado.

$version = get_option('thi_plugin_version', '1.0.0');

Propiedad	Valor
Tipo	string
Descripción	Versión del plugin. Se actualiza automáticamente al actualizar.

thi_last_api_connection

Timestamp del último contacto exitoso con API.

$last_api = get_option('thi_last_api_connection', null);

Propiedad	Valor
Tipo	string (ISO 8601)
Descripción	Ayuda a detectar problemas de conectividad con Tokko.

thi_last_api_response_time

Tiempo de respuesta (en ms) de la última llamada API.

$response_time = get_option('thi_last_api_response_time', 0);

echo 'Última respuesta: ' . $response_time . 'ms';

Propiedad	Valor
Tipo	int
Unidad	Milisegundos
Descripción	Útil para monitorear rendimiento de conexión con Tokko.

Acceso a opciones en código

Obtener opciones

// Obtener con valor predeterminado
$api_key = get_option('thi_api_key', 'default_value');

// Obtener sin valor predeterminado
$api_key = get_option('thi_api_key');

// Obtener y decodificar JSON
$fields = json_decode(get_option('thi_enhanced_search_fields', '[]'), true);

Actualizar opciones

// Actualizar simple
update_option('thi_api_key', 'nueva-clave');

// Actualizar con serialización automática
update_option('thi_enhanced_search_fields', [
    'precio',
    'dormitorios'
]);

// Usar add_option si es nueva
add_option('thi_custom_option', 'valor', '', 'yes');

Eliminar opciones

// Eliminar opción
delete_option('thi_custom_option');

Mejores prácticas

No edites directamente en la base de datos. Siempre usa funciones de WordPress para garantizar sanitización y validación correctas.

Usa nombres con prefijo al crear opciones personalizadas para evitar conflictos:

// ✅ CORRECTO
add_option('thi_my_custom_option', $value);

// ❌ INCORRECTO
add_option('custom_option', $value);

// ✅ BUEN EJEMPLO - Actualizar opción con validación
function update_my_option($value) {
    // Validar
    if (!is_array($value)) {
        return false;
    }

    // Sanitizar
    $sanitized = array_map('sanitize_text_field', $value);

    // Actualizar
    return update_option('thi_my_option', $sanitized);
}

Exportar/Importar opciones

// Exportar todas las opciones de Tokko
$tokko_options = [];
$all_options = wp_load_alloptions();

foreach ($all_options as $name => $value) {
    if (strpos($name, 'thi_') === 0) {
        $tokko_options[$name] = $value;
    }
}

echo json_encode($tokko_options);

// Importar opciones
$backup = json_decode(file_get_contents('backup.json'), true);

foreach ($backup as $name => $value) {
    update_option($name, $value);
}

​Opciones de WordPress

​Configuración de API

​thi_api_key

​thi_language

​thi_plugin_language

​Configuración de sincronización

​thi_sync_option

​thi_custom_interval_value

​thi_sync_developments

​Configuración de visualización

​thi_default_map_enabled

​thi_generate_thumbnails

​thi_enable_secondary_url

​thi_enable_tokko_broker_url

​thi_use_address_as_title

​thi_hide_property_address

​Configuración de búsqueda avanzada

​thi_enhanced_search_enabled

​thi_enhanced_search_fields

​thi_age_range_slider_color

​thi_age_range_slider_label

​thi_age_range_slider_half_map_enabled

​Configuración de agentes

​thi_enable_agent_sync

​thi_agent_mobile_is_whatsapp

​thi_download_agent_images

​thi_auto_assign_agent_id

​Configuración de imágenes

​thi_image_quality

​Configuración de contacto

​thi_enable_contact_integration

​Notificaciones por email

​thi_email_error_alert_enabled

​thi_email_error_alert_level

​thi_email_error_alert_recipients

​thi_email_periodic_enabled

​thi_email_periodic_frequency

​thi_email_periodic_recipients

​thi_email_from_name

​Estado y rastreo

​thi_last_sync_time

​thi_last_sync_metadata

​thi_recent_sync_results

​thi_sync_error_history

​thi_plugin_version

​thi_last_api_connection

​thi_last_api_response_time

​Acceso a opciones en código

​Obtener opciones

​Actualizar opciones

​Eliminar opciones

​Mejores prácticas

​Exportar/Importar opciones

Opciones de WordPress

Configuración de API

thi_api_key

thi_language

thi_plugin_language

Configuración de sincronización

thi_sync_option

thi_custom_interval_value

thi_sync_developments

Configuración de visualización

thi_default_map_enabled

thi_generate_thumbnails

thi_enable_secondary_url

thi_enable_tokko_broker_url

thi_use_address_as_title

thi_hide_property_address

Configuración de búsqueda avanzada

thi_enhanced_search_enabled

thi_enhanced_search_fields

thi_age_range_slider_color

thi_age_range_slider_label

thi_age_range_slider_half_map_enabled

Configuración de agentes

thi_enable_agent_sync

thi_agent_mobile_is_whatsapp

thi_download_agent_images

thi_auto_assign_agent_id

Configuración de imágenes

thi_image_quality

Configuración de contacto

thi_enable_contact_integration

Notificaciones por email

thi_email_error_alert_enabled

thi_email_error_alert_level

thi_email_error_alert_recipients

thi_email_periodic_enabled

thi_email_periodic_frequency

thi_email_periodic_recipients

thi_email_from_name

Estado y rastreo

thi_last_sync_time

thi_last_sync_metadata

thi_recent_sync_results

thi_sync_error_history

thi_plugin_version

thi_last_api_connection

thi_last_api_response_time

Acceso a opciones en código

Obtener opciones

Actualizar opciones

Eliminar opciones

Mejores prácticas

Exportar/Importar opciones