Agregar estructura completa del tema APUS con Bootstrap 5 y optimizaciones de rendimiento

Se implementa tema WordPress personalizado para Análisis de Precios Unitarios con funcionalidades avanzadas:
- Sistema de templates (front-page, single, archive, page, 404, search)
- Integración de Bootstrap 5.3.8 con estructura modular de assets
- Panel de opciones del tema con Customizer API
- Optimizaciones de rendimiento (Critical CSS, Image Optimization, Performance)
- Funcionalidades SEO y compatibilidad con Rank Math
- Sistema de posts relacionados y tabla de contenidos
- Badge de categorías y manejo de AdSense diferido
- Tipografías Google Fonts configurables
- Documentación completa del tema y guías de uso

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

Co-Authored-By: Claude <noreply@anthropic.com>

wp-content/themes/apus-theme/TEMPLATES.md

@@ -0,0 +1,252 @@
+# Apus Theme - Documentación de Templates
+
+## Templates Principales Creados
+
+### 1. single.php
+**Propósito:** Template para posts individuales de blog
+
+**Características:**
+- Imagen destacada con lazy loading
+- Badge de categoría con estilos personalizados
+- Título H1 semántico
+- Meta información (fecha de publicación, fecha de actualización, autor)
+- Tiempo estimado de lectura
+- Contenido completo del post
+- Etiquetas (tags)
+- Enlaces de edición para usuarios con permisos
+- Navegación anterior/siguiente
+- Soporte para comentarios
+- Hooks para TOC (`apus_before_post_content`)
+- Hooks para posts relacionados (`apus_after_post_content`)
+
+**Ubicación:** `/wp-content/themes/apus-theme/single.php`
+
+---
+
+### 2. page.php
+**Propósito:** Template para páginas estáticas
+
+**Características:**
+- Imagen destacada (hero image)
+- Título H1
+- Contenido completo
+- Soporte para páginas paginadas (<!--nextpage-->)
+- Enlaces de edición para usuarios con permisos
+- Soporte para comentarios
+- Layout limpio y enfocado en contenido
+
+**Ubicación:** `/wp-content/themes/apus-theme/page.php`
+
+---
+
+### 3. archive.php
+**Propósito:** Template para archivos (categorías, etiquetas, fechas, autor)
+
+**Características:**
+- Título dinámico según el tipo de archivo
+- Descripción del archivo (si existe)
+- Loop de posts con thumbnails
+- Vista de rejilla con imagen y extracto
+- Badge de categoría en cada post
+- Meta información (fecha, autor)
+- Enlaces "Leer más"
+- Paginación completa
+- Responsive design
+
+**Ubicación:** `/wp-content/themes/apus-theme/archive.php`
+
+---
+
+### 4. 404.php
+**Propósito:** Página de error 404 cuando no se encuentra contenido
+
+**Características:**
+- Mensaje de error claro y amigable
+- Lista de sugerencias para el usuario
+- Posts recientes (últimos 5)
+- Categorías principales (top 5 por cantidad)
+- Enlace a página principal
+- Diseño centrado y accesible
+
+**Ubicación:** `/wp-content/themes/apus-theme/404.php`
+
+---
+
+### 5. search.php
+**Propósito:** Template que SIEMPRE retorna 404 (búsqueda desactivada)
+
+**Características:**
+- Fuerza status HTTP 404
+- Desactiva caché
+- Mensaje claro de que la búsqueda está deshabilitada
+- Lista de categorías para navegación alternativa
+- Posts recientes
+- Sin funcionalidad de búsqueda activa
+
+**Nota:** La búsqueda está desactivada a nivel de tema mediante:
+- `template-functions.php` con hooks que redireccionan búsquedas a 404
+- Widget de búsqueda desregistrado
+
+**Ubicación:** `/wp-content/themes/apus-theme/search.php`
+
+---
+
+### 6. front-page.php
+**Propósito:** Template para la portada estática del sitio
+
+**Características:**
+- Hero section con imagen destacada de ancho completo
+- Título H1
+- Contenido completo de la página
+- Soporte para páginas paginadas
+- Hook `apus_front_page_content` para contenido adicional
+- Diseño especial para página principal
+- Compatible con página estática en Settings > Reading
+
+**Ubicación:** `/wp-content/themes/apus-theme/front-page.php`
+
+---
+
+## Jerarquía de Templates WordPress
+
+WordPress usa los templates en el siguiente orden de prioridad:
+
+```
+Portada:
+1. front-page.php
+2. home.php
+3. index.php
+
+Posts individuales:
+1. single-{post-type}.php
+2. single.php
+3. singular.php
+4. index.php
+
+Páginas:
+1. page-{slug}.php
+2. page-{id}.php
+3. page.php
+4. singular.php
+5. index.php
+
+Archivos:
+1. archive-{post-type}.php
+2. archive.php
+3. index.php
+
+Categorías:
+1. category-{slug}.php
+2. category-{id}.php
+3. category.php
+4. archive.php
+5. index.php
+
+Etiquetas:
+1. tag-{slug}.php
+2. tag-{id}.php
+3. tag.php
+4. archive.php
+5. index.php
+
+Búsqueda:
+1. search.php
+2. index.php
+
+404:
+1. 404.php
+2. index.php
+```
+
+## Archivos de Soporte Creados
+
+### inc/template-tags.php
+Funciones reutilizables para templates:
+- `apus_post_meta()` - Meta información de posts
+- `apus_post_categories()` - Categorías del post
+- `apus_pagination()` - Paginación personalizada
+- `apus_breadcrumbs()` - Migas de pan
+- `apus_archive_title()` - Título de archivo
+- `apus_archive_description()` - Descripción de archivo
+
+### inc/template-functions.php
+Funciones auxiliares y filtros:
+- `apus_body_classes()` - Clases personalizadas del body
+- `apus_post_classes()` - Clases personalizadas de posts
+- `apus_get_excerpt()` - Extracto por caracteres
+- `apus_disable_search()` - Desactiva búsqueda
+- `apus_redirect_search_to_404()` - Redirige búsquedas a 404
+- `apus_remove_search_widget()` - Elimina widget de búsqueda
+
+## Estilos CSS Agregados
+
+Se han agregado estilos específicos en `style.css` para:
+- Layout de contenido (content-wrapper)
+- Posts individuales (single)
+- Archivos (archive)
+- Paginación
+- Navegación de posts
+- Página 404
+- Front page
+- Thumbnails y media
+- Responsive design
+
+## HTML5 Semántico y Accesibilidad
+
+Todos los templates incluyen:
+- Elementos semánticos (`<article>`, `<nav>`, `<aside>`, `<header>`, `<footer>`)
+- Atributos ARIA apropiados
+- Roles WAIARIA
+- Texto para lectores de pantalla
+- Enlaces de salto al contenido
+- Tamaños mínimos de toque (44px)
+- Contraste de colores adecuado
+- Estructura de encabezados correcta
+
+## WordPress Coding Standards
+
+Todos los archivos cumplen con:
+- WordPress PHP Coding Standards
+- Escapado de salida apropiado
+- Sanitización de entradas
+- Traducciones i18n/l10n
+- Documentación PHPDoc
+- Nombres de funciones con prefijo `apus_`
+
+## Hooks Disponibles
+
+### Actions
+- `apus_before_post_content` - Antes del contenido del post (ideal para TOC)
+- `apus_after_post_content` - Después del contenido del post (ideal para posts relacionados)
+- `apus_front_page_content` - Contenido adicional en front page
+
+### Filters
+- `body_class` - Clases del body
+- `post_class` - Clases de posts
+- `apus_content_width` - Ancho del contenido
+
+## Personalización
+
+Para personalizar los templates, puedes:
+
+1. **Crear un Child Theme** (recomendado)
+2. **Usar Hooks** para agregar funcionalidad
+3. **Sobrescribir templates** copiándolos al child theme
+4. **Agregar template parts** en `/template-parts/`
+
+## Performance
+
+Todos los templates están optimizados para:
+- Minimal DOM
+- Lazy loading de imágenes
+- Sin JavaScript innecesario
+- CSS crítico inline (future)
+- Cache-friendly markup
+- Core Web Vitals
+
+---
+
+**Versión del tema:** 1.0.0  
+**Última actualización:** 2025-11-03  
+**WordPress requerido:** 6.0+  
+**PHP requerido:** 8.0+