<?php
-/* Credits.php -- formats credits for articles
+/**
+ * Credits.php -- formats credits for articles
* Copyright 2004, Evan Prodromou <evan@wikitravel.org>.
*
* This program is free software; you can redistribute it and/or modify
* 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
+ *
+ * @author <evan@wikitravel.org>
*/
-/* This is largely cadged from PageHistory::history */
-
-function showCreditsPage($article)
-{
+/**
+ * This is largely cadged from PageHistory::history
+ */
+function showCreditsPage($article) {
global $wgOut;
- $fname = "showCreditsPage";
+ $fname = 'showCreditsPage';
wfProfileIn( $fname );
$wgOut->setPageTitle( $article->mTitle->getPrefixedText() );
- $wgOut->setSubtitle( wfMsg( "creditspage" ) );
+ $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" );
+ $s = wfMsg( 'nocredits' );
} else {
$s = getCredits($article, -1);
}
wfProfileOut( $fname );
}
-function getCredits($article, $cnt) {
+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);
+ $s .= ' ' . getContributorCredits($article, $cnt - 1, $showIfMax);
}
}
return $s;
}
-function getAuthorCredits($article) {
-
+/**
+ *
+ */
+function getAuthorCredits($article) {
global $wgLang;
$last_author = $article->getUser();
return wfMsg('lastmodifiedby', $d, $author_credit);
}
-function getContributorCredits($article, $cnt) {
+/**
+ *
+ */
+function getContributorCredits($article, $cnt, $showIfMax) {
global $wgLang, $wgAllowRealName;
- $contributors = $article->getContributors($cnt);
+ $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);
+ }
+ }
+
$real_names = array();
$user_names = array();
+ $anon = '';
+
# Sift for real versus user names
- foreach ($contributors as $user_id => $user_parts) {
- if ($user_id != 0) {
- if ($wgAllowRealName && !empty($user_parts[1])) {
- $real_names[$user_id] = creditLink($user_parts[0], $user_parts[1]);
+ foreach ($contributors as $user_parts) {
+ if ($user_parts[0] != 0) {
+ if ($wgAllowRealName && !empty($user_parts[2])) {
+ $real_names[] = creditLink($user_parts[1], $user_parts[2]);
} else {
- $user_names[$user_id] = creditLink($user_parts[0]);
+ $user_names[] = creditLink($user_parts[1]);
}
+ } else {
+ $anon = wfMsg('anonymous');
}
}
+
+ # Two strings: real names, and user names
- $real = $wgLang->listToText(array_values($real_names));
- $user = $wgLang->listToText(array_values($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);
+ $user = wfMsg('siteusers', $user);
}
+
+ # This is the big list, all mooshed together. We sift for blank strings
- if ($contributors[0] && $contributors[0][0] > 0) {
- $anon = wfMsg('anonymous');
- } else {
- $anon = '';
+ $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(array($real, $user, $anon));
+ $creds = $wgLang->listToText($fulllist);
+
+ # "Based on work by ..."
- return wfMsg('othercontribs', $creds);
+ return (empty($creds)) ? '' : wfMsg('othercontribs', $creds);
}
+/**
+ *
+ */
function creditLink($user_name, $link_text = '') {
global $wgUser, $wgLang;
$skin = $wgUser->getSkin();
- return $skin->makeKnownLink($wgLang->getNsText(NS_USER) . ":" . $user_name,
- (empty($link_text)) ? $user_name : $link_text);
+ return $skin->makeLink($wgLang->getNsText(NS_USER) . ':' . $user_name,
+ (empty($link_text)) ? $user_name : $link_text);
+}
+
+/**
+ *
+ */
+function creditOthersLink($article) {
+ global $wgUser, $wgLang;
+ $skin = $wgUser->getSkin();
+ return $skin->makeKnownLink($article->mTitle->getPrefixedText(), wfMsg('others'), 'action=credits');
}
?>