WordPressで外部のjQueryなどを参照させる方法と、重複読み込みさせない作法

基本ですが、自分用メモ。

WordPress のとあるプラグインが使っている jQuery を新バージョンに差し替えたい。とか、自前ホストしているものでなくて、Google CDN から読ませたい場合などに使える方法です。

プラグインのソースに手を加えるのはイヤだし。と思ったら基本作法だった様子。

また、自作テンプレートやプラグインから  jQuery を使う際に、複数回読み込ませない作法にも触れます。

WordPress用プラグインが使うjQueryを差し替える（wp_register_script）

WordPress 用プラグインが使う jQuery を、Google CDN 上の 1.10.1 に差し替える場合は、functions.php などに以下のコードを書くと良いでしょう。

if (!is_admin()) { // 管理画面のjQueryは変えない
    wp_deregister_script('jquery');
    wp_register_script('jquery', '//ajax.googleapis.com/ajax/libs/jquery/1.10.1/jquery.min.js', false, null);
}

モバイル向けに別バージョンの jQuery を使う事もできます。

if (!is_admin()) { // 管理画面のjQueryは変えない
    wp_deregister_script('jquery');
    if (IS_MOBILE_THEME) { // 自前でモバイル判別定数を作成
        // mobile -> jQuery 2.x
        wp_register_script('jquery', '//ajax.googleapis.com/ajax/libs/jquery/2.0.2/jquery.min.js', false, null);
    } else {
        // Other -> jQuery 1.x
        wp_register_script('jquery', '//ajax.googleapis.com/ajax/libs/jquery/1.10.1/jquery.min.js', false, null);
    }
}

wp_deregister_script() は、Wordpress がデフォルトで登録済みのハンドルの上書きに必要です。つまり、ハンドル ’jquery’ は登録済み。という事。

WordPress で登録済みの「スクリプト用ハンドル」一覧は以下にあります。

• Function Reference/wp_register_script « WordPress Codex（英語）

引数の詳細も上記公式サイトから。今回は外部の jQuery を参照させているため、クエリストリングを削除させるパラメータを喰わせています。

管理者チェックをしているのは、ダッシュボードの jQuery を別バージョンに差し替えると一部機能が動かなかったためです。というか、PC向けは差し替えないほうがいいのかも。という気もしなくはありませんが。詳細は不明です。

自前のテンプレートでjQueryを読ませる場合 - プラグインとの重複を避ける（wp_enqueue_script）

プラグインの jQuery 読み込みとの重複を回避しつつ、自前テンプレートで jQuery を読み込ませるには、自前テンプレート内で以下のように記述します。

<?php wp_enqueue_script('jquery');

詳細仕様は公式サイトを確認ください。

• Function Reference/wp_enqueue_script « WordPress Codex（英語）

こうすれば、jQuery を読んでいるプラグインを無効化しても jQuery を読んでくれますし、プラグインを有効化しても、（まっとうな書き方のプラグインなら）重複読み込みされません。

実は、今回の主要件は、プラグイン「WordPress Popular Posts」が、設定・訪問者によって jQuery を読んだり読まなかったりするので、テンプレート側で確実に jQuery を読ませたかった事、とか、モバイル・PC向けに違う ver の jQuery を使わせたい。とかとかから色々掘っていって辿り着いた。という感じ。

しかし WordPress は設計がしっかりしているので本当に助かります。