API: Page prop=revisions by rev_id or (rev_page, rev_id), depending on mode, because...
[lhc/web/wiklou.git] / includes / Credits.php
index 6721687..ae9377f 100644 (file)
  *  Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
  *
  * @author <evan@wikitravel.org>
- * @package MediaWiki
  */
 
-/**
- * This is largely cadged from PageHistory::history
- */
 class Credits {
-       function showCreditsPage($article) {
-               global $wgOut;
-
-               $fname = 'Credits::showCreditsPage';
 
-               wfProfileIn( $fname );
+       /**
+        * This is largely cadged from PageHistory::history
+        * @param $article Article object
+        */
+       public static function showPage( Article $article ) {
+               global $wgOut;
+       
+               wfProfileIn( __METHOD__ );
        
                $wgOut->setPageTitle( $article->mTitle->getPrefixedText() );
                $wgOut->setSubtitle( wfMsg( 'creditspage' ) );
                $wgOut->setArticleFlag( false );
                $wgOut->setArticleRelated( true );
-               $wgOut->setRobotpolicy( 'noindex,nofollow' );
-
+               $wgOut->setRobotPolicy( 'noindex,nofollow' );
+       
                if( $article->mTitle->getArticleID() == 0 ) {
                        $s = wfMsg( 'nocredits' );
                } else {
-                       $s = Credits::getCredits($article, -1);
+                       $s = self::getCredits($article, -1 );
                }
-
+       
                $wgOut->addHTML( $s );
-
-               wfProfileOut( $fname );
+       
+               wfProfileOut( __METHOD__ );
        }
 
-       function getCredits($article, $cnt, $showIfMax=true) {
-               $fname = 'Credits::getCredits';
-               wfProfileIn( $fname );
+       /**
+        * Get a list of contributors of $article
+        * @param $article Article object
+        * @param $cnt Int: maximum list of contributors to show
+        * @param $showIfMax Bool: whether to contributors if there more than $cnt
+        * @return String: html
+        */
+       public static function getCredits($article, $cnt, $showIfMax=true) {
+               wfProfileIn( __METHOD__ );
                $s = '';
 
-               if (isset($cnt) && $cnt != 0) {
-                       $s = Credits::getAuthorCredits($article);
+               if( isset( $cnt ) && $cnt != 0 ){
+                       $s = self::getAuthor( $article );
                        if ($cnt > 1 || $cnt < 0) {
-                               $s .= ' ' . Credits::getContributorCredits($article, $cnt - 1, $showIfMax);
+                               $s .= ' ' . self::getContributors( $article, $cnt - 1, $showIfMax );
                        }
                }
 
-               wfProfileOut( $fname );
+               wfProfileOut( __METHOD__ );
                return $s;
        }
 
        /**
-        *
+        * Get the last author with the last modification time
+        * @param $article Article object
         */
-       function getAuthorCredits($article) {
+       protected static function getAuthor( Article $article ){
                global $wgLang, $wgAllowRealName;
 
-               $last_author = $article->getUser();
-
-               if ($last_author == 0) {
-                       $author_credit = wfMsg('anonymous');
-               } else {
-                       if($wgAllowRealName) { $real_name = User::whoIsReal($last_author); }
-                       $user_name = User::whoIs($last_author);
-
-                       if (!empty($real_name)) {
-                               $author_credit = Credits::creditLink($user_name, $real_name);
-                       } else {
-                               $author_credit = wfMsg('siteuser', Credits::creditLink($user_name));
-                       }
-               }
+               $user = User::newFromId( $article->getUser() );
 
                $timestamp = $article->getTimestamp();
-               if ($timestamp) {
-                       $d = $wgLang->timeanddate($article->getTimestamp(), true);
+               if( $timestamp ){
+                       $d = $wgLang->date( $article->getTimestamp(), true );
+                       $t = $wgLang->time( $article->getTimestamp(), true );
                } else {
                        $d = '';
+                       $t = '';
                }
-               return wfMsg('lastmodifiedby', $d, $author_credit);
+               return wfMsg( 'lastmodifiedatby', $d, $t, self::userLink( $user ) );
        }
 
        /**
-        *
+        * Get a list of contributors of $article
+        * @param $article Article object
+        * @param $cnt Int: maximum list of contributors to show
+        * @param $showIfMax Bool: whether to contributors if there more than $cnt
+        * @return String: html
         */
-       function getContributorCredits($article, $cnt, $showIfMax) {
-
+       protected static function getContributors( Article $article, $cnt, $showIfMax ) {
                global $wgLang, $wgAllowRealName;
-
+       
                $contributors = $article->getContributors();
-
+       
                $others_link = '';
-
+       
                # Hmm... too many to fit!
-
-               if ($cnt > 0 && count($contributors) > $cnt) {
-                       $others_link = Credits::creditOthersLink($article);
-                       if (!$showIfMax) {
-                               return wfMsg('othercontribs', $others_link);
-                       } else {
-                               $contributors = array_slice($contributors, 0, $cnt);
-                       }
+               if( $cnt > 0 && $contributors->count() > $cnt ){
+                       $others_link = self::othersLink( $article );
+                       if( !$showIfMax )
+                               return wfMsg( 'othercontribs', $others_link );
                }
-
+       
                $real_names = array();
                $user_names = array();
-
-               $anon = '';
-
+               $anon = 0;
+       
                # Sift for real versus user names
-
-               foreach ($contributors as $user_parts) {
-                       if ($user_parts[0] != 0) {
-                               if ($wgAllowRealName && !empty($user_parts[2])) {
-                                       $real_names[] = Credits::creditLink($user_parts[1], $user_parts[2]);
-                               } else {
-                                       $user_names[] = Credits::creditLink($user_parts[1]);
-                               }
+               foreach( $contributors as $user ) {
+                       $cnt--;
+                       if( $user->isLoggedIn() ){
+                               $link = self::link( $user );
+                               if( $wgAllowRealName && $user->getRealName() )
+                                       $real_names[] = $link;
+                               else
+                                       $user_names[] = $link;
                        } else {
-                               $anon = wfMsg('anonymous');
+                               $anon++;
                        }
+                       if( $cnt == 0 ) break;
                }
-
+       
                # Two strings: real names, and user names
-
-               $real = $wgLang->listToText($real_names);
-               $user = $wgLang->listToText($user_names);
-
+               $real = $wgLang->listToText( $real_names );
+               $user = $wgLang->listToText( $user_names );
+               if( $anon )
+                       $anon = wfMsgExt( 'anonymous', array( 'parseinline' ), $anon );
+       
                # "ThisSite user(s) A, B and C"
-
-               if (!empty($user)) {
-                       $user = wfMsg('siteusers', $user);
+               if( !empty( $user ) ){
+                       $user = wfMsgExt( 'siteusers', array( 'parsemag' ), $user, count( $user_names ) );
                }
-
+       
                # This is the big list, all mooshed together. We sift for blank strings
-
                $fulllist = array();
-
-               foreach (array($real, $user, $anon, $others_link) as $s) {
-                       if (!empty($s)) {
-                               array_push($fulllist, $s);
+               foreach( array( $real, $user, $anon, $others_link ) as $s ){
+                       if( !empty( $s ) ){
+                               array_push( $fulllist, $s );
                        }
                }
 
                # Make the list into text...
-
-               $creds = $wgLang->listToText($fulllist);
+               $creds = $wgLang->listToText( $fulllist );
 
                # "Based on work by ..."
-
-               return (empty($creds)) ? '' : wfMsg('othercontribs', $creds);
+               return empty( $creds ) ? '' : wfMsg( 'othercontribs', $creds );
        }
 
        /**
-        *
+        * Get a link to $user_name page
+        * @param $user User object
+        * @return String: html
         */
-       function creditLink($user_name, $link_text = '') {
-               global $wgUser, $wgContLang;
+       protected static function link( User $user ) {
+               global $wgUser, $wgAllowRealName;
+               if( $wgAllowRealName )
+                       $real = $user->getRealName();
+               else
+                       $real = false;
+
                $skin = $wgUser->getSkin();
-               return $skin->makeLink($wgContLang->getNsText(NS_USER) . ':' . $user_name,
-                                      htmlspecialchars( (empty($link_text)) ? $user_name : $link_text ));
+               $page = $user->getUserPage();
+                       
+               return $skin->link( $page, htmlspecialchars( $real ? $real : $user->getName() ) );
+       }
+
+       /**
+        * Get a link to $user_name page
+        * @param $user_name String: user name
+        * @param $linkText String: optional display
+        * @return String: html
+        */
+       protected static function userLink( User $user ) {
+               global $wgUser, $wgAllowRealName;
+               if( $user->isAnon() ){
+                       return wfMsgExt( 'anonymous', array( 'parseinline' ), 1 );
+               } else {
+                       $link = self::link( $user );
+                       if( $wgAllowRealName && $user->getRealName() )
+                               return $link;
+                       else 
+                               return wfMsgExt( 'siteuser', array( 'parseinline', 'replaceafter' ), $link );
+               }
        }
 
        /**
-        *
+        * Get a link to action=credits of $article page
+        * @param $article Article object
+        * @return String: html
         */
-       function creditOthersLink($article) {
+       protected static function othersLink( Article $article ) {
                global $wgUser;
                $skin = $wgUser->getSkin();
-               return $skin->makeKnownLink($article->mTitle->getPrefixedText(), wfMsg('others'), 'action=credits');
+               return $skin->link( $article->getTitle(), wfMsgHtml( 'others' ), array(), array( 'action' => 'credits' ), array( 'known' ) );
        }
-}
-?>
+}
\ No newline at end of file