アクションフックの使い方、動作の仕組みを知ればみるみる使いこなせるようになる。よく使うアクションフックを紹介。

値の受け渡しを行わない

add_action('A', 'B')
A(これをtriggerとして) B(この関数を読み込む) 説明
wp_head

wp_head関数が呼び出された時にscriptタグを出力。基本的に全ページのheadタグを出力する時に呼ばれる。

wp_enqueue_scripts ↑sがついてる
スクリプトファイルの読み込みを制御する関数。複数のスクリプトを読み込む時に使う。
$handle スクリプトの識別名
$src スクリプトのパス
$deps 依存スクリプト
$ver スクリプトのバージョン
$in_footer スクリプトの読み込み位置(trueで/body前、falseで/head前)

フックされた関数内で、wp_register_script()wp_enqueue_script()sがついてない。wp_register_style()wp_enqueue_style()が内部で使える。

admin_enqueue_scripts

管理画面でのファイルの読み込み

admin_menu 管理メニューの読み込み
login_enqueue_scripts ログイン画面でのファイルの読み込み

wp_enwurue_scripts

wp_enqueue_style('好きな名前','読み込むcssファイルのパス');
    wp_enqueue_script('好きな名前','読み込むjsファイルのパス');
wp_enqueue_style($handle, $src, $deps, $ver, $media);
引数 説明 初期値
$handle スタイルシートのハンドル名を指定。
文字列に ‘?’ という記号を含むと、それより後の部分はクエリパラメータとしてURL に追加されます。
なし
$src スタイルシートへのパスを指定。 false
$deps 依存する(このスタイルシートより前に読み込まれる必要がある)他のスタイルシートのハンドル名を配列で指定する。
依存関係がない場合は falseを指定する。
array()
$ver 任意のバージョンを指定。
ファイル名にクエリパラメータとして追加され、ブラウザキャッシュ対策にもなる。
false
$media

media属性に関する指定。

wp_enqueue_script

引数 説明 初期値
$handle スクリプトを区別するハンドル名を指定。

文字列に ‘?’ という記号を含むと、それより後の部分はクエリパラメータとしてURL に追加されます。

なし
$src スクリプトへのパスを指定。 false
$deps 依存する(このスクリプトより前に読み込まれる必要がある)他のスクリプトのハンドル名を配列で指定する。
依存関係がない場合は falseを指定する。
array()
$ver 任意のバージョンを指定。
ファイル名にクエリパラメータとして追加され、ブラウザキャッシュ対策になる。
false
$in_footer スクリプトの読み込み位置を指定。trueにするとwp_footer()で読み込める。

第5引数だけ、wp_enqueue_styleの場合と意味合いが異なりますね。

この5つ目の引数 $in_footer をtrueに指定するだけで、wp_enqueue_scriptでのスクリプトの読み込みはwp_footer()で行われるようになります。

第3、第4引数は特に指定する(初期値から変える)必要がなく、第5引数の$in_footerだけ指定したい!という場合

wp_enqueue_script('ハンドル名','スクリプトへのパス', array(), false, true);

array()の部分は依存関係を特に指定しないということなので、falseでも良いです。

第3、第4は省略して最後の引数をtrueにするだけでよい、という記事を見かけたのですが、私はそれでは読み込み位置は変わりませんでした。

is_user_logged_in()

log inしている場合はtrueが返ってくる

has_capユーザーの権限をみる。寄稿者、管理者など。

フィルターフック

値を受け渡しを行う。

WordPressの処理の途中で出力するためのもの。

引数でデフォルトの出力内容が入ってる。

カスタマイズして返り値とできるのが特徴。

document_title_parts
タイトルとURLをコピーしました