Standardised file description headers; first path
[lhc/web/wiklou.git] / includes / specials / SpecialMostlinkedcategories.php
1 <?php
2 /**
3 * Implements Special:Mostlinkedcategories
4 *
5 * Copyright © 2005, Ævar Arnfjörð Bjarmason
6 *
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.
11 *
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.
16 *
17 * You should have received a copy of the GNU General Public License along
18 * with this program; if not, write to the Free Software Foundation, Inc.,
19 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
20 * http://www.gnu.org/copyleft/gpl.html
21 *
22 * @file
23 * @ingroup SpecialPage
24 * @author Ævar Arnfjörð Bjarmason <avarab@gmail.com>
25 */
26
27 /**
28 * A querypage to show categories ordered in descending order by the pages in them
29 *
30 * @ingroup SpecialPage
31 */
32 class MostlinkedCategoriesPage extends QueryPage {
33
34 function getName() { return 'Mostlinkedcategories'; }
35 function isExpensive() { return true; }
36 function isSyndicated() { return false; }
37
38 function getSQL() {
39 $dbr = wfGetDB( DB_SLAVE );
40 $categorylinks = $dbr->tableName( 'categorylinks' );
41 $name = $dbr->addQuotes( $this->getName() );
42 return
43 "
44 SELECT
45 $name as type,
46 " . NS_CATEGORY . " as namespace,
47 cl_to as title,
48 COUNT(*) as value
49 FROM $categorylinks
50 GROUP BY cl_to
51 ";
52 }
53
54 function sortDescending() { return true; }
55
56 /**
57 * Fetch user page links and cache their existence
58 */
59 function preprocessResults( $db, $res ) {
60 $batch = new LinkBatch;
61 while ( $row = $db->fetchObject( $res ) )
62 $batch->add( $row->namespace, $row->title );
63 $batch->execute();
64
65 // Back to start for display
66 if ( $db->numRows( $res ) > 0 )
67 // If there are no rows we get an error seeking.
68 $db->dataSeek( $res, 0 );
69 }
70
71 function formatResult( $skin, $result ) {
72 global $wgLang, $wgContLang;
73
74 $nt = Title::makeTitle( $result->namespace, $result->title );
75 $text = $wgContLang->convert( $nt->getText() );
76
77 $plink = $skin->link( $nt, htmlspecialchars( $text ) );
78
79 $nlinks = wfMsgExt( 'nmembers', array( 'parsemag', 'escape'),
80 $wgLang->formatNum( $result->value ) );
81 return wfSpecialList($plink, $nlinks);
82 }
83 }
84
85 /**
86 * constructor
87 */
88 function wfSpecialMostlinkedCategories() {
89 list( $limit, $offset ) = wfCheckLimits();
90
91 $wpp = new MostlinkedCategoriesPage();
92
93 $wpp->doQuery( $offset, $limit );
94 }