7ba9080f57
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>
253 lines
6.2 KiB
Markdown
253 lines
6.2 KiB
Markdown
# 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+
|