【WordPress】これでわかる！アクションフックについて解説します

WordPressのアクションフックって何なの？そもそもフックがよく分からないんだけど、、、誰か解説してほしいなあ

本記事は上記のような疑問に役立つ記事となっております。

WordPressの開発を行なっていると「フック」(hook)という概念が出てきますが、正直最初は概念がよく分からないですよね。

そのためこの記事ではWordPress開発初心者の方に向けてフックが何か、またアクションフックが何かについて詳しく解説していこうと思います。

フックやアクションフックがわからない、という方は是非ご覧ください。

フックとは

では早速ですがフックについて見ていきましょう。

フックとは、WordPress内で関数などの処理を行うタイミングを決めるものです。

調べていると色々な言い回しがあって理解にしにくいフックですが、「タイミングを決めるもの」という表現が個人的にしっくりくるかなと思います。

ちなみに、「フック = hook = 引っ掛ける」などの意味があります。

WordPressで作ったサイトにはプログラミングを処理するタイミングがあります。

例えば「header部分を読み込んだ後」や「WordPressのコードが完全に読み込まれた後」というようにフックによって処理をするタイミングを決めることが出来ます。

例えば以下のようなフックがあります。

・wp_loaded：WordPressが完全に読み込まれた後

・the_posts:投稿データが内部処理された時

・admin_bar_init：Adminバーの初期設定時

などなど。

フック自体はかなり数が多く、全てを使いこなすのは不可能かもしれません。

そのため、必要に応じて使いたいものを調べて使う、くらいで良いと思います。

そして上記に挙げたもの、これらはフックの中でもアクションフックと呼ばれるもので、アクションフック以外にはフィルターフックというものもあります。

今回はこのアクションフックについて深掘りしていきたいと思います。

アクションフックとは

アクションフックとは、関数などの処理を任意の場所で処理出来る機能です。

例えば、WEBサイトを読み込む時にはWordPressのindex.phpやstyleシートはもちろん、single.phpやfunctions.phpなどのファイルも全て読み込むわけですが、全てのコードを一気に処理してしまうと正しく動作してくれなかったり、望む結果が得られなかったりします。

そのため、任意の場所でアクションフックを設定することで「このタイミングでこの処理をしてね」という指示をプログラムし、ブラウザに正しく処理するタイミングを指示できるということです。

例えば以下のコードは、functions.phpで書いているカスタム投稿タイプを作っている関数ですが、この関数を処理するタイミングをアクションフックで決めることが出来ます。

add_action('init',function(){
	register_post_type('staff',[
		'label' =>'従業員',
		'public' =>true,
		'menu_position'=>5,
		'menu_icon'=>'dashicons-businessman',
		'supports'=>['title','thumbnail','editor','page-attributes'],
		'hierarchical'=>true
	]);
});

上記では、'init'というアクションフックを使っていますが、このアクションフックが作動するタイミングはWordPress.orgに以下のように書かれています。

Fires after WordPress has finished loading but before any headers are sent.
引用元:WordPress.ORG

上記を英訳すると以下のようになります。

・WordPressの読み込みが完了した後、headerが送信される前に発火します。

つまり、WordPressの読み込みが終わってから、headerのコードが読み込まれる前に処理しますよということですね。

headerといえば通常、サイトの一番上の方に位置するものですので、ほぼほぼ一番最初に読み込まれるアクションと考えてもらえればと思います。

このように、処理する場所を決める機能を「アクションフック」と言います。

実際にアクションフックの書き方についても見ていきましょう。

アクションフックの書き方

では次にアクションフックの書き方ですが、基本的には以下のように書きます。

<?php add_action('フック名','実行する関数' ); ?>

となります。

「add_action」は関数にフックをつけるための書き方で、「アクションフックを付与する時に書くものなんだな」と覚えて下さい。

先に記述した以下のコードでは、

add_action('init',function(){
	register_post_type('staff',[
		'label' =>'従業員',
		'public' =>true,
		'menu_position'=>5,
		'menu_icon'=>'dashicons-businessman',
		'supports'=>['title','thumbnail','editor','page-attributes'],
		'hierarchical'=>true
	]);
});

initがフック名で実行する関数のところに関数の内容が書かれていることが分かりますね。

これが基本的な書き方です。