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);

add_filter('thi_server_health_check_enabled', function($enabled) {
    // Deshabilitar solo en entorno local
    if (defined('WP_DEBUG') && WP_DEBUG) {
        return false;
    }
    return $enabled;
});

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);

add_filter('thi_allow_image_sync_when_unhealthy', function($allow, $health) {
    // Permitir si solo el disco está bajo (pero memoria y CPU están OK)
    if ($health['disk']['status'] === 'warning' && $health['memory']['status'] === 'ok') {
        return true;
    }
    return $allow;
}, 10, 2);

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);

add_filter('thi_memory_warning_threshold', fn() => 75.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);

// Fuerza-habilitar notificaciones aunque no seas premium (solo para staging)
add_filter('thi_notifications_enabled', '__return_true');

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);

// Throttle más agresivo: una alerta por hora como máximo
add_filter('thi_error_alert_throttle_seconds', fn() => HOUR_IN_SECONDS);

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);

// Conservar 90 días de reportes
add_filter('thi_sync_reports_retention_days', fn() => 90);

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
});

Referencia

Filtros (Filters)

Filtros

Chequeos de salud del servidor (health checks)

thi_server_health_check_enabled

thi_allow_image_sync_when_unhealthy

thi_server_health_check_memory_enabled

thi_memory_warning_threshold

thi_memory_critical_threshold

thi_server_health_check_load_enabled

thi_load_warning_threshold_normalized

thi_load_critical_threshold_normalized

thi_server_health_check_load_hard_fail

thi_server_health_check_disk_enabled

thi_disk_warning_gb

thi_disk_critical_gb

Notificaciones y reportes

thi_notifications_enabled

thi_error_alert_throttle_seconds

thi_sync_reports_retention_days

Buenas prácticas

​Filtros

​Chequeos de salud del servidor (health checks)

​thi_server_health_check_enabled

​thi_allow_image_sync_when_unhealthy

​thi_server_health_check_memory_enabled

​thi_memory_warning_threshold

​thi_memory_critical_threshold

​thi_server_health_check_load_enabled

​thi_load_warning_threshold_normalized

​thi_load_critical_threshold_normalized

​thi_server_health_check_load_hard_fail

​thi_server_health_check_disk_enabled

​thi_disk_warning_gb

​thi_disk_critical_gb

​Notificaciones y reportes

​thi_notifications_enabled

​thi_error_alert_throttle_seconds

​thi_sync_reports_retention_days

​Buenas prácticas

Filtros

Chequeos de salud del servidor (health checks)

thi_server_health_check_enabled

thi_allow_image_sync_when_unhealthy

thi_server_health_check_memory_enabled

thi_memory_warning_threshold

thi_memory_critical_threshold

thi_server_health_check_load_enabled

thi_load_warning_threshold_normalized

thi_load_critical_threshold_normalized

thi_server_health_check_load_hard_fail

thi_server_health_check_disk_enabled

thi_disk_warning_gb

thi_disk_critical_gb

Notificaciones y reportes

thi_notifications_enabled

thi_error_alert_throttle_seconds

thi_sync_reports_retention_days

Buenas prácticas