feat(exclusions): Implement component exclusion system (Plan 99.11)

Adds ability to exclude components from specific:
- Categories (by slug or term_id)
- Post/Page IDs
- URL patterns (substring or regex)

Architecture:
- Domain: Value Objects (CategoryExclusion, PostIdExclusion,
  UrlPatternExclusion, ExclusionRuleSet) + Contracts
- Application: EvaluateExclusionsUseCase +
  EvaluateComponentVisibilityUseCase (orchestrator)
- Infrastructure: WordPressExclusionRepository,
  WordPressPageContextProvider, WordPressServerRequestProvider
- Admin: ExclusionFormPartial (reusable UI),
  ExclusionFieldProcessor, JS toggle

The PageVisibilityHelper now uses the orchestrator UseCase that
combines page-type visibility (Plan 99.10) with exclusion rules.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
FrankZamora
2025-12-03 10:51:00 -06:00
parent 8735962f52
commit 14138e7762
19 changed files with 1407 additions and 5 deletions

View File

@@ -6,11 +6,11 @@ namespace ROITheme\Shared\Infrastructure\Services;
use ROITheme\Shared\Infrastructure\Di\DIContainer;
/**
* Facade/Helper para evaluar visibilidad de componentes
* Facade/Helper para evaluar visibilidad completa de componentes
*
* PROPÓSITO:
* Permite que los Renderers existentes evalúen visibilidad sin modificar sus constructores.
* Actúa como un Service Locator limitado a este único propósito.
* PROPOSITO:
* Permite que los Renderers existentes evaluen visibilidad sin modificar sus constructores.
* Ahora incluye tanto visibilidad por tipo de pagina como reglas de exclusion.
*
* USO EN RENDERERS:
* ```php
@@ -19,17 +19,41 @@ use ROITheme\Shared\Infrastructure\Di\DIContainer;
* }
* ```
*
* FLUJO:
* 1. Verifica visibilidad por tipo de pagina (home, posts, pages, etc.)
* 2. Verifica reglas de exclusion (categorias, IDs, patrones URL)
* 3. Retorna true SOLO si pasa ambas verificaciones
*
* @package ROITheme\Shared\Infrastructure\Services
*/
final class PageVisibilityHelper
{
/**
* Evalúa si un componente debe mostrarse en la página actual
* Evalua si un componente debe mostrarse en la pagina actual
*
* Incluye verificacion de:
* - Visibilidad por tipo de pagina (Plan 99.10)
* - Reglas de exclusion (Plan 99.11)
*
* @param string $componentName Nombre del componente (kebab-case)
* @return bool True si debe mostrarse
*/
public static function shouldShow(string $componentName): bool
{
$container = DIContainer::getInstance();
$useCase = $container->getEvaluateComponentVisibilityUseCase();
return $useCase->execute($componentName);
}
/**
* Evalua SOLO visibilidad por tipo de pagina (sin exclusiones)
*
* @deprecated Usar shouldShow() que incluye exclusiones
* @param string $componentName Nombre del componente (kebab-case)
* @return bool True si debe mostrarse segun tipo de pagina
*/
public static function shouldShowByPageType(string $componentName): bool
{
$container = DIContainer::getInstance();
$useCase = $container->getEvaluatePageVisibilityUseCase();