# 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+