3 * Formats credits for articles
5 * Copyright 2004, Evan Prodromou <evan@wikitravel.org>.
7 * This program is free software; you can redistribute it and/or modify
8 * it under the terms of the GNU General Public License as published by
9 * the Free Software Foundation; either version 2 of the License, or
10 * (at your option) any later version.
12 * This program is distributed in the hope that it will be useful,
13 * but WITHOUT ANY WARRANTY; without even the implied warranty of
14 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
15 * GNU General Public License for more details.
17 * You should have received a copy of the GNU General Public License
18 * along with this program; if not, write to the Free Software
19 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
23 * @author <evan@wikitravel.org>
29 class CreditsAction
extends FormlessAction
{
31 public function getName() {
35 protected function getDescription() {
36 return $this->msg( 'creditspage' )->escaped();
40 * This is largely cadged from PageHistory::history
44 public function onView() {
45 wfProfileIn( __METHOD__
);
47 if ( $this->page
->getID() == 0 ) {
48 $s = $this->msg( 'nocredits' )->parse();
50 $s = $this->getCredits( -1 );
53 wfProfileOut( __METHOD__
);
55 return Html
::rawElement( 'div', array( 'id' => 'mw-credits' ), $s );
59 * Get a list of contributors
61 * @param int $cnt maximum list of contributors to show
62 * @param bool $showIfMax whether to contributors if there more than $cnt
63 * @return String: html
65 public function getCredits( $cnt, $showIfMax = true ) {
66 wfProfileIn( __METHOD__
);
70 $s = $this->getAuthor( $this->page
);
71 if ( $cnt > 1 ||
$cnt < 0 ) {
72 $s .= ' ' . $this->getContributors( $cnt - 1, $showIfMax );
76 wfProfileOut( __METHOD__
);
82 * Get the last author with the last modification time
86 protected function getAuthor( Page
$page ) {
87 $user = User
::newFromName( $page->getUserText(), false );
89 $timestamp = $page->getTimestamp();
91 $lang = $this->getLanguage();
92 $d = $lang->date( $page->getTimestamp(), true );
93 $t = $lang->time( $page->getTimestamp(), true );
99 return $this->msg( 'lastmodifiedatby', $d, $t )->rawParams(
100 $this->userLink( $user ) )->params( $user->getName() )->escaped();
104 * Get a list of contributors of $article
105 * @param int $cnt maximum list of contributors to show
106 * @param bool $showIfMax whether to contributors if there more than $cnt
107 * @return String: html
109 protected function getContributors( $cnt, $showIfMax ) {
110 global $wgHiddenPrefs;
112 $contributors = $this->page
->getContributors();
114 $others_link = false;
116 # Hmm... too many to fit!
117 if ( $cnt > 0 && $contributors->count() > $cnt ) {
118 $others_link = $this->othersLink();
120 return $this->msg( 'othercontribs' )->rawParams(
121 $others_link )->params( $contributors->count() )->escaped();
125 $real_names = array();
126 $user_names = array();
129 # Sift for real versus user names
130 foreach ( $contributors as $user ) {
132 if ( $user->isLoggedIn() ) {
133 $link = $this->link( $user );
134 if ( !in_array( 'realname', $wgHiddenPrefs ) && $user->getRealName() ) {
135 $real_names[] = $link;
137 $user_names[] = $link;
140 $anon_ips[] = $this->link( $user );
148 $lang = $this->getLanguage();
150 if ( count( $real_names ) ) {
151 $real = $lang->listToText( $real_names );
156 # "ThisSite user(s) A, B and C"
157 if ( count( $user_names ) ) {
158 $user = $this->msg( 'siteusers' )->rawParams( $lang->listToText( $user_names ) )->params(
159 count( $user_names ) )->escaped();
164 if ( count( $anon_ips ) ) {
165 $anon = $this->msg( 'anonusers' )->rawParams( $lang->listToText( $anon_ips ) )->params(
166 count( $anon_ips ) )->escaped();
171 # This is the big list, all mooshed together. We sift for blank strings
173 foreach ( array( $real, $user, $anon, $others_link ) as $s ) {
174 if ( $s !== false ) {
175 array_push( $fulllist, $s );
179 $count = count( $fulllist );
181 # "Based on work by ..."
183 ?
$this->msg( 'othercontribs' )->rawParams(
184 $lang->listToText( $fulllist ) )->params( $count )->escaped()
189 * Get a link to $user's user page
190 * @param $user User object
191 * @return String: html
193 protected function link( User
$user ) {
194 global $wgHiddenPrefs;
195 if ( !in_array( 'realname', $wgHiddenPrefs ) && !$user->isAnon() ) {
196 $real = $user->getRealName();
201 $page = $user->isAnon()
202 ? SpecialPage
::getTitleFor( 'Contributions', $user->getName() )
203 : $user->getUserPage();
205 return Linker
::link( $page, htmlspecialchars( $real ?
$real : $user->getName() ) );
209 * Get a link to $user's user page
210 * @param $user User object
211 * @return String: html
213 protected function userLink( User
$user ) {
214 $link = $this->link( $user );
215 if ( $user->isAnon() ) {
216 return $this->msg( 'anonuser' )->rawParams( $link )->parse();
218 global $wgHiddenPrefs;
219 if ( !in_array( 'realname', $wgHiddenPrefs ) && $user->getRealName() ) {
222 return $this->msg( 'siteuser' )->rawParams( $link )->params( $user->getName() )->escaped();
228 * Get a link to action=credits of $article page
229 * @return String: HTML link
231 protected function othersLink() {
232 return Linker
::linkKnown(
234 $this->msg( 'others' )->escaped(),
236 array( 'action' => 'credits' )