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.
Búsqueda Avanzada
Tokko Plugins mejora significativamente el sistema de búsqueda de Houzez con filtros avanzados, búsqueda por múltiples campos y controles intuitivos para una mejor experiencia del usuario.
Búsqueda Mejorada por Palabra Clave
Habilitar Búsqueda Mejorada
Opción: thi_enhanced_search_enabled
// Habilitada:
// - Búsqueda en múltiples campos
// - Lógica OR (cualquiera coincide)
// - Incluye referencias internas
// Deshabilitada (por defecto):
// - Solo búsqueda estándar de Houzez
// - Solo título de propiedad
La búsqueda mejorada reemplaza el sistema estándar de Houzez de manera transparente.
La búsqueda mejorada es más potente pero consume ligeramente más recursos. En sitios con +5000 propiedades, considera activarla solo en horarios de bajo tráfico.
Campos Buscables
Opción: thi_enhanced_search_fields
Configura qué campos se buscan:
// Campos disponibles:
✓ post_title // Título de propiedad
✓ fave_property_address // Dirección completa
✓ fave_property_id // ID de Tokko
✓ fave_reference_code // Código de referencia
✓ postal_code // Código postal
✓ city // Ciudad
✓ state // Provincia/Estado
✓ country // País
✓ post_content // Descripción completa
Seleccionar Campos
Accede a Configuración
WordPress > Tokko Plugins > Configuración
Busca Búsqueda Avanzada
Desplázate hasta “Búsqueda Mejorada”
Marca Campos
Selecciona los campos a buscar
Guarda
Haz clic en “Guardar cambios”
// Configuración recomendada:
thi_enhanced_search_fields = [
'post_title',
'fave_property_address',
'city',
'postal_code'
];
Lógica de Búsqueda
La búsqueda usa lógica OR (cualquiera coincide):
Búsqueda: "3 ambientes recoleta"
Resultados:
✓ Propiedades con "3 ambientes"
✓ Propiedades en "Recoleta"
✓ Propiedades con ambas características
(No requiere TODAS las palabras)
Esto es más intuitivo que buscar coincidencias exactas.
Integración con Houzez
El plugin intercepta automáticamente:
// Hook de Houzez:
add_filter('fave_property_search_query',
'thi_enhance_search_query');
// Modifica el query para incluir múltiples campos
// Sin afectar el funcionamiento de Houzez
Slider de Rango de Edad
¿Qué es Edad de Propiedad?
La edad se calcula desde el año de construcción:
Edad = Año actual - Año construcción
Ejemplos:
- Construcción 2020 → Edad 4 años
- Construcción 2024 → Edad 0 años ("A estrenar")
- En construcción → Edad -1 años
Habilitar Slider de Edad
Clase: THI_Age_Range_Slider
// Crea automáticamente un slider visual
// Permite filtrar por rango de edad
// Se integra con Houzez Search
Configuración Visual
Opción: thi_age_range_slider_color
Cambia el color del slider según tu diseño:
- Default: #007bff (azul)
- Personalizado: #FF6B6B (rojo) u otro color
Formato: código hex (#RRGGBB)
Opción: thi_age_range_slider_label
// Cambiar etiqueta del slider:
thi_age_range_slider_label = "Antigüedad"
thi_age_range_slider_label = "Edad de construcción"
thi_age_range_slider_label = "Años desde construcción"
Valores Especiales
El slider reconoce valores especiales:
| Valor | Significado |
|---|
| 0 | A estrenar (sin uso anterior) |
| -1 | En construcción (no completada) |
| 1-100 | Años desde construcción |
Opción: thi_age_range_slider_half_map_enabled
// Habilitada:
// El slider aparece DENTRO de la búsqueda
// mismo donde Houzez muestra el mapa
// (solo en vista de media mapa)
// Deshabilitada:
// Slider en barra de búsqueda superior
// Disponible en todas las vistas
Activa “half_map” si usas el tema Houzez con búsqueda de media mapa. El slider se verá mejor integrado.
Frontend: Usar el Slider
// Shortcode:
[houzez_search_slider type="age"]
// O automático:
// Si habilitas THI_Age_Range_Slider,
// aparece en todas las búsquedas Houzez
<!-- Ejemplo HTML generado -->
<div class="age-range-slider">
<label>Antigüedad de propiedad</label>
<input type="range" min="-1" max="100" value="0,30">
<span>Entre a estrenar y 30 años</span>
</div>
Multi-Select de Cantidades
¿Qué es Multi-Select?
Convierte campos numéricos simples en selecciones múltiples:
Antes (Houzez estándar):
Habitaciones: [ 3 ] ← Solo 1 opción
Después (con plugin):
Habitaciones: [✓ 1] [✓ 2] [✓ 3] [✓ 4+] ← Múltiples
Clase de Implementación
Clase: THI_Quantity_Multiselect
// Convierte campos en checkboxes:
add_filter('fave_rooms_filter',
array('THI_Quantity_Multiselect', 'render_multiselect'));
add_filter('fave_bedrooms_filter',
array('THI_Quantity_Multiselect', 'render_multiselect'));
add_filter('fave_bathrooms_filter',
array('THI_Quantity_Multiselect', 'render_multiselect'));
add_filter('fave_garage_filter',
array('THI_Quantity_Multiselect', 'render_multiselect'));
Campos Convertidos
El plugin convierte automáticamente:
| Campo | Descripción |
|---|
| Ambientes | Total de espacios |
| Habitaciones | Dormitorios |
| Baños | Baños y medios baños |
| Garaje | Lugares de estacionamiento |
Ejemplo de Uso
<!-- Antes -->
<select name="property_rooms">
<option>1</option>
<option>2</option>
<option>3</option>
</select>
<!-- Después (con multi-select) -->
<div class="property-rooms-filter">
<label>
<input type="checkbox" value="1"> 1 Ambiente
</label>
<label>
<input type="checkbox" value="2"> 2 Ambientes
</label>
<label>
<input type="checkbox" value="3"> 3 Ambientes
</label>
<label>
<input type="checkbox" value="4"> 4+ Ambientes
</label>
</div>
Beneficios
✅ Usuario selecciona múltiples opciones
✅ Más intuitivo que dropdowns
✅ Mejora conversión
✅ Mejor UX en móviles
Corrección de Búsqueda Numérica
Problema: Búsquedas Incompletas
Sin esta corrección:
Usuario busca: "1"
Coincidencias incorrectas:
❌ Propiedades con ID 12345
❌ Propiedades referencia 2134
❌ Propiedades con 1 ambiente (correcto)
❌ Propiedades con 10 ambientes (¿?)
Solución: Búsqueda Exacta
Función: thi_fix_numeric_search()
// Filtra para que "1" SOLO encuentre:
✓ 1 ambiente (exactamente)
✓ Direcciones con "1"
✓ Códigos con "1"
// NO encuentra:
❌ 12, 21, 100, 213, etc.
La búsqueda numérica se vuelve más precisa.
Esta corrección se aplica automáticamente cuando buscas números. No requiere configuración adicional.
Cómo Funciona
// Cuando usuario busca "1":
1. Detecta que es búsqueda numérica
2. Busca solo coincidencias exactas
3. No aplica búsqueda parcial
4. Retorna resultados más precisos
Integración Completa
Flujo de Búsqueda
Usuario abre búsqueda
↓
Ve campos mejorados:
- Keyword (múltiples campos)
- Edad (slider)
- Habitaciones (multi-select)
- Baños (multi-select)
↓
Selecciona opciones
↓
Presiona "Buscar"
↓
Plugin procesa:
- Keyword en todos los campos
- Filtra por rango de edad
- Filtra por múltiples cantidades
↓
Muestra resultados
Compatibilidad
✅ Compatible con:
- Houzez Search por defecto
- Houzez + Elementor
- Temas personalizados con Houzez hooks
❌ No compatible:
- Búsquedas de otros plugins
- Mapas terceros sin hooks Houzez
- Temas sin soporte Houzez
Configuración Recomendada
Para Máxima Funcionalidad
// Habilita todas las mejoras:
thi_enhanced_search_enabled = true
thi_enhanced_search_fields = [
'post_title',
'fave_property_address',
'city',
'postal_code'
]
thi_age_range_slider_color = '#007bff'
thi_age_range_slider_label = 'Antigüedad'
thi_age_range_slider_half_map_enabled = true
// Multi-select se habilita automáticamente
// Si tienes +10000 propiedades:
thi_enhanced_search_enabled = false // Usa búsqueda estándar
thi_age_range_slider_half_map_enabled = false // No en half-map
// Multi-select se habilita siempre (es ligero)
Personalización Avanzada
Modificar Campos Buscables
// En functions.php del tema:
add_filter('thi_enhanced_search_fields', function($fields) {
$fields[] = 'fave_property_type'; // Agregar tipo
$fields[] = 'custom_meta_field'; // Campo personalizado
return $fields;
});
Cambiar Color del Slider
// En functions.php:
add_filter('thi_age_slider_color', function() {
return '#FF6B6B'; // Color rojo personalizado
});
Customizar HTML del Multi-Select
// En functions.php:
add_filter('thi_quantity_multiselect_html',
function($html, $field) {
// Modifica estructura HTML
return custom_render_checkboxes($field);
}, 10, 2
);
Solución de Problemas
Búsqueda Mejorada No Funciona
Verifica Habilitación
Comprueba que thi_enhanced_search_enabled = true
Limpia Cache
Si usas caché, limpia (W3 Total Cache, WP Super Cache)
Verifica Houzez
Asegúrate que Houzez está activo y versión actualizada
Prueba en Incógnito
Abre navegador privado para evitar cache del navegador
Slider No Aparece
// Verifica:
1. thi_age_range_slider_color tiene valor válido
2. No hay conflicto con otros sliders (jQuery)
3. Half-map está habilitado si usas esa vista
4. Houzez Search está en la página
Multi-Select No Funciona
// Posibles causas:
1. Houzez versión antigua (actualiza)
2. JavaScript conflictivo (otro plugin)
3. CSS que esconde checkboxes
// Solución:
Desactiva otros plugins de búsqueda
Verifica consola JS (F12) para errores
Búsquedas Numérica Lenta
// Si muchas propiedades con números:
1. Considera desactivar búsqueda mejorada
2. Usa búsqueda estándar de Houzez
3. Implementa caché de búsquedas frecuentes
Análisis de Búsquedas
Ver Términos Más Buscados
En WordPress > Tokko Plugins > Dashboard:
Búsquedas más frecuentes:
1. "departamento 3 ambientes" - 1,234 búsquedas
2. "casa zona norte" - 892 búsquedas
3. "oficina centro" - 456 búsquedas
Usa esta información para:
- Mejorar descripción de propiedades
- Destacar ubicaciones populares
- Ajustar precios según demanda
Próximos pasos: Aprende sobre Dashboard para monitorear sincronización y estadísticas de tu sitio.