ff5ba25505
Add CacheFirstHooksRegistrar that fires roi_theme_before_page_serve hook on template_redirect priority 0 for singular pages. - Only fires for anonymous users (cache doesn't apply to logged in) - Only fires for singular pages (posts, pages, CPTs) - Provides post_id to external plugins - Does NOT define DONOTCACHEPAGE (allows page caching) Plan 1000.01 implementation. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
83 lines
2.4 KiB
PHP
83 lines
2.4 KiB
PHP
<?php
|
|
declare(strict_types=1);
|
|
|
|
namespace ROITheme\Shared\Infrastructure\Hooks;
|
|
|
|
/**
|
|
* Registra hooks para arquitectura cache-first.
|
|
*
|
|
* Permite que plugins externos evalúen condiciones ANTES de servir páginas,
|
|
* sin bloquear el cache de WordPress.
|
|
*
|
|
* @see openspec/specs/cache-first-architecture/spec.md
|
|
* @package ROITheme\Shared\Infrastructure\Hooks
|
|
*/
|
|
final class CacheFirstHooksRegistrar
|
|
{
|
|
/**
|
|
* Registra los hooks de cache-first.
|
|
*/
|
|
public function register(): void
|
|
{
|
|
add_action('template_redirect', [$this, 'fireBeforePageServe'], 0);
|
|
}
|
|
|
|
/**
|
|
* Dispara hook para que plugins externos evalúen acceso.
|
|
*
|
|
* Solo se dispara para:
|
|
* - Páginas singulares (posts, pages, CPTs)
|
|
* - Visitantes NO logueados (cache no aplica a usuarios logueados)
|
|
*
|
|
* Los plugins pueden llamar wp_safe_redirect() + exit para bloquear.
|
|
* Si no hacen nada, la página se sirve normalmente (con cache si disponible).
|
|
*/
|
|
public function fireBeforePageServe(): void
|
|
{
|
|
// No para usuarios logueados (cache no aplica, no tiene sentido evaluar)
|
|
if (is_user_logged_in()) {
|
|
return;
|
|
}
|
|
|
|
// Solo páginas singulares
|
|
if (!is_singular()) {
|
|
return;
|
|
}
|
|
|
|
// No en admin/ajax/cron/REST
|
|
if (is_admin() || wp_doing_ajax() || wp_doing_cron()) {
|
|
return;
|
|
}
|
|
|
|
if (defined('REST_REQUEST') && REST_REQUEST) {
|
|
return;
|
|
}
|
|
|
|
$post_id = get_queried_object_id();
|
|
|
|
if ($post_id > 0) {
|
|
/**
|
|
* Hook: roi_theme_before_page_serve
|
|
*
|
|
* Permite que plugins externos evalúen condiciones antes de servir página.
|
|
*
|
|
* Uso típico:
|
|
* - Rate limiters (límite de vistas por IP)
|
|
* - Membership plugins (verificar acceso)
|
|
* - Geolocation restrictions
|
|
*
|
|
* Para bloquear acceso:
|
|
* wp_safe_redirect('/pagina-destino/', 302);
|
|
* exit;
|
|
*
|
|
* Para permitir acceso:
|
|
* return; // La página se servirá (con cache si disponible)
|
|
*
|
|
* @since 1.0.0
|
|
* @param int $post_id ID del post/page que se va a servir
|
|
*/
|
|
do_action('roi_theme_before_page_serve', $post_id);
|
|
}
|
|
}
|
|
}
|