Funkce wp_enqueue_script

Funkce wp_enqueue_script vytváří odkaz na script, který jste již dříve zaregistrovali pomocí wp_register_script. Jedná se o jediný správný způsob, jak vkládat do šablony například jQuery, protože WordPress kontroluje zaregistrované scripty a nedochází tak k opakovanému načtení stejného scriptu.

wp_enqueue_script( $handle, $src, $deps, $ver, $in_footer );

Parametry:

$handle – vyžadováno, obsahuje jméno scriptu, pod kterým je zaregistrován. Pokud jste tedy zaregistrovali script pod jménem „slider“, pod stejným jménem ho budete volat v této funkci.

$src – cesta ke scriptu. Povinná je pouze v tom případě, že jste ji již nedefinovali v wp_register_script. V žádném případě v cestě nepoužívejte pevné pojmenování url, ale v případě pluginu funkci plugins_url a v šabloně get_template_directory_uri.

$deps – pomocí tohoto parametru můžete ovlivnit řazení vkládaných scriptů a určit, který soubor se vkládá dříve. Použijte pouze, pokud jste jej nedefinovali v wp_register_sript.

$ver – zde můžete definovat verzi scriptu a defaultně je nastavena na false. V tom případě WordPress automaticky přidává do url verzi instalace WordPressu. Pokud chcete link bez uvedení verze, nastavte na null.

$in_footer – určuje, zda se bude script načítat v head, nebo footer. Pokud je true, načte se v patičce. Defaultně je false.

Několik příkladů z WordPress.org

Protože jsem na toto téma již článek napsal – Jak vložit javascript do šablony, uvedu jen příklady, které článek rozšiřují.

Vložení js souboru, který je již ve WordPressu vložen a zaregistrován:

function my_scripts_method() {
    wp_enqueue_script( 'scriptaculous' );
}

add_action( 'wp_enqueue_scripts', 'my_scripts_method' );

Akce wp_enqueue, kterou zde voláme, se vztahuje jen k frontendu. Pokud potřebujeme soubory vložit do administrace, musíme použít hook admin_enqueue_scripts.

Vložení scriptu v závislosti na jQuery

Řada vkládaných scriptů je závislá na některé z knihoven, jako je jQuery. Pokud použijeme parametr $deps, vloží se script pouze, pokud již bylo vloženo jQuery.

function my_scripts_method() {
	wp_enqueue_script(
		'custom-script',
		get_stylesheet_directory_uri() . '/js/custom_script.js',
		array( 'jquery' )
	);
}

add_action( 'wp_enqueue_scripts', 'my_scripts_method' );

Vložení scriptu do patičky bez závislosti na jiném souboru

add_action( 'wp_enqueue_scripts', 'child_add_scripts' );

function child_add_scripts() {
    wp_register_script(
        'google-analytics',
        get_stylesheet_directory_uri() . '/google_analytics_object.js',
        false,
        '1.0',
        true
    );

    wp_enqueue_script( 'google-analytics' );
}

Scripty, které WordPress již obsahuje a vkládá:

Při instalaci již WordPress obsahuje řadu scriptů, které využívá v administraci a pro funkce webu. Zde je seznam všech scriptů, které tak můžete použít ve svých šablonách a pluginech:

Využití takových scriptů vám určitě usnadní práci na šablonách a můžete využívat řadu funkcí, které již WordPress v základu má.