
the_feed_link()とは?
the_feed_link()
は
サイトのフィードURLへのリンクをHTMLで出力する関数
です。
「フィード」とはRSSやAtomなどのXML形式の更新情報のこと。
この関数を使えば、ユーザーが購読できるフィードへのリンクを簡単に表示できます。
the_feed_link()の基本の書式
the_feed_link( string $anchor = '', string $feed = '' )
the_feed_link()の引数
引数 | 型 | 説明 |
---|---|---|
$anchor | string | リンクテキスト(例:「RSSを購読」)。空の場合はフィードURLがテキストになる |
$feed | string | フィードタイプ(例:rss2 , rss , atom )。空ならデフォルト(rss2 ) |
the_feed_link()の戻り値
なし(HTMLを直接echoで出力します)
the_feed_link()の出力されるHTML例
例えば:
the_feed_link('RSSを購読');
出力されるHTML:
<a href="https://example.com/feed/">RSSを購読</a>
esc_url()
でエスケープ済みrel="alternate"
属性は自動では付かない(必要なら自分で付ける)
フィードの種類
WordPressは複数のフィードフォーマットをサポートしています。
値 | 説明 |
---|---|
rss2 (デフォルト) | RSS 2.0 |
rss | RSS 0.92 |
rdf | RDF |
atom | Atom |
フィードのURL例
rss2
:https://example.com/feed/
rss
:https://example.com/feed/rss/
rdf
:https://example.com/feed/rdf/
atom
:https://example.com/feed/atom/
the_feed_link()の具体例
1. デフォルトのRSS2フィードリンクを出す
the_feed_link('RSSを購読');
2. Atomフィードリンクを出す
the_feed_link('Atomで購読', 'atom');
出力:
<a href="https://example.com/feed/atom/">Atomで購読</a>
3. アンカーテキストを指定しない
the_feed_link();
出力:
<a href="https://example.com/feed/">https://example.com/feed/</a>
カスタムHTMLを付けたい場合
the_feed_link()は出力をカスタマイズしにくいため、
自分でHTMLを組むことも多いです。
get_feed_link()と組み合わせる
get_feed_link()
はURLだけを取得できます。
$url = get_feed_link();
例:カスタムHTML
<?php
$url = get_feed_link('atom');
?>
<a href="<?php echo esc_url($url); ?>" rel="alternate">📡 Atomフィード</a>
the_feed_link()のよくある用途
- サイドバーやフッターに「RSS購読リンク」を設置
- フィードリーダー向けにフィードを案内
- カスタムフィードへのリンク作成
フィルターフック
the_feed_link()
自体には専用のフィルターはありませんが、
内部で呼ばれるget_feed_link()
にはfeed_link
フィルターがあります。
フィルター例:URLを改変する
add_filter('feed_link', function($url, $feed){
if ($feed === 'rss2') {
return $url . '?utm_source=feed';
}
return $url;
}, 10, 2);
the_feed_link()の関連関数
関数 | 内容 |
---|---|
get_feed_link() | フィードURLだけ取得 |
the_feed_link() | HTMLリンクを出力 |
bloginfo('rss2_url') | RSS2フィードURL取得(古い方法) |
bloginfo_rss() | RSS用情報を出力 |
検索エンジンへの通知
WordPressは新しい投稿が公開されると、
フィードを通じて検索エンジンや購読者に更新情報を自動配信します。
the_feed_link()を使うことで、読者が簡単にRSS購読できます。
the_feed_link()のよくある質問
the_feed_link()
でrel属性を付けられる?-
自動では付きません。
get_feed_link()
を使って自分でHTMLを組む方が柔軟です。 - カスタム投稿タイプのフィードをリンクできる?
-
get_post_type_archive_feed_link()
を使います。例:
$url = get_post_type_archive_feed_link('book');
- フィードURLは常に有効?
-
デフォルトでは有効ですが、フィードを無効化するプラグインや設定があると404になります。
カスタマイズ例:フィードアイコンつきリンク
<?php
$url = get_feed_link('rss2');
?>
<a href="<?php echo esc_url($url); ?>" rel="alternate">
📡 RSSを購読
</a>
実用サンプル:ウィジェットでフィードリンク
<div class="rss-widget">
<?php the_feed_link('RSSフィードを購読'); ?>
</div>
the_feed_link()のまとめ
the_feed_link()
はフィードURLへのHTMLリンクを出力する関数$anchor
でリンクテキスト指定$feed
でフォーマット指定(rss2, atomなど)- 柔軟なカスタマイズは
get_feed_link()
推奨 - フィルターでURL改変も可能
ポイント
- RSS購読を案内したいときに活用
- URLだけ欲しいなら
get_feed_link()
esc_url()
は自動で適用済み