WP Deferred JavaScripts

FAQ

Le code de WP Deferred JavaScript inclut quelques filtres et actions. Si vous n’en avez jamais utilisé, lisez cette page. Il est préférable d’utiliser ces filtres dans une extension (classique ou automatisée).

Exclure des scripts

do_not_defer est un filtre qui prend en paramètre un tableau contenant les identifiants des fichier à charger de façon classique.

Voici un exemple :

// Normal script enqueue.
add_action( 'wp_enqueue_scripts', 'register_canvas_script' );
function register_canvas_script() {
    wp_register_script( 'my-canvas-script', 'http://exemple.com/myscript.js' );
    wp_enqueue_script( 'my-canvas-script' );
}

// Don't defer this script.
add_filter( 'do_not_defer', 'exclude_canvas_script' );
function exclude_canvas_script( $do_not_defer ) {
    $do_not_defer[] = 'my-canvas-script';
    return $do_not_defer;
}

Depuis la version 2.0.3, vous pouvez aussi utiliser la page des réglages de WP Deferred JS settings !

Changer l’URL de LABJS

wdjs_labjs_src est un filtre qui permet de changer l’URL de LABJS.
($lab_src, $lab_ver)

// for example, I need a specific version of LabJS
add_filter( 'wdjs_labjs_src', 'my_labjs_src', 10, 2 );
function my_labjs_src( $src, $ver ) {
    if ( '2.0' !== $ver ) {
        // Hotlinking raw github is a bad practice, I did it just for the lulz.
        return 'https://raw.githubusercontent.com/getify/LABjs/edb9fed40dc224bc03c338be938cb586ef397fa6/LAB.min.js';
    }
    return $src;
}

Compatibilité HTML5

Si vous utilisez HTML5, wdjs_use_html5 est un filtre qui enlève l’attribut type="text/javascript". Il s’utilise de cette façon :

add_filter( 'wdjs_use_html5', '__return_true' );

Intervenir sur la source d’un fichier différé

wdjs_deferred_script_src peut être employé pour changer la façon dont un script est chargé. Par exemple :

// Here, I need to add information about the charset.
add_filter( 'wdjs_deferred_script_src', '', 10, 3 );
function change_my_script_src( $src_string, $handle, $src ) {
    // $src_string -> .script("http://exemple.com/myscript.js?v=2.0")
    // $handle -> my-script
    // $src -> http://exemple.com/myscript.js?v=2.0
    $out = array( 'src' => $src, 'charset' => 'iso-8859-1' );
    return '.wait(' . json_encode( $out ) . ')';
}

Comment exécuter un code directement après le chargement d’un script ?

Il est possible de devoir exécuter un script directement après sont chargement. Vous pouvez utiliser le filtre wdjs_deferred_script_wait dans ce but.

add_action( 'wdjs_deferred_script_wait', 'after_my_script', 10, 2 );
function after_my_script( $wait, $handle ) {
    if ( 'my-script' === $handle ) {
        $wait = 'function(){new MyScriptObject();}';
    }
    return $wait;
}

Exécuter une fonction lorsque tous les scripts sont chargés

Il est possible d’avoir du code javascript « inline » dans les pages de son site. Si tel est le cas, il vous faudra utiliser ce filtre pour que votre script soit compatible avec WP Deferred JavaScripts.

Vous devez d’abord contenir ce code javascript « inline » dans une nouvelle fonction. Ensuite il faut utiliser wdjs_before_end_lab pour l’exécuter.

// This is a fake function that we are wrapping in a new function
add_filter( 'before_shitty_plugin_print_js', 'wrap_this_code' );
function wrap_this_code( $code ) {
    return 'function PluginShittyCode(){' . $code . '}';
}

add_filter( 'wdjs_before_end_lab', 'call_shitty_code' );
function call_shitty_code( $end ) {
    $end .= '.PluginShittyCode()';
    return $end;
}