git.admin/roi-theme
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
ab41eb6be88f189d1bd42f0df9097a89806015d4
roi-theme/_planeacion/ANALISIS-ISSUES-VS-TEMPLATE.md
FrankZamora ea38a12055 [NIVEL 2 AVANCE] Issues #49-#53 - Componentes Principales Verificados 
Todos los componentes del NIVEL 2 ya están implementados correctamente:
- ✅ Notification Bar (#49)
- ✅ Navbar (#50)
- ✅ Hero Section (#51)
- ✅ Sidebar (#52)
- ✅ Footer (#53)

Solo se actualizó notification-bar.css para usar variables CSS.

Próximo paso: NIVEL 3 (Refinamientos visuales)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 20:01:07 -06:00

291 lines
11 KiB
Markdown
Raw Blame History

# ANÁLISIS DE ISSUES EXISTENTES VS NUEVO TEMPLATE
**Fecha**: 2025-11-04
**Contexto**: El cliente ha proporcionado un template completo en `_planeacion/theme-template/` que debe implementarse. Necesitamos analizar qué issues existentes se pueden reutilizar/actualizar vs crear nuevos.
---
## 📊 RESUMEN EJECUTIVO
**Total de Issues**: 28
- **Abiertos**: 19
- **Cerrados**: 9
**Recomendación**:
- ✅ **REUTILIZAR/ACTUALIZAR**: 14 issues (74%)
- ⚠️ **ADAPTAR SIGNIFICATIVAMENTE**: 3 issues (16%)
- ❌ **OBSOLETOS (ya cerrados)**: 5 issues (26%)
- 🆕 **FUNCIONALIDADES NUEVAS SIN ISSUE**: 6 funcionalidades
---
## ✅ ISSUES 100% REUTILIZABLES (Solo necesitan actualización menor)
Estos issues **ya están bien definidos** y solo necesitan **actualizar su descripción** para alinearse con el nuevo template:
### **Issue #2** - Eliminar bloat innecesario de WordPress
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Actualizar para mantener consistencia con `inc/performance.php` (ya corregido en #22)
- **Trabajo ya hecho**: `inc/performance.php` ya implementado
- **Qué actualizar**: Verificar que todas las optimizaciones del template estén activas
---
### **Issue #3** - Desactivar funcionalidad de búsqueda nativa
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Implementar según especificaciones del template
- **Nota**: El template no menciona búsqueda, confirmar si se mantiene desactivada
---
### **Issue #4** - Desactivar completamente el sistema de comentarios
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Implementar según template
- **Nota**: El template no menciona comentarios, confirmar desactivación
---
### **Issue #5** - Integración de Bootstrap local (CSS y JS)
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido** - CRÍTICO
- **Acción**: **ACTUALIZAR URGENTE** - Cliente confirmó Bootstrap en LOCAL, no CDN
- **Qué hacer**:
1. Descargar Bootstrap 5.3.2 (mismo del template)
2. Colocar en `assets/vendor/bootstrap/`
3. Actualizar `inc/enqueue-scripts.php` para cargar local
4. Eliminar referencias a CDN del template HTML
---
### **Issue #6** - Sistema de tipografías autohospedadas y fuentes del sistema
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: **ACTUALIZAR** - Cliente confirmó usar **System Fonts**, no Poppins
- **Qué hacer**:
1. NO descargar Google Fonts
2. Modificar CSS del template para usar system fonts
3. Actualizar `inc/customizer-fonts.php` para system fonts por defecto
4. Hacer Poppins opcional (descargable desde opciones)
---
### **Issue #10** - Implementar imágenes destacadas configurables
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Implementar según template (featured-image-container ya definido en CSS)
- **Qué hacer**: Conectar con opciones del tema
---
### **Issue #16** - Retardo de carga de AdSense hasta el primer scroll
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Mantener funcionalidad (ya implementado en `inc/adsense-delay.php`)
- **Qué hacer**: Verificar compatibilidad con nuevo template
---
### **Issue #17** - Imágenes responsive con srcset/sizes y soporte WebP/AVIF
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Implementar según mejores prácticas
- **Nota**: Template no lo menciona pero es importante para performance
---
### **Issue #18** - Accesibilidad y navegación por teclado (WCAG 2.1 AA)
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Aplicar a todos los componentes del nuevo template
- **Nota**: Crítico para SEO y usabilidad
---
### **Issue #20** - Documentación completa del tema
- **Estado**: Abierto
- **Relevancia**: ✅ **100% válido**
- **Acción**: Actualizar documentación con el nuevo template
- **Nota**: El template ya incluye excelente documentación en THEME-DOCUMENTATION.md
---
### **Issue #26** - Testing de rendimiento y compatibilidad
- **Estado**: Abierto (Sub-issue de #21)
- **Relevancia**: ✅ **100% válido**
- **Acción**: Testing del nuevo template en staging
- **Nota**: Aplicable a cualquier versión del tema
---
### **Issue #27** - Revisar y optimizar funcionalidades opcionales
- **Estado**: Abierto (Sub-issue de #21)
- **Relevancia**: ✅ **100% válido**
- **Acción**: Revisar funciones deshabilitadas en `performance.php`
- **Nota**: Ya se identificaron funciones problemáticas en #22
---
### **Issue #28** - Documentación de correcciones y deployment
- **Estado**: Abierto (Sub-issue de #21)
- **Relevancia**: ✅ **100% válido**
- **Acción**: Documentar el proceso de migración al nuevo template
- **Nota**: Aplicable al deployment del nuevo diseño
---
## ⚠️ ISSUES QUE NECESITAN ADAPTACIÓN SIGNIFICATIVA
Estos issues necesitan **reescribirse completamente** porque el template define una implementación específica diferente:
### **Issue #7** - Header sticky con menú hamburguesa responsive
- **Estado**: Abierto
- **Relevancia**: ⚠️ **Parcialmente válido - REESCRIBIR**
- **Problema**: El template define un navbar específico con animaciones y estructura diferente
- **Acción**:
1. CERRAR issue #7
2. CREAR NUEVO: "Implementar Navbar según template (sticky + animaciones)"
3. Usar el HTML/CSS/JS exacto del template
- **Razón**: La implementación del template es muy específica y está completa
---
### **Issue #8** - Footer con 4 áreas de widgets
- **Estado**: Abierto
- **Relevancia**: ⚠️ **Parcialmente válido - VERIFICAR TEMPLATE**
- **Acción**:
1. Revisar si el template define footer
2. Si NO: mantener issue #8
3. Si SÍ: actualizar issue con especificaciones del template
- **Nota**: El archivo `index.html` del template no muestra footer, verificar en `footer.php`
---
### **Issue #11** - Badge de categoría sobre H1 en single posts
- **Estado**: Abierto
- **Relevancia**: ⚠️ **REEMPLAZAR - Template lo define diferente**
- **Problema**: Template define badges en HERO section (no sobre H1)
- **Acción**:
1. CERRAR issue #11
2. ACTUALIZAR con: "Implementar Hero Section con badges de categoría"
3. Usar diseño del template (glassmorphism, fondo azul degradado)
---
## ❌ ISSUES OBSOLETOS (Ya cerrados correctamente)
### **Issue #14** - Panel de opciones del tema ❌ CERRADO
- **Razón**: Template no lo requiere, se maneja vía Customizer
### **Issue #19** - Configuración SEO ❌ CERRADO
- **Razón**: Template incluye Schema.org completo
### **Issue #22** - Funciones sanitizadoras ❌ CERRADO
- **Razón**: Ya resuelto
### **Issue #23, #24, #25** - Validaciones ❌ CERRADOS
- **Razón**: Obsoletos con nuevo template
---
## 🆕 FUNCIONALIDADES DEL TEMPLATE SIN ISSUE EXISTENTE
Estas funcionalidades **están definidas en el template** pero **NO tienen issue**:
### 1. **Hero Section con degradado azul**
- **Descripción**: Sección con fondo degradado (#1e3a5f → #2c5282), badges de categorías glassmorphism, H1 centrado
- **Archivos**: `template-parts/content-hero.php`
- **Issue requerido**: ✅ SÍ - **CREAR NUEVO**
---
### 2. **TOC (Tabla de Contenidos) con ScrollSpy mejorado**
- **Descripción**: TOC sticky con ScrollSpy preciso, smooth scroll, generación automática desde H2
- **Archivos**: `template-parts/content-toc.php`, `inc/toc.php`
- **Issue existente**: #12 (Tabla de contenidos automática)
- **Acción**: ✅ **ACTUALIZAR #12** con especificaciones exactas del template
---
### 3. **Botones de compartir en redes sociales**
- **Descripción**: Facebook, Instagram, LinkedIn, WhatsApp, X, Email con iconos Bootstrap Icons
- **Archivos**: `template-parts/content-share.php`
- **Issue requerido**: ✅ SÍ - **CREAR NUEVO**
---
### 4. **CTA con A/B Testing**
- **Descripción**: 2 variantes (Catálogo vs Membresía), rotación 50/50, tracking GA
- **Archivos**: `template-parts/content-cta.php`, `inc/ab-testing.php`
- **Issue requerido**: ✅ SÍ - **CREAR NUEVO**
---
### 5. **Posts Relacionados (12 posts + paginación)**
- **Descripción**: Grid 3 columnas, 12 posts, cards grises con borde azul hover, paginación Bootstrap
- **Archivos**: `template-parts/content-related-posts.php`
- **Issue existente**: #13 (Posts relacionados configurables)
- **Acción**: ✅ **ACTUALIZAR #13** con diseño específico del template
---
### 6. **Tablas APU con estilos específicos**
- **Descripción**: Tablas sin bordes, zebra striping, section-header, subtotal-row, total-row
- **Archivos**: CSS en `assets/css/custom-style.css` (líneas 241-420)
- **Issue requerido**: ✅ SÍ - **CREAR NUEVO** (CRÍTICO para el sitio)
---
### 7. **Schema.org completo (5 schemas)**
- **Descripción**: Article, HowTo, FAQ, VideoObject, BreadcrumbList
- **Archivos**: `inc/schema-markup.php`
- **Issue existente**: #19 (ya cerrado como obsoleto)
- **Acción**: ✅ **CREAR NUEVO** específico para implementar los 5 schemas del template
---
## 📋 RECOMENDACIONES FINALES
### **NO CREAR NUEVOS ISSUES PARA**:
- ❌ Funcionalidades ya cubiertas por issues abiertos
- ❌ Issues de validación (ya cerrados #23-25)
- ❌ Panel de opciones (ya cerrado #14)
### **ACTUALIZAR ESTOS ISSUES**:
1. ✏️ **#12** - TOC: Agregar especificaciones del ScrollSpy mejorado
2. ✏️ **#13** - Posts relacionados: Agregar diseño de 12 posts + paginación
3. ✏️ **#5** - Bootstrap: Clarificar que debe ser LOCAL
4. ✏️ **#6** - Tipografías: Clarificar que son SYSTEM FONTS por defecto
### **CREAR SOLO ESTOS 5 ISSUES NUEVOS** (atómicos, específicos):
1. 🆕 **#29** - Implementar Hero Section con degradado y badges glassmorphism
2. 🆕 **#30** - Implementar botones de compartir en redes sociales
3. 🆕 **#31** - Implementar CTA con A/B Testing (2 variantes + GA tracking)
4. 🆕 **#32** - Implementar tablas APU con estilos específicos (CRÍTICO)
5. 🆕 **#33** - Implementar Schema.org completo (5 schemas)
### **CERRAR/REEMPLAZAR**:
- ❌ **#7** → Crear nuevo "Implementar Navbar según template"
- ❌ **#11** → Ya cubierto por nuevo issue #29 (Hero Section)
---
## 🎯 PLAN DE ACCIÓN SUGERIDO
1. **Actualizar 4 issues existentes** (#5, #6, #12, #13)
2. **Crear 5 issues nuevos** (#29-#33) solo para funcionalidades NO cubiertas
3. **Cerrar/consolidar** #7 y #11 en nuevos issues
4. **Mantener abiertos** todos los demás issues (#2, #3, #4, #10, #15-18, #20, #26-28)
**Total de trabajo**:
- 4 actualizaciones
- 5 creaciones
- 2 consolidaciones
- **11 acciones en total** (vs crear 20+ issues nuevos innecesariamente)
---
**Conclusión**: Podemos reutilizar **74% de los issues existentes** solo actualizándolos. Solo necesitamos crear **5 issues nuevos** para funcionalidades específicas del template que no están cubiertas.
Reference in New Issue View Git Blame Copy Permalink