cnt-sindikatua/CONTEXT.md

Contexto del Proyecto: CNT Sindikatua

¿Qué es?

Tema de WordPress para el sitio web del sindicato CNT (Confederación Nacional del Trabajo) del País Vasco. Basado en el Timber Starter Theme con Twig como motor de plantillas.

Stack Tecnológico

Componente	Tecnología
CMS	WordPress
Tema base	Timber Starter Theme (v2)
Motor de plantillas	Twig (PHP)
Frontend	Bootstrap 5.3, Bootstrap Icons
Fuente	Yaro (custom)
PHP	Composer, PSR-4 autoloading
Post Types	post (noticias, campaña, conflictos laborales), opinion, videos, documento
Plugins clave	Polylang (multilenguaje ES/EU), ACF (Advanced Custom Fields), Contact Form 7, Routes

Idiomas

Soporte bilingüe: Español (/es) y Euskera (/eu) mediante Polylang.

Estructura del tema

cnt-sindikatua/
├── assets/              # CSS, JS, fuentes, imágenes
│   ├── fonts/yaro-font-family/
│   ├── scripts/site.js
│   └── styles/
├── src/                 # Clases PHP (autoload PSR-4)
│   ├── StarterSite.php  -> Clase principal del tema
│   ├── Comments.php     -> Desactiva comentarios globalmente
│   └── SMTP.php         -> Configuración de correo SMTP
├── views/               # Plantillas Twig
│   ├── layouts/base.twig        -> Layout base (HTML, header, footer)
│   ├── partials/                -> Componentes reutilizables
│   └── templates/               -> Plantillas por página/taxonomía
├── functions.php        -> Punto de entrada, inicializa todo
├── style.css            -> Estilos + metadatos del tema
└── template-portada.php -> Template especial para portada

Funcionalidades principales

1. Portada dinámica

template-portada.php con contexto que incluye:

• Últimas noticias (getLastsPostsNews)
• Último artículo de opinión (getLastPostOpinion)
• Último post de campaña (getLastPostCampana)
• Último post de conflictos laborales (getLastPostConflicts)
• Botones de enlaces con imagen (getBotonesEnlaces)
• Slider de videos (getVideosSlider)

2. Archivos personalizados con rutas (Routes)

Rutas definidas en functions.php con upstatement/routes:

Ruta ES	Ruta EU	Archivo PHP
/es/noticias	/eu/berriak	archive-noticias.php
/es/noticias/conflictos-laborales	/eu/berriak/lan-gatazkak	archive-conflictos-laborales.php
/es/documentos	/eu/dokumentuak	archive-documentos.php

Todas con soporte de paginación (/page/:paged).

3. Páginas especiales

Cada una con su template Twig correspondiente:

• Acerca de CNT / CNT-ri buruz
• Afiliación / Afiliazioa
• Contactos / Kontaktua (con formulario CF7)
• Servicios / Zerbitzuak
• Industria
• Enlaces / Loturak
• Noticias / Berriak
• Opinión / Iritzia
• Videos / Bideoak
• Documentos / Dokumentuak
• Aviso Legal, Política de Privacidad, Política de Cookies

4. Videos

• Custom post type videos
• Reproductor modal con iframe (YouTube/Vimeo)
• Slider en portada
• Embed generado automáticamente con generar_embed_universal()
• Script en site.js maneja apertura/cierre del modal (autoplay al abrir, stop al cerrar)

5. Opinión

• Custom post type opinion
• Archive propio con paginación
• Sección destacada en portada

6. SMTP

• Clase SMTP.php que configura phpmailer_init
• Configuración desde opciones de ACF (host, puerto, seguridad, credenciales, remitente)
• Almacenado como opciones de WordPress (options_smtp_*)

7. Comentarios

• Totalmente desactivados en todo el sitio mediante Comments.php
• Oculta menú de comentarios en admin, redirige acceso directo, elimina soporte en post types

8. Redes sociales

• Configurables desde ACF (opciones del tema)
• Hasta 4 iconos con imagen y URL
• Estilo SVG blanco en footer con efecto hover

9. Búsqueda

• Excluye páginas marcadas con ACF exclude_from_search
• Filtro en pre_get_posts

10. Header y Footer

• Header: Top bar (idiomas), logos configurables (ACF), menú principal con dropdown, menú hamburguesa (offcanvas)
• Footer: Logos, textos configurables, últimas noticias, último artículo de opinión, redes sociales, enlaces, listado de sedes

11. Paginación

• Estilos personalizados con las clases CSS del tema
• Varios partials: pagination.twig, pagination-custom.twig, pagination-custom-pages.twig

Identidad visual

• Color principal: Rojo CNT (--rojo-cnt: #dc2d30)
• Colores secundarios: --rojo-cnt-dark: #9d1b1d, --rojo-cnt-light: #d6453f
• Tipografía titular: Yaro (YaroSt-Black) para headings y títulos especiales
• Soporte SVG en subidas de medios mediante filtro upload_mimes

Scripts JS

• site.js: Maneja el modal de videos (autoplay al abrir, stop al cerrar)
• Bootstrap JS: Menús, offcanvas, modals
• Dependencias cargadas desde vendor/ via Composer

Migración

• Proyecto migrado desde Joomla a WordPress
• MIGRATION.md contiene instrucciones para limpieza de BBDD (tablas con prefijos legacy: d8yd3_, bak_, gdkw3_, qwe9g_)
• Categorías limpiadas durante migración: Blog, News, Review, tutorial, updates, Joomla!, Uncategorised, Helbideak, Service
• Categorías mantenidas: Berriak/noticias, Albisteak/noticias, Lan gatazkak/conflictos laborales, Industria, Acerca de CNT

Notas de desarrollo

• Versión de assets cacheada con time() para evitar caché del navegador en desarrollo
• Antiguo intento de reescritura de reglas para search pagination comentado en StarterSite.php
• Función pll_current_language() para integración ACF + Polylang
• Hook en CF7 para añadir título de página como campo oculto en formularios