🛠️ Tabla de Hooks Principales del Core de WordPress

1.- Hooks Principales del Core de WordPress

Hook	Tipo	Momento de Ejecución (Ciclo de Vida)	Uso Principal / Caso Práctico	Parámetros Clave
`plugins_loaded`	Action	Inmediatamente después de cargar todos los plugins activos.	Inicializar plugins, comprobar dependencias entre plugins, cargar textdomains (traducciones).	N/A
`after_setup_theme`	Action	Inmediatamente después de cargar el `functions.php` del tema activo.	Registrar soporte del tema (`add_theme_support`), definir menús nativos (`register_nav_menus`).	N/A
`init`	Action	Tras cargar el entorno de WP y antes de procesar cabeceras HTTP o consultas.	Registrar Custom Post Types, Taxonomías, Rewrite Rules, inicializar sesiones PHP.	N/A
`admin_init`	Action	Solo en `wp-admin` / AJAX. Tras la inicialización del panel de administración.	Registrar ajustes con la Settings API (`register_setting`), procesar guardados de formularios admin.	N/A
`admin_menu`	Action	Al construir la estructura de menús del panel de administración.	Crear páginas de opciones y submenús en el admin (`add_menu_page`, `add_submenu_page`).	N/A
`wp_loaded`	Action	Tras la carga total de WordPress y la sesión del usuario actual.	Procesar formularios en el frontend (envíos `POST`), redirecciones previas a renderizado.	N/A
`parse_request`	Action	Tras parsear la URL recibida según las reglas de reescritura.	Inspeccionar o modificar las variables de consulta (`$wp->query_vars`) antes de consultar la BD.	`\WP $wp`
`query_vars`	Filter	Durante el filtrado de variables públicas en `$wp->parse_request()`.	Añadir variables de URL personalizadas a la lista blanca de WordPress.	`array $public_query_vars`
`pre_get_posts`	Action	Justo antes de ejecutar la consulta SQL principal de `$wp_query`.	Alterar la consulta de la base de datos (ej: cambiar `posts_per_page`, filtrar CPTs en búsquedas).	`\WP_Query $query`
`template_redirect`	Action	Tras resolver la consulta `$wp_query` y definir qué página se está cargando.	Redirecciones HTTP (301/302), comprobación de muros de pago, cortar la ejecución (exit) para vistas custom.	N/A
`template_include`	Filter	En `template-loader.php`, justo antes de incluir el archivo `.php` del tema.	Sobrescribir el archivo de plantilla a renderizar (como vimos en nuestro `Template_Enforcer`).	`string $template` (Ruta absoluta)
`wp_enqueue_scripts`	Action	Antes de procesar la cabecera HTML en peticiones frontend.	Encolar hojas de estilo CSS (`wp_enqueue_style`) y scripts JS (`wp_enqueue_script`).	N/A
`admin_enqueue_scripts`	Action	Antes de renderizar la interfaz de administración (`wp-admin`).	Encolar scripts o estilos exclusivos para el panel de administración.	`string $hook_suffix`
`wp_head`	Action	Dentro de la etiqueta `<head>` del HTML.	Imprimir favicons, meta tags, pixels de analítica o scripts inline globales.	N/A
`body_class`	Filter	Al invocar la función `body_class()` en la etiqueta `<body>`.	Añadir o quitar clases CSS al elemento `<body>` según el contexto de la página.	`array $classes`, `array $class`
`the_content`	Filter	Al invocar la función `the_content()` para mostrar el cuerpo de un post/página.	Modificar el HTML del contenido (inyectar banners, filtrar palabras, transformar shortcodes).	`string $content`
`wp_footer`	Action	Justo antes de la etiqueta de cierre `</body>`.	Imprimir scripts JS en el pie, modales Bootstrap, badges de depuración (como nuestro Laboratorio).	N/A
`save_post`	Action	Al guardar, actualizar o crear una entrada en la base de datos.	Guardar campos personalizados (meta keys), actualizar cachés, enviar notificaciones por mail.	`int $post_id`, `\WP_Post $post`, `bool $update`
`wp_insert_post_data`	Filter	Justo antes de que los datos de un post sean insertados o actualizados en la BD.	Sanitizar, modificar o validar títulos, slug o estado del post antes de ejecutar el SQL.	`array $data`, `array $postarr`

⏱️ El Ciclo de Vida Resumido en 4 Fases Clave

Plaintext

┌────────────────────────────────────────────────────────┐
│ 1. FASE DE CARGA Y BOOTSTRAP                           │
│    plugins_loaded ──> after_setup_theme ──> init       │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 2. FASE DE ENRUTAMIENTO Y CONSULTA                     │
│    parse_request ──> pre_get_posts ──> wp              │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 3. FASE DE SELECCIÓN Y RENDERIZADO                     │
│    template_redirect ──> template_include ──> wp_head  │
└───────────────────────────┬────────────────────────────┘
│
┌───────────────────────────▼────────────────────────────┐
│ 4. FASE DE SALIDA Y CIERRE                             │
│    the_content ──> wp_footer ──> shutdown              │
└────────────────────────────────────────────────────────┘

┌────────────────────────────────────────────────────────┐

│ 1. FASE DE CARGA Y BOOTSTRAP │

│ plugins_loaded ──> after_setup_theme ──> init │

└───────────────────────────┬────────────────────────────┘

│

┌───────────────────────────▼────────────────────────────┐

│ 2. FASE DE ENRUTAMIENTO Y CONSULTA │

│ parse_request ──> pre_get_posts ──> wp │

└───────────────────────────┬────────────────────────────┘

│

┌───────────────────────────▼────────────────────────────┐

│ 3. FASE DE SELECCIÓN Y RENDERIZADO │

│ template_redirect ──> template_include ──> wp_head │

└───────────────────────────┬────────────────────────────┘

│

┌───────────────────────────▼────────────────────────────┐

│ 4. FASE DE SALIDA Y CIERRE │

│ the_content ──> wp_footer ──> shutdown │

└────────────────────────────────────────────────────────┘

💡 Reglas de Oro para Trabajar con Hooks

Usa pre_get_posts en lugar de query_posts() o segundas consultas:
Modificar la consulta principal con pre_get_posts evita hacer dos peticiones SQL consecutivas a la base de datos. Asegúrate siempre de validar $query->is_main_query() para no alterar widgets o subconsultas secundarias.
Acciones no retornan valor, los Filtros SÍ:
En add_action, la función realiza una operación (ej: enviar un email, encolar un script). En add_filter, la función debe retornar obligatoriamente el valor recibido, modificado o no, o romperás la cadena de datos de WordPress:
// CORRECTO add_filter('the_content', function(string $content): string { return $content . '<p>Texto inyectado al final</p>'; });
1
2
3
4
// CORRECTO
add_filter('the_content', function(string $content): string {
return $content . '<p>Texto inyectado al final</p>';
});
3.- Gana la batalla de prioridades cuando sea necesario:
Si necesitas que tu código se ejecute después de cualquier plugin comercial o maquetador, usa prioridades altas (999 o mayores). Si necesitas adelantarte a todos, usa prioridades bajas (1 a 5).

1.- Hooks Principales del Core de WordPress

⏱️ El Ciclo de Vida Resumido en 4 Fases Clave

💡 Reglas de Oro para Trabajar con Hooks

Entradas relacionadas