<?php
-
/**
- * Special page lists various statistics, including the contents of
- * `site_stats`, plus page view details if enabled
+ * Implements Special:Statistics
+ *
+ * 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
* @ingroup SpecialPage
*/
/**
- * Show the special page
+ * Special page lists various statistics, including the contents of
+ * `site_stats`, plus page view details if enabled
*
- * @param mixed $par (not used)
+ * @ingroup SpecialPage
*/
-function wfSpecialStatistics( $par = '' ) {
- global $wgOut, $wgLang, $wgRequest, $wgUser, $wgContLang;
- global $wgDisableCounters, $wgMiserMode, $wgImplicitGroups, $wgGroupPermissions;
- $sk = $wgUser->getSkin();
- $dbr = wfGetDB( DB_SLAVE );
-
- $views = SiteStats::views();
- $edits = SiteStats::edits();
- $good = SiteStats::articles();
- $images = SiteStats::images();
- $total = SiteStats::pages();
- $users = SiteStats::users();
- $activeUsers = SiteStats::activeUsers();
- $admins = SiteStats::numberingroup('sysop');
- $numJobs = SiteStats::jobs();
-
- # Staticic - views
- $viewsStats = '';
- if( !$wgDisableCounters ) {
- $viewsStats = Xml::tags( 'th', array( 'colspan' => '2' ), wfMsg( 'statistics-header-views' ) ) .
- formatRow( wfMsgExt( 'statistics-views-total', array( 'parseinline' ) ),
- $wgLang->formatNum( $views ) ) .
- formatRow( wfMsgExt( 'statistics-views-peredit', array( 'parseinline' ) ),
- $wgLang->formatNum( sprintf( '%.2f', $edits ? $views / $edits : 0 ) ) );
- }
- # Set active user count
- if( !$wgMiserMode ) {
- $dbw = wfGetDB( DB_MASTER );
- SiteStatsUpdate::cacheUpdate( $dbw );
+class SpecialStatistics extends SpecialPage {
+
+ private $views, $edits, $good, $images, $total, $users,
+ $activeUsers = 0;
+
+ public function __construct() {
+ parent::__construct( 'Statistics' );
}
- if( $wgRequest->getVal( 'action' ) == 'raw' ) {
- # Depreciated, kept for backwards compatibility
- # http://lists.wikimedia.org/pipermail/wikitech-l/2008-August/039202.html
- $wgOut->disable();
- header( 'Pragma: nocache' );
- echo "total=$total;good=$good;views=$views;edits=$edits;users=$users;";
- echo "activeusers=$activeUsers;admins=$admins;images=$images;jobs=$numJobs\n";
- return;
- } else {
- $text = Xml::openElement( 'table', array( 'class' => 'mw-statistics-table' ) ) .
- # Statistic - pages
- Xml::tags( 'th', array( 'colspan' => '2' ), wfMsg( 'statistics-header-pages' ) ) .
- formatRow( wfMsgExt( 'statistics-articles', array( 'parseinline' ) ),
- $wgLang->formatNum( $good ) ) .
- formatRow( wfMsgExt( 'statistics-pages', array( 'parseinline' ) ),
- $wgLang->formatNum( $total ), NULL, 'statistics-pages-tooltip' ) .
- formatRow( wfMsgExt( 'statistics-files', array( 'parseinline' ) ),
- $wgLang->formatNum( $images ) ) .
-
- # Statistic - edits
- Xml::tags( 'th', array( 'colspan' => '2' ), wfMsg( 'statistics-header-edits' ) ) .
- formatRow( wfMsgExt( 'statistics-edits', array( 'parseinline' ) ),
- $wgLang->formatNum( $edits ) ) .
- formatRow( wfMsgExt( 'statistics-edits-average', array( 'parseinline' ) ),
- $wgLang->formatNum( sprintf( '%.2f', $total ? $edits / $total : 0 ) ) ) .
- formatRow( wfMsgExt( 'statistics-jobqueue', array( 'parseinline' ) ),
- $wgLang->formatNum( $numJobs ) ) .
-
- # Statistic - users
- Xml::tags( 'th', array( 'colspan' => '2' ), wfMsg( 'statistics-header-users' ) ) .
- formatRow( wfMsgExt( 'statistics-users', array( 'parseinline' ) ),
- $wgLang->formatNum( $users ) ) .
- formatRow( wfMsgExt( 'statistics-users-active', array( 'parseinline' ) ),
- $wgLang->formatNum( $activeUsers ), NULL, 'statistics-users-active-tooltip' );
+ public function execute( $par ) {
+ global $wgMemc, $wgDisableCounters, $wgMiserMode;
+
+ $this->setHeaders();
+ $this->getOutput()->addModuleStyles( 'mediawiki.special' );
+
+ $this->views = SiteStats::views();
+ $this->edits = SiteStats::edits();
+ $this->good = SiteStats::articles();
+ $this->images = SiteStats::images();
+ $this->total = SiteStats::pages();
+ $this->users = SiteStats::users();
+ $this->activeUsers = SiteStats::activeUsers();
+ $this->hook = '';
+
+ # Staticic - views
+ $viewsStats = '';
+ if( !$wgDisableCounters ) {
+ $viewsStats = $this->getViewsStats();
+ }
+
+ # Set active user count
+ if( !$wgMiserMode ) {
+ $key = wfMemcKey( 'sitestats', 'activeusers-updated' );
+ // Re-calculate the count if the last tally is old...
+ if( !$wgMemc->get($key) ) {
+ $dbw = wfGetDB( DB_MASTER );
+ SiteStatsUpdate::cacheUpdate( $dbw );
+ $wgMemc->set( $key, '1', 24*3600 ); // don't update for 1 day
+ }
+ }
+
+ $text = Xml::openElement( 'table', array( 'class' => 'wikitable mw-statistics-table' ) );
+
+ # Statistic - pages
+ $text .= $this->getPageStats();
+
+ # Statistic - edits
+ $text .= $this->getEditStats();
+
+ # Statistic - users
+ $text .= $this->getUserStats();
# Statistic - usergroups
+ $text .= $this->getGroupStats();
+ $text .= $viewsStats;
+
+ # Statistic - popular pages
+ if( !$wgDisableCounters && !$wgMiserMode ) {
+ $text .= $this->getMostViewedPages();
+ }
+
+ # Statistic - other
+ $extraStats = array();
+ if( wfRunHooks( 'SpecialStatsAddExtra', array( &$extraStats ) ) ) {
+ $text .= $this->getOtherStats( $extraStats );
+ }
+
+ $text .= Xml::closeElement( 'table' );
+
+ # Customizable footer
+ $footer = $this->msg( 'statistics-footer' );
+ if ( !$footer->isBlank() ) {
+ $text .= "\n" . $footer->parse();
+ }
+
+ $this->getOutput()->addHTML( $text );
+ }
+
+ /**
+ * Format a row
+ * @param $text String: description of the row
+ * @param $number Float: a statistical number
+ * @param $trExtraParams Array: params to table row, see Html::elememt
+ * @param $descMsg String: message key
+ * @param $descMsgParam Array: message params
+ * @return string table row in HTML format
+ */
+ private function formatRow( $text, $number, $trExtraParams = array(), $descMsg = '', $descMsgParam = '' ) {
+ if( $descMsg ) {
+ $msg = $this->msg( $descMsg, $descMsgParam );
+ if ( $msg->exists() ) {
+ $descriptionText = $this->msg( 'parentheses' )->rawParams( $msg->parse() )->escaped();
+ $text .= "<br />" . Xml::element( 'small', array( 'class' => 'mw-statistic-desc'),
+ " $descriptionText" );
+ }
+ }
+ return Html::rawElement( 'tr', $trExtraParams,
+ Html::rawElement( 'td', array(), $text ) .
+ Html::rawElement( 'td', array( 'class' => 'mw-statistics-numbers' ), $number )
+ );
+ }
+
+ /**
+ * Each of these methods is pretty self-explanatory, get a particular
+ * row for the table of statistics
+ * @return string
+ */
+ private function getPageStats() {
+ return Xml::openElement( 'tr' ) .
+ Xml::tags( 'th', array( 'colspan' => '2' ), $this->msg( 'statistics-header-pages' )->parse() ) .
+ Xml::closeElement( 'tr' ) .
+ $this->formatRow( Linker::linkKnown( SpecialPage::getTitleFor( 'Allpages' ),
+ $this->msg( 'statistics-articles' )->parse() ),
+ $this->getLanguage()->formatNum( $this->good ),
+ array( 'class' => 'mw-statistics-articles' ) ) .
+ $this->formatRow( $this->msg( 'statistics-pages' )->parse(),
+ $this->getLanguage()->formatNum( $this->total ),
+ array( 'class' => 'mw-statistics-pages' ),
+ 'statistics-pages-desc' ) .
+ $this->formatRow( Linker::linkKnown( SpecialPage::getTitleFor( 'Listfiles' ),
+ $this->msg( 'statistics-files' )->parse() ),
+ $this->getLanguage()->formatNum( $this->images ),
+ array( 'class' => 'mw-statistics-files' ) );
+ }
+ private function getEditStats() {
+ return Xml::openElement( 'tr' ) .
+ Xml::tags( 'th', array( 'colspan' => '2' ), $this->msg( 'statistics-header-edits' )->parse() ) .
+ Xml::closeElement( 'tr' ) .
+ $this->formatRow( $this->msg( 'statistics-edits' )->parse(),
+ $this->getLanguage()->formatNum( $this->edits ),
+ array( 'class' => 'mw-statistics-edits' ) ) .
+ $this->formatRow( $this->msg( 'statistics-edits-average' )->parse(),
+ $this->getLanguage()->formatNum( sprintf( '%.2f', $this->total ? $this->edits / $this->total : 0 ) ),
+ array( 'class' => 'mw-statistics-edits-average' ) );
+ }
+
+ private function getUserStats() {
+ global $wgActiveUserDays;
+ return Xml::openElement( 'tr' ) .
+ Xml::tags( 'th', array( 'colspan' => '2' ), $this->msg( 'statistics-header-users' )->parse() ) .
+ Xml::closeElement( 'tr' ) .
+ $this->formatRow( $this->msg( 'statistics-users' )->parse(),
+ $this->getLanguage()->formatNum( $this->users ),
+ array( 'class' => 'mw-statistics-users' ) ) .
+ $this->formatRow( $this->msg( 'statistics-users-active' )->parse() . ' ' .
+ Linker::linkKnown(
+ SpecialPage::getTitleFor( 'Activeusers' ),
+ $this->msg( 'listgrouprights-members' )->escaped()
+ ),
+ $this->getLanguage()->formatNum( $this->activeUsers ),
+ array( 'class' => 'mw-statistics-users-active' ),
+ 'statistics-users-active-desc',
+ $this->getLanguage()->formatNum( $wgActiveUserDays ) );
+ }
+
+ private function getGroupStats() {
+ global $wgGroupPermissions, $wgImplicitGroups;
+ $text = '';
foreach( $wgGroupPermissions as $group => $permissions ) {
# Skip generic * and implicit groups
if ( in_array( $group, $wgImplicitGroups ) || $group == '*' ) {
continue;
}
$groupname = htmlspecialchars( $group );
- $msg = wfMsg( 'group-' . $groupname );
- if ( wfEmptyMsg( 'group-' . $groupname, $msg ) || $msg == '' ) {
+ $msg = $this->msg( 'group-' . $groupname );
+ if ( $msg->isBlank() ) {
$groupnameLocalized = $groupname;
} else {
- $groupnameLocalized = $msg;
+ $groupnameLocalized = $msg->text();
}
- $msg = wfMsgForContent( 'grouppage-' . $groupname );
- if ( wfEmptyMsg( 'grouppage-' . $groupname, $msg ) || $msg == '' ) {
+ $msg = $this->msg( 'grouppage-' . $groupname )->inContentLanguage();
+ if ( $msg->isBlank() ) {
$grouppageLocalized = MWNamespace::getCanonicalName( NS_PROJECT ) . ':' . $groupname;
} else {
- $grouppageLocalized = $msg;
+ $grouppageLocalized = $msg->text();
}
- $grouppage = $sk->makeLink( $grouppageLocalized, $groupnameLocalized );
- $grouplink = $sk->link( SpecialPage::getTitleFor( 'Listusers' ),
- wfMsgHtml( 'listgrouprights-members' ),
+ $linkTarget = Title::newFromText( $grouppageLocalized );
+ $grouppage = Linker::link(
+ $linkTarget,
+ htmlspecialchars( $groupnameLocalized )
+ );
+ $grouplink = Linker::linkKnown(
+ SpecialPage::getTitleFor( 'Listusers' ),
+ $this->msg( 'listgrouprights-members' )->escaped(),
array(),
- array( 'group' => $group ),
- 'known' );
- $text .= formatRow( $grouppage . ' ' . $grouplink,
- $wgLang->formatNum( SiteStats::numberingroup( $groupname ) ),
- ' class="statistics-group-' . Sanitizer::escapeClass( $group ) . '"' );
+ array( 'group' => $group )
+ );
+ # Add a class when a usergroup contains no members to allow hiding these rows
+ $classZero = '';
+ $countUsers = SiteStats::numberingroup( $groupname );
+ if( $countUsers == 0 ) {
+ $classZero = ' statistics-group-zero';
+ }
+ $text .= $this->formatRow( $grouppage . ' ' . $grouplink,
+ $this->getLanguage()->formatNum( $countUsers ),
+ array( 'class' => 'statistics-group-' . Sanitizer::escapeClass( $group ) . $classZero ) );
}
+ return $text;
+ }
+
+ private function getViewsStats() {
+ return Xml::openElement( 'tr' ) .
+ Xml::tags( 'th', array( 'colspan' => '2' ), $this->msg( 'statistics-header-views' )->parse() ) .
+ Xml::closeElement( 'tr' ) .
+ $this->formatRow( $this->msg( 'statistics-views-total' )->parse(),
+ $this->getLanguage()->formatNum( $this->views ),
+ array ( 'class' => 'mw-statistics-views-total' ), 'statistics-views-total-desc' ) .
+ $this->formatRow( $this->msg( 'statistics-views-peredit' )->parse(),
+ $this->getLanguage()->formatNum( sprintf( '%.2f', $this->edits ?
+ $this->views / $this->edits : 0 ) ),
+ array ( 'class' => 'mw-statistics-views-peredit' ) );
}
- $text .= $viewsStats;
- # Statistic - popular pages
- if( !$wgDisableCounters && !$wgMiserMode ) {
+ private function getMostViewedPages() {
+ $text = '';
+ $dbr = wfGetDB( DB_SLAVE );
$res = $dbr->select(
- 'page',
- array(
- 'page_namespace',
- 'page_title',
- 'page_counter',
- ),
- array(
- 'page_is_redirect' => 0,
- 'page_counter > 0',
- ),
- __METHOD__,
- array(
- 'ORDER BY' => 'page_counter DESC',
- 'LIMIT' => 10,
- )
- );
- if( $res->numRows() > 0 ) {
- $text .= Xml::tags( 'th', array( 'colspan' => '2' ), wfMsg( 'statistics-mostpopular' ) );
- while( $row = $res->fetchObject() ) {
- $title = Title::makeTitleSafe( $row->page_namespace, $row->page_title );
- if( $title instanceof Title ) {
- $text .= formatRow( $sk->link( $title ),
- $wgLang->formatNum( $row->page_counter ) );
+ 'page',
+ array(
+ 'page_namespace',
+ 'page_title',
+ 'page_counter',
+ ),
+ array(
+ 'page_is_redirect' => 0,
+ 'page_counter > 0',
+ ),
+ __METHOD__,
+ array(
+ 'ORDER BY' => 'page_counter DESC',
+ 'LIMIT' => 10,
+ )
+ );
+ if( $res->numRows() > 0 ) {
+ $text .= Xml::openElement( 'tr' );
+ $text .= Xml::tags( 'th', array( 'colspan' => '2' ), $this->msg( 'statistics-mostpopular' )->parse() );
+ $text .= Xml::closeElement( 'tr' );
+ foreach ( $res as $row ) {
+ $title = Title::makeTitleSafe( $row->page_namespace, $row->page_title );
+ if( $title instanceof Title ) {
+ $text .= $this->formatRow( Linker::link( $title ),
+ $this->getLanguage()->formatNum( $row->page_counter ) );
+ }
}
+ $res->free();
}
- $res->free();
- }
+ return $text;
}
- $text .= Xml::closeElement( 'table' );
+ private function getOtherStats( $stats ) {
+ if ( !count( $stats ) )
+ return '';
- # Customizable footer
- $footer = wfMsgExt( 'statistics-footer', array('parseinline') );
- if( !wfEmptyMsg( 'statistics-footer', $footer ) && $footer != '' ) {
- $text .= "\n" . $footer;
- }
+ $return = Xml::openElement( 'tr' ) .
+ Xml::tags( 'th', array( 'colspan' => '2' ), $this->msg( 'statistics-header-hooks' )->parse() ) .
+ Xml::closeElement( 'tr' );
- $wgOut->addHtml( $text );
-}
+ foreach( $stats as $name => $number ) {
+ $name = htmlspecialchars( $name );
+ $number = htmlspecialchars( $number );
-/**
- * Format a row
- *
- * @param string $text description of the row
- * @param float $number a number
- * @return string table row in HTML format
- */
-function formatRow( $text, $number, $trExtraParams = '', $tooltip = '' ) {
- if( $tooltip ) {
- $text = '<div title="' . wfMsg( $tooltip ) . '">' . $text . '<sup>*</sup></div>';
- }
+ $return .= $this->formatRow( $name, $this->getLanguage()->formatNum( $number ), array( 'class' => 'mw-statistics-hook' ) );
+ }
- return "<tr{$trExtraParams}>
- <td>" .
- $text .
- '</td>
- <td class="mw-statistics-numbers">' .
- $number .
- '</td>
- </tr>';
+ return $return;
+ }
}