Added 'fromdbmaster' param option to WikiPage::loadPageData()
[lhc/web/wiklou.git] / includes / Feed.php
index 782b642..528b5f5 100644 (file)
@@ -1,42 +1,43 @@
 <?php
-
-# Copyright (C) 2004 Brion Vibber <brion@pobox.com>
-# http://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
-
 /**
- * @defgroup Feed Feed
- *
  * Basic support for outputting syndication feeds in RSS, other formats.
+ *
  * Contain a feed class as well as classes to build rss / atom ... feeds
  * Available feeds are defined in Defines.php
  *
+ * Copyright © 2004 Brion Vibber <brion@pobox.com>
+ * http://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
  */
 
+/**
+ * @defgroup Feed Feed
+ */
+
 /**
  * A base class for basic support for outputting syndication feeds in RSS and other formats.
  *
  * @ingroup Feed
  */
 class FeedItem {
-       /**#@+
-        * @var string
-        * @private
+       /**
+        * @var Title
         */
        var $Title = 'Wiki';
        var $Description = '';
@@ -45,12 +46,11 @@ class FeedItem {
        var $Author = '';
        var $UniqueId = '';
        var $RSSIsPermalink;
-       /**#@-*/
 
        /**
         * Constructor
         *
-        * @param $Title String: Item's title
+        * @param $Title String|Title Item's title
         * @param $Description String
         * @param $Url String: URL uniquely designating the item.
         * @param $Date String: Item's date
@@ -68,6 +68,15 @@ class FeedItem {
                $this->Comments = $Comments;
        }
 
+       /**
+        * Get the last touched timestamp
+        *
+        * @return String last-touched timestamp
+        */
+       public function getLastMod() {
+               return $this->Title->getTouched();
+       }
+
        /**
         * Encode $string so that it can be safely embedded in a XML document
         *
@@ -97,9 +106,9 @@ class FeedItem {
         * @param $uniqueId String: unique id for the item
         * @param $RSSisPermalink Boolean: set to true if the guid (unique id) is a permalink (RSS feeds only)
         */
-       public function setUniqueId($uniqueId, $RSSisPermalink = False) {
+       public function setUniqueId($uniqueId, $RSSisPermalink = false) {
                $this->UniqueId = $uniqueId;
-               $this->RSSIsPermalink = $isPermalink;
+               $this->RSSIsPermalink = $RSSisPermalink;
        }
 
        /**
@@ -111,6 +120,16 @@ class FeedItem {
                return $this->xmlEncode( $this->Title );
        }
 
+       /**
+        * Get the DB prefixed title
+        *
+        * @return String the prefixed title, with underscores and
+        *  any interwiki and namespace prefixes
+        */
+       public function getDBPrefixedTitle() {
+               return $this->Title->getPrefixedDBKey();
+       }
+
        /**
         * Get the URL of this item; already xml-encoded
         *
@@ -135,8 +154,8 @@ class FeedItem {
         * @return String
         */
        public function getLanguage() {
-               global $wgContLanguageCode;
-               return $wgContLanguageCode;
+               global $wgLanguageCode;
+               return $wgLanguageCode;
        }
 
        /**
@@ -303,7 +322,7 @@ class RSSFeed extends ChannelFeed {
                <item>
                        <title><?php print $item->getTitle() ?></title>
                        <link><?php print $item->getUrl() ?></link>
-                       <guid<?php if( $item->RSSIsPermalink ) print ' isPermaLink="true"' ?>><?php print $item->getUniqueId() ?></guid>
+                       <guid<?php if( !$item->RSSIsPermalink ) print ' isPermaLink="false"' ?>><?php print $item->getUniqueId() ?></guid>
                        <description><?php print $item->getDescription() ?></description>
                        <?php if( $item->getDate() ) { ?><pubDate><?php print $this->formatTime( $item->getDate() ) ?></pubDate><?php } ?>
                        <?php if( $item->getAuthor() ) { ?><dc:creator><?php print $item->getAuthor() ?></dc:creator><?php }?>
@@ -397,9 +416,9 @@ class AtomFeed extends ChannelFeed {
                <?php if( $item->getAuthor() ) { ?><author><name><?php print $item->getAuthor() ?></name></author><?php }?>
        </entry>
 
-<?php /* FIXME need to add comments
+<?php /* @todo FIXME: Need to add comments
        <?php if( $item->getComments() ) { ?><dc:comment><?php print $item->getComments() ?></dc:comment><?php }?>
-      */
+         */
        }
 
        /**