X-Git-Url: http://git.heureux-cyclage.org/?a=blobdiff_plain;ds=sidebyside;f=includes%2FCredits.php;h=ad7e0290725125338d6bc9a9f066457688977c3b;hb=3d6c4a9b2126876c87ebc3f041a68e097a3ecca4;hp=ffbeeff57a2c95d9f45d6bd2134e12890641fdc5;hpb=217357f46e226deb47d36cfa469e3185c7c63f9d;p=lhc%2Fweb%2Fwiklou.git diff --git a/includes/Credits.php b/includes/Credits.php index ffbeeff57a..ad7e029072 100644 --- a/includes/Credits.php +++ b/includes/Credits.php @@ -2,185 +2,205 @@ /** * Credits.php -- formats credits for articles * Copyright 2004, Evan Prodromou . - * + * * 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, + * 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., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA + * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA * * @author - * @package MediaWiki */ -/** - * This is largely cadged from PageHistory::history - */ -function showCreditsPage($article) { - global $wgOut; - - $fname = 'showCreditsPage'; - - wfProfileIn( $fname ); - - $wgOut->setPageTitle( $article->mTitle->getPrefixedText() ); - $wgOut->setSubtitle( wfMsg( 'creditspage' ) ); - $wgOut->setArticleFlag( false ); - $wgOut->setArticleRelated( true ); - $wgOut->setRobotpolicy( 'noindex,nofollow' ); - - if( $article->mTitle->getArticleID() == 0 ) { - $s = wfMsg( 'nocredits' ); - } else { - $s = getCredits($article, -1); - } - - $wgOut->addHTML( $s ); - - wfProfileOut( $fname ); -} - -function getCredits($article, $cnt, $showIfMax=true) { - - $s = ''; - - if (isset($cnt) && $cnt != 0) { - $s = getAuthorCredits($article); - if ($cnt > 1 || $cnt < 0) { - $s .= ' ' . getContributorCredits($article, $cnt - 1, $showIfMax); - } - } - - return $s; -} +class Credits { -/** - * - */ -function getAuthorCredits($article) { - global $wgLang; - - $last_author = $article->getUser(); - - if ($last_author == 0) { - $author_credit = wfMsg('anonymous'); - } else { + /** + * This is largely cadged from PageHistory::history + * @param $article Article object + */ + public static function showPage( Article $article ) { + global $wgOut; - $real_name = htmlspecialchars( User::whoIsReal($last_author) ); - $user_name = htmlspecialchars( User::whoIs($last_author) ); + wfProfileIn( __METHOD__ ); - if (!empty($real_name)) { - $author_credit = creditLink($user_name, $real_name); - } else { - $author_credit = wfMsg('siteuser', creditLink($user_name)); + $wgOut->setPageTitle( $article->mTitle->getPrefixedText() ); + $wgOut->setSubtitle( wfMsg( 'creditspage' ) ); + $wgOut->setArticleFlag( false ); + $wgOut->setArticleRelated( true ); + $wgOut->setRobotPolicy( 'noindex,nofollow' ); + + if( $article->mTitle->getArticleID() == 0 ) { + $s = wfMsg( 'nocredits' ); + } else { + $s = self::getCredits($article, -1 ); + } + + $wgOut->addHTML( $s ); + + wfProfileOut( __METHOD__ ); } - } - - $timestamp = $article->getTimestamp(); - if ($timestamp) { - $d = $wgLang->timeanddate($article->getTimestamp(), true); - } else { - $d = ''; - } - return wfMsg('lastmodifiedby', $d, $author_credit); -} -/** - * - */ -function getContributorCredits($article, $cnt, $showIfMax) { - - global $wgLang, $wgAllowRealName; - - $contributors = $article->getContributors(); - - $others_link = ''; - - # Hmm... too many to fit! - - if ($cnt > 0 && count($contributors) > $cnt) { - $others_link = creditOthersLink($article); - if (!$showIfMax) { - return wfMsg('othercontribs', $others_link); - } else { - $contributors = array_slice($contributors, 0, $cnt); + /** + * 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 = self::getAuthor( $article ); + if ($cnt > 1 || $cnt < 0) { + $s .= ' ' . self::getContributors( $article, $cnt - 1, $showIfMax ); + } + } + + wfProfileOut( __METHOD__ ); + return $s; } - } - - $real_names = array(); - $user_names = array(); - - $anon = ''; - - # Sift for real versus user names - - foreach ($contributors as $user_parts) { - if ($user_parts[0] != 0) { - if ($wgAllowRealName && !empty($user_parts[2])) { - $real_names[] = htmlspecialchars( creditLink($user_parts[1], $user_parts[2]) ); - } else { - $user_names[] = htmlspecialchars( creditLink($user_parts[1]) ); - } - } else { - $anon = wfMsg('anonymous'); + + /** + * Get the last author with the last modification time + * @param $article Article object + */ + protected static function getAuthor( Article $article ){ + global $wgLang; + + $user = User::newFromId( $article->getUser() ); + + $timestamp = $article->getTimestamp(); + if( $timestamp ){ + $d = $wgLang->date( $article->getTimestamp(), true ); + $t = $wgLang->time( $article->getTimestamp(), true ); + } else { + $d = ''; + $t = ''; + } + return wfMsgExt( 'lastmodifiedatby', 'parsemag', $d, $t, self::userLink( $user ), $user->getName() ); } - } + + /** + * 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 + */ + protected static function getContributors( Article $article, $cnt, $showIfMax ) { + global $wgLang, $wgHiddenPrefs; - # Two strings: real names, and user names - - $real = $wgLang->listToText($real_names); - $user = $wgLang->listToText($user_names); - - # "ThisSite user(s) A, B and C" - - if (!empty($user)) { - $user = wfMsg('siteusers', $user); - } - - # 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); + $contributors = $article->getContributors(); + + $others_link = ''; + + # Hmm... too many to fit! + 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 = 0; + + # Sift for real versus user names + foreach( $contributors as $user ) { + $cnt--; + if( $user->isLoggedIn() ){ + $link = self::link( $user ); + if( !in_array( 'realname', $wgHiddenPrefs ) && $user->getRealName() ) + $real_names[] = $link; + else + $user_names[] = $link; + } else { + $anon++; + } + if( $cnt == 0 ) break; + } + + # Two strings: real names, and 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 = 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 ); + } + } + + # Make the list into text... + $creds = $wgLang->listToText( $fulllist ); + + # "Based on work by ..." + return empty( $creds ) ? '' : wfMsg( 'othercontribs', $creds ); } - } - - # Make the list into text... - - $creds = $wgLang->listToText($fulllist); - # "Based on work by ..." - - return (empty($creds)) ? '' : wfMsg('othercontribs', $creds); -} + /** + * Get a link to $user_name page + * @param $user User object + * @return String: html + */ + protected static function link( User $user ) { + global $wgUser, $wgHiddenPrefs; + if( !in_array( 'realname', $wgHiddenPrefs ) ) + $real = $user->getRealName(); + else + $real = false; + + $skin = $wgUser->getSkin(); + $page = $user->getUserPage(); + + return $skin->link( $page, htmlspecialchars( $real ? $real : $user->getName() ) ); + } -/** - * - */ -function creditLink($user_name, $link_text = '') { - global $wgUser, $wgContLang; - $skin = $wgUser->getSkin(); - return $skin->makeLink($wgContLang->getNsText(NS_USER) . ':' . $user_name, - (empty($link_text)) ? $user_name : $link_text); -} + /** + * 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 ) { + if( $user->isAnon() ){ + return wfMsgExt( 'anonymous', array( 'parseinline' ), 1 ); + } else { + global $wgHiddenPrefs; + $link = self::link( $user ); + if( !in_array( 'realname', $wgHiddenPrefs ) && $user->getRealName() ) + return $link; + else + return wfMsgExt( 'siteuser', array( 'parseinline', 'replaceafter' ), $link ); + } + } -/** - * - */ -function creditOthersLink($article) { - global $wgUser, $wgLang; - $skin = $wgUser->getSkin(); - return $skin->makeKnownLink($article->mTitle->getPrefixedText(), wfMsg('others'), 'action=credits'); + /** + * Get a link to action=credits of $article page + * @param $article Article object + * @return String: html + */ + protected static function othersLink( Article $article ) { + global $wgUser; + $skin = $wgUser->getSkin(); + return $skin->link( $article->getTitle(), wfMsgHtml( 'others' ), array(), array( 'action' => 'credits' ), array( 'known' ) ); + } } - -?>