72 [
'AncientPagesPage',
'Ancientpages' ],
73 [
'BrokenRedirectsPage',
'BrokenRedirects' ],
74 [
'DeadendPagesPage',
'Deadendpages' ],
75 [
'DoubleRedirectsPage',
'DoubleRedirects' ],
76 [
'FileDuplicateSearchPage',
'FileDuplicateSearch' ],
77 [
'ListDuplicatedFilesPage',
'ListDuplicatedFiles' ],
78 [
'LinkSearchPage',
'LinkSearch' ],
79 [
'ListredirectsPage',
'Listredirects' ],
80 [
'LonelyPagesPage',
'Lonelypages' ],
81 [
'LongPagesPage',
'Longpages' ],
82 [
'MediaStatisticsPage',
'MediaStatistics' ],
83 [
'MIMEsearchPage',
'MIMEsearch' ],
84 [
'MostcategoriesPage',
'Mostcategories' ],
85 [
'MostimagesPage',
'Mostimages' ],
86 [
'MostinterwikisPage',
'Mostinterwikis' ],
87 [
'MostlinkedCategoriesPage',
'Mostlinkedcategories' ],
88 [
'MostlinkedTemplatesPage',
'Mostlinkedtemplates' ],
89 [
'MostlinkedPage',
'Mostlinked' ],
90 [
'MostrevisionsPage',
'Mostrevisions' ],
91 [
'FewestrevisionsPage',
'Fewestrevisions' ],
92 [
'ShortPagesPage',
'Shortpages' ],
93 [
'UncategorizedCategoriesPage',
'Uncategorizedcategories' ],
94 [
'UncategorizedPagesPage',
'Uncategorizedpages' ],
95 [
'UncategorizedImagesPage',
'Uncategorizedimages' ],
96 [
'UncategorizedTemplatesPage',
'Uncategorizedtemplates' ],
97 [
'UnusedCategoriesPage',
'Unusedcategories' ],
98 [
'UnusedimagesPage',
'Unusedimages' ],
99 [
'WantedCategoriesPage',
'Wantedcategories' ],
100 [
'WantedFilesPage',
'Wantedfiles' ],
101 [
'WantedPagesPage',
'Wantedpages' ],
102 [
'WantedTemplatesPage',
'Wantedtemplates' ],
103 [
'UnwatchedpagesPage',
'Unwatchedpages' ],
104 [
'UnusedtemplatesPage',
'Unusedtemplates' ],
105 [
'WithoutInterwikiPage',
'Withoutinterwiki' ],
107 Hooks::run(
'wgQueryPages', [ &$qp ] );
119 $this->listoutput = $bool;
160 throw new MWException(
"Bug in a QueryPage: doesn't implement getQueryInfo() nor "
161 .
"getQuery() properly" );
206 return $this->
getConfig()->get(
'DisableQueryPages' );
267 $this->
getOutput()->addWikiMsg(
'specialpage-empty' );
309 $fname = static::class .
'::recache';
320 $num =
$res->numRows();
323 foreach (
$res as $row ) {
324 if ( isset( $row->value ) ) {
329 $value = intval( $row->value );
337 'qc_namespace' => $row->namespace,
338 'qc_title' => $row->title,
343 $dbw->doAtomicSection(
346 # Clear out any old cached data
347 $dbw->
delete(
'querycache',
348 [
'qc_type' => $this->
getName() ],
351 # Save results into the querycache table on the master
352 if ( count( $vals ) ) {
355 # Update the querycache_info record for the page
356 $dbw->
delete(
'querycache_info',
357 [
'qci_type' => $this->
getName() ],
360 $dbw->
insert(
'querycache_info',
361 [
'qci_type' => $this->
getName(),
369 if ( !$ignoreErrors ) {
394 $fname = static::class .
'::reallyDoQuery';
400 foreach ( $order as &$field ) {
405 if ( is_array(
$query ) ) {
430 $sql .=
' ORDER BY ' . implode(
', ', $order );
473 foreach ( $order as &$field ) {
481 return $dbr->select(
'querycache',
483 'namespace' =>
'qc_namespace',
484 'title' =>
'qc_title',
485 'value' =>
'qc_value' ],
486 [
'qc_type' => $this->
getName() ],
503 if ( is_null( $this->cachedTimestamp ) ) {
505 $fname = static::class .
'::getCachedTimestamp';
506 $this->cachedTimestamp =
$dbr->selectField(
'querycache_info',
'qci_timestamp',
526 if ( $this->
getConfig()->
get(
'MiserMode' ) ) {
546 if ( $this->
getConfig()->
get(
'MiserMode' ) ) {
547 $limit = min( $uiLimit + 1, $maxResults - $uiOffset );
565 return max( $this->
getConfig()->
get(
'QueryCacheLimit' ), 10000 );
586 $out->addWikiMsg(
'querypage-disabled' );
592 if ( $this->limit == 0 && $this->offset == 0 ) {
595 $dbLimit = $this->
getDBLimit( $this->limit, $this->offset );
598 # select one extra row for navigation
601 # Get the cached result, select one extra row for navigation
603 if ( !$this->listoutput ) {
604 # Fetch the timestamp of this update
607 $maxResults =
$lang->formatNum( $this->
getConfig()->
get(
'QueryCacheLimit' ) );
610 $updated =
$lang->userTimeAndDate( $ts, $user );
611 $updateddate =
$lang->userDate( $ts, $user );
612 $updatedtime =
$lang->userTime( $ts, $user );
613 $out->addMeta(
'Data-Cache-Time', $ts );
614 $out->addJsConfigVars(
'dataCacheTime', $ts );
615 $out->addWikiMsg(
'perfcachedts', $updated, $updateddate, $updatedtime, $maxResults );
617 $out->addWikiMsg(
'perfcached', $maxResults );
620 # If updates on this page have been disabled, let the user know
621 # that the data set won't be refreshed for now
622 if ( is_array( $this->
getConfig()->
get(
'DisableQueryPageUpdate' ) )
623 && in_array( $this->
getName(), $this->
getConfig()->
get(
'DisableQueryPageUpdate' ) )
626 "<div class=\"mw-querypage-no-updates\">\n$1\n</div>",
627 'querypage-no-updates'
633 $this->numRows =
$res->numRows();
638 $out->addHTML( Xml::openElement(
'div', [
'class' =>
'mw-spcontent' ] ) );
640 # Top header and navigation
641 if ( $this->shownavigation ) {
643 if ( $this->numRows > 0 ) {
644 $out->addHTML( $this->
msg(
'showingresultsinrange' )->numParams(
645 min( $this->numRows, $this->limit ), #
do not show the one extra row,
if exist
646 $this->offset + 1, ( min( $this->numRows, $this->limit ) + $this->offset ) )->parseAsBlock() );
647 # Disable the "next" link when we reach the end
648 $miserMaxResults = $this->
getConfig()->get(
'MiserMode' )
649 && ( $this->offset + $this->limit >= $this->
getMaxResults() );
650 $atEnd = ( $this->numRows <=
$this->limit ) || $miserMaxResults;
653 $out->addHTML(
'<p>' . $paging .
'</p>' );
655 # No results to show, so don't bother with "showing X of Y" etc.
656 # -- just let the user know and give up now
658 $out->addHTML( Xml::closeElement(
'div' ) );
663 # The actual results; specialist subclasses will want to handle this
664 # with more than a straight list, so we hand them the info, plus
665 # an OutputPage, and let them get on with it
670 min( $this->numRows, $this->limit ), #
do not format the one extra row,
if exist
673 # Repeat the paging links at the bottom
674 if ( $this->shownavigation ) {
675 $out->addHTML(
'<p>' . $paging .
'</p>' );
678 $out->addHTML( Xml::closeElement(
'div' ) );
697 if ( !$this->listoutput ) {
701 # $res might contain the whole 1,000 rows, so we read up to
702 # $num [should update this to use a Pager]
704 for ( $i = 0; $i < $num && $row =
$res->fetchObject(); $i++ ) {
708 $html[] = $this->listoutput
710 :
"<li>{$line}</li>\n";
714 # Flush the final result
719 $html[] = $this->listoutput
721 :
"<li>{$line}</li>\n";
725 if ( !$this->listoutput ) {
729 $html = $this->listoutput
731 : implode(
'',
$html );
742 return "\n<ol start='" . (
$offset + 1 ) .
"' class='special'>\n";
767 if ( !$this->
getConfig()->
get(
'Feed' ) ) {
768 $this->
getOutput()->addWikiMsg(
'feed-unavailable' );
774 $feedClasses = $this->
getConfig()->get(
'FeedClasses' );
775 if ( isset( $feedClasses[$class] ) ) {
777 $feed =
new $feedClasses[$class](
784 foreach (
$res as $obj ) {
787 $feed->outItem( $item );
805 if ( !isset( $row->title ) ) {
808 $title = Title::makeTitle( intval( $row->namespace ), $row->title );
810 $date = isset( $row->timestamp ) ? $row->timestamp :
'';
813 $talkpage = $title->getTalkPage();
814 $comments = $talkpage->getFullURL();
818 $title->getPrefixedText(),
819 $this->feedItemDesc( $row ),
820 $title->getFullURL(),
822 $this->feedItemAuthor( $row ),
830 return isset( $row->comment ) ? htmlspecialchars( $row->comment ) :
'';
834 return isset( $row->user_text ) ? $row->user_text :
'';
840 $sitename = $this->
getConfig()->get(
'Sitename' );
841 return "$sitename - $desc [$code]";
845 return $this->
msg(
'tagline' )->text();
863 if ( !
$res->numRows() ) {
868 foreach (
$res as $row ) {
869 $batch->
add( $ns !==
null ? $ns : $row->namespace, $row->title );
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
if(!defined( 'MEDIAWIKI')) $fname
This file is not a valid entry point, perform no further processing unless MEDIAWIKI is defined.
A base class for basic support for outputting syndication feeds in RSS and other formats.
Class representing a list of titles The execute() method checks them all for existence and adds them ...
This is a class for doing query pages; since they're almost all the same, we factor out some of the f...
isExpensive()
Is this query expensive (for some definition of expensive)? Then we don't let it run in miser mode.
linkParameters()
If using extra form wheely-dealies, return a set of parameters here as an associative array.
getMaxResults()
Get max number of results we can return in miser mode.
doQuery( $offset=false, $limit=false)
Somewhat deprecated, you probably want to be using execute()
setListoutput( $bool)
A mutator for $this->listoutput;.
recache( $limit, $ignoreErrors=true)
Clear the cache and save new results.
tryLastResult()
Some special pages (for example SpecialListusers used to) might not return the current object formatt...
fetchFromCache( $limit, $offset=false)
Fetch the query results from the query cache.
int $offset
The offset and limit in use, as passed to the query() function.
outputResults( $out, $skin, $dbr, $res, $num, $offset)
Format and output report results using the given information plus OutputPage.
isCached()
Whether or not the output of the page in question is retrieved from the database cache.
$shownavigation
Whether to show prev/next links.
doFeed( $class='', $limit=50)
Similar to above, but packaging in a syndicated feed instead of a web page.
sortDescending()
Override to sort by increasing values.
formatResult( $skin, $result)
Formats the results of the query for display.
isSyndicated()
Sometime we don't want to build rss / atom feeds.
static getPages()
Get a list of query page classes and their associated special pages, for periodic updates.
reallyDoQuery( $limit, $offset=false)
Run the query and return the result.
isCacheable()
Is the output of this query cacheable? Non-cacheable expensive pages will be disabled in miser mode a...
executeLBFromResultWrapper(ResultWrapper $res, $ns=null)
Creates a new LinkBatch object, adds all pages from the passed ResultWrapper (MUST include title and ...
getOrderFields()
Subclasses return an array of fields to order by here.
showEmptyText()
Outputs some kind of an informative message (via OutputPage) to let the user know that the query retu...
usesTimestamps()
Does this query return timestamps rather than integers in its 'value' field? If true,...
getCacheOrderFields()
Return the order fields for fetchFromCache.
getQueryInfo()
Subclasses return an SQL query here, formatted as an array with the following keys: tables => Table(s...
getDBLimit( $uiLimit, $uiOffset)
What is limit to fetch from DB.
$numRows
The number of rows returned by the query.
preprocessResults( $db, $res)
Do any necessary preprocessing of the result object.
getSQL()
For back-compat, subclasses may return a raw SQL query here, as a string.
getPageHeader()
The content returned by this function will be output before any result.
bool $listoutput
Whether or not we want plain listoutput rather than an ordered list.
execute( $par)
This is the actual workhorse.
feedResult( $row)
Override for custom handling.
getLimitOffset()
Returns limit and offset, as returned by $this->getRequest()->getLimitOffset().
getRecacheDB()
Get a DB connection to be used for slow recache queries.
Parent class for all special pages.
outputHeader( $summaryMessageKey='')
Outputs a summary message on top of special pages Per default the message key is the canonical name o...
getName()
Get the name of this Special Page.
setHeaders()
Sets headers - this should be called from the execute() method of all derived classes!
getDescription()
Returns the name that goes in the <h1> in the special page itself, and also the name that will be l...
getOutput()
Get the OutputPage being used for this instance.
getUser()
Shortcut to get the User executing this instance.
getSkin()
Shortcut to get the skin being used for this instance.
msg( $key)
Wrapper around wfMessage that sets the current context.
getConfig()
Shortcut to get main config object.
getRequest()
Get the WebRequest being used for this instance.
displayRestrictionError()
Output an error message telling the user what access level they have to have.
getPageTitle( $subpage=false)
Get a self-referential title object.
getLanguage()
Shortcut to get user's language.
userCanExecute(User $user)
Checks if the given user (identified by an object) can execute this special page (as defined by $mRes...
deferred txt A few of the database updates required by various functions here can be deferred until after the result page is displayed to the user For updating the view updating the linked to tables after a etc PHP does not yet have any way to tell the server to actually return and disconnect while still running these but it might have such a feature in the future We handle these by creating a deferred update object and putting those objects on a global list
this class mediates it Skin Encapsulates a look and feel for the wiki All of the functions that render HTML and make choices about how to render it are here and are called from various other places when and is meant to be subclassed with other skins that may override some of its functions The User object contains a reference to a and so rather than having a global skin object we just rely on the global User and get the skin with $wgUser and also has some character encoding functions and other locale stuff The current user interface language is instantiated as and the local content language as $wgContLang
the array() calling protocol came about after MediaWiki 1.4rc1.
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist Do not use this to implement individual filters if they are compatible with the ChangesListFilter and ChangesListFilterGroup structure use sub classes of those in conjunction with the ChangesListSpecialPageStructuredFilters hook This hook can be used to implement filters that do not implement that or custom behavior that is not an individual filter e g Watchlist & $tables
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped & $options
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output modifiable & $code
this hook is for auditing only or null if authentication failed before getting that far or null if we can t even determine that probably a stub it is not rendered in wiki pages or galleries in category pages allow injecting custom HTML after the section Any uses of the hook need to handle escaping see BaseTemplate::getToolbox and BaseTemplate::makeListItem for details on the format of individual items inside of this array or by returning and letting standard HTTP rendering take place modifiable or by returning false and taking over the output $out
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses & $html
null for the local wiki Added should default to null in handler for backwards compatibility add a value to it if you want to add a cookie that have to vary cache options can modify $query
returning false will NOT prevent logging $e
if(!isset( $args[0])) $lang