Encolar scripts en línea en WordPress debido a dependencias

Simplemente no lo conviertas en un script en línea y luego pases los parámetros dinámicos como variables. Otto ha escrito una excelente guía sobre cómo hacer esto de manera efectiva.

WordPress 3.3 también hará esto más potente: https://core.trac.wordpress.org/ticket/11520

Esta solución es similar a la respuesta de @scribu, pero sigue la forma de wp_enqueue_script(), y colocará el script en el encabezado si sus dependencias están incluidas en el encabezado.

/**
 * Encola JavaScript en línea. @see wp_enqueue_script().
 * 
 * ERROR CONOCIDO: Los scripts en línea no pueden ser encolados antes 
 *  que cualquier script en línea del que dependan (a menos que se coloquen
 *  en el encabezado y el dependiente en el pie de página).
 * 
 * @param string      $handle    Nombre identificador del script
 * @param string      $src       El código JavaScript
 * @param array       $deps      (opcional) Array de nombres de scripts de los que depende este script
 * @param bool        $in_footer (opcional) Si se debe encolar el script antes de </head> o antes de </body>
 * 
 * @return null
 */
function enqueue_inline_script( $handle, $js, $deps = array(), $in_footer = false ){
    // Callback para imprimir el script en línea.
    $cb = function()use( $handle, $js ){
        // Asegura que el script solo se incluya una vez.
        if( wp_script_is( $handle, 'done' ) )
            return;
        // Imprime el script y lo marca como incluido.
        echo "<script type=\"text/javascript\" id=\"js-$handle\">\n$js\n</script>\n";
        global $wp_scripts;
        $wp_scripts->done[] = $handle;
    };
    // (`wp_print_scripts` se llama en el encabezado y pie de página, pero $cb tiene protección de reinclusión.)
    $hook = $in_footer ? 'wp_print_footer_scripts' : 'wp_print_scripts';

    // Si no hay dependencias, simplemente se engancha al encabezado o pie de página.
    if( empty($deps)){
        add_action( $hook, $cb );
        return;
    }

    // Retrasa la impresión del script hasta que todas las dependencias hayan sido incluidas.
    $cb_maybe = function()use( $deps, $in_footer, $cb, &$cb_maybe ){
        foreach( $deps as &$dep ){
            if( !wp_script_is( $dep, 'done' ) ){
                // Las dependencias no están incluidas en el encabezado, intenta nuevamente en el pie de página.
                if( ! $in_footer ){
                    add_action( 'wp_print_footer_scripts', $cb_maybe, 11 );
                }
                else{
                    // Las dependencias no fueron incluidas en `wp_head` o `wp_footer`.
                }
                return;
            }
        }
        call_user_func( $cb );
    };
    add_action( $hook, $cb_maybe, 0 );
}

// Uso
enqueue_inline_script('test','alert(\'enqueue inline script test\');',array( 'jquery'));

Nota: esto utiliza funciones anónimas, pero para versiones de PHP anteriores a 5.3, esto se puede convertir fácilmente a una clase.

Desde WordPress 4.5 puedes usar wp_add_inline_script():

add_action( 'wp_enqueue_scripts', 'cyb_enqueue_scripts' );
function cyb_enqueue_scripts() {
   wp_enqueue_script( 'myscript', 'url/to/myscript.js', array(), '1.0' );
   wp_add_inline_script( 'myscript', 'Tu código JavaScript inline va aquí' );
}

La mejor forma que he encontrado es usando wp_localize_script(), como sugirió @scribu.

Normalmente, decidía usar Javascript en línea porque necesitaba proporcionar algunas variables PHP a mi script. Esto se puede resolver con wp_localize_script(). Proporcionaré un ejemplo:

Tienes un array $aFoo con algunas opciones y necesitas pasarlo a un script.

$aFoo = array( 'option1' => $option1Value, 'option2' => $option2Value );

Usando script en línea:

<script> 
    var oFoo = {};
    oFoo.option1 = <?php echo $aFoo['option1'] ?>;  
    oFoo.option2 = <?php echo $aFoo['option2'] ?>;            
    //hacer algunas cosas con oFoo
</script>

Usando wp_localize_script():

wp_register_script( 'script_name', 'pathToScript/script.js', array( 'jquery' )); //si jQuery no es necesario, simplemente elimina el último argumento.
wp_localize_script( 'script_name', 'object_name', $aFoo ); //pasa 'object_name' a script.js
wp_enqueue_script( 'script_name' );    

Entonces, pathToScript/script.js sería:

var oFoo = {};
oFoo.option1 = object_name.option1;   
oFoo.option2 = object_name.option2;            
//hacer algunas cosas con oFoo (no se necesita PHP)

De esta manera ya no necesitas scripts en línea nunca más.

scribu tiene toda la razón. De todos modos, quiero añadir algo de información:

Quiero que mi función imprima un script una sola vez, sin importar cuántas veces sea llamada. Es una función relacionada con el contenido, así que no puedo esperar por ningún hook. Usé la información de scribu y algo de lectura del núcleo de WP para llegar a esto:

function print_script_once() {
    if(!wp_script_is('my-handle', 'done')) {
        echo "<script>alert('una vez!');</script>";
        global $wp_scripts;
        $wp_scripts->done[] = 'my-handle';
    }
}
add_action('get_footer', print_script_once);

Usando este método puedo imprimir un script en línea una sola vez. En mi caso tengo una función que crea un botón de compartir y necesita que un script se ejecute para todos los botones. Pero solo una vez.