Release status: stable
|Description||Outputs a list of pages based on what categories they are in as an RSS feed or Google news sitemap.|
|Latest version||2.1.0 (continuous updates)|
|Compatibility policy||Snapshots releases along with MediaWiki. Master is not backward compatible.|
|License||GNU General Public License 2.0 or later|
|Quarterly downloads||6 (Ranked 157th)|
|Translate the GoogleNewsSitemap extension if it is available at translatewiki.net|
|Issues||Open tasks · Report a bug|
The GoogleNewsSitemap extension acts like DynamicPageList (Wikimedia), but instead of outputting a categoryintersection in a wikipage, it makes a special page which outputs such a category-intersection as either an rss feed, an atom feed, or in google news sitemap format.
For example, this can create an rss feed of the last five articles added to category:Published, ordered by the date they were added to the category, as well as a bunch of other things.
This extension was originally made for Wikinews.
It uses the syntax of (stuff in [ ] is optional, stuff in ( ) means potential choices):
Multiple values for categories and notcategories options are separated with a pipe (
| or encoded in urls as
For example if you wanted an rss feed of the last 7 articles added to Category:Foo and Category:Bar but not in Category:Baz, ordered by the date added to Category:Foo such that the one added most recently comes first, you would use the page http://my.wiki.example.com/w/index.php?title=Special:GoogleNewsSitemap?feed=rss&categories=foo%7Cbar¬categories=baz&stablepages=include&qualitypages=include
Just doing Special:GoogleNewsSitemap (or equivalently Special:NewsFeed ) uses the category Published, and the feed type of atom, no notcategories, count of 50, order descending, ordermethod categoryadd, redirects include, stable and quality pages set to only. (These are sucky defaults, you may need to override a lot of them).
See DynamicPageList (Wikimedia) to see what the options do. While they are not exactly the same, they are very similar. The Main exceptions are that the namespace parameter in this extension can also take
:all: as a parameter, and defaults to the main namespace if omitted (instead of all namespaces). The
hourcount parameter specifies the number of hours ago the article could have been added to the first category to be considered for inclusion. It can be disabled by setting it to -1 hours.
- Download and place the file(s) in a directory called
- Add the following code at the bottom of your LocalSettings.php file:
wfLoadExtension( 'GoogleNewsSitemap' );
- Configure as described
- Done – Navigate to Special:Version on your wiki to verify that the extension is successfully installed.
To users running MediaWiki 1.24 or earlier:
The instructions above describe the new way of installing this extension using
If you need to install this extension on these earlier versions (MediaWiki 1.24 and earlier), instead of
wfLoadExtension( 'GoogleNewsSitemap' );, you need to use:
The categories in use by the sitemap format is controlled by the
googlenewssitemap_categorymap system message which maps categories to sitemap keywords. It uses the following format:
The following configuration variables are also taken into account (Shown with their defaults):
$wgGNSMmaxCategories = 6; // Maximum number of categories to look for $wgGNSMmaxResultCount = 50; // Maximum number of results to allow $wgGNSMfallbackCategory = 'Published'; // Fallback category if no categories are specified. $wgGNSMsmaxage = 1800; // squid cache time (separate from memcache time). // $wgGNSMcommentNamespace can be false to mean do not include a <comments> element in the feeds, // or it can be true, to mean use the talk page of the relevent page as the comments page // or it can be a specific namespace number ( or NS_BLAH constant) to denote a specific namespace. // For example, on many Wikinews sites, the comment namespace is Comments (102), not talk. $wgGNSMcommentNamespace = true;
All of these configuration parameters are pretty much self-explanatory. $wgGNSMsmaxage determines how long to cache in squid. This determines how out of date the feed can be. Defaults to 30 minutes. The extension also caches the feed using memcache (or other caching backend) for 12 hours, but that cache is checked to see if there are any new articles before using. The squid cache is not checked as such, so you want the timeout to be set to a low value to avoid entries that are too outdated.
The feed title is set by the
googlenewssitemap_feedtitle system message. It defaults to
[Language Name] [Site Name] [Feed type] feed., for example: "British English MyWiki RSS feed.".
|This extension is being used on one or more Wikimedia projects. This probably means that the extension is stable and works well enough to be used by such high-traffic websites. Look for this extension's name in Wikimedia's CommonSettings.php and InitialiseSettings.php configuration files to see where it's installed. A full list of the extensions installed on a particular wiki can be seen on the wiki's Special:Version page.|
|This extension is included in the following wiki farms/hosts and/or packages:|