概要
bloginfo_rssフィルタは、WordPressのフィード向けのブログ情報を出力するために使用されます。このフィルタは、RSSフィードに特定のデータを追加したり、デフォルトの出力を変更したりする際に役立ちます。主に次のような機能を実装する際によく使われます。
- ブログタイトルの変更
- フィード内の著者情報のカスタマイズ
- フィードの説明の追加や変更
- サイトのURLやホームページのリンク修正
- 特定のメタデータの追加
- デフォルトのフィード項目の削除
- フィードのエンコーディング属性の変更
- フィード内にカスタムリンクを追加
構文
add_filter('bloginfo_rss', 'your_custom_function');
パラメータ
$output: フィルタを適用するブログ情報の出力内容。
戻り値
- フィルタを適用した後のブログ情報。
関連する関数
使用可能なバージョン
bloginfo_rssフィルタはWordPress 2.1.0以降で使用可能です。特定のバージョンで非推奨または削除されたという情報はありません。
コアファイルのパス
wp-includes/general-template.php
この関数のアクションでの使用可能性
| アクション | 使用可能性 |
|---|---|
| mu_plugin_loaded | |
| registered_post_type | |
| plugins_loaded | |
| wp_roles_init | |
| setup_theme | |
| after_setup_theme | |
| set_current_user | |
| init | |
| register_sidebar | |
| wp_loaded | |
| send_headers | |
| parse_query | |
| pre_get_posts | |
| wp | |
| template_redirect | |
| get_header | |
| wp_head | 〇 |
サンプルコード
サンプルコード1 – ブログタイトルを変更する
add_filter('bloginfo_rss', function($output) {
return '新しいブログタイトル';
});
このサンプルコードは、RSSフィード内のブログタイトルを「新しいブログタイトル」に変更します。
サンプルコード2 – RSSフィードの著者名をカスタマイズ
add_filter('bloginfo_rss', function($output) {
return 'カスタム著者名 - ' . $output;
});
このコードは、RSSフィードの著者名を「カスタム著者名 – 」という前置きを追加して出力します。
サンプルコード3 – RSSフィードにカスタム説明を追加
add_filter('bloginfo_rss', function($output) {
return 'カスタム説明: ' . $output;
});
このサンプルでは、RSSフィードの説明部分に「カスタム説明: 」を追加しています。
サンプルコード4 – フィード内の特定のリンクを修正
add_filter('bloginfo_rss', function($output) {
return str_replace('http://old-url.com', 'http://new-url.com', $output);
});
このコードは、RSSフィード内の古いURLを新しいURLに変更します。
サンプルコード5 – フィードのエンコーディングを変更
add_filter('bloginfo_rss', function($output) {
return mb_convert_encoding($output, 'UTF-8');
});
このサンプルでは、RSSフィードの出力をUTF-8エンコーディングに変更しています。