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

@@ -0,0 +1,52 @@
<?php
declare(strict_types=1);
namespace ROITheme\Shared\Application\UseCases\EvaluateComponentVisibility;
use ROITheme\Shared\Application\UseCases\EvaluatePageVisibility\EvaluatePageVisibilityUseCase;
use ROITheme\Shared\Application\UseCases\EvaluateExclusions\EvaluateExclusionsUseCase;
/**
* Caso de uso: Evaluar visibilidad completa de un componente
*
* Orquesta la evaluacion de:
* 1. Visibilidad por tipo de pagina (Plan 99.10)
* 2. Reglas de exclusion (Plan 99.11)
*
* El componente se muestra SOLO si:
* - Pasa la verificacion de tipo de pagina
* - NO esta excluido por ninguna regla
*
* PATRON: Facade/Orchestrator - combina dos UseCases
*
* @package ROITheme\Shared\Application\UseCases\EvaluateComponentVisibility
*/
final class EvaluateComponentVisibilityUseCase
{
public function __construct(
private readonly EvaluatePageVisibilityUseCase $pageVisibilityUseCase,
private readonly EvaluateExclusionsUseCase $exclusionsUseCase
) {}
/**
* Evalua si el componente debe mostrarse en la pagina actual
*
* @param string $componentName Nombre del componente (kebab-case)
* @return bool True si debe mostrarse
*/
public function execute(string $componentName): bool
{
// Paso 1: Verificar visibilidad por tipo de pagina
$visibleByPageType = $this->pageVisibilityUseCase->execute($componentName);
if (!$visibleByPageType) {
return false;
}
// Paso 2: Verificar exclusiones
$isExcluded = $this->exclusionsUseCase->execute($componentName);
// Mostrar si NO esta excluido
return !$isExcluded;
}
}

View File

@@ -0,0 +1,44 @@
<?php
declare(strict_types=1);
namespace ROITheme\Shared\Application\UseCases\EvaluateExclusions;
use ROITheme\Shared\Domain\Contracts\ExclusionRepositoryInterface;
use ROITheme\Shared\Domain\Contracts\PageContextProviderInterface;
/**
* Caso de uso: Evaluar si un componente debe excluirse en la pagina actual
*
* Obtiene las reglas de exclusion del repositorio y evalua si aplican
* al contexto actual (post ID, categorias, URL).
*
* DIP: Depende de interfaces, no implementaciones.
*
* @package ROITheme\Shared\Application\UseCases\EvaluateExclusions
*/
final class EvaluateExclusionsUseCase
{
public function __construct(
private readonly ExclusionRepositoryInterface $exclusionRepository,
private readonly PageContextProviderInterface $contextProvider
) {}
/**
* Evalua si el componente debe excluirse
*
* @param string $componentName Nombre del componente (kebab-case)
* @return bool True si debe EXCLUIRSE (NO mostrar)
*/
public function execute(string $componentName): bool
{
$exclusions = $this->exclusionRepository->getExclusions($componentName);
if (!$exclusions->isEnabled()) {
return false;
}
$context = $this->contextProvider->getCurrentContext();
return $exclusions->shouldExclude($context);
}
}