the_excerpt_rss()

Q: フィード内の抜粋にリンクを追加できますか？

excerpt_more フィルターを使うと、「続きを読む」のリンクを追加できます。 <?phpfunction rss_excerpt_more($more) { return '... <a href="' . get_permalink() . '">続きを読む</a>';}add_filter('excerpt_more', 'rss_excerpt_more');?>

Q: 抜粋のHTMLタグを保持する方法は？

デフォルトでは the_excerpt_rss() ではHTMLが削除されますが、get_the_excerpt() を使用し、wp_kses_post() で特定のHTMLを許可することが可能です。

Function

2025/3/28 Friday2025/4/1 Tuesday

the_excerpt_rss() は、RSSフィードに投稿の要約（抜粋）を表示するテンプレートタグです。WordPressで投稿のフィードを生成する際、フィード内に投稿内容の要約を出力するために使用されます。

機能の説明

the_excerpt_rss() は、RSSフィードで投稿の抜粋を表示するための関数です。これは the_excerpt() と同様に、投稿編集画面で入力した抜粋、または投稿本文の冒頭部分（デフォルトで55文字）を取得します。HTMLタグは削除され、プレーンテキストで表示されます。

シンプルなコード例

<?php the_excerpt_rss(); ?>

このコードを使うと、RSSフィードに各投稿の抜粋が表示されます。抜粋が設定されていない場合は、本文の最初の部分が表示されます。

使い方の解説

the_excerpt_rss() は、WordPressのRSSフィードで投稿の内容を短く伝える際に利用されます。テーマファイル内での使用例として、RSSフィードのカスタマイズを行う際に役立ちます。

使用例：RSSフィードのカスタマイズ

<?php if (have_posts()) : while (have_posts()) : the_post(); ?>
    <item>
        <title><?php the_title_rss(); ?></title>
        <link><?php the_permalink_rss(); ?></link>
        <description><?php the_excerpt_rss(); ?></description>
    </item>
<?php endwhile; endif; ?>

the_title_rss(): RSSフィード内で投稿のタイトルを表示します。
the_permalink_rss(): 投稿のリンクを表示します。
the_excerpt_rss(): 抜粋または投稿本文の冒頭を表示します。

一緒に使うことが多い関連タグ

`the_title_rss()`

RSSフィードで投稿のタイトルを表示するためのタグです。

<item>
    <title><?php the_title_rss(); ?></title>
</item>

`the_permalink_rss()`

投稿のリンクをRSSフィードに表示します。

<item>
    <link><?php the_permalink_rss(); ?></link>
</item>

使用例

<item>
    <title><?php the_title_rss(); ?></title>
    <link><?php the_permalink_rss(); ?></link>
    <description><?php the_excerpt_rss(); ?></description>
</item>

これらのテンプレートタグは、RSSフィード内の各投稿アイテムで使われ、the_excerpt_rss() と組み合わせることでフィード内の投稿情報を簡潔に表示できます。

追加情報を取得したい場合

フィードの形式をカスタマイズする

the_excerpt_rss() の出力をカスタマイズしたい場合、excerpt_length フィルターを利用することができます。

<?php
function custom_rss_excerpt_length($length) {
    return 30; // RSSフィードで抜粋を30文字に制限
}
add_filter('excerpt_length', 'custom_rss_excerpt_length');
?>

このコードで、RSSフィード内の抜粋を30文字に制限しています。

`get_the_excerpt()`で取得できる情報

<?php echo get_the_excerpt(); ?>

name：投稿の要約（抜粋）
length：文字数はデフォルトで55文字
HTML：HTMLタグは削除される

`get_the_content()` で取得できる本文情報

<?php echo get_the_content(); ?>

name：投稿の全文
HTML：HTMLタグを含む
画像：埋め込まれた画像も含む

想定されるトラブル

HTMLタグが表示されない

the_excerpt_rss() は、HTMLタグをすべて削除します。

解決策

get_the_excerpt() を使用し、wp_kses_post() で許可するHTMLタグを指定します。

<?php echo wp_kses_post(get_the_excerpt()); ?>

抜粋の長さがフィードで足りない

デフォルトの55文字ではフィードで伝えたい情報が不足する場合があります。

解決策

excerpt_length フィルターで抜粋の長さを変更します。

<?php
function increase_rss_excerpt_length($length) {
    return 100; // 100文字に変更
}
add_filter('excerpt_length', 'increase_rss_excerpt_length');
?>

Q&A

RSSフィードで抜粋が表示されないのはなぜですか？

投稿に「抜粋」が設定されていない場合、本文の最初の部分が表示されます。それもない場合、フィードが空になることがあります。

フィード内の抜粋にリンクを追加できますか？

excerpt_more フィルターを使うと、「続きを読む」のリンクを追加できます。

<?php
function rss_excerpt_more($more) {
    return '... <a href="' . get_permalink() . '">続きを読む</a>';
}
add_filter('excerpt_more', 'rss_excerpt_more');
?>

抜粋のHTMLタグを保持する方法は？

デフォルトでは the_excerpt_rss() ではHTMLが削除されますが、get_the_excerpt() を使用し、wp_kses_post() で特定のHTMLを許可することが可能です。

まと

the_excerpt_rss() は、RSSフィード内で投稿の要約を表示するための便利なテンプレートタグです。フィードを通じてユーザーに簡潔に投稿内容を伝えるため、アーカイブページや検索結果ページの要約とは異なり、HTMLタグはすべて取り除かれます。

the_title_rss() や the_permalink_rss() と組み合わせることで、フィード内の投稿情報を整理して表示できます。また、excerpt_length や excerpt_more フィルターを使えば、抜粋の長さや表示方法を柔軟にカスタマイズすることが可能です。