Recibir aviso es wordpress “WP_Scripts::localize se llamó incorrectamente”

Mensaje completo: Aviso: WP_Scripts::localize se llamó incorrectamente. El parámetro $l10n debe ser una matriz. Para pasar datos arbitrarios a los scripts, use la función wp_add_inline_script() en su lugar. Consulte Depuración en WordPress para obtener más información. (Este mensaje se agregó en la versión 5.7.0.) en /home3/dduconne/public_html/wp-includes/functions.php en la línea 5313

Apareció justo después de actualizar wordpress a 5.7.0

Ok, ya que hay bastantes vistas y la respuesta anterior simplemente lo tira debajo de la alfombra.

Sí, ahora es una advertencia, pero quién sabe qué pasará, es una advertencia por una razón, deshabilitar algo no lo resuelve, hay una razón por la cual los desarrolladores lo establecieron como una advertencia por ahora.

Mientras esperamos a que los desarrolladores de complementos lo resuelvan, puede averiguar el origen del problema habilitando php_xdebug en php. Recomiendo no dejarlo después de la depuración, ya que no estoy seguro del costo de rendimiento de su activación.

php_xdebug devolverá una pila de todos los archivos afectados, desde allí puede rastrearlo hasta el origen del problema. La solución una vez encontrada la fuente es bastante fácil. Lo más probable es que el culpable sea wp_localize_script() que requiere que el último parámetro sea un array()!

Así que encontrarías algo como esto:

wp_localize_script( 'handle', 'object_name', 'l10n_culprit_string' );

Que debe convertirse en:

wp_localize_script( 'handle', 'object_name', array( 'l10n_culprit_string' ) );

La solución al problema vino de aquí

Esta es una nueva advertencia que aparece en WordPress 5.7. Si no desea verlo y aún desea tener WP_DEBUG establecido en verdadero, es posible deshabilitar el mensaje agregando, por ejemplo, lo siguiente en functions.php de su tema:

 add_filter('doing_it_wrong_trigger_error', function () {return false;}, 10, 0);

Ahora es un aviso si está utilizando wp5.7 y php7.4, pero al cambiar a php8 puede aparecer como un error. Para mí, cuando cambié (en mi propio código) el valor pasado a la matriz (sí, probablemente también se necesitaron algunos cambios en los js involucrados), todo funcionó bien.

Esto se debe a que una de las secuencias de comandos PHP en su instalación de wordpress usa wp_localize_script() para pasar algunas variables de PHP a una secuencia de comandos JS a través de una solicitud AJAX, y ya no es una buena práctica. Esto puede estar dentro de un complemento o dentro de su tema personalizado o functions.php de child-theme. Si wp_localize_script() no está en un tema infantil o funciones de tema personalizado.php, intente esto:

1. copia de seguridad de su sitio web
2. desactivar todos los complementos
3. reactivarlos uno a uno hasta que te llegue de nuevo el aviso
4. cuando el aviso vuelve a aparecer, significa que el complemento que acaba de reactivar usa wp_localize_script() de manera incorrecta
5. si no está actualizado, intente actualizarlo (si lo desea): tal vez el aviso desaparezca
6. si ya está actualizado, o no desea actualizarlo, busque dentro de wp-content/plugins la carpeta del complemento correspondiente
7. ábralo e intente encontrar los archivos donde se llama wp_localize_script(), también puede usar CLI con la terminal de su servidor para encontrar cadenas en los archivos. Por ejemplo, si su servidor se ejecuta en Linux: grep -H -r “wp_localize_script()” /root/pathtopluginfolder | cortar -d: -f1
8. Luego, reemplace el código de la siguiente manera:

El anterior debería verse casi así:

wp_enqueue_script( 'wpdocs-my-script', 'https://url-to/my-script.js' );
wp_localize_script( 'wpdocs-my-script', 'MYSCRIPT', array(
    'ajaxUrl' => admin_url( 'admin-ajax.php' ),
    'otherParam' => 'some value',
) );

Uno nuevo :

wp_enqueue_script( 'wpdocs-my-script', 'https://url-to/my-script.js' );
wp_add_inline_script( 'wpdocs-my-script', 'const MYSCRIPT = ' . json_encode( array(
    'ajaxUrl' => admin_url( 'admin-ajax.php' ),
    'otherParam' => 'some value',
) ), 'before' );

Tenga en cuenta que debe agregar ‘antes’ como tercer parámetro a la función wp_add_inline_script.

Una vez hecho esto, el aviso ya no debería mostrarse. Si es así, comuníquese con el desarrollador del complemento para informarle sobre esto para que pueda ser parte de la próxima actualización.

Para obtener más información, consulte el comentario de Jules Colle en esta página: https://developer.wordpress.org/reference/functions/wp_add_inline_script/