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.
Dashboard
El Dashboard de Tokko Plugins proporciona una vista centralizada de toda la actividad de sincronización, estadísticas de propiedades y salud del sistema. Desde aquí puedes monitorear, analizar y controlar todo lo que sucede en tu integración.
Acceso al Dashboard
Ubicación
WordPress > Tokko Plugins > Dashboard
Requisitos
- Rol de administrador de WordPress
- Tokko Plugins v3.0.0+
- Acceso a la API de Tokko Broker
Vista General
Panel Principal
El Dashboard mostrará al abrirlo:
Dashboard de Tokko Plugins
├── Estadísticas en Vivo
├── Actividad Reciente
├── Gráficos de Rendimiento
├── Estado del Sistema
└── Acciones Rápidas
THI_Enhanced_Dashboard (definida en includes/core/class-thi-enhanced-dashboard.php)
El dashboard es completamente responsive y funciona en escritorio y móvil.
Estadísticas de Propiedades
Tarjetas de Resumen
El dashboard muestra 4 tarjetas principales:
| Tarjeta | Descripción |
|---|
| Total Propiedades | Todas las propiedades sincronizadas |
| Propiedades Activas | Publicadas y visibles en el sitio |
| Propiedades Pendientes | En proceso de sincronización |
| Propiedades Archivadas | Propiedades inactivas/vendidas |
Total: 1,234
├── Activas: 1,100 (89%)
├── Pendientes: 34 (3%)
└── Archivadas: 100 (8%)
Colores Indicadores
🟢 Verde → Status OK / Activa
🟡 Amarillo → Pendiente / En proceso
🔴 Rojo → Error / Archivada
⚪ Gris → Sin datos / Inactiva
Tab Propiedades: consola operativa
Desde la v3.3.0, el tab Propiedades dejó de ser un panel de analítica (se quitaron los widgets de Propiedades por área y Análisis de precios) y pasó a ser una consola operativa centrada en troubleshooting y control fino del sync.
Columnas de la tabla
La tabla paginada lista todas las propiedades sincronizadas con las columnas:
| Columna | Detalle |
|---|
| ID | ID de Tokko de la propiedad |
| Título | Título publicado en WordPress |
| Estado de sync | synced, pending, error o archived |
| Última acción | Nueva, actualizada, omitida, archivada o reactivada |
| Imágenes | Total descargado vs. total esperado |
| Última sync | Fecha/hora de la última participación en un sync |
| Acciones | Menú por fila (ver detalle abajo) |
Acciones por fila
Cada propiedad ofrece un menú rápido con:
- Último reporte — abre el modal con el reporte completo del último sync en que participó esa propiedad (sin navegar al historial).
- ¿Por qué no veo esta propiedad? — diagnóstico en vivo: existencia en Tokko, publicación en WordPress, imágenes, archivado, errores registrados.
- Imágenes — marca la propiedad con
_thi_force_image_resync y dispara un sync selectivo para volver a descargar todas las fotos.
- Abrir en Tokko — abre el detalle en el backoffice de Tokko Broker si configuraste
tokkoBackofficeBase. Si no, el botón se reemplaza por Copiar ID (usa Clipboard API para dejar el tokko_id listo para pegar).
Sincronización selectiva
La consola soporta dos formas de sync selectiva, que respetan el mismo lock global que la sync completa:
- Por checkboxes: selecciona una o varias filas y usa la barra flotante Sincronizar seleccionadas (N).
- Por IDs de Tokko: pega uno o más IDs (separados por coma) en el campo de la toolbar; no necesitan estar en la vista actual.
Los reportes resultantes quedan marcados con el trigger Selectivo en el historial.
KPI “Archivadas recientemente por Tokko”
Una tarjeta destacada muestra el conteo de propiedades que Tokko marcó como archivadas (status = archived) en los últimos 7 días. Es la forma más rápida de detectar borrados masivos en el lado de Tokko que impacten en el sitio.
Cronograma de Sincronización
Timeline Visual
El dashboard muestra un timeline de sincronizaciones:
Hoy
├─ 14:32 ✅ Sincronización completada (450 props)
├─ 08:15 ✅ Sincronización completada (438 props)
│
Ayer
├─ 20:45 ✅ Sincronización completada (445 props)
├─ 14:30 ✅ Sincronización completada (442 props)
└─ 08:00 ✅ Sincronización completada (440 props)
- Hora exacta
- Estado (✅ OK, ⚠️ Parcial, ❌ Error)
- Número de propiedades procesadas
- Duración de sincronización
Cliquea para Detalles
Haz clic en cualquier sincronización para ver:
Sincronización #1234
├── Duración: 2m 34s
├── Propiedades procesadas: 450
├── Imágenes descargadas: 1,245
├── Errores: 3
├── Advertencias: 12
└── Detalles: Ver log completo
Indicadores de Rendimiento
Métricas Clave
Velocidad de Sincronización:
Promedio: 2.5 propiedades/segundo
Máximo: 3.1 props/seg
Mínimo: 1.8 props/seg
(En base a últimas 10 sincronizaciones)
Última 24h: 99.2%
Última semana: 98.9%
Última mes: 98.7%
Próxima sincronización: en 14m 32s
Duración estimada: 2m 45s
Basado en: 1,234 propiedades
Consumo y Proyección de Storage
En el tab Sincronización del dashboard, al final, aparece un bloque Consumo y Proyección (solo en licencias Pro/trial) con cuatro tarjetas y una tabla de proyección:
- Peso promedio por imagen en los últimos 30 días.
- Total descargado en la ventana.
- Ritmo diario promedio (
/día).
- Propiedades sincronizadas distintas.
La tabla de proyección estima el consumo a 30, 90 y 365 días al ritmo actual. El encabezado del bloque incluye un badge Confianza: alta / media / baja según cuántos días con actividad tengas dentro de la ventana de 30 días:
- Alta: 20+ días con actividad.
- Media: 7–19 días.
- Baja: menos de 7 días (muestra aviso de “Datos limitados”).
Este mismo bloque aparece como Highlights mensuales en el reporte por correo cuando configuras la frecuencia en Mensual. Más detalle en la guía de Sincronización.
Salud del Sistema
Indicadores del Servidor
Memoria:
Usada: 256 MB / 512 MB (50%)
├─ 🟢 OK (< 70%)
└─ Recomendación: Aumentar si >85%
Uso actual: 35%
├─ 🟢 Bajo
└─ Promedio últimas 2h: 42%
/wp-content/uploads: 2.3 GB / 10 GB (23%)
├─ 🟢 OK
└─ Imágenes de propiedad: 1.8 GB
API Tokko Broker: 245 ms
└─ 🟢 Excelente (< 500ms)
WordPress: 142 ms
└─ 🟢 Rápido (< 200ms)
Recomendaciones Automáticas
El sistema analiza salud y sugiere optimizaciones:
⚠️ Memoria alcanzará límite en ~5 sincronizaciones
→ Acción: Aumenta memory_limit a 1024M en wp-config.php
⚠️ Cache está deshabilitado
→ Acción: Activa W3 Total Cache para mejor rendimiento
ℹ️ 1.2 GB de imágenes huérfanas detectadas
→ Acción: Ejecuta limpieza automática
Historial de Sincronización
Ver Todos los Intentos
En “Historial de Sincronización” puedes ver:
Fecha/Hora Estado Props Imágenes Duración
2024-03-25 14:32 ✅ OK 450 1245 2m 34s
2024-03-25 08:15 ✅ OK 438 1100 2m 15s
2024-03-24 20:45 ✅ OK 445 1200 2m 40s
2024-03-24 14:30 ⚠️ Parcial 442 1050 3m 12s
2024-03-24 08:00 ✅ OK 440 1180 2m 25s
Filtrar Historial
Por estado: [✅ OK] [⚠️ Parcial] [❌ Error]
Por fecha: [Últimas 24h] [7 días] [30 días]
Exportar Datos
Descarga historial en CSV:
Dashboard > Historial > Exportar a CSV
Historial de Errores
Errores Detectados
El dashboard registra todos los errores encontrados:
ID Tipo Mensaje Fecha Estado
1245 Descarga Imagen No se pudo descargar... Hoy 14:32 Pendiente
1244 Timeout API timeout en props... Hoy 08:15 Resuelto
1243 Validación Precio inválido: ABC Ayer 20:45 Ignorado
Detalles del Error
Haz clic en cualquier error para ver:
Error #1245
├── Tipo: Descarga de Imagen
├── Propiedad: ID 12345
├── URL: https://tokko-api.../imagen.jpg
├── Error: "Connection timeout"
├── Intentos: 3 / 5
├── Próximo intento: en 15 minutos
└── Acción: [Reintentar ahora] [Ignorar] [Investigar]
Exportar Errores
Para análisis profundo:
Dashboard > Historial de Errores > Exportar a CSV
Monitoreo en Tiempo Real
Sincronización Activa
Cuando está en proceso:
Sincronización en curso...
█████████░░░░░░░░░░ 50%
Procesadas: 625 / 1,250 propiedades
Tiempo transcurrido: 1m 30s
Tiempo estimado restante: 1m 45s
Velocidad: 2.6 props/segundo
Detalles:
├─ Descargas: 450 imágenes
├─ Actualizadas: 300 propiedades
├─ Nuevas: 325 propiedades
└─ Errores: 2 (será reintentado)
Heartbeat / Latido
El sistema envía un “latido” cada 30 segundos:
Última actividad: hace 8 segundos ✅
Estado: Sincronización activa
ETA: 1m 45s restantes
Acciones Rápidas
Botones de Control
[↻ Sincronizar Ahora]
[⬇️ Descargar Imágenes]
[🧹 Limpiar Errores]
[📋 Ver Configuración]
[⚙️ Avanzado]
Sincronización Manual
Haz clic en “Sincronizar Ahora” para:
1. Iniciar sincronización inmediata
2. No esperar al siguiente ciclo programado
3. Ver progreso en tiempo real
4. Cancelar si algo va mal
Descarga de Imágenes
[⬇️ Descargar Imágenes Faltantes]
Analiza qué imágenes están en Tokko
pero no en WordPress media library.
Descarga automáticamente.
Útil después de:
- Agregar nuevas propiedades
- Restaurar base de datos
- Migración de servidor
Limpiar Errores Antiguos
[🧹 Limpiar Errores]
Opción 1: Borrar errores > 30 días
Opción 2: Borrar errores > 7 días
Opción 3: Borrar todos los errores
⚠️ Esta acción no se puede deshacer.
Exporta CSV primero si los necesitas.
Configuración del Dashboard
Personalizar Vistas
Opción: thi_dashboard_layout
thi_dashboard_layout = 'default' // Distribución estándar
thi_dashboard_layout = 'compact' // Más compacta
thi_dashboard_layout = 'detailed' // Más detalles
Intervalo de Actualización
Opción: thi_dashboard_refresh_interval
thi_dashboard_refresh_interval = 30 // Segundos (por defecto)
thi_dashboard_refresh_interval = 10 // Actualización frecuente
thi_dashboard_refresh_interval = 60 // Actualización lenta
Mostrar/Ocultar Secciones
☑️ Estadísticas
☑️ Gráficos
☑️ Timeline
☑️ Indicadores Sistema
☑️ Historial
☑️ Errores
Iconografía y Componentes
Iconos SVG
El dashboard usa iconos SVG nativos (sin dependencias):
✅ Sincronización exitosa
⚠️ Advertencia/parcial
❌ Error/fallida
🟢 OK/Sano
🟡 Precaución
🔴 Crítico
↻ Sincronizar
⬇️ Descargar
🧹 Limpiar
Tarjetas Modernas
Diseño responsive con tarjetas:
┌─────────────────────────────┐
│ 📊 Total Propiedades │
│ 1,234 │
│ ↑ 12 nuevas esta semana │
└─────────────────────────────┘
Notificaciones
Sistema de Alertas
El dashboard notifica sobre:
✅ Sincronización completada
⚠️ Errores encontrados (3)
❌ Sincronización fallida
ℹ️ Mantenimiento del sistema
⏰ Próxima sincronización en...
Tipo de Notificaciones
En Pantalla:
- Toast (arriba derecha) - 5 segundos
En Dashboard:
- Banner persistente - hasta descartar
Por Email (opcional):
- Errores críticos
- Sincronización fallida
Compatibilidad Móvil
Responsive Design
El dashboard funciona perfectamente en:
📱 Mobile (320px+)
└─ Tarjetas apiladas verticalmente
└─ Gráficos adaptativos
└─ Botones para toque
📱 Tablet (768px+)
└─ Diseño de 2 columnas
└─ Gráficos más grandes
💻 Desktop (1024px+)
└─ Diseño completo
└─ Gráficos interactivos
Uso en Móvil
- Swipe para cambiar gráficos
- Tap en tarjetas para detalles
- Scroll vertical para historial
- Botones grandes para acciones
Solución de Problemas
Dashboard en Blanco
Limpia Cache
Desactiva caché de plugins (W3 Total, WP Super Cache)
Recarga Forzada
Presiona Ctrl+Shift+R (o Cmd+Shift+R en Mac)
Verifica Permisos
Asegúrate que eres administrador de WordPress
Revisa Logs
Busca errores en /wp-content/debug.log
Datos No Se Actualizan
// Verifica:
1. Sincronización está habilitada
2. CRON de WordPress está activo
3. API Key de Tokko es válida
4. No hay firewall bloqueando Tokko
// Para debugging:
wp cron test // Verifica CRON
Dashboard Lento
// Si dashboard tarda en cargar:
1. Reduce intervalo de actualización
2. Activa caché de WordPress
3. Desactiva gráficos no usados
4. Aumenta memory_limit en wp-config.php
Gráficos No Aparecen
// Verifica:
1. JavaScript no bloqueado
2. Consola del navegador sin errores (F12)
3. Plugin Chart.js no esté conflictando
4. Navegador actualizado
Mejores Prácticas
Monitoreo Regular
✅ Revisa dashboard:
- Después de cada sincronización
- Al menos 1 vez por día
- Antes de cambios importantes
❌ No:
- Ignores errores por días
- Confíes solo en notificaciones
- Asumas que todo está bien
Análisis de Datos
Datos útiles:
- Patrones de error: ¿Suceden siempre a cierta hora?
- Velocidad de sincronización: ¿Ha aumentado?
- Distribución de propiedades: ¿Balanced?
- Tasa de éxito: ¿Está mejorando?
Exporta Regularmente
Mensual:
1. Exporta historial de sincronización
2. Exporta errores si hay
3. Guarda para registros
Fin de Guías Principales: Ya has cubierto todos los aspectos clave de Tokko Plugins. Para soporte adicional, visita Centro de Ayuda o contacta a soporte@tokkoplugins.com.