# Yeboyebo_HeadSeo

Módulo Magento que inyecta SEO server-side en el shell HTML de ScandiPWA (y en renderizados Magento estándar). Objetivo: sustituir la dependencia de Prerender.io para SEO, entregando meta tags, hreflangs, JSON-LD, OG y canonical al crawler sin necesidad de JS.

## Componentes

### Plugin principal

- `Plugin\InjectHeadSeo` — hook `afterRenderResult` en `Magento\Framework\View\Result\Page` + `ScandiPWA\Customization\View\Result\Page`. Orquesta los renderers y aplica sus payloads sobre el body de la respuesta.

### Renderers (cada uno con su feature flag)

| Code | Clase | Flag | Función |
|---|---|---|---|
| `title` | `TitleRenderer` | `yeboyebo_headseo/title/enabled` | `<title>` con `brand_prefix` + separator + brand_suffix, dedupe literal case-insensitive |
| `meta_description` | `MetaDescriptionRenderer` | `yeboyebo_headseo/description/enabled` | `<meta name="description">` con fallback product.name |
| `canonical` | `CanonicalRenderer` | `yeboyebo_headseo/canonical/enabled` | `<link rel="canonical">` usando url_rewrite flat para productos |
| `hreflang` | `HreflangRenderer` | `yeboyebo_headseo/hreflang/enabled` | `<link rel="alternate" hreflang="X">` para 9-13 storeviews, con overrides JSON por store |
| `h1` | `H1Renderer` | `yeboyebo_headseo/title/enabled` | `<h1>` server-side sr-only WCAG (default desactivado via `per_page/h1=disabled` si shell ya tiene) |
| `jsonld` | `JsonLdRenderer` | `yeboyebo_headseo/jsonld/enabled` | JSON-LD Organization + WebSite + SearchAction + Product + BreadcrumbList + ItemList + Brand |
| `og` | `OgRenderer` | `yeboyebo_headseo/og/enabled` | `<meta property="og:*">` + Twitter Card tags derivados |
| `noscript` | `NoscriptRenderer` | `yeboyebo_headseo/noscript/enabled` | `<noscript>` con contenido indexable (home + categorías) |

### Observer `ProductCanonicalRedirect`

Evento `controller_action_predispatch`. Si URL visitada ≠ URL canonical del producto → 301 redirect. Resuelve el problema de duplicate-URL por producto (Magento con `product_use_categories=1` genera N URLs accesibles por producto — 1 flat + M con path categoría).

- Kill switch: `yeboyebo_headseo/canonical/force_redirect` (default 0)
- Solo TYPE_PRODUCT, solo GET, preserva query string

## Config principal

Todo en **Stores → Configuration → Yeboyebo → Head SEO**:

### General
- `Master enabled` — kill switch global
- `Dry-run mode` — log-only, no inyección
- `Logging enabled` — escribir a `/var/log/yeboyebo_headseo.log`
- `Blacklist paths` — regex patterns para skip

### Title
- `brand_prefix` — texto antes del title (ej. `El Ganso® `)
- `brand_suffix` — texto después del separator
- `separator` — normalmente ` | `
- `home_h1` — H1 por storeview para la home

### Hreflang
- `x_default_store_code` — store del `x-default`
- `overrides_json` — JSON `{"storecode": {"hreflang": "xx-YY", "exclude": true}}`

### Canonical
- `force_redirect` — 301 a canonical en productos (resuelve duplicate URLs)

### JSON-LD
- Feature flags individuales: `include_product`, `include_breadcrumb`, `include_itemlist`, `include_organization`, `include_website`, `include_reviews`
- Config shipping/returns/GTIN/MPN para Product/Offer rich results

### OpenGraph + Twitter Card
- `site_name`, `fb_app_id`, `fallback_image`
- `twitter_site`, `twitter_creator` — handles para Twitter Card

### Per-page scoping
- Multiselect por renderer + entity type (product/category/cms/home) — permite desactivar un renderer en tipos específicos

## Arquitectura defensiva

- **Try/catch top-level** en `InjectHeadSeo::afterRenderResult` — una bug no puede romper la página
- **Try/catch per-renderer** en `RendererPool::render` — un renderer fallido no bloquea los demás
- **Guard marker** `<!--yeboyebo_headseo_injected-->` — evita doble inyección en la misma respuesta
- **Skip prefixes** hardcoded en `EntityResolver`: `graphql, static, media, rest, adminganso66, customer, checkout`

## Admin UI

Bajo **Stores → Head SEO**:
- **Health Dashboard** — métricas del estado del módulo
- **Preview** — simulador SEO por URL
- **Logs** — viewer del log file

## Cómo rollback instantáneo

```sql
UPDATE core_config_data SET value='0'
WHERE path='yeboyebo_headseo/general/enabled' AND scope='default';
```
Luego `bin/magento cache:flush`. Módulo quedará inerte sin deploy.

## Log entries ejemplos

```
[HeadSeo] INJECT type=product id=130444 store=es path=/camisa-lina-bordados-azul-130444.html head=4193B body=532B replacements=12
[HeadSeo] REDIRECT 301 product=130444 store=es from=/mujer/camisas/producto.html to=/producto-flat.html
[HeadSeo] DRY-RUN type=home id=- store=es path=/ head=1798B body=231B replacements=9
[HeadSeo] renderer jsonld failed for product /producto.html: <error>
```
