MediaWiki  1.28.0
SpecialNewpages.php
Go to the documentation of this file.
1 <?php
33  protected $opts;
34  protected $customFilters;
35 
36  protected $showNavigation = false;
37 
38  public function __construct() {
39  parent::__construct( 'Newpages' );
40  }
41 
42  protected function setup( $par ) {
43  // Options
44  $opts = new FormOptions();
45  $this->opts = $opts; // bind
46  $opts->add( 'hideliu', false );
47  $opts->add( 'hidepatrolled', $this->getUser()->getBoolOption( 'newpageshidepatrolled' ) );
48  $opts->add( 'hidebots', false );
49  $opts->add( 'hideredirs', true );
50  $opts->add( 'limit', $this->getUser()->getIntOption( 'rclimit' ) );
51  $opts->add( 'offset', '' );
52  $opts->add( 'namespace', '0' );
53  $opts->add( 'username', '' );
54  $opts->add( 'feed', '' );
55  $opts->add( 'tagfilter', '' );
56  $opts->add( 'invert', false );
57 
58  $this->customFilters = [];
59  Hooks::run( 'SpecialNewPagesFilters', [ $this, &$this->customFilters ] );
60  foreach ( $this->customFilters as $key => $params ) {
61  $opts->add( $key, $params['default'] );
62  }
63 
64  // Set values
66  if ( $par ) {
67  $this->parseParams( $par );
68  }
69 
70  // Validate
71  $opts->validateIntBounds( 'limit', 0, 5000 );
72  }
73 
74  protected function parseParams( $par ) {
75  $bits = preg_split( '/\s*,\s*/', trim( $par ) );
76  foreach ( $bits as $bit ) {
77  if ( 'shownav' == $bit ) {
78  $this->showNavigation = true;
79  }
80  if ( 'hideliu' === $bit ) {
81  $this->opts->setValue( 'hideliu', true );
82  }
83  if ( 'hidepatrolled' == $bit ) {
84  $this->opts->setValue( 'hidepatrolled', true );
85  }
86  if ( 'hidebots' == $bit ) {
87  $this->opts->setValue( 'hidebots', true );
88  }
89  if ( 'showredirs' == $bit ) {
90  $this->opts->setValue( 'hideredirs', false );
91  }
92  if ( is_numeric( $bit ) ) {
93  $this->opts->setValue( 'limit', intval( $bit ) );
94  }
95 
96  $m = [];
97  if ( preg_match( '/^limit=(\d+)$/', $bit, $m ) ) {
98  $this->opts->setValue( 'limit', intval( $m[1] ) );
99  }
100  // PG offsets not just digits!
101  if ( preg_match( '/^offset=([^=]+)$/', $bit, $m ) ) {
102  $this->opts->setValue( 'offset', intval( $m[1] ) );
103  }
104  if ( preg_match( '/^username=(.*)$/', $bit, $m ) ) {
105  $this->opts->setValue( 'username', $m[1] );
106  }
107  if ( preg_match( '/^namespace=(.*)$/', $bit, $m ) ) {
108  $ns = $this->getLanguage()->getNsIndex( $m[1] );
109  if ( $ns !== false ) {
110  $this->opts->setValue( 'namespace', $ns );
111  }
112  }
113  }
114  }
115 
121  public function execute( $par ) {
122  $out = $this->getOutput();
123 
124  $this->setHeaders();
125  $this->outputHeader();
126 
127  $this->showNavigation = !$this->including(); // Maybe changed in setup
128  $this->setup( $par );
129 
130  $this->addHelpLink( 'Help:New pages' );
131 
132  if ( !$this->including() ) {
133  // Settings
134  $this->form();
135 
136  $feedType = $this->opts->getValue( 'feed' );
137  if ( $feedType ) {
138  $this->feed( $feedType );
139 
140  return;
141  }
142 
143  $allValues = $this->opts->getAllValues();
144  unset( $allValues['feed'] );
145  $out->setFeedAppendQuery( wfArrayToCgi( $allValues ) );
146  }
147 
148  $pager = new NewPagesPager( $this, $this->opts );
149  $pager->mLimit = $this->opts->getValue( 'limit' );
150  $pager->mOffset = $this->opts->getValue( 'offset' );
151 
152  if ( $pager->getNumRows() ) {
153  $navigation = '';
154  if ( $this->showNavigation ) {
155  $navigation = $pager->getNavigationBar();
156  }
157  $out->addHTML( $navigation . $pager->getBody() . $navigation );
158  } else {
159  $out->addWikiMsg( 'specialpage-empty' );
160  }
161  }
162 
163  protected function filterLinks() {
164  // show/hide links
165  $showhide = [ $this->msg( 'show' )->escaped(), $this->msg( 'hide' )->escaped() ];
166 
167  // Option value -> message mapping
168  $filters = [
169  'hideliu' => 'rcshowhideliu',
170  'hidepatrolled' => 'rcshowhidepatr',
171  'hidebots' => 'rcshowhidebots',
172  'hideredirs' => 'whatlinkshere-hideredirs'
173  ];
174  foreach ( $this->customFilters as $key => $params ) {
175  $filters[$key] = $params['msg'];
176  }
177 
178  // Disable some if needed
179  if ( !User::groupHasPermission( '*', 'createpage' ) ) {
180  unset( $filters['hideliu'] );
181  }
182  if ( !$this->getUser()->useNPPatrol() ) {
183  unset( $filters['hidepatrolled'] );
184  }
185 
186  $links = [];
187  $changed = $this->opts->getChangedValues();
188  unset( $changed['offset'] ); // Reset offset if query type changes
189 
190  $self = $this->getPageTitle();
191  $linkRenderer = $this->getLinkRenderer();
192  foreach ( $filters as $key => $msg ) {
193  $onoff = 1 - $this->opts->getValue( $key );
194  $link = $linkRenderer->makeLink(
195  $self,
196  new HtmlArmor( $showhide[$onoff] ),
197  [],
198  [ $key => $onoff ] + $changed
199  );
200  $links[$key] = $this->msg( $msg )->rawParams( $link )->escaped();
201  }
202 
203  return $this->getLanguage()->pipeList( $links );
204  }
205 
206  protected function form() {
207  $out = $this->getOutput();
208  $out->addModules( 'mediawiki.userSuggest' );
209 
210  // Consume values
211  $this->opts->consumeValue( 'offset' ); // don't carry offset, DWIW
212  $namespace = $this->opts->consumeValue( 'namespace' );
213  $username = $this->opts->consumeValue( 'username' );
214  $tagFilterVal = $this->opts->consumeValue( 'tagfilter' );
215  $nsinvert = $this->opts->consumeValue( 'invert' );
216 
217  // Check username input validity
219  $userText = $ut ? $ut->getText() : '';
220 
221  // Store query values in hidden fields so that form submission doesn't lose them
222  $hidden = [];
223  foreach ( $this->opts->getUnconsumedValues() as $key => $value ) {
224  $hidden[] = Html::hidden( $key, $value );
225  }
226  $hidden = implode( "\n", $hidden );
227 
228  $form = [
229  'namespace' => [
230  'type' => 'namespaceselect',
231  'name' => 'namespace',
232  'label-message' => 'namespace',
233  'default' => $namespace,
234  ],
235  'nsinvert' => [
236  'type' => 'check',
237  'name' => 'invert',
238  'label-message' => 'invert',
239  'default' => $nsinvert,
240  'tooltip' => 'invert',
241  ],
242  'tagFilter' => [
243  'type' => 'tagfilter',
244  'name' => 'tagfilter',
245  'label-raw' => $this->msg( 'tag-filter' )->parse(),
246  'default' => $tagFilterVal,
247  ],
248  'username' => [
249  'type' => 'text',
250  'name' => 'username',
251  'label-message' => 'newpages-username',
252  'default' => $userText,
253  'id' => 'mw-np-username',
254  'size' => 30,
255  'cssclass' => 'mw-autocomplete-user', // used by mediawiki.userSuggest
256  ],
257  ];
258 
259  $htmlForm = new HTMLForm( $form, $this->getContext() );
260 
261  $htmlForm->setSubmitText( $this->msg( 'newpages-submit' )->text() );
262  $htmlForm->setSubmitProgressive();
263  // The form should be visible on each request (inclusive requests with submitted forms), so
264  // return always false here.
265  $htmlForm->setSubmitCallback(
266  function () {
267  return false;
268  }
269  );
270  $htmlForm->setMethod( 'get' );
271 
272  $out->addHTML( Xml::fieldset( $this->msg( 'newpages' )->text() ) );
273 
274  $htmlForm->show();
275 
276  $out->addHTML(
278  'div',
279  null,
280  $this->filterLinks()
281  ) .
282  Xml::closeElement( 'fieldset' )
283  );
284  }
285 
293  public function formatRow( $result ) {
295 
296  # Revision deletion works on revisions, so we should cast one
297  $row = [
298  'comment' => $result->rc_comment,
299  'deleted' => $result->rc_deleted,
300  'user_text' => $result->rc_user_text,
301  'user' => $result->rc_user,
302  ];
303  $rev = new Revision( $row );
304  $rev->setTitle( $title );
305 
306  $classes = [];
307 
308  $lang = $this->getLanguage();
309  $dm = $lang->getDirMark();
310 
311  $spanTime = Html::element( 'span', [ 'class' => 'mw-newpages-time' ],
312  $lang->userTimeAndDate( $result->rc_timestamp, $this->getUser() )
313  );
314  $linkRenderer = $this->getLinkRenderer();
315  $time = $linkRenderer->makeKnownLink(
316  $title,
317  new HtmlArmor( $spanTime ),
318  [],
319  [ 'oldid' => $result->rc_this_oldid ]
320  );
321 
322  $query = $title->isRedirect() ? [ 'redirect' => 'no' ] : [];
323 
324  $plink = $linkRenderer->makeKnownLink(
325  $title,
326  null,
327  [ 'class' => 'mw-newpages-pagename' ],
328  $query
329  );
330  $histLink = $linkRenderer->makeKnownLink(
331  $title,
332  $this->msg( 'hist' )->text(),
333  [],
334  [ 'action' => 'history' ]
335  );
336  $hist = Html::rawElement( 'span', [ 'class' => 'mw-newpages-history' ],
337  $this->msg( 'parentheses' )->rawParams( $histLink )->escaped() );
338 
339  $length = Html::rawElement(
340  'span',
341  [ 'class' => 'mw-newpages-length' ],
342  $this->msg( 'brackets' )->rawParams(
343  $this->msg( 'nbytes' )->numParams( $result->length )->escaped()
344  )->escaped()
345  );
346 
347  $ulink = Linker::revUserTools( $rev );
349 
350  if ( $this->patrollable( $result ) ) {
351  $classes[] = 'not-patrolled';
352  }
353 
354  # Add a class for zero byte pages
355  if ( $result->length == 0 ) {
356  $classes[] = 'mw-newpages-zero-byte-page';
357  }
358 
359  # Tags, if any.
360  if ( isset( $result->ts_tags ) ) {
361  list( $tagDisplay, $newClasses ) = ChangeTags::formatSummaryRow(
362  $result->ts_tags,
363  'newpages',
364  $this->getContext()
365  );
366  $classes = array_merge( $classes, $newClasses );
367  } else {
368  $tagDisplay = '';
369  }
370 
371  $css = count( $classes ) ? ' class="' . implode( ' ', $classes ) . '"' : '';
372 
373  # Display the old title if the namespace/title has been changed
374  $oldTitleText = '';
375  $oldTitle = Title::makeTitle( $result->rc_namespace, $result->rc_title );
376 
377  if ( !$title->equals( $oldTitle ) ) {
378  $oldTitleText = $oldTitle->getPrefixedText();
379  $oldTitleText = Html::rawElement(
380  'span',
381  [ 'class' => 'mw-newpages-oldtitle' ],
382  $this->msg( 'rc-old-title' )->params( $oldTitleText )->escaped()
383  );
384  }
385 
386  return "<li{$css}>{$time} {$dm}{$plink} {$hist} {$dm}{$length} "
387  . "{$dm}{$ulink} {$comment} {$tagDisplay} {$oldTitleText}</li>\n";
388  }
389 
396  protected function patrollable( $result ) {
397  return ( $this->getUser()->useNPPatrol() && !$result->rc_patrolled );
398  }
399 
405  protected function feed( $type ) {
406  if ( !$this->getConfig()->get( 'Feed' ) ) {
407  $this->getOutput()->addWikiMsg( 'feed-unavailable' );
408 
409  return;
410  }
411 
412  $feedClasses = $this->getConfig()->get( 'FeedClasses' );
413  if ( !isset( $feedClasses[$type] ) ) {
414  $this->getOutput()->addWikiMsg( 'feed-invalid' );
415 
416  return;
417  }
418 
419  $feed = new $feedClasses[$type](
420  $this->feedTitle(),
421  $this->msg( 'tagline' )->text(),
422  $this->getPageTitle()->getFullURL()
423  );
424 
425  $pager = new NewPagesPager( $this, $this->opts );
426  $limit = $this->opts->getValue( 'limit' );
427  $pager->mLimit = min( $limit, $this->getConfig()->get( 'FeedLimit' ) );
428 
429  $feed->outHeader();
430  if ( $pager->getNumRows() > 0 ) {
431  foreach ( $pager->mResult as $row ) {
432  $feed->outItem( $this->feedItem( $row ) );
433  }
434  }
435  $feed->outFooter();
436  }
437 
438  protected function feedTitle() {
439  $desc = $this->getDescription();
440  $code = $this->getConfig()->get( 'LanguageCode' );
441  $sitename = $this->getConfig()->get( 'Sitename' );
442 
443  return "$sitename - $desc [$code]";
444  }
445 
446  protected function feedItem( $row ) {
447  $title = Title::makeTitle( intval( $row->rc_namespace ), $row->rc_title );
448  if ( $title ) {
449  $date = $row->rc_timestamp;
450  $comments = $title->getTalkPage()->getFullURL();
451 
452  return new FeedItem(
453  $title->getPrefixedText(),
454  $this->feedItemDesc( $row ),
455  $title->getFullURL(),
456  $date,
457  $this->feedItemAuthor( $row ),
458  $comments
459  );
460  } else {
461  return null;
462  }
463  }
464 
465  protected function feedItemAuthor( $row ) {
466  return isset( $row->rc_user_text ) ? $row->rc_user_text : '';
467  }
468 
469  protected function feedItemDesc( $row ) {
470  $revision = Revision::newFromId( $row->rev_id );
471  if ( $revision ) {
472  // XXX: include content model/type in feed item?
473  return '<p>' . htmlspecialchars( $revision->getUserText() ) .
474  $this->msg( 'colon-separator' )->inContentLanguage()->escaped() .
475  htmlspecialchars( FeedItem::stripComment( $revision->getComment() ) ) .
476  "</p>\n<hr />\n<div>" .
477  nl2br( htmlspecialchars( $revision->getContent()->serialize() ) ) . "</div>";
478  }
479 
480  return '';
481  }
482 
483  protected function getGroupName() {
484  return 'changes';
485  }
486 
487  protected function getCacheTTL() {
488  return 60 * 5;
489  }
490 }
static newFromRow($row)
Make a Title object from a DB row.
Definition: Title.php:450
Helper class to keep track of options when mixing links and form elements.
Definition: FormOptions.php:35
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
Definition: deferred.txt:11
static revComment(Revision $rev, $local=false, $isPublic=false)
Wrap and format the given revision's comment block, if the current user is allowed to view it...
Definition: Linker.php:1550
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
Definition: hooks.txt:802
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
Definition: hooks.txt:1555
getContext()
Gets the context this SpecialPage is executed in.
static rawElement($element, $attribs=[], $contents= '')
Returns an HTML element in a string.
Definition: Html.php:209
if(!isset($args[0])) $lang
A special page that list newly created pages.
static hidden($name, $value, array $attribs=[])
Convenience function to produce an input element with type=hidden.
Definition: Html.php:758
$comment
$value
msg()
Wrapper around wfMessage that sets the current context.
including($x=null)
Whether the special page is being evaluated via transclusion.
patrollable($result)
Should a specific result row provide "patrollable" links?
getOutput()
Get the OutputPage being used for this instance.
feed($type)
Output a subscription feed listing recent edits to this page.
static stripComment($text)
Quickie hack...
Definition: Feed.php:180
addHelpLink($to, $overrideBaseUrl=false)
Adds help link with an icon via page indicators.
The index of the header message $result[1]=The index of the body text message $result[2 through n]=Parameters passed to body text message.Please note the header message cannot receive/use parameters. 'ImportHandleLogItemXMLTag':When parsing a XML tag in a log item.Return false to stop further processing of the tag $reader:XMLReader object $logInfo:Array of information 'ImportHandlePageXMLTag':When parsing a XML tag in a page.Return false to stop further processing of the tag $reader:XMLReader object &$pageInfo:Array of information 'ImportHandleRevisionXMLTag':When parsing a XML tag in a page revision.Return false to stop further processing of the tag $reader:XMLReader object $pageInfo:Array of page information $revisionInfo:Array of revision information 'ImportHandleToplevelXMLTag':When parsing a top level XML tag.Return false to stop further processing of the tag $reader:XMLReader object 'ImportHandleUploadXMLTag':When parsing a XML tag in a file upload.Return false to stop further processing of the tag $reader:XMLReader object $revisionInfo:Array of information 'ImportLogInterwikiLink':Hook to change the interwiki link used in log entries and edit summaries for transwiki imports.&$fullInterwikiPrefix:Interwiki prefix, may contain colons.&$pageTitle:String that contains page title. 'ImportSources':Called when reading from the $wgImportSources configuration variable.Can be used to lazy-load the import sources list.&$importSources:The value of $wgImportSources.Modify as necessary.See the comment in DefaultSettings.php for the detail of how to structure this array. 'InfoAction':When building information to display on the action=info page.$context:IContextSource object &$pageInfo:Array of information 'InitializeArticleMaybeRedirect':MediaWiki check to see if title is a redirect.&$title:Title object for the current page &$request:WebRequest &$ignoreRedirect:boolean to skip redirect check &$target:Title/string of redirect target &$article:Article object 'InternalParseBeforeLinks':during Parser's internalParse method before links but after nowiki/noinclude/includeonly/onlyinclude and other processings.&$parser:Parser object &$text:string containing partially parsed text &$stripState:Parser's internal StripState object 'InternalParseBeforeSanitize':during Parser's internalParse method just before the parser removes unwanted/dangerous HTML tags and after nowiki/noinclude/includeonly/onlyinclude and other processings.Ideal for syntax-extensions after template/parser function execution which respect nowiki and HTML-comments.&$parser:Parser object &$text:string containing partially parsed text &$stripState:Parser's internal StripState object 'InterwikiLoadPrefix':When resolving if a given prefix is an interwiki or not.Return true without providing an interwiki to continue interwiki search.$prefix:interwiki prefix we are looking for.&$iwData:output array describing the interwiki with keys iw_url, iw_local, iw_trans and optionally iw_api and iw_wikiid. 'InvalidateEmailComplete':Called after a user's email has been invalidated successfully.$user:user(object) whose email is being invalidated 'IRCLineURL':When constructing the URL to use in an IRC notification.Callee may modify $url and $query, URL will be constructed as $url.$query &$url:URL to index.php &$query:Query string $rc:RecentChange object that triggered url generation 'IsFileCacheable':Override the result of Article::isFileCacheable()(if true) &$article:article(object) being checked 'IsTrustedProxy':Override the result of IP::isTrustedProxy() &$ip:IP being check &$result:Change this value to override the result of IP::isTrustedProxy() 'IsUploadAllowedFromUrl':Override the result of UploadFromUrl::isAllowedUrl() $url:URL used to upload from &$allowed:Boolean indicating if uploading is allowed for given URL 'isValidEmailAddr':Override the result of Sanitizer::validateEmail(), for instance to return false if the domain name doesn't match your organization.$addr:The e-mail address entered by the user &$result:Set this and return false to override the internal checks 'isValidPassword':Override the result of User::isValidPassword() $password:The password entered by the user &$result:Set this and return false to override the internal checks $user:User the password is being validated for 'Language::getMessagesFileName':$code:The language code or the language we're looking for a messages file for &$file:The messages file path, you can override this to change the location. 'LanguageGetMagic':DEPRECATED!Use $magicWords in a file listed in $wgExtensionMessagesFiles instead.Use this to define synonyms of magic words depending of the language &$magicExtensions:associative array of magic words synonyms $lang:language code(string) 'LanguageGetNamespaces':Provide custom ordering for namespaces or remove namespaces.Do not use this hook to add namespaces.Use CanonicalNamespaces for that.&$namespaces:Array of namespaces indexed by their numbers 'LanguageGetSpecialPageAliases':DEPRECATED!Use $specialPageAliases in a file listed in $wgExtensionMessagesFiles instead.Use to define aliases of special pages names depending of the language &$specialPageAliases:associative array of magic words synonyms $lang:language code(string) 'LanguageGetTranslatedLanguageNames':Provide translated language names.&$names:array of language code=> language name $code:language of the preferred translations 'LanguageLinks':Manipulate a page's language links.This is called in various places to allow extensions to define the effective language links for a page.$title:The page's Title.&$links:Associative array mapping language codes to prefixed links of the form"language:title".&$linkFlags:Associative array mapping prefixed links to arrays of flags.Currently unused, but planned to provide support for marking individual language links in the UI, e.g.for featured articles. 'LanguageSelector':Hook to change the language selector available on a page.$out:The output page.$cssClassName:CSS class name of the language selector. 'LinkBegin':DEPRECATED!Use HtmlPageLinkRendererBegin instead.Used when generating internal and interwiki links in Linker::link(), before processing starts.Return false to skip default processing and return $ret.See documentation for Linker::link() for details on the expected meanings of parameters.$skin:the Skin object $target:the Title that the link is pointing to &$html:the contents that the< a > tag should have(raw HTML) $result
Definition: hooks.txt:1934
outputHeader($summaryMessageKey= '')
Outputs a summary message on top of special pages Per default the message key is the canonical name o...
fetchValuesFromRequest(WebRequest $r, $optionKeys=null)
Fetch values for all options (or selected options) from the given WebRequest, making them available f...
FormOptions $opts
usually copyright or history_copyright This message must be in HTML not wikitext & $link
Definition: hooks.txt:2889
static fieldset($legend=false, $content=false, $attribs=[])
Shortcut for creating fieldsets.
Definition: Xml.php:578
static closeElement($element)
Shortcut to close an XML element.
Definition: Xml.php:118
Shortcut to construct an includable special page.
static groupHasPermission($group, $role)
Check, if the given group has the given permission.
Definition: User.php:4625
$css
static formatSummaryRow($tags, $page, IContextSource $context=null)
Creates HTML for the given tags.
Definition: ChangeTags.php:50
$self
$params
getDescription()
Returns the name that goes in the \ in the special page itself, and also the name that will be l...
setHeaders()
Sets headers - this should be called from the execute() method of all derived classes! ...
Object handling generic submission, CSRF protection, layout and other logic for UI forms...
Definition: HTMLForm.php:128
static makeTitleSafe($ns, $title, $fragment= '', $interwiki= '')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:535
namespace and then decline to actually register it file or subcat img or subcat $title
Definition: hooks.txt:953
static run($event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:131
design txt This is a brief overview of the new design More thorough and up to date information is available on the documentation wiki at etc Handles the details of getting and saving to the user table of the and dealing with sessions and cookies OutputPage Encapsulates the entire HTML page that will be sent in response to any server request It is used by calling its functions to add text
Definition: design.txt:12
formatRow($result)
Format a row, providing the timestamp, links to the page/history, size, user links, and a comment.
presenting them properly to the user as errors is done by the caller return true use this to change the list i e etc $rev
Definition: hooks.txt:1721
A base class for basic support for outputting syndication feeds in RSS and other formats.
Definition: Feed.php:38
This document is intended to provide useful advice for parties seeking to redistribute MediaWiki to end users It s targeted particularly at maintainers for Linux since it s been observed that distribution packages of MediaWiki often break We ve consistently had to recommend that users seeking support use official tarballs instead of their distribution s and this often solves whatever problem the user is having It would be nice if this could such as
Definition: distributors.txt:9
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
Definition: hooks.txt:802
add($name, $default, $type=self::AUTO)
Add an option to be handled by this FormOptions instance.
Definition: FormOptions.php:78
validateIntBounds($name, $min, $max)
execute($par)
Show a form for filtering namespace and username.
static newFromId($id, $flags=0)
Load a page revision from a given revision ID number.
Definition: Revision.php:110
injection txt This is an overview of how MediaWiki makes use of dependency injection The design described here grew from the discussion of RFC T384 The term dependency this means that anything an object needs to operate should be injected from the the object itself should only know narrow no concrete implementation of the logic it relies on The requirement to inject everything typically results in an architecture that based on two main types of and essentially stateless service objects that use other service objects to operate on the value objects As of the beginning MediaWiki is only starting to use the DI approach Much of the code still relies on global state or direct resulting in a highly cyclical dependency which acts as the top level factory for services in MediaWiki which can be used to gain access to default instances of various services MediaWikiServices however also allows new services to be defined and default services to be redefined Services are defined or redefined by providing a callback the instantiator that will return a new instance of the service When it will create an instance of MediaWikiServices and populate it with the services defined in the files listed by thereby bootstrapping the DI framework Per $wgServiceWiringFiles lists includes ServiceWiring php
Definition: injection.txt:35
this hook is for auditing only or null if authentication failed before getting that far $username
Definition: hooks.txt:802
versus $oldTitle
Definition: globals.txt:16
getUser()
Shortcut to get the User executing this instance.
wfArrayToCgi($array1, $array2=null, $prefix= '')
This function takes one or two arrays as input, and returns a CGI-style string, e.g.
getConfig()
Shortcut to get main config object.
getLanguage()
Shortcut to get user's language.
this hook is for auditing only RecentChangesLinked and Watchlist RecentChangesLinked and Watchlist e g Watchlist removed from all revisions and log entries to which it was applied This gives extensions a chance to take it off their books as the deletion has already been partly carried out by this point or something similar the user will be unable to create the tag set and then return false from the hook function Ensure you consume the ChangeTagAfterDelete hook to carry out custom deletion actions as context called by AbstractContent::getParserOutput May be used to override the normal model specific rendering of page content as context as context the output can only depend on parameters provided to this hook not on global state indicating whether full HTML should be generated If generation of HTML may be but other information should still be present in the ParserOutput object to manipulate or replace but no entry for that model exists in $wgContentHandlers if desired whether it is OK to use $contentModel on $title Handler functions that modify $ok should generally return false to prevent further hooks from further modifying $ok inclusive $limit
Definition: hooks.txt:1046
getRequest()
Get the WebRequest being used for this instance.
static revUserTools($rev, $isPublic=false)
Generate a user tool link cluster if the current user is allowed to view it.
Definition: Linker.php:1141
static element($element, $attribs=[], $contents= '')
Identical to rawElement(), but HTML-escapes $contents (like Xml::element()).
Definition: Html.php:229
do that in ParserLimitReportFormat instead use this to modify the parameters of the image and a DIV can begin in one section and end in another Make sure your code can handle that case gracefully See the EditSectionClearerLink extension for an example zero but section is usually empty its values are the globals values before the output is cached one of or reset my talk my contributions etc etc otherwise the built in rate limiting checks are if enabled allows for interception of redirect as a string mapping parameter names to values & $type
Definition: hooks.txt:2491
static makeTitle($ns, $title, $fragment= '', $interwiki= '')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:511
see documentation in includes Linker php for Linker::makeImageLink & $time
Definition: hooks.txt:1749
getPageTitle($subpage=false)
Get a self-referential title object.
MediaWiki Linker LinkRenderer null $linkRenderer
Definition: SpecialPage.php:66