この記事は最後に更新してから1年以上経過しています。

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


お勧め

has_category(2012年1月17日 更新)

bool has_category( [ mixed $category = '' [ , mixed $post = null ] ] )
投稿記事がカテゴリーに属しているか調べる。

comments_template(2018年5月27日 更新)

void comments_template( string $file = '/comments.php' , bool $separate_comments = false )
投稿ページ(post)または単一ページ(page)のコメント情報を取得し、コメント表示・投稿用のテンプレートファイルを読み込んで表示する。

is_taxonomy_hierarchical(2018年5月27日 更新)

bool is_taxonomy_hierarchical( string $taxonomy )
タクソノミーに階層(親子)関係があるか調べる。

send_confirmation_on_profile_email(2018年5月27日 更新)

void send_confirmation_on_profile_email()
メールアドレス変更を確認するメールを送信する。

get_the_modified_time(2023年9月20日 更新)

string | int | false get_the_modified_time( [ string $format = '' [ , int | WP_Post $post = null ] ] )
パラメータ$formatで指定したフォーマットで投稿の更新時刻を取得する。