[A la espera de la opinión de los usuarios] Incompatibilidad Flexible Checkout Fields (y PRO) con WooCommerce Multilingual & Multicurrency

<?php
/*
Plugin Name: FCF ⇄ WCML Compat (logic_results_storage normalizer)
Description: Normaliza el payload de lógica condicional de Flexible Checkout Fields PRO cuando WCML está activo para evitar fallos de validación por JSON mal decodificado.
Author: DevOps
Version: 0.1
*/

if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * Intenta decodificar en distintos escenarios de codificación.
 * Devuelve array si tiene éxito o null si falla.
 */
function fcf_wcml_try_decode_results( $raw ) {
    // Sin tocar
    $arr = json_decode( $raw, true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // urldecode (una vez)
    $arr = json_decode( urldecode( $raw ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // rawurldecode
    $arr = json_decode( rawurldecode( $raw ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // Doble urldecode
    $arr = json_decode( urldecode( urldecode( $raw ) ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // Quitar slashes extra
    $arr = json_decode( wp_unslash( $raw ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    return null;
}

/**
 * Normaliza $_POST['logic_results_storage'] lo antes posible en el proceso de checkout
 * para que FCF PRO pueda decodificarlo correctamente con su urldecode() interno.
 */
add_action( 'woocommerce_checkout_process', function () {
    $key = 'logic_results_storage';
    if ( empty( $_POST[ $key ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
        return;
    }

    $raw = $_POST[ $key ]; // phpcs:ignore WordPress.Security.NonceVerification.Missing
    // No usar wp_unslash aquí: queremos probar varias ramas nosotros mismos.
    $decoded = fcf_wcml_try_decode_results( $raw );

    if ( is_array( $decoded ) ) {
        // Re-serializamos en el formato que espera FCF: urlencode(JSON)
        $normalized = urlencode( wp_json_encode( $decoded ) );
        $_POST[ $key ] = $normalized; // phpcs:ignore WordPress.Security.NonceVerification.Missing

        // Opcional: logging de diagnóstico (comentado por defecto).
        // error_log( '[FCF-WCML-Compat] logic_results_storage normalizado correctamente.' );
    } else {
        // error_log( '[FCF-WCML-Compat] No se pudo normalizar logic_results_storage.' );
    }
}, 1 );

/**
 * Durante el procesamiento del checkout (solamente en POST), desactiva "required"
 * para aquellos campos que no vienen en $_POST. Esto evita que WooCommerce valide
 * campos que no se mostraron por lógica condicional.
 */
add_filter( 'woocommerce_checkout_fields', function ( $fields ) {
    if ( empty( $_POST ) ) { // Solo actuar en envío del checkout.
        return $fields;
    }

    foreach ( $fields as $section => $section_fields ) {
        if ( ! is_array( $section_fields ) ) {
            continue;
        }
        foreach ( $section_fields as $key => $field ) {
            if ( ! array_key_exists( $key, $_POST ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
                // No venía en el POST → probablemente oculto. Evita que falle la validación.
                $fields[ $section ][ $key ]['required'] = false;
            }
        }
    }

    return $fields;
}, 1000001 );

<?php
/*
Plugin Name: FCF ⇄ WCML Compat (logic_results_storage normalizer)
Description: Normaliza el payload de lógica condicional de Flexible Checkout Fields PRO cuando WCML está activo para evitar fallos de validación por JSON mal decodificado.
Author: DevOps
Version: 0.1
*/

if ( ! defined( 'ABSPATH' ) ) {
    exit;
}

/**
 * Intenta decodificar en distintos escenarios de codificación.
 * Devuelve array si tiene éxito o null si falla.
 */
function fcf_wcml_try_decode_results( $raw ) {
    // Sin tocar
    $arr = json_decode( $raw, true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // urldecode (una vez)
    $arr = json_decode( urldecode( $raw ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // rawurldecode
    $arr = json_decode( rawurldecode( $raw ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // Doble urldecode
    $arr = json_decode( urldecode( urldecode( $raw ) ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    // Quitar slashes extra
    $arr = json_decode( wp_unslash( $raw ), true );
    if ( is_array( $arr ) ) {
        return $arr;
    }

    return null;
}

/**
 * Obtiene resultados de lógica condicional desde $_POST si están presentes.
 *
 * @return array|null
 */
function fcf_wcml_get_results_from_post() {
    $key = 'logic_results_storage';
    if ( empty( $_POST[ $key ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
        return null;
    }

    $raw = $_POST[ $key ]; // phpcs:ignore WordPress.Security.NonceVerification.Missing

    $candidates = [
        $raw,
        urldecode( $raw ),
        rawurldecode( $raw ),
        wp_unslash( $raw ),
        urldecode( wp_unslash( $raw ) ),
    ];

    foreach ( $candidates as $candidate ) {
        $arr = json_decode( $candidate, true );
        if ( is_array( $arr ) ) {
            return $arr;
        }
    }

    return null;
}

/**
 * Normaliza $_POST['logic_results_storage'] lo antes posible en el proceso de checkout
 * para que FCF PRO pueda decodificarlo correctamente con su urldecode() interno.
 */
add_action( 'woocommerce_checkout_process', function () {
    $key = 'logic_results_storage';
    if ( empty( $_POST[ $key ] ) ) { // phpcs:ignore WordPress.Security.NonceVerification.Missing
        return;
    }

    $raw = $_POST[ $key ]; // phpcs:ignore WordPress.Security.NonceVerification.Missing
    // No usar wp_unslash aquí: queremos probar varias ramas nosotros mismos.
    $decoded = fcf_wcml_try_decode_results( $raw );

    if ( is_array( $decoded ) ) {
        // Re-serializamos en el formato que espera FCF: urlencode(JSON)
        $normalized = urlencode( wp_json_encode( $decoded ) );
        $_POST[ $key ] = $normalized; // phpcs:ignore WordPress.Security.NonceVerification.Missing

        // Opcional: logging de diagnóstico (comentado por defecto).
        // error_log( '[FCF-WCML-Compat] logic_results_storage normalizado correctamente.' );
    } else {
        // error_log( '[FCF-WCML-Compat] No se pudo normalizar logic_results_storage.' );
    }
}, 1 );

/**
 * Durante el procesamiento del checkout (solamente en POST), desactiva "required"
 * para aquellos campos que no vienen en $_POST. Esto evita que WooCommerce valide
 * campos que no se mostraron por lógica condicional.
 */
add_filter( 'woocommerce_checkout_fields', function ( $fields ) {
    if ( empty( $_POST ) ) { // Solo actuar en envío del checkout.
        return $fields;
    }

    $results = fcf_wcml_get_results_from_post();
    if ( ! is_array( $results ) ) {
        // Si no tenemos resultados válidos, no tocar los requeridos para evitar falsos positivos/negativos.
        return $fields;
    }

    foreach ( $fields as $section_name => $section_fields ) {
        if ( ! is_array( $section_fields ) ) {
            continue;
        }
        foreach ( $section_fields as $field_name => $field_def ) {
            if ( ! isset( $results[ $field_name ] ) || ! is_array( $results[ $field_name ] ) ) {
                continue;
            }
            foreach ( $results[ $field_name ] as $action => $value ) {
                switch ( $action ) {
                    case 'required':
                        $fields[ $section_name ][ $field_name ]['required'] = (bool) $value;
                        break;
                    case 'hide':
                        if ( true === (bool) $value ) {
                            unset( $fields[ $section_name ][ $field_name ] );
                        }
                        break;
                    case 'show':
                        if ( false === (bool) $value ) {
                            unset( $fields[ $section_name ][ $field_name ] );
                        }
                        break;
                }
            }
        }
    }

    return $fields;
}, 1000001 );