Files
roi-theme/wp-content/themes/apus-theme/inc/customizer-cta.php
FrankZamora 895e63bd81 Implementar Issues #15, #21, #32 - Optimización final y corrección crítica
Tercera ola de implementaciones con corrección del error crítico del tema y optimizaciones finales de rendimiento.

**Issue #21 - CRÍTICO RESUELTO - Error Cannot redeclare:**
- inc/sanitize-functions.php: Consolidadas 8 funciones sanitización
  - Todas con protección if (!function_exists())
  - apus_sanitize_checkbox(), apus_sanitize_css(), apus_sanitize_js()
  - apus_sanitize_integer(), apus_sanitize_text(), apus_sanitize_url()
  - apus_sanitize_html(), apus_sanitize_select()
- inc/admin/options-api.php: Eliminadas 6 funciones duplicadas
  - Agregada nota de referencia a sanitize-functions.php
- ISSUE-21-RESOLUTION-REPORT.md: Reporte completo de resolución
- Cambios: -60 líneas duplicadas, +98 líneas consolidadas
- Resultado: Tema ahora se activa sin errores fatales

**Issue #15 - Core Web Vitals y rendimiento perfecto:**
- inc/performance.php: +340 líneas, 11 nuevas funciones
  - Resource hints: dns-prefetch (CDN, Analytics, AdSense)
  - Preconnect: Bootstrap Icons CDN con crossorigin
  - Preload: fuentes críticas (inter-var.woff2), CSS (bootstrap, fonts)
  - apus_add_script_attributes(): async para tracking scripts
  - apus_remove_query_strings(): limpieza de ?ver= en assets propios
  - apus_optimize_heartbeat(): desactivado en frontend, reducido en admin
  - apus_optimize_main_query(): límite 12 posts, optimización cache
  - apus_disable_self_pingbacks(): elimina pingbacks propios
  - apus_cleanup_expired_transients(): limpieza automática semanal
  - apus_add_font_display_swap(): font-display swap para prevenir FOIT
  - apus_enable_image_dimensions(): dimensiones explícitas (anti-CLS)
  - apus_enable_gzip_compression(): GZIP nivel 6
- Verificados sin cambios:
  - inc/critical-css.php: CSS crítico inline (opcional, desactivado)
  - inc/image-optimization.php: WebP/AVIF, lazy loading, srcset
  - inc/enqueue-scripts.php: defer strategy en todos los scripts
- docs/CORE-WEB-VITALS-OPTIMIZATION.md: 17KB guía completa
  - Explicación de LCP, FID/INP, CLS
  - 10 categorías de optimización
  - Configuración Apache/Nginx completa
  - Testing con PageSpeed, Lighthouse, WebPageTest
  - Mejores prácticas contenido/desarrollo/hosting
  - Troubleshooting de 5 problemas comunes
- ISSUE-15-COMPLETION-REPORT.md: Reporte técnico 15KB
- Objetivos: LCP <2.5s, FID <100ms, CLS <0.1, PageSpeed 90+
- Resultado: Tema 100% optimizado para Core Web Vitals

**Issue #32 - CTA con A/B Testing:**
- inc/cta-ab-testing.php: Sistema completo A/B testing
  - Asignación aleatoria 50/50 con cookie 30 días
  - Template tag apus_display_cta()
  - Shortcode [apus_cta]
  - Body classes dinámicas (has-cta, cta-variant-a/b)
  - Localización de datos para JS
- inc/customizer-cta.php: Panel configuración Customizer
  - Toggle on/off del CTA
  - Variante A "Catálogo": título, texto, botón, URL
  - Variante B "Membresía": título, texto, botón, URL
  - Google Analytics Tracking ID
  - 11 opciones personalizables
- template-parts/content-cta.php: Template reutilizable
- assets/css/cta.css: 400 líneas estilos
  - Degradado naranja-amarillo (#FF8600 → #FFB800)
  - Sombra prominente con color naranja
  - Botón blanco con icono flecha (Bootstrap Icons)
  - Hover effects (elevación + sombra)
  - Responsive: 2 columnas desktop, stack mobile
  - Accesibilidad: prefers-reduced-motion, high-contrast
  - Dark mode, print styles, RTL support
- assets/js/cta-tracking.js: 300 líneas tracking GA4
  - IntersectionObserver para impresiones (50%+ visible)
  - Event delegation para clicks
  - Eventos: cta_impression, cta_click
  - Parámetros: variant, button_text, target_url, value
  - Debug mode con WP_DEBUG
  - API pública window.apusCTATracking
- single.php: Integración después de botones sociales
- ISSUE-32-CTA-AB-TESTING.md: 25KB documentación
  - Guía de uso, configuración GA4
  - Debugging, testing checklist
  - KPIs y métricas recomendadas
- Resultado: A/B testing completo con tracking profesional

**Archivos Modificados:**
- functions.php: Includes cta-ab-testing y customizer-cta
- inc/enqueue-scripts.php: Enqueue CTA assets (condicional single)
- inc/performance.php: 11 funciones optimización
- inc/sanitize-functions.php: Consolidación de funciones
- inc/admin/options-api.php: Eliminación duplicados
- single.php: Integración CTA

**Archivos Creados:**
- 5 archivos PHP (cta-ab-testing, customizer-cta, content-cta, sanitize consolidado)
- 2 archivos assets (cta.css, cta-tracking.js)
- 1 guía Core Web Vitals (17KB)
- 3 reportes .md (Issue 15, 21, 32)

**Estadísticas:**
- Total funciones nuevas: 24
- Líneas de código: 1,500+
- Documentación: 9,000+ palabras
- Archivos nuevos: 11
- Archivos modificados: 6
- Error crítico: RESUELTO
- Core Web Vitals: OPTIMIZADO
- A/B Testing: IMPLEMENTADO

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-04 17:33:00 -06:00

258 lines
9.8 KiB
PHP

<?php
/**
* CTA A/B Testing Customizer Settings
*
* Opciones del panel de personalización para configurar
* las dos variantes del CTA (A y B).
*
* @package APUS_Theme
* @since 1.0.0
*/
// Exit if accessed directly
if (!defined('ABSPATH')) {
exit;
}
/**
* Registrar configuraciones del CTA en el Customizer
*/
function apus_customize_cta($wp_customize) {
// Agregar sección para CTA A/B Testing
$wp_customize->add_section('apus_cta', array(
'title' => __('CTA A/B Testing', 'apus-theme'),
'description' => __('Configura las dos variantes del Call-to-Action que se mostrarán aleatoriamente. El sistema asignará automáticamente una variante a cada usuario (50/50).', 'apus-theme'),
'priority' => 132,
));
// =====================================================
// CONFIGURACIÓN GENERAL
// =====================================================
// Habilitar/Deshabilitar CTA
$wp_customize->add_setting('apus_enable_cta', array(
'default' => true,
'sanitize_callback' => 'apus_sanitize_checkbox',
'transport' => 'refresh',
));
$wp_customize->add_control('apus_enable_cta', array(
'label' => __('Habilitar CTA con A/B Testing', 'apus-theme'),
'description' => __('Muestra un Call-to-Action en los posts individuales con dos variantes aleatorias.', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'checkbox',
));
// Auto-insertar CTA (opcional, por defecto usar template tag)
$wp_customize->add_setting('apus_cta_auto_insert', array(
'default' => false,
'sanitize_callback' => 'apus_sanitize_checkbox',
'transport' => 'refresh',
));
$wp_customize->add_control('apus_cta_auto_insert', array(
'label' => __('Auto-insertar CTA después del contenido', 'apus-theme'),
'description' => __('Si está desactivado, usa el template tag apus_display_cta() manualmente.', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'checkbox',
));
// =====================================================
// VARIANTE A - ENFOQUE EN CATÁLOGO
// =====================================================
// Separador visual
$wp_customize->add_setting('apus_cta_a_separator', array(
'sanitize_callback' => 'sanitize_text_field',
));
$wp_customize->add_control(new WP_Customize_Control(
$wp_customize,
'apus_cta_a_separator',
array(
'label' => __('━━━ Variante A: Catálogo ━━━', 'apus-theme'),
'description' => __('Enfoque en acceso al catálogo de 200,000+ APUs', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'hidden',
)
));
// Título Variante A
$wp_customize->add_setting('apus_cta_a_title', array(
'default' => __('Accede a 200,000+ Análisis de Precios Unitarios', 'apus-theme'),
'sanitize_callback' => 'sanitize_text_field',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_a_title', array(
'label' => __('Título', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'text',
));
// Texto Variante A
$wp_customize->add_setting('apus_cta_a_text', array(
'default' => __('Consulta estructuras completas, insumos y dosificaciones de los APUs más utilizados en construcción en México.', 'apus-theme'),
'sanitize_callback' => 'sanitize_textarea_field',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_a_text', array(
'label' => __('Texto descriptivo', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'textarea',
));
// Botón Variante A
$wp_customize->add_setting('apus_cta_a_button', array(
'default' => __('Ver Catálogo Completo', 'apus-theme'),
'sanitize_callback' => 'sanitize_text_field',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_a_button', array(
'label' => __('Texto del botón', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'text',
));
// URL Variante A
$wp_customize->add_setting('apus_cta_a_url', array(
'default' => '#',
'sanitize_callback' => 'esc_url_raw',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_a_url', array(
'label' => __('URL del botón', 'apus-theme'),
'description' => __('Ejemplo: /catalogo-completo/ o una URL completa', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'url',
));
// =====================================================
// VARIANTE B - ENFOQUE EN MEMBRESÍA
// =====================================================
// Separador visual
$wp_customize->add_setting('apus_cta_b_separator', array(
'sanitize_callback' => 'sanitize_text_field',
));
$wp_customize->add_control(new WP_Customize_Control(
$wp_customize,
'apus_cta_b_separator',
array(
'label' => __('━━━ Variante B: Membresía ━━━', 'apus-theme'),
'description' => __('Enfoque en planes de membresía y acceso premium', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'hidden',
)
));
// Título Variante B
$wp_customize->add_setting('apus_cta_b_title', array(
'default' => __('¿Necesitas Consultar Más APUs?', 'apus-theme'),
'sanitize_callback' => 'sanitize_text_field',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_b_title', array(
'label' => __('Título', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'text',
));
// Texto Variante B
$wp_customize->add_setting('apus_cta_b_text', array(
'default' => __('Accede a nuestra biblioteca de 200,000 análisis de precios unitarios con estructuras detalladas y listados de insumos.', 'apus-theme'),
'sanitize_callback' => 'sanitize_textarea_field',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_b_text', array(
'label' => __('Texto descriptivo', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'textarea',
));
// Botón Variante B
$wp_customize->add_setting('apus_cta_b_button', array(
'default' => __('Conocer Planes de Membresía', 'apus-theme'),
'sanitize_callback' => 'sanitize_text_field',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_b_button', array(
'label' => __('Texto del botón', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'text',
));
// URL Variante B
$wp_customize->add_setting('apus_cta_b_url', array(
'default' => '#',
'sanitize_callback' => 'esc_url_raw',
'transport' => 'postMessage',
));
$wp_customize->add_control('apus_cta_b_url', array(
'label' => __('URL del botón', 'apus-theme'),
'description' => __('Ejemplo: /planes-de-membresia/ o una URL completa', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'url',
));
// =====================================================
// GOOGLE ANALYTICS TRACKING
// =====================================================
// Separador visual
$wp_customize->add_setting('apus_cta_ga_separator', array(
'sanitize_callback' => 'sanitize_text_field',
));
$wp_customize->add_control(new WP_Customize_Control(
$wp_customize,
'apus_cta_ga_separator',
array(
'label' => __('━━━ Google Analytics ━━━', 'apus-theme'),
'description' => __('Configuración para tracking de conversiones', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'hidden',
)
));
// Google Analytics Tracking ID
$wp_customize->add_setting('apus_ga_tracking_id', array(
'default' => '',
'sanitize_callback' => 'sanitize_text_field',
'transport' => 'refresh',
));
$wp_customize->add_control('apus_ga_tracking_id', array(
'label' => __('Google Analytics Tracking ID', 'apus-theme'),
'description' => __('Formato: G-XXXXXXXXXX (GA4) o UA-XXXXXXXXX-X (Universal Analytics). Déjalo vacío si ya tienes GA instalado mediante plugin.', 'apus-theme'),
'section' => 'apus_cta',
'type' => 'text',
));
}
add_action('customize_register', 'apus_customize_cta');
/**
* Agregar script de Google Analytics en el header si está configurado
*/
function apus_output_google_analytics() {
$tracking_id = get_theme_mod('apus_ga_tracking_id', '');
// No mostrar si está vacío o si estamos en el admin
if (empty($tracking_id) || is_admin()) {
return;
}
// No mostrar si es un usuario admin logueado
if (current_user_can('manage_options')) {
return;
}
?>
<!-- Google Analytics (CTA A/B Testing) -->
<script async src="https://www.googletagmanager.com/gtag/js?id=<?php echo esc_attr($tracking_id); ?>"></script>
<script>
window.dataLayer = window.dataLayer || [];
function gtag(){dataLayer.push(arguments);}
gtag('js', new Date());
gtag('config', '<?php echo esc_js($tracking_id); ?>', {
'anonymize_ip': true,
'cookie_flags': 'SameSite=None;Secure'
});
</script>
<?php
}
add_action('wp_head', 'apus_output_google_analytics', 1);