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

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 ()
• 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+