Files
roi-theme/Shared/Domain/Contracts/WrapperVisibilityCheckerInterface.php
FrankZamora 36d5cf56de fix(wrappers): eliminar wrappers vacíos y corregir exclusiones AdSense (Plan 99.15)
## Problema
- Componentes deshabilitados/excluidos dejaban wrappers HTML vacíos
  (navbar 32px, sidebar col-lg-3 294px)
- AdSense ignoraba exclusiones por URL pattern en grupo _exclusions

## Solución Plan 99.15 (Clean Architecture)

### Domain Layer
- WrapperVisibilityCheckerInterface: contrato para verificar visibilidad

### Application Layer
- CheckWrapperVisibilityUseCase: orquesta verificaciones de visibilidad

### Infrastructure Layer
- WordPressComponentVisibilityRepository: consulta BD + PageVisibilityHelper
- WrapperVisibilityService: facade estático para templates
- BodyClassHooksRegistrar: agrega clases CSS failsafe al body

### Templates modificados
- header.php: renderizado condicional de <nav> wrapper
- page.php/single.php: lógica dinámica col-lg-9/col-lg-12 según sidebar

### CSS Failsafe
- css-global-utilities.css: reglas body.roi-hide-* como respaldo

## Fix AdSense (Inc/adsense-placement.php)
- Agregado PageVisibilityHelper::shouldShow() a todas las funciones:
  roi_render_ad_slot, roi_render_rail_ads, roi_enqueue_adsense_script,
  roi_inject_content_ads, roi_render_anchor_ads, roi_render_vignette_ad,
  roi_enqueue_anchor_vignette_scripts

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-12-04 11:46:21 -06:00

51 lines
1.7 KiB
PHP

<?php
declare(strict_types=1);
namespace ROITheme\Shared\Domain\Contracts;
/**
* Interface para verificar visibilidad de wrappers de componentes
*
* Responsabilidad: Definir contrato para determinar si un wrapper
* de componente debe renderizarse basándose en:
* - Estado habilitado/deshabilitado
* - Visibilidad por dispositivo
* - Reglas de exclusión (categoría, post ID, URL pattern, page visibility)
*
* @package ROITheme\Shared\Domain\Contracts
* @see Plan 99.15 - Fix Empty Layout Wrappers
*/
interface WrapperVisibilityCheckerInterface
{
/**
* Verifica si el componente está habilitado globalmente
*
* @param string $componentName Nombre del componente (kebab-case)
* @return bool True si is_enabled = true en BD
*/
public function isEnabled(string $componentName): bool;
/**
* Verifica si el componente es visible en el dispositivo actual
*
* @param string $componentName Nombre del componente (kebab-case)
* @param bool $isMobile True si es dispositivo móvil
* @return bool True si show_on_mobile/show_on_desktop según corresponda
*/
public function isVisibleOnDevice(string $componentName, bool $isMobile): bool;
/**
* Verifica si el componente NO está excluido para la página actual
*
* Evalúa todas las reglas de exclusión:
* - Exclusión por categoría
* - Exclusión por post ID
* - Exclusión por URL pattern
* - Page visibility (home, posts, pages, archives, search)
*
* @param string $componentName Nombre del componente (kebab-case)
* @return bool True si el componente NO está excluido
*/
public function isNotExcluded(string $componentName): bool;
}