FrankZamora
d5fe816add
[NIVEL 3] Issue #55 - TOC ScrollSpy con IntersectionObserver
...
Implementación completa de TOC sticky con scrollspy avanzado según Issue #55 .
**Cambios en toc.css:**
- TOC sticky: position: sticky, top: 5.5rem, z-index: 10
- Border-left en links: 3px solid transparent (activo: #0d6efd)
- Scrollbar personalizado: width 6px, color #cbd5e0, hover #a0aec0
- Ajustados padding/margin para border-left
**Cambios en toc.js:**
- Reemplazado scroll handler por IntersectionObserver
- rootMargin: '-20% 0px -35% 0px' para detección óptima
- Tracking de headings visibles con Set
- Active link basado en primer heading visible
- Renombrado updateActiveLink → updateActiveLinkOnClick (evitar conflicto)
- Mantiene smooth scroll y reduce-motion support
**Características:**
✅ TOC sticky funcional con top: 5.5rem
✅ ScrollSpy con IntersectionObserver (rootMargin personalizado)
✅ Border-left 3px solid en active links
✅ Scrollbar width 6px, color #cbd5e0
✅ Smooth scroll con offset dinámico
✅ Performance optimizado (sin scroll events)
✅ Compatible todos los browsers modernos
Closes #55
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-11-04 20:09:45 -06:00
FrankZamora
d36bc0f725
Implementar Issues #17 , #18 , #30 , #31 , #33 - Optimizaciones avanzadas y contenido
...
Segunda ola de implementaciones masivas con agentes paralelos para funcionalidades avanzadas de SEO, accesibilidad y contenido especializado.
**Issue #17 - Imágenes responsive con srcset/WebP/AVIF:**
- inc/image-optimization.php: 8 nuevas funciones para optimización
- Soporte WebP/AVIF con detección de servidor
- Srcset y sizes automáticos contextuales
- Lazy loading inteligente (excluye LCP)
- Threshold 2560px para big images
- Picture element con fallbacks
- Preload de featured images
- Calidad JPEG optimizada (85%)
- Dimensiones explícitas (previene CLS)
- 14 filtros WordPress implementados
- Beneficios: 30-50% reducción con WebP, 50-70% con AVIF
- Core Web Vitals: Mejora LCP y CLS
**Issue #18 - Accesibilidad WCAG 2.1 AA:**
- assets/css/accessibility.css: +461 líneas
- Focus styles visibles (3px outline)
- Screen reader utilities
- Touch targets ≥44px
- High contrast mode support
- Reduced motion support
- Color contrast AA (4.5:1, 3:1)
- assets/js/accessibility.js: 19KB nuevo
- Skip links con smooth scroll
- Navegación por teclado en dropdowns
- Arrow keys en menús WordPress
- Modal keyboard support
- Focus management y trap
- ARIA live regions
- Announcements para screen readers
- header.php: ARIA labels en navbar
- Actualizaciones JS: Respeto prefers-reduced-motion en main.js, toc.js, header.js
- Cumplimiento completo WCAG 2.1 Level AA
**Issue #30 - Tablas APU (Análisis Precios Unitarios):**
- assets/css/tables-apu.css: 560 líneas
- Diseño sin bordes, moderno
- Zebra striping (#f8f9fa/#ffffff)
- Headers sticky con degradado azul
- 4 tipos de filas: normal, section-header, subtotal, total
- Fuente monospace para columnas monetarias
- Responsive (scroll horizontal móvil)
- Print styles con color-adjust: exact
- inc/apu-tables.php: 330 líneas, 6 funciones
- apus_process_apu_tables() - Procesamiento automático
- Shortcodes: [apu_table], [apu_row type=""]
- apus_generate_apu_table($data) - Generación programática
- 4 métodos de uso: data-apu, shortcode, clase manual, PHP
- docs/APU-TABLES-GUIDE.md: Guía completa de usuario
- docs/APU-TABLE-EXAMPLE.html: Ejemplo funcional
- 6 columnas: Clave, Descripción, Unidad, Cantidad, Costo, Importe
- CRÍTICO: Contenido principal del sitio de construcción
**Issue #31 - Botones de compartir en redes sociales:**
- inc/social-share.php: 127 líneas
- apus_get_social_share_buttons() - Genera HTML
- apus_display_social_share() - Template tag
- 5 redes: Facebook, X/Twitter, LinkedIn, WhatsApp, Email
- URLs nativas sin JavaScript de terceros
- Encoding seguro, ARIA labels
- assets/css/social-share.css: 137 líneas
- Animaciones hover (translateY, scale)
- Colores específicos por red
- Responsive (576px, 360px)
- Focus styles accesibles
- single.php: Integración después del contenido
- Bootstrap Icons CDN (v1.11.3)
- Panel de opciones con configuración
**Issue #33 - Schema.org completo (5 tipos):**
- inc/schema-org.php: 468 líneas, 7 funciones
- Organization schema con logo y redes sociales
- WebSite schema con SearchAction
- Article schema (posts) con autor, imagen, categorías, wordCount
- WebPage schema (páginas) con featured image
- BreadcrumbList schema (8 contextos diferentes)
- JSON-LD format en <head>
- Referencias cruzadas con @id
- Google Rich Results compliant
- Deshabilita schemas Rank Math/Yoast (evita duplicación)
- Locale: es-MX
- Hook: wp_head (prioridad 5)
**Archivos Modificados:**
- functions.php: Includes de nuevos módulos (schema-org, apu-tables, social-share)
- inc/enqueue-scripts.php: Enqueue de nuevos CSS/JS, Bootstrap Icons CDN
- inc/image-optimization.php: 8 funciones nuevas WebP/AVIF
- assets/css/accessibility.css: +461 líneas
- assets/js/main.js, toc.js, header.js: Reduced motion support
- single.php: Social share buttons
- header.php: ARIA labels
- inc/admin/options-api.php: Social share settings
**Archivos Creados:**
- 3 archivos PHP funcionales (apu-tables, social-share, schema-org)
- 1 archivo JavaScript (accessibility.js - 19KB)
- 3 archivos CSS (tables-apu, social-share)
- 2 archivos docs/ (APU guide y example)
- 5 reportes .md de documentación
**Estadísticas:**
- Total funciones nuevas: 30+
- Líneas de código nuevas: 2,500+
- Archivos nuevos: 13
- Archivos modificados: 10
- Mejoras de accesibilidad: WCAG 2.1 AA compliant
- Mejoras SEO: 5 schemas JSON-LD
- Mejoras performance: WebP/AVIF, lazy loading, srcset
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com >
2025-11-04 17:12:03 -06:00
FrankZamora
7ba9080f57
Agregar estructura completa del tema APUS con Bootstrap 5 y optimizaciones de rendimiento
...
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 >
2025-11-04 09:31:47 -06:00