feedリンクの制御が簡単になる

説明

WordPress 6.1ではこれまでのバージョンアップ時と同じくらいフィルターが追加されている。今回はその中でも7つのフィルターが追加された feed_links_extra関数に注目した。

feedリンクが出力される仕組み

まずはfeedリンクについて簡単に説明する。feedリンクは、ページのhead要素内に出力されるlink要素のことである。

<link rel="alternate" type="application/rss+xml" title="開発環境 » フィード" href="http://localhost/feed/" />
<link rel="alternate" type="application/rss+xml" title="開発環境 » コメントフィード" href="http://localhost/comments/feed/" />
<link rel="alternate" type="application/rss+xml" title="開発環境 » Hello world! のコメントのフィード" href="http://localhost/hello-world/feed/" />

1つ目と2つ目のlink要素はサイト共通で、 feed_links関数によって出力される。3つ目のlink要素はリクエストされたページに応じて変わるもので、こちらは feed_links_extra関数によって出力される。どちらの関数もwp_headアクションのコールバック関数として登録済みであり、標準ではテーマやプラグインから呼び出す必要はない。

add_action( 'wp_head', 'feed_links', 2 );
add_action( 'wp_head', 'feed_links_extra', 3 );

サイト共通のlink要素の出力は、前提としてテーマが'automatic-feed-links'をサポートしている必要がある。その上で次の2つのフィルターを使って個別に制御できる(WordPress 4.4.0以降)。

feedリンクフィルター
投稿feedリンクapply_filters( 'feed_links_show_posts_feed', true )
コメントfeedリンクapply_filters( 'feed_links_show_comments_feed', true )

例えば、投稿feedリンクを出力したくないなら、次の内容をテーマのfunctions.phpに追加すればよい。

add_filter( 'feed_links_show_posts_feed', '__return_false' );

ページに応じたfeedリンクを制御

バージョン6.1でfeed_links_extra関数に追加されるフィルターは、リクエストされたページに応じて用意されている。

リクエスト条件フィルター
is_singular()$show_post_comments_feed = apply_filters( 'feed_links_extra_show_post_comments_feed', $show_comments_feed );
is_post_type_archive()$show_post_type_archive_feed = apply_filters( 'feed_links_extra_show_post_type_archive_feed', true );
is_category()$show_category_feed = apply_filters( 'feed_links_extra_show_category_feed', true );
is_tag()$show_tag_feed = apply_filters( 'feed_links_extra_show_tag_feed', true );
is_tax()$show_tax_feed = apply_filters( 'feed_links_extra_show_tax_feed', true );
is_author()$show_author_feed = apply_filters( 'feed_links_extra_show_author_feed', true );
is_search()$show_search_feed = apply_filters( 'feed_links_extra_show_search_feed', true );

これらは、リクエスト条件を上から順に判定され、マッチした時点で分岐するようになっている。例えば任意のページの場合(is_singular()がtrue)ならそのページのコメントfeedリンクのデータが生成され、それ以降の判定は行われない。

feed_links関数のフィルターと同様に、各フィルターの返り値にfalseを返すことでリクエストに応じたfeedリンクは出力されなくなる。例えばカテゴリーアーカイブページのfeedリンクを出力したくない場合は、次の内容をテーマのfunctions.phpに追加すればよい。

add_filter( 'feed_links_extra_show_category_feed', '__return_false' );

投稿タグアーカイブページや検索結果ページなどのfeedリンクを出力したくない場合もそれぞれに対応したフィルターのコールバックを追記することになる。バージョン6.1ではリクエストページに応じたfeedリンクの出力が柔軟かつ容易に制御できる。


最終更新 : 2022年11月07日 10:16


お勧め

wp_authenticate(2022年1月31日 更新)

WP_User | WP_Error wp_authenticate( string $username, string $password )
ユーザー認証を行う。

wp_send_json_success(2020年12月10日 更新)

void wp_send_json_success( [ mixed $response = null [ , int $status_code = null [ , int $options = 0 ] ] ] )
AJAXリクエストの成功レスポンスとしてJSON情報を返す。

wp_oembed_get(2014年11月16日 更新)

mixed wp_oembed_get( string $url [ , mixed $args = '' ] )
oEmbedに対応したページの埋め込み用コンテンツを取得する。

setup_postdata(2014年11月16日 更新)

bool setup_postdata( stdClass $post )
投稿記事に関連するグローバル変数を設定する。

the_permalink(2018年5月27日 更新)

void the_permalink( [ mixed $post = 0 ] )
現在の投稿データのパーマリンクを表示する。