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.
Filtros
Los filtros permiten modificar valores que el plugin usa internamente sin tocar su código. Se conectan con add_filter() y deben devolver el valor modificado.
Todos los filtros documentados aquí están verificados contra el código fuente (apply_filters(...)). Si un filtro no aparece en esta página, el plugin no lo dispara.
Chequeos de salud del servidor (health checks)
Antes de iniciar la sincronización, el plugin verifica memoria, carga (load average) y disco. Estos filtros ajustan los umbrales y permiten desactivar chequeos individuales.
thi_server_health_check_enabled
Habilita o deshabilita por completo los chequeos de salud antes de sincronizar.
$enabled = apply_filters('thi_server_health_check_enabled', true);
| Propiedad | Valor |
|---|
| Valor predeterminado | true |
| Tipo de retorno | boolean |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_allow_image_sync_when_unhealthy
Permite continuar la sincronización de imágenes aun cuando los chequeos detectan presión de recursos.
$allow = apply_filters('thi_allow_image_sync_when_unhealthy', false, $health_result);
| Propiedad | Valor |
|---|
| Valor predeterminado | false |
| Argumentos | $allow (bool), $health_result (array con detalles por sistema) |
| Ubicación | includes/ajax/ajax-handlers.php |
Devolver true en servidores con recursos al límite puede causar timeouts o fallas OOM. Úsalo sólo cuando sepas que los umbrales por defecto son demasiado conservadores para tu entorno.
thi_server_health_check_memory_enabled
Habilita o deshabilita específicamente el chequeo de memoria.
$enabled = apply_filters('thi_server_health_check_memory_enabled', true);
| Propiedad | Valor |
|---|
| Valor predeterminado | true |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_memory_warning_threshold
Porcentaje de memoria a partir del cual el chequeo emite un warning.
$threshold = apply_filters('thi_memory_warning_threshold', 85.0);
| Propiedad | Valor |
|---|
| Valor predeterminado | 85.0 (%) |
| Tipo | float |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_memory_critical_threshold
Porcentaje de memoria a partir del cual el chequeo bloquea la sincronización.
$threshold = apply_filters('thi_memory_critical_threshold', 95.0);
| Propiedad | Valor |
|---|
| Valor predeterminado | 95.0 (%) |
| Tipo | float |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_server_health_check_load_enabled
Habilita o deshabilita el chequeo de load average.
$enabled = apply_filters('thi_server_health_check_load_enabled', true);
| Propiedad | Valor |
|---|
| Valor predeterminado | true |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_load_warning_threshold_normalized
Umbral de advertencia para el load average normalizado por CPU (load average / número de núcleos).
$threshold = apply_filters('thi_load_warning_threshold_normalized', 1.2);
| Propiedad | Valor |
|---|
| Valor predeterminado | 1.2 |
| Tipo | float |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_load_critical_threshold_normalized
Umbral crítico para el load average normalizado por CPU.
$threshold = apply_filters('thi_load_critical_threshold_normalized', 2.0);
| Propiedad | Valor |
|---|
| Valor predeterminado | 2.0 |
| Tipo | float |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_server_health_check_load_hard_fail
Indica si superar el umbral crítico de load debe bloquear la sincronización (hard fail) o solo advertir.
$hard_fail = apply_filters('thi_server_health_check_load_hard_fail', !$is_docker);
| Propiedad | Valor |
|---|
| Valor predeterminado | true en hosts normales, false cuando se detecta Docker (donde el load puede ser engañoso) |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_server_health_check_disk_enabled
Habilita o deshabilita el chequeo de espacio en disco.
$enabled = apply_filters('thi_server_health_check_disk_enabled', true);
| Propiedad | Valor |
|---|
| Valor predeterminado | true |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_disk_warning_gb
GB libres a partir de los cuales el chequeo emite warning de disco.
$gb = apply_filters('thi_disk_warning_gb', 5.0);
| Propiedad | Valor |
|---|
| Valor predeterminado | 5.0 GB |
| Tipo | float |
| Ubicación | includes/ajax/ajax-handlers.php |
thi_disk_critical_gb
GB libres a partir de los cuales el chequeo falla con error crítico.
$gb = apply_filters('thi_disk_critical_gb', 1.0);
| Propiedad | Valor |
|---|
| Valor predeterminado | 1.0 GB |
| Tipo | float |
| Ubicación | includes/ajax/ajax-handlers.php |
Notificaciones y reportes
thi_notifications_enabled
Controla si el plugin envía notificaciones por email (alertas de error + reporte periódico).
$enabled = apply_filters('thi_notifications_enabled', $is_premium);
| Propiedad | Valor |
|---|
| Valor predeterminado | true si el plan tiene premium code, false en caso contrario |
| Ubicación | includes/notifications/notification-functions.php |
En el plan Starter las notificaciones por email están deshabilitadas por defecto porque es una característica premium.
thi_error_alert_throttle_seconds
Tiempo mínimo (en segundos) entre dos correos de alerta de error consecutivos para evitar spam.
$seconds = apply_filters('thi_error_alert_throttle_seconds', 1800);
| Propiedad | Valor |
|---|
| Valor predeterminado | 1800 (30 minutos) |
| Ubicación | includes/notifications/class-thi-error-alert.php |
thi_sync_reports_retention_days
Días que se conservan los reportes de sincronización antes de ser purgados por el cron diario.
$days = apply_filters('thi_sync_reports_retention_days', 30);
| Propiedad | Valor |
|---|
| Valor predeterminado | 30 días |
| Ejecutado por | el evento WP-Cron thi_daily_sync_reports_cleanup |
| Ubicación | includes/sync/class-thi-sync-report-store.php |
Buenas prácticas
- Devuelve siempre el valor (modificado o no). Un filtro que no retorna dispara advertencias y rompe comportamiento.
- Usa prioridades distintas a
10 si quieres garantizar que tu filtro se ejecute después del default del plugin (si cambia en el futuro).
- No llames operaciones pesadas dentro del callback de un filtro: estos se evalúan en cada request relevante.
// ✅ Correcto
add_filter('thi_memory_warning_threshold', function($threshold) {
return 70.0; // retorna el nuevo valor
});
// ❌ Incorrecto (no retorna nada)
add_filter('thi_memory_warning_threshold', function($threshold) {
$new = 70.0;
// missing return
});
