ワードプレスで指定のフックに登録された関数を手軽に調べる方法

Tweet

WordPressでフックを使用してカスタマイズをしていると、慣れないうちは思いがけず上手く動かない事もしばしば。使いたいアクションフックやフィルターフックに、どんな関数がどんな順序で登録されているのか調べたい事って、少なからずあるのではないでしょうか。

という事で今回は、指定のアクション／フィルターフックに追加されている関数の一覧を表示できるショートコードを作ってみました。非公開のテストページ上に記述してプレビューで確認できます。

functions.phpにコードを追記

ショートコードを追加するコードです。コピーして、お使いのテーマのfunctions.phpの最後にでも貼り付けて下さい。

13行目のコメントアウトを消すと、さらに詳細を表示できますが、メモリ不足でエラーが出るケースがあるので、コメントアウトしてあります。

2021-08-26　上記の詳細表示によるメモリ関連のエラーで、このページが閲覧できなくなっていたのを修正しました。それに合わせてショートコードも編集してあります。

テスト用ページを作成

投稿ページでも固定ページでもよいのですが、本文に下のコードだけを書いたページを公開状態を「非公開*」にして作成しておきます。何でもいいので、使いたい時に見つけやすいタイトルを付けておいて下さい。ショートコードが動いてしまうので、本来必要なカッコを書いていません。[○○]と、角カッコ？大カッコ？の中に書いてください。

※下書きでも別に問題ありませんが、（私は）うっかり公開してしまいやすいので非公開がおすすめです。

とりあえずwp_footerとなっていますが、この部分を調べたいフックの名前に変更しましょう。このページをブラウザで見れば関数の一覧が表示されます。

例：the_contentを調べる場合

例を挙げておきます。the_contentにフックされている関数を表示するには、以下のショートコードを書きます。

実際の表示

以下は、実際にショートコードの引数をwp_footerとして出力したものです。

wp_footerに登録されている関数

priority：1

1. [wp_enqueue_global_styles]
2. [wp_enqueue_stored_styles]
3. [wp_maybe_inline_styles]

priority：10

1. [the_block_template_skip_link]
2. [00000000366d2d07000000005693da3dmenu_render_on_frontend]
3. [back_to_index]
4. [add_origin_thanks_page]
5. [00000000366d277f000000005693da3dfooter]

priority：20

1. [wp_print_footer_scripts]

priority：99

1. [00000000366d277e000000005693da3dlateInit]

priority：1000

1. [wp_admin_bar_render]

最後に

上の例の中にもありますが、関数名の部分が何だかわからない数字の羅列になってしまっている部分は、add_filterとかする時にfunctionに名前を付けていない場合（無名関数を使用している場合）のようです。

ワードプレスで指定のフックに登録された関数を手軽に調べる方法

この記事は2018年8月5日に公開されました。

Tweet