WordPressのフィルターフックを活用する方法

ホーム
バックエンド
WordPressのフィルターフックを活用する方法

2023.04.6

WordPressのフィルターフックを活用する方法

WordPressのフィルターフックって何？

ナカイ君: WordPressのフィルターフックについてわかりやすく教えてほしいんだけど。

世界のアオキ: OK、フィルターフックってのは、WordPressがデータを表示する前にそのデータを変更するために使う仕組みだよ。テキストの加工やカスタムフィールドの値の調整など、表示する内容を動的に変更したい場合に非常に便利な機能だね。

ナカイ君: もっと具体的に教えてくれない?

世界のアオキ: そうだね。例えば、投稿の内容に自動で特定のテキストを追加したいとか、特定のショートコードを動的に置き換えたい場合にフィルターフックを使うんだ。

わかりやすいコード例

ナカイ君: わかりやすいコードがあれば教えてほしいな。

世界のアオキ: もちろんだよ。投稿の内容に自動でフッターメッセージを追加したい場合、こんなコードを使うんだ。

function add_footer_message($content) {
    return $content . '<footer>ここにフッターメッセージを追加。</footer>';
}
add_filter('the_content', 'add_footer_message');

the_contentは、投稿の本文を表示する際に適用されるフィルターフックだよ。

具体的にどうやって使うの？

ナカイ君: 具体的にはどうやって使うの？

世界のアオキ: このコードをテーマのfunctions.phpファイルやプラグインのファイルに追加するんだ。そうすると、サイト上で投稿の内容が表示されるたびに、自動的にフッターメッセージが追加されるようになるんだ。

ナカイ君: 他のパターンがあれば教えてほしいな。

世界のアオキ: 了解だよ。例えば、特定のショートコードをカスタムフィールドの値で動的に置き換えたい場合は、こんな感じでフィルターフックを使うことができるんだ。

function replace_shortcode_with_custom_field($content) {
    global $post;
    $custom_field_value = get_post_meta($post->ID, 'custom_field_key', true);
    $content = str_replace('[custom_shortcode]', $custom_field_value, $content);
    return $content;
}
add_filter('the_content', 'replace_shortcode_with_custom_field');

これで、投稿の中に[custom_shortcode]というショートコードがあれば、それがカスタムフィールドの値に置き換えられるよ。

ナカイ君: そうやって使えばいいんだね。

世界のアオキ: そういうわけで、フィルターフックを使えば、表示するデータを柔軟にカスタマイズできるんだ。ただし、コードを追加する時は、サイトの動作に影響が出ないように注意してね。

ナカイ君: わかった、ありがとう！