Convoca Core Utilities

Plugin base del ecosistema Convoca. Proporciona utilidades compartidas, logging centralizado, webhooks, dashboard, backup/restore, y gestión de capacidades.

Requirements

• WordPress 6.4+
• PHP 8.1+

Main Features

• DNI/NIE validation
• Centralized Logger with rotation
• Webhook manager with retries + dedup
• Atomic lock system
• Rate limiter
• Unified Dashboard (Convoca > Panel)
• Centralized Log Viewer (Convoca > Logs)
• Setup Wizard (Convoca > Asistente)
• Backup/Restore (Convoca > Backup)
• System Health (Convoca > Salud)
• Upgrade Manager
• REST API

📖 Documentación

La documentación completa (manual de usuario, API REST, hooks, instalación) vive en la wiki:

👉 Convoca core

Dependencies

WordPress 6.4+, PHP 8.1+

Webhook Manager

Register and manage webhooks from Convoca > Webhooks.

Available events

HMAC signature

If a secret is configured, each request includes X-Convoca-Signature header with hash_hmac('sha256', $body, $secret). Verify on your endpoint:

$computed = hash_hmac('sha256', file_get_contents('php://input'), $secret);
if (hash_equals($computed, $_SERVER['HTTP_X_CONVOCA_SIGNATURE'])) {
    // valid
}

Delivery

• Blocking mode, 15s timeout.
• Deduplication via transient (10s TTL, md5 payload hash).
• Each delivery gets a unique X-Convoca-Delivery UUID.
• Retries with exponential backoff: 60s, 120s, 240s (max 3 attempts).
• Delivery logs: last 50 entries per webhook.

Testing

Click "Test" on any webhook to send a test.ping event. The delivery is logged identically to real events.

Gestión de Plantillas PDF

Administra las plantillas desde Ajustes > Plantillas PDF.

Plantillas disponibles

Uso

1. Cada plantilla es HTML puro con placeholders {{nombre}}, {{dni}}, {{fecha}}, etc. (varían según el documento).
2. Puedes editarlas directamente desde el panel de administración y ver los placeholders disponibles en cada una.
3. Al guardar, se crea automáticamente un backup versionado (últimas 5 versiones).
4. Si la plantilla se corrompe (HTML inválido), se restaura a los valores por defecto y se guarda una copia de seguridad.
5. El sistema valida: tamaño máximo 500KB, profundidad DOM < 30, máximo 10 bloques `