roi-theme/inc/cta-ab-testing.php

<?php
/**
 * CTA A/B Testing System
 *
 * Sistema de Call-to-Action con A/B Testing que muestra aleatoriamente
 * una de dos variantes (A o B) para optimizar conversiones.
 *
 * Características:
 * - Rotación 50/50 entre variante A (Catálogo) y B (Membresía)
 * - Cookie persistence para mantener la misma variante por usuario
 * - Template tag: apus_display_cta()
 * - Tracking de conversiones con Google Analytics 4
 *
 * @package APUS_Theme
 * @since 1.0.0
 */

// Exit if accessed directly
if (!defined('ABSPATH')) {
    exit;
}

/**
 * Obtener la variante de CTA para el usuario actual
 *
 * Usa cookies para mantener la misma variante durante 30 días.
 * Si no hay cookie, asigna aleatoriamente A o B (50/50).
 *
 * @return string 'A' o 'B'
 */
function apus_get_cta_variant() {
    $cookie_name = 'apus_cta_variant';

    // Verificar si ya existe una variante asignada
    if (isset($_COOKIE[$cookie_name]) && in_array($_COOKIE[$cookie_name], array('A', 'B'))) {
        return sanitize_text_field($_COOKIE[$cookie_name]);
    }

    // Asignar variante aleatoria (50/50)
    $variant = (rand(0, 1) === 0) ? 'A' : 'B';

    // Guardar en cookie por 30 días
    setcookie($cookie_name, $variant, time() + (30 * DAY_IN_SECONDS), COOKIEPATH, COOKIE_DOMAIN);

    return $variant;
}

/**
 * Template tag para mostrar el CTA
 *
 * Uso: <?php apus_display_cta(); ?>
 *
 * @param array $args Argumentos opcionales para personalizar el CTA
 * @return void
 */
function apus_display_cta($args = array()) {
    // Verificar si el CTA está habilitado
    $enable_cta = get_theme_mod('apus_enable_cta', true);
    if (!$enable_cta) {
        return;
    }

    // Solo mostrar en posts individuales por defecto
    $show_on = isset($args['show_on']) ? $args['show_on'] : 'single';

    if ($show_on === 'single' && !is_single()) {
        return;
    }

    // Obtener la variante del usuario
    $variant = apus_get_cta_variant();

    // Obtener configuración desde el Customizer
    $cta_config = apus_get_cta_config($variant);

    // Renderizar el CTA
    apus_render_cta($variant, $cta_config);
}

/**
 * Obtener configuración del CTA desde el Customizer
 *
 * @param string $variant 'A' o 'B'
 * @return array Configuración del CTA
 */
function apus_get_cta_config($variant) {
    if ($variant === 'A') {
        return array(
            'title'       => get_theme_mod('apus_cta_a_title', __('Accede a 200,000+ Análisis de Precios Unitarios', 'apus-theme')),
            'text'        => get_theme_mod('apus_cta_a_text', __('Consulta estructuras completas, insumos y dosificaciones de los APUs más utilizados en construcción en México.', 'apus-theme')),
            'button_text' => get_theme_mod('apus_cta_a_button', __('Ver Catálogo Completo', 'apus-theme')),
            'button_url'  => get_theme_mod('apus_cta_a_url', home_url('/catalogo')),
            'variant'     => 'A',
        );
    } else {
        return array(
            'title'       => get_theme_mod('apus_cta_b_title', __('¿Necesitas Consultar Más APUs?', 'apus-theme')),
            'text'        => get_theme_mod('apus_cta_b_text', __('Accede a nuestra biblioteca de 200,000 análisis de precios unitarios con estructuras detalladas y listados de insumos.', 'apus-theme')),
            'button_text' => get_theme_mod('apus_cta_b_button', __('Conocer Planes de Membresía', 'apus-theme')),
            'button_url'  => get_theme_mod('apus_cta_b_url', home_url('/planes')),
            'variant'     => 'B',
        );
    }
}

/**
 * Renderizar el HTML del CTA
 *
 * @param string $variant 'A' o 'B'
 * @param array $config Configuración del CTA
 * @return void
 */
function apus_render_cta($variant, $config) {
    ?>
    <!-- CTA A/B Testing - Variante <?php echo esc_attr($variant); ?> -->
    <div class="my-5 p-4 rounded cta-section cta-variant-<?php echo esc_attr(strtolower($variant)); ?>"
         data-variant="<?php echo esc_attr($variant); ?>">
        <div class="row align-items-center">
            <div class="col-md-8">
                <h3 class="h4 fw-bold text-white mb-2">
                    <?php echo esc_html($config['title']); ?>
                </h3>
                <p class="text-white mb-md-0">
                    <?php echo esc_html($config['text']); ?>
                </p>
            </div>
            <div class="col-md-4 text-md-end mt-3 mt-md-0">
                <a href="<?php echo esc_url($config['button_url']); ?>"
                   class="btn btn-light btn-lg cta-button"
                   data-cta-variant="<?php echo esc_attr($variant); ?>">
                    <?php echo esc_html($config['button_text']); ?>
                    <i class="bi bi-arrow-right ms-2"></i>
                </a>
            </div>
        </div>
    </div>
    <?php
}

/**
 * Hook para agregar el CTA automáticamente después del contenido
 *
 * Se puede desactivar usando remove_filter('the_content', 'apus_auto_insert_cta')
 */
function apus_auto_insert_cta($content) {
    // Solo en posts individuales
    if (!is_single()) {
        return $content;
    }

    // Verificar si está habilitado
    $enable_cta = get_theme_mod('apus_enable_cta', true);
    $auto_insert = get_theme_mod('apus_cta_auto_insert', false);

    if (!$enable_cta || !$auto_insert) {
        return $content;
    }

    // Capturar el output del CTA
    ob_start();
    apus_display_cta();
    $cta_html = ob_get_clean();

    // Insertar después del contenido
    return $content . $cta_html;
}
// add_filter('the_content', 'apus_auto_insert_cta', 20); // Descomentado por defecto, usar template tag

/**
 * Shortcode para insertar el CTA manualmente
 *
 * Uso: [apus_cta]
 */
function apus_cta_shortcode($atts) {
    ob_start();
    apus_display_cta($atts);
    return ob_get_clean();
}
add_shortcode('apus_cta', 'apus_cta_shortcode');

/**
 * Agregar atributos data-* al body para tracking
 */
function apus_add_cta_body_class($classes) {
    if (is_single() && get_theme_mod('apus_enable_cta', true)) {
        $variant = apus_get_cta_variant();
        $classes[] = 'has-cta';
        $classes[] = 'cta-variant-' . strtolower($variant);
    }
    return $classes;
}
add_filter('body_class', 'apus_add_cta_body_class');

/**
 * Agregar datos de configuración para JavaScript
 */
function apus_cta_localize_script() {
    if (!is_single() || !get_theme_mod('apus_enable_cta', true)) {
        return;
    }

    $variant = apus_get_cta_variant();

    $cta_data = array(
        'variant'      => $variant,
        'ga_enabled'   => !empty(get_theme_mod('apus_ga_tracking_id', '')),
        'ga_id'        => get_theme_mod('apus_ga_tracking_id', ''),
        'debug_mode'   => defined('WP_DEBUG') && WP_DEBUG,
    );

    wp_localize_script('apus-cta-tracking', 'apusCTA', $cta_data);
}
add_action('wp_enqueue_scripts', 'apus_cta_localize_script', 20);