PROBLEMA:
Submenu "Buscador General de Precios Unitarios" tiene 18 elementos
y se oculta fuera de la pantalla, haciendo inaccesibles los últimos.
CAMBIOS:
1. Reducir padding vertical de .dropdown-item (0.625rem → 0.5rem)
- Ahorra ~64px total con 18 elementos
- Elementos más compactos visualmente
2. Agregar max-height: 70vh a .dropdown-menu
- Permite ver ~10-12 elementos simultáneamente
- Todos los 18 elementos accesibles mediante scroll
3. Activar overflow-y: auto
- Scroll vertical aparece automáticamente si necesario
- Solo cuando contenido excede 70vh
4. Mejorar UX del scroll
- scroll-behavior: smooth (scroll suave)
- Scrollbar personalizado (6px, color gris)
- scrollbar-width: thin (Firefox)
- Custom webkit scrollbar (Chrome, Safari, Edge)
RESULTADO:
✅ Todos los 18 elementos del submenu son accesibles
✅ Scroll vertical suave y con estilo personalizado
✅ Elementos más compactos pero legibles
✅ Funciona en todos los navegadores modernos
Fixes#103🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
RAZÓN:
La función apus_remove_query_strings_from_static_resources()
es una práctica obsoleta de hace 10+ años que causaba más
problemas que beneficios.
PROBLEMAS QUE CAUSABA:
- Impedía cache busting de WordPress (filemtime(), versiones)
- Usuarios quedaban con CSS/JS desactualizado después de updates
- Causó que el botón Let's Talk se viera azul en lugar de naranja
POR QUÉ ES OBSOLETA:
- CDNs modernos (Cloudflare, AWS, Fastly) cachean con query strings
- WordPress depende de query strings para versionado correcto
- Google PageSpeed ya no lo recomienda desde hace años
- HTTP/2 hace irrelevante esta "optimización"
RESULTADO:
Ahora WordPress puede usar query strings correctamente para
asegurar que usuarios descarguen versiones actualizadas de CSS/JS.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
PROBLEMA RAÍZ ENCONTRADO:
La función apus_remove_query_strings_from_static_resources()
estaba eliminando TODOS los query strings (?ver=X.X.X) de los CSS,
incluyendo el style.css principal.
Esto impedía que los navegadores descargaran nuevas versiones del CSS
cuando se hacían cambios, causando que el botón Let's Talk siguiera
mostrándose azul en lugar de naranja.
SOLUCIÓN:
Modificar la función para que NO elimine el query string del
/assets/css/style.css, permitiendo cache busting cuando se actualiza.
Los demás archivos CSS siguen sin query string para mejor cache.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Servidor confirmado sirviendo CSS correcto con !important.
Perfmatters MU plugin desactivado.
Todos los caches limpiados.
CSS descargado directamente del servidor tiene !important correcto.
El problema es browser cache del usuario final.
Incrementando versión a 1.0.3 para forzar descarga.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Caches limpiados:
- W3 Total Cache (page cache + minify)
- Perfmatters cache
- PHP OPcache
- Browser cache (via version bump)
Esto forzará descarga del CSS con !important para botón naranja.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Se cambió el version number del enqueue de style.css de filemtime()
dinámico a '1.0.1' hardcoded para bypass-ear todos los caches
(Memcached, OPcache, browser) que están sirviendo CSS sin !important.
Esto fuerza a todos los navegadores a descargar el CSS actualizado
que tiene el !important necesario para el botón naranja.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
PROBLEMA:
Código comentado es BASURA. No debe permanecer en archivos de producción.
Para eso existe Git - historial completo disponible si se necesita.
ARCHIVOS LIMPIADOS:
1. buttons.css:
- ANTES: 54 líneas (header + código comentado)
- AHORA: 9 líneas (solo header indicando deshabilitación)
- ELIMINADO: ~45 líneas de CSS comentado
2. custom-style.css:
- ELIMINADO: ~84 líneas de navbar comentado (líneas 86-166)
- ELIMINADO: ~23 líneas de botón comentado (líneas 168-190)
- REEMPLAZADO: con 1 línea de nota breve
- ANTES: 107 líneas de código basura comentado
- AHORA: 1 línea de referencia
3. enqueue-scripts.php:
- ELIMINADO: ~13 líneas de enqueue buttons.css comentado
- ELIMINADO: ~33 líneas de enqueue notification-bar comentado
- AHORA: Código limpio sin basura
TOTAL ELIMINADO: ~152 líneas de código comentado basura
PRINCIPIO:
- Código comentado = basura
- Git guarda historial completo
- Si se necesita algo, está en el commit anterior
- Archivos de producción deben estar limpios
REFERENCIAS:
- CSS correcto está en: assets/css/style.css
- Historial en Git si se necesita código anterior
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
PROBLEMA IDENTIFICADO:
- En commit anterior (41b12) solo comenté el ENQUEUE de buttons.css
- El archivo buttons.css TODAVÍA contenía CSS ACTIVO (sin comentar)
- Este CSS con gradiente incorrecto podía seguir aplicándose por:
* Cache de WordPress/navegador
* Referencias directas al archivo
* Plugins que cargan todos los CSS de la carpeta
SÍNTOMAS:
- Botón Let's Talk mostraba gradiente en lugar de color sólido
- No coincidía con template fuente apus-theme-template/css/style.css
ANÁLISIS CSS:
buttons.css tenía (INCORRECTO):
- background: linear-gradient(135deg, #FF6B35 0%, #FF8C42 100%)
- transform: translateY(-2px) en hover
- box-shadow no presente en template
- Media query responsive no documentada
Template fuente tiene (CORRECTO):
- background-color: var(--color-orange-primary) - Color SÓLIDO
- Sin transform
- Sin box-shadow extra
- Sin media queries
SOLUCIÓN:
- Comentado TODO el contenido CSS de buttons.css
- Archivo ahora solo contiene comentarios
- CSS correcto permanece en assets/css/style.css (líneas 766-785)
- Eliminada cualquier posibilidad de conflicto
ARCHIVOS MODIFICADOS:
- wp-content/themes/apus-theme/assets/css/buttons.css
* TODO el CSS convertido a comentarios
* Agregado header explicando el problema
* Referencia a ubicación correcta del CSS
VERIFICACIÓN:
✅ style.css tiene CSS correcto (idéntico a template fuente)
✅ custom-style.css tiene CSS comentado (sin conflicto)
✅ enqueue-scripts.php tiene enqueue comentado (sin carga)
✅ buttons.css ahora completamente deshabilitado (sin CSS activo)
REFERENCIAS:
- Template CSS: apus-theme-template/css/style.css líneas 163-180
- Issue: #101🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
PROBLEMAS CORREGIDOS:
1. CSS duplicado en custom-style.css y buttons.css
2. buttons.css tenía implementación INCORRECTA:
- Usaba gradiente en lugar de color sólido
- Agregaba efectos de transform/shadow no presentes en template
- Tenía media queries responsive no documentadas
3. CSS no estaba en ubicación documentada (style.css)
ANÁLISIS DE IMPLEMENTACIONES:
buttons.css (INCORRECTO - deshabilitado):
- ❌ background: linear-gradient() - Template usa color sólido
- ❌ transform: translateY(-2px) en hover - NO en template
- ❌ box-shadow con valores no documentados
- ❌ Estado :active no presente en template
- ❌ Media query responsive no en template
custom-style.css (CORRECTO pero ubicación incorrecta):
- ✅ background-color: var(--color-orange-primary) - Sólido
- ✅ Hover a var(--color-orange-hover)
- ✅ Sin transform ni shadow extra
- ✅ IDÉNTICO al template fuente
SOLUCIÓN IMPLEMENTADA:
1. style.css:
- Agregado CSS correcto al final (líneas 766-785)
- Comentario separador: /* === BOTÓN LET'S TALK === */
- CSS idéntico a template fuente
2. custom-style.css:
- Comentado CSS duplicado (líneas 168-190)
- Agregado nota de nueva ubicación
3. enqueue-scripts.php:
- Comentado enqueue de buttons.css (líneas 101-113)
- Agregado nota explicando por qué se deshabilitó
IMPLEMENTACIÓN COMPLETA:
✅ HTML: header.php (líneas 80-83) - SUPERIOR a template (i18n)
✅ CSS: assets/css/style.css (líneas 766-785) - IDÉNTICO a template
❌ buttons.css: DESHABILITADO (implementación incorrecta)
REFERENCIAS:
- Template HTML: apus-theme-template/index.html líneas 132-134
- Template CSS: apus-theme-template/css/style.css líneas 163-180
- Documentación: theme-documentation/07-componente-boton-lets-talk/
ISSUE: #101🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
PROBLEMA:
- Implementación previa NO coincidía con template fuente apus-theme-template/index.html
- HTML tenía estructura compleja con spans responsive e i18n
- CSS cargaba archivo separado notification-bar.css (253 líneas) con animaciones innecesarias
- Faltaban variables de color APU en style.css
SOLUCIÓN:
1. header.php (líneas 23-32):
- Reemplazado HTML complejo con estructura simple del template
- Eliminado texto responsive innecesario
- Cambiado de múltiples <span> a un solo <span><strong>Nuevo:</strong> texto</span>
- Agregado clases text-white y text-decoration-underline al enlace
2. assets/css/style.css:
- Agregadas variables de color APU (líneas 49-55):
--color-navy-dark, --color-navy-primary, --color-orange-primary, etc.
- Agregado CSS de Top Notification Bar (líneas 658-685)
- Solo 28 líneas de CSS limpio sin animaciones ni JavaScript
3. inc/enqueue-scripts.php:
- Comentada función apus_enqueue_notification_bar_assets()
- CSS ahora en style.css principal, no en archivo separado
- Componente no requiere JavaScript
FUENTE DE VERDAD:
- apus-theme-template/index.html (líneas 55-63)
- apus-theme-template/css/style.css (líneas 57-80)
ISSUE: #97🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Cambios realizados:
- NUEVO: Crear assets/css/style.css con CSS base del tema (650 líneas)
- MODIFICADO: style.css - Dejar solo header obligatorio de WordPress (~25 líneas)
- MODIFICADO: enqueue-scripts.php - Agregar carga de assets/css/style.css
Detalles:
- Mover todo el CSS de style.css (variables, reset, typography, layouts)
a assets/css/style.css para cumplir con arquitectura modular
- style.css ahora contiene SOLO el comentario header de WordPress
- Agregar función apus_enqueue_main_stylesheet() con filemtime()
para cache busting
- Orden de carga: Bootstrap → Variables → style.css → componentes
Validación FASE 1 completada:
✅ style.css con header WordPress
✅ functions.php completo
✅ index.php con The Loop
✅ assets/css/style.css creado
✅ assets/js/main.js existe
✅ Arquitectura modular respetada
Referencia: _planeacion/_desarrollo-tema-apus/theme-documentation/03-fase-1-cimiento/
Closes#95🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Eliminados 14 archivos .md basura del repositorio
- Configurado .claude/settings.local.json con instrucciones claras:
* NUNCA crear archivos .md para issues/reportes
* Documentación solo en GitHub issues/comments
* No usar --body-file, solo --body inline
- Limpieza completa del repo
Los archivos .md eran basura temporal que no deben estar en el código.
Toda la documentación ya está en GitHub issues.
- Eliminado inc/schema-org.php completamente
- Eliminada referencia en functions.php
- Rank Math maneja 100% de los schemas
- El tema NO debe tocar nada de schemas
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Carpeta _planeacion/ excluida del repositorio
- Contiene documentación de planeación y archivos de referencia
- No necesario en repositorio de producción
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
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>
Implementación de CIMIENTOS del tema según template index.html.
Sin estos cambios NO se puede avanzar a componentes visuales.
**Issue #47: Estructura HTML Base**
- single.php: Reemplazada estructura con Grid Bootstrap exacto del template
- Agregado: <div class="container"> → <div class="row">
- Columna principal: <div class="col-lg-9"> (línea 28)
- Columna sidebar: <div class="col-lg-3"> (línea 244)
- Eliminado: <div class="content-wrapper"> (obsoleto)
- Estructura ahora coincide 100% con template líneas 347-350
**Issue #48: Sistema de Variables CSS**
- Creado: assets/css/variables.css (180 líneas)
- 50+ variables CSS de colores paleta RDash
- Variables tipográficas (fonts, sizes, weights)
- Variables de espaciado y bordes
- Variables de sombras y transiciones
- Variables de gradientes del template
- Registrado en enqueue-scripts.php (línea 51-58)
- Dependencia: se carga DESPUÉS de Bootstrap
**Archivos Modificados:**
- wp-content/themes/apus-theme/single.php
- wp-content/themes/apus-theme/inc/enqueue-scripts.php
**Archivos Creados:**
- wp-content/themes/apus-theme/assets/css/variables.css
**Referencia Template:**
D:\_Desarrollo\02AnalisisDePreciosUnitarios\analisisdepreciosunitarios.com\_planeacion\theme-template\index.html
**Resultado:**
NIVEL 1 (CIMIENTOS) está completo. Ahora se puede avanzar a NIVEL 2 (Componentes Principales).
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Implementación completa de navbar sticky con menú hamburguesa responsive según especificaciones del template del cliente:
**Archivos Modificados:**
- header.php: Reescritura completa con navbar Bootstrap 5, sticky positioning, y responsive hamburger menu
- functions.php: Agregado require para nav-walker.php
- inc/enqueue-scripts.php: Agregado enqueue de custom-style.css y main.js
**Archivos Creados:**
- assets/css/custom-style.css: Estilos navbar con animaciones (gradient underline, dropdown slideDown, etc.)
- assets/js/main.js: JavaScript para scroll effect, active menu highlight, y mobile auto-close
- inc/nav-walker.php: Bootstrap 5 Nav Walker para dropdowns WordPress
**Características:**
✅ Navbar sticky con transición de sombra al hacer scroll
✅ Gradient underline animation en hover de nav-links
✅ Dropdown menus con animación slideDown
✅ Menú hamburguesa responsive (< 991px)
✅ Auto-close mobile menu al hacer click en enlaces
✅ Active menu item highlighting
✅ Smooth scroll para anchor links
✅ Skip link para accesibilidad
✅ Compatible con WordPress menu system
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Cambios realizados:
- Actualizado assets/css/fonts.css con stack de system fonts del template
- System fonts por defecto (máximo rendimiento, 0 KB descargados)
- Poppins opcional (comentado, para activar desde Customizer)
- Variables CSS actualizadas (--font-system, --font-primary, --font-headings)
- Utilidades de fuentes (font-weight, font-size, line-height)
- Responsive font sizes para móvil, tablet y desktop
- Font smoothing para mejor renderizado
Stack de system fonts:
-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto,
Oxygen-Sans, Ubuntu, Cantarell, 'Helvetica Neue', sans-serif
Beneficios:
✅ 0 HTTP requests
✅ 0 KB descargados
✅ Mejor LCP y Core Web Vitals
✅ Sin FOIT/FOUT
Customizer ya configurado en inc/customizer-fonts.php para activar
Poppins opcional si el usuario lo requiere.
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
- Eliminar archivos .md que faltaban en el commit anterior
- Actualizar referencias en single.php e index.php
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Cambios realizados:
- Eliminados 14 archivos de documentación .md innecesarios (root + docs/)
- Instalado Bootstrap 5.3.2 local en assets/vendor/bootstrap/
- Actualizado inc/enqueue-scripts.php con rutas correctas a Bootstrap
- Limpieza de estructura para mantener estándar de WordPress
- Sin jQuery (Bootstrap 5 no lo requiere)
Archivos eliminados:
- CHANGELOG.md, CREDITS.md, README.md, etc. (11 archivos)
- docs/01-initial-setup.md, docs/02-theme-options.md, docs/03-performance-seo.md
Bootstrap 5.3.2:
- CSS: assets/vendor/bootstrap/css/bootstrap.min.css
- JS: assets/vendor/bootstrap/js/bootstrap.bundle.min.js
- Versión exacta del template del cliente
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Resuelve issue #21 (parte 3) - Agotamiento de memoria (14GB)
PROBLEMA:
- PHP Fatal error: Allowed memory size of 14680064000 bytes exhausted
- El tema intentaba usar 14 GB de memoria antes de fallar
- Timeout de 15+ segundos antes del crash
- Error en wp-includes/option.php línea 615
CAUSA RAÍZ:
La combinación de apus_add_dns_prefetch() y apus_remove_dns_prefetch()
creaba un loop infinito:
1. apus_add_dns_prefetch() agrega hints en wp_head con prioridad 0
2. apus_remove_dns_prefetch() filtra wp_resource_hints
3. Esto causa que WordPress recalcule hints infinitamente
4. Cada recalculo consume memoria hasta agotar 14GB
SOLUCIÓN:
Deshabilitar temporalmente apus_add_dns_prefetch() comentando el
add_action en línea 448. Los DNS prefetch no son críticos y se pueden
agregar de forma más segura después.
ARCHIVOS MODIFICADOS:
- inc/performance.php (línea 447-448)
VERIFICACIÓN:
✅ Sitio funciona con HTTP 200
✅ Sin agotamiento de memoria
✅ Sin timeouts
✅ Performance.php funcional
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
Resuelve issue #21 (parte 2) - HTTP 500 / Timeout
PROBLEMA:
- La función apus_remove_dns_prefetch() causaba un loop infinito
- Usaba wp_dependencies_unique_hosts() de manera incorrecta
- Causaba timeout de 36 segundos y HTTP 500 en staging
- El tema no podía activarse sin causar error
CAUSA RAÍZ:
La función llamaba a wp_dependencies_unique_hosts() dentro del filtro
'wp_resource_hints', lo cual podía disparar más dependencias que volvían
a llamar el mismo filtro, creando un loop infinito.
Código problemático (línea 309):
return array_diff( wp_dependencies_unique_hosts(), $hints );
SOLUCIÓN:
Reescribir la función para filtrar hints directamente sin llamar a
wp_dependencies_unique_hosts(), usando un loop simple para eliminar
solo las referencias a s.w.org.
ARCHIVOS MODIFICADOS:
- inc/performance.php (líneas 307-321)
VERIFICACIÓN EN STAGING:
✅ Sitio funciona con tema APUS activado
✅ No hay timeouts
✅ HTTP 200 en lugar de HTTP 500
✅ Performance.php funciona correctamente
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
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>
- Documentación técnica completa de tareas realizadas
- Verificaciones detalladas de cada requisito
- Estructura de archivos creados
- Beneficios implementados
- Matriz de compatibilidad
- Próximos pasos recomendados
- Testing checklist
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- Verificado: add_theme_support('title-tag') está activo en functions.php (línea 30)
- Verificado: header.php está limpio sin meta tags duplicados (solo charset, viewport, X-UA-Compatible)
- Creado: inc/seo.php con optimizaciones SEO no conflictivas con Rank Math
- Función apus_remove_generator() para eliminar versión de WordPress
- Eliminación de headers innecesarios (RSD, WLW Manifest, REST API link)
- Prefetch hints para Google Fonts
- Fallback schema.org que se desactiva si Rank Math está activo
- Security headers (X-Content-Type-Options, X-Frame-Options, X-XSS-Protection)
- Optimización de robots.txt cache headers
- Actualizado: functions.php para incluir inc/seo.php en el flujo de carga
- Creado: SEO-COMPATIBILITY.md con documentación completa
- Explicación de features SEO del tema
- Qué hace Rank Math
- Cómo trabajan juntos sin conflictos
- Configuración recomendada de Rank Math
- Checklist de verificación
- Troubleshooting
🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
- WordPress core y plugins
- Tema Twenty Twenty-Four configurado
- Plugin allow-unfiltered-html.php simplificado
- .gitignore configurado para excluir wp-config.php y uploads
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
