1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103
|
<?php
/**
* Copyright © 2004 Brooke Vibber <bvibber@wikimedia.org>
* https://www.mediawiki.org/
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License as published by
* the Free Software Foundation; either version 2 of the License, or
* (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License along
* with this program; if not, write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
* http://www.gnu.org/copyleft/gpl.html
*
* @file
*/
namespace MediaWiki\Feed;
/**
* Generate an RSS feed.
*
* @ingroup Feed
*/
class RSSFeed extends ChannelFeed {
/**
* Format a date given a timestamp. If a timestamp is not given, nothing is returned
*
* @param string|int|null $ts Timestamp
* @return string|null Date string
*/
private function formatTime( $ts ) {
if ( $ts ) {
return gmdate( 'D, d M Y H:i:s \G\M\T', (int)wfTimestamp( TS_UNIX, $ts ) );
}
return null;
}
/**
* Output an RSS 2.0 header
*/
public function outHeader() {
$this->outXmlHeader();
// Manually escaping rather than letting Mustache do it because Mustache
// uses htmlentities, which does not work with XML
$templateParams = [
'title' => $this->getTitle(),
'url' => $this->xmlEncode(
$this->urlUtils->expand( $this->getUrlUnescaped(), PROTO_CURRENT ) ?? ''
),
'description' => $this->getDescription(),
'language' => $this->xmlEncode( $this->getLanguage() ),
'version' => $this->xmlEncode( MW_VERSION ),
'timestamp' => $this->xmlEncode( $this->formatTime( wfTimestampNow() ) )
];
print $this->templateParser->processTemplate( 'RSSHeader', $templateParams );
}
/**
* Output an RSS 2.0 item
* @param FeedItem $item Item to be output
*/
public function outItem( $item ) {
// Manually escaping rather than letting Mustache do it because Mustache
// uses htmlentities, which does not work with XML
$templateParams = [
"title" => $item->getTitle(),
"url" => $this->xmlEncode(
$this->urlUtils->expand( $item->getUrlUnescaped(), PROTO_CURRENT ) ?? ''
),
"permalink" => $item->rssIsPermalink,
"uniqueID" => $item->getUniqueID(),
"description" => $item->getDescription(),
"date" => $this->xmlEncodeNullable( $this->formatTime( $item->getDate() ) ),
"author" => $item->getAuthor()
];
$comments = $item->getCommentsUnescaped();
if ( $comments ) {
$commentsEscaped = $this->xmlEncode(
$this->urlUtils->expand( $comments, PROTO_CURRENT ) ?? ''
);
$templateParams["comments"] = $commentsEscaped;
}
print $this->templateParser->processTemplate( 'RSSItem', $templateParams );
}
/**
* Output an RSS 2.0 footer
*/
public function outFooter() {
print "</channel></rss>";
}
}
/** @deprecated class alias since 1.40 */
class_alias( RSSFeed::class, 'RSSFeed' );
|