Jump to content

Extension:RSS

課題管理システム: #MediaWiki-extensions-RSS
ショートカット: RSS
From mediawiki.org
This page is a translated version of the page Extension:RSS and the translation is 17% complete.
Languages:
MediaWiki 拡張機能マニュアル
RSS
リリースの状態: 安定
実装 タグ
説明 ウィキページ上にRSSフィードを表示する
作者 K. Elliott-McCrea, mutante, D. Kinzler, Rdb, Mafs, Alxndr, T. Gries, C. Reigrut, K001, J. De Dauw, J. Phoenix, M.A. Hershberger
最新バージョン 2.25.1 (2017-04-21)
MediaWiki 1.23+
PHP 5.4+
データベースの変更 いいえ
パラメーター
  • $wgRSSUserAgent
  • $wgRSSDateDefaultFormat
  • $wgRSSNamespaces
  • $wgRSSUrlNumberOfAllowedRedirects
  • $wgRSSFetchTimeout
  • $wgRSSItemMaxLength
  • $wgRSSAllowImageTag
  • $wgRSSProxy
  • $wgRSSCacheAge
  • $wgRSSAllowLinkTag
  • $wgRSSCacheCompare
  • $wgRSSUrlWhitelist
タグ
‎<rss>
使用するフック
ライセンス GNU 一般公衆利用許諾書 2.0 以降
ダウンロード
拡張機能をダウンロード
Git [?]:

README
RELEASE-NOTES
例 spookyverse.de (example 1, example 2) (see the wiki's main page where the rss feeds are displayed)
translatewiki.net で翻訳を利用できる場合は、RSS 拡張機能の翻訳にご協力ください
問題点 未解決のタスク · バグを報告

RSS拡張機能は一つ以上のRSSフィードをウィキページで標準又は利用者が定義可能な形式で提供(表示)します。

インストール

  • ダウンロードして、ファイルをextensions/フォルダー内のRSSという名前のディレクトリ内に配置します。
    開発者とコード寄稿者は、上記の代わりに以下を使用してGitからインストールします:
    cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/RSS
  • 以下のコードを LocalSettings.php ファイルの末尾に追加します: 
    wfLoadExtension( 'RSS' );
  • Yes 完了 – ウィキの「Special:Version」に移動して、拡張機能が正しくインストールされたことを確認します。

使用法

Use one section between ‎<rss>-tags for each feed. The rss element may contain parameters if you provide them as attributes to the rss element:

RSSタグ内のパラメータ
任意のタグ属性 コメント
template="name" 'name' (default: rss-item) is the name of a page in the MediaWiki template namespace (default: MediaWiki:Rss-item), which comprises the name of another template (default: MediaWiki:Rss-feed since version 1.90; Template:RSSPost before version 1.90) and a list of named variables of RSS Feed channel subelements (item), these values then being passed to this other template to finally format the RSS items.

Note that when a template is specified here, the extension doesn't pass to it the name of a - default - formatting template. The template specified here needs to take care of that by hard-coding the name of the other template. I.e the default template process is completely aborted.

templatename="Pagename" or

templatename="Namespace:Pagename"

 'Pagename' is the name of a template page which is used in the default template MediaWiki:Rss-item (defining the channel subelements) to finally format the RSS items; the template can be in the template namespace (first case denotes a page Template:Pagename) or any other namespace (second case uses the full specified form [[Namespace:Pagename]])
max="n" show at most n channel subelements (items)
highlight="term1 term2 ..." highlight terms in different colours
filter="term1 term2 ..." show only RSS items with at least one of the terms
filterout="term1 term2 ..." do not show any RSS item containing any of these terms
reverse display the RSS items in reverse order (since Version 2.25 seems to be a bug regarding the reverse sorting which may be worked around like this:

in \extensions\RSS\RSSParser.php edit line 62: $this->reversed = true; -> this needs to be set to false if entries should be sorted as dates desc (newest first) when the reverse variable is used in ‎<rss>)

date="(Y-m-d H:i:s)" date format string[1]
(since r111347)
item-max-length="1000" limits the number of character in item descriptions (since r111350)

This is not correctly working in v2.18 see T32377.

カテゴリの追跡

All pages in a wiki which use the RSS extension are automatically added to the RSS tracking Category:Pages_with_RSS_feeds.

チャンネル準要素や RSS フィードの設定に使うテンプレート

A manual setup is not necessarily required. You can skip this complicated documentation section.
One template name has been changed: MediaWiki:Rss-feed since version 1.90; Template:RSSPost before version 1.90.[2]

The RSS extension renders feeds on wiki page by using two templates in the MediaWiki system namespace, which can be changed, or which wiki admins can redirected to user-editable namespaces. The mechanism is perhaps not easy to understand, but after its installation, the extension starts with a useful set of templates; a manual set-up is not required.

If a template is not specified, then the one in MediaWiki:Rss-item is used and determines only which RSS feed channel subelements (items) are used. The other template MediaWiki:Rss-feed determines how the complete feed is shown on wiki pages i.e. how and which channel items are shown or listed.

This is the template MediaWiki:Rss-item (since version 1.90) which determines which item elements are used.[2] 

{{ MediaWiki:Rss-feed \
| title = {{{title}}} \
| link = {{{link}}} \
| date = {{{date}}} \
| author = {{{author}}} \
| description = {{{description}}} }}

The selected items are passed to the other template MediaWiki:Rss-feed (since version 1.90)[2] which determines how the RSS Feed is rendered on the wiki pages. It iterates over each <item> of the RSS feed and substitutes the value of each element found there, e.g. <title>, <link>, <date>, <author>, etc.

Basic MediaWiki:Rss-feed template: 

; '''<span class='plainlinks'>[{{{link}}} {{{title}}}]</span>'''
: {{{description}}}
: {{{author}}} {{{date}}}<!-- don't use newline here -->

An alternative improved MediaWiki:Rss-feed template requires the Extension:ParserFunctions : 

<!-- The second is an improved version which requires Extension:ParserFunctions --> \
; '''<span class='plainlinks'>[{{{link}}} {{{title}}}]</span>''' \
{{#if: {{{description|}}} \
|: {{{description}}}}}{{#if: {{{author|}}} \
| {{#if: {{{date|}}} |: — {{{author}}} {{{date}}}}} \
| {{#if: {{{author|}}}|: — {{{author}}}}} {{#if: {{{date|}}}|:{{{date}}}}}|}}<!-- don't use newline here -->

例

The following code renders the four recent items of the Wikimedia blog feed on the present page and highlights some terms.

The layout depends on the content of feed template MediaWiki:Rss-feed and also of the item template MediaWiki:Rss-item as mentioned above:

<rss max=4 highlight="community wiki foundation">https://wikimediafoundation.org/news/feed/</rss>
OpenAI “rogue” agent activities found on Wikimedia projects
The Wikimedia Foundation found "rogue" OpenAI agents editing wikis, trying to exploit a hosted tool, and driving heavy traffic to Wikimedia projects.
The post <a href="https://wikimediafoundation.or…
Selena Deckelmann 2026-10-05 17:02:58
Human knowledge at stake: Wikimedia Foundation makes its case at the United Nations General Assembly
Wikipedia powers AI, but the models that rely on its data are straining its infrastructure and the larger human knowledge ecosystem online.
The post <a href="https://wikimediafoundation.org/news/202…
Wikimedia Foundation 2026-09-30 15:53:35
Wikimedia Foundation Statement on US staff unionization
Today, eligible Wikimedia Foundation staff in the United States voted in favor of union representation. The election was conducted by the National Labor Relations Board (NLRB) by secret ballot.
The …
Wikimedia Foundation 2026-09-03 23:24:55
Wikimedia Foundation welcomes Rena Kokalari as new Chief People Officer
The Wikimedia Foundation, the global nonprofit that operates Wikipedia, today announced the appointment of Rena Kokalari as its new Chief People Officer.
The post <a href="https://wikimediafoundati…
Wikimedia Foundation 2026-08-04 15:51:02


環境設定

Add any one of the following settings you want to customize to your LocalSettings.php .

Configuration settings in RSS.php
parameter default comment
$wgRSSCacheAge 3600 (one hour) Store entries in memcached for this many seconds
$wgRSSCacheCompare false Check cached content, if available, against remote. $wgRSSCacheCompare should be set to false or a timeout in seconds which is less than $wgRSSCacheAge after which a comparison will be made.
$wgRSSFetchTimeout 15 read timeout in seconds
$wgRSSUserAgent 'MediaWikiRSS/<Version> (+https://www.mediawiki.org/wiki/Extension:RSS) / MediaWiki RSS extension' User-Agent to use for fetching feeds
$wgRSSNamespaces null Ignore the RSS tag in all but the namespaces listed here

null means the ‎<rss> tag can be used anywhere

$wgRSSUrlWhitelist array() (deny any URL = no whitelisted URLs) URL whitelist of RSS Feeds, the whitelist is empty by default and no URLs are allowed. If there are items in the array, and the used feed URL isn't in the array, it will not be allowed.
Use array( "*" ) if you as admin want to allow anyone to use any feed Url. In case your whitelist entries are ignored, please use square brackets for the array instead, e.g. $wgRSSUrlWhitelist = [ 'URL1', 'URL2', 'URL3', ];
$wgRSSUrlNumberOfAllowedRedirects 0 (no redirects are allowed) Maximum number of redirects to follow. This should only be used when the target URLs are trusted to avoid attacks on intranet services accessible by HTTP.
$wgRSSProxy false Optional proxy server url and port number to be used for fetching feeds.

false: no proxy used
If you need a proxy for certain urls and not for others:
Example for disabling proxy use for certain urls in RSSParser::fetchRemote how to use a regular expression for a conditional proxy switching.

$wgRSSDateDefaultFormat "Y-m-d H:i:s" default date format[1] for RSS publication dates
$wgRSSItemMaxLength

(deactivated in version 2.12 r113297; will be activated later.)[3]

200 default maximum length of item descriptions (since r111350)
$wgRSSAllowLinkTag false to allow active links in feed items
$wgRSSAllowImageTag false If you allow to see images in feed items. Do not confuse this parameter with $wgAllowImageTag of MediaWiki core, Display of images causes privacy problems, because the image is fetched in the browser context, so the (image-) server log will contain data of the requesting browser, see the discussion here. Note that since 2013 due to the MediaWiki sanitizer, image tags which have the form <img src="blah"/> are not parsed correctly by the MediaWiki core sanitizer and are not displayed irrespective of this setting (see T48443).

If you want the image to show, set this to true in LocalSettings.php and in \extensions\RSS\RSSParser.php remove this part at lines 485 

if ( isset( $wgRSSAllowImageTag ) && $wgRSSAllowImageTag ) {
            $extraInclude[] = "img";
        } else {
            $extraExclude[] = "img";
        }

技術的な歴史と帰属

RSS extension is a heavily modified version of the engines RSS by Mafs, RSS by Rdb78, RSS by Duesentrieb, and RSSFeed by Mutante.

脚注

  1. ↑ 1.0 1.1 https://php.net/date
  2. ↑ 2.0 2.1 2.2 Former versions before 1.90 used the name Template:RSSPost in the template MediaWiki:Rss-item which thus had the default value 
    {{ RSSPost | title = {{{title}}} | link = {{{link}}} | date = {{{date}}} | author = {{{author}}} }}
  3. ↑ bug30377

関連項目

Retrieved from "https://www.mediawiki.org/w/index.php?title=Extension:RSS/ja&oldid=8613067"