Tweak doc

[lhc/web/wiklou.git] / includes / SpecialPopularpages.php

diff --git a/includes/SpecialPopularpages.php b/includes/SpecialPopularpages.php
index 1e0db4e..af0ed26 100644 (file)
--- a/includes/SpecialPopularpages.php
+++ b/includes/SpecialPopularpages.php
@@ -1,37 +1,69 @@
-<?
-
-include_once( "QueryPage.php" );
+<?php
+/**
+ *
+ * @addtogroup SpecialPage
+ */
 
+/**
+ * implements Special:Popularpages
+ * @addtogroup SpecialPage
+ */
 class PopularPagesPage extends QueryPage {
 
-    function getName() {
-       return "Popularpages";
-    }
-    
-    function isExpensive() {
-       return 1;
-    }
-    
-    function getSQL( $offset, $limit ) {
-       return "SELECT DISTINCT cur_title, cur_counter FROM cur " .
-         "WHERE cur_namespace=0 AND cur_is_redirect=0 ORDER BY " .
-         "cur_counter DESC LIMIT {$offset}, {$limit}";
-    }
-    
-    function formatResult( $skin, $result ) {
-       $link = $skin->makeKnownLink( $result->cur_title, "" );
-       $nv = wfMsg( "nviews", $result->cur_counter );
-       return "{$link} ({$nv})";
-    }
+       function getName() {
+               return "Popularpages";
+       }
+
+       function isExpensive() {
+               # page_counter is not indexed
+               return true;
+       }
+       function isSyndicated() { return false; }
+
+       function getSQL() {
+               $dbr = wfGetDB( DB_SLAVE );
+               $page = $dbr->tableName( 'page' );
+
+               $query = 
+                       "SELECT 'Popularpages' as type,
+                               page_namespace as namespace,
+                               page_title as title,
+                               page_counter as value
+                       FROM $page ";
+               $where =
+                       "WHERE page_is_redirect=0 AND page_namespace";
+
+               global $wgContentNamespaces;
+               if( empty( $wgContentNamespaces ) ) {
+                       $where .= '='.NS_MAIN;
+               } else if( count( $wgContentNamespaces ) > 1 ) {
+                       $where .= ' in (' . implode( ', ', $wgContentNamespaces ) . ')';
+               } else {
+                       $where .= '='.$wgContentNamespaces[0];
+               }
+
+               return $query . $where;
+       }
+
+       function formatResult( $skin, $result ) {
+               global $wgLang, $wgContLang;
+               $title = Title::makeTitle( $result->namespace, $result->title );
+               $link = $skin->makeKnownLinkObj( $title, htmlspecialchars( $wgContLang->convert( $title->getPrefixedText() ) ) );
+               $nv = wfMsgExt( 'nviews', array( 'parsemag', 'escape'),
+                       $wgLang->formatNum( $result->value ) );
+               return wfSpecialList($link, $nv);
+       }
 }
 
-function wfSpecialPopularpages()
-{
-    list( $limit, $offset ) = wfCheckLimits();
-    
-    $ppp = new PopularPagesPage();
-    
-    return $ppp->doQuery( $offset, $limit );
+/**
+ * Constructor
+ */
+function wfSpecialPopularpages() {
+       list( $limit, $offset ) = wfCheckLimits();
+
+       $ppp = new PopularPagesPage();
+
+       return $ppp->doQuery( $offset, $limit );
 }
 
-?>
+