MediaWiki  master
Linker.php
Go to the documentation of this file.
1 <?php
25 
35 class Linker {
39  const TOOL_LINKS_NOBLOCK = 1;
40  const TOOL_LINKS_EMAIL = 2;
41 
85  public static function link(
86  $target, $html = null, $customAttribs = [], $query = [], $options = []
87  ) {
88  if ( !$target instanceof LinkTarget ) {
89  wfWarn( __METHOD__ . ': Requires $target to be a LinkTarget object.', 2 );
90  return "<!-- ERROR -->$html";
91  }
92 
93  $services = MediaWikiServices::getInstance();
94  $options = (array)$options;
95  if ( $options ) {
96  // Custom options, create new LinkRenderer
97  if ( !isset( $options['stubThreshold'] ) ) {
98  $defaultLinkRenderer = $services->getLinkRenderer();
99  $options['stubThreshold'] = $defaultLinkRenderer->getStubThreshold();
100  }
101  $linkRenderer = $services->getLinkRendererFactory()
102  ->createFromLegacyOptions( $options );
103  } else {
104  $linkRenderer = $services->getLinkRenderer();
105  }
106 
107  if ( $html !== null ) {
108  $text = new HtmlArmor( $html );
109  } else {
110  $text = null;
111  }
112 
113  if ( in_array( 'known', $options, true ) ) {
114  return $linkRenderer->makeKnownLink( $target, $text, $customAttribs, $query );
115  }
116 
117  if ( in_array( 'broken', $options, true ) ) {
118  return $linkRenderer->makeBrokenLink( $target, $text, $customAttribs, $query );
119  }
120 
121  if ( in_array( 'noclasses', $options, true ) ) {
122  return $linkRenderer->makePreloadedLink( $target, $text, '', $customAttribs, $query );
123  }
124 
125  return $linkRenderer->makeLink( $target, $text, $customAttribs, $query );
126  }
127 
141  public static function linkKnown(
142  $target, $html = null, $customAttribs = [],
143  $query = [], $options = [ 'known' ]
144  ) {
145  return self::link( $target, $html, $customAttribs, $query, $options );
146  }
147 
163  public static function makeSelfLinkObj( $nt, $html = '', $query = '', $trail = '', $prefix = '' ) {
164  $nt = Title::newFromLinkTarget( $nt );
165  $ret = "<a class=\"mw-selflink selflink\">{$prefix}{$html}</a>{$trail}";
166  if ( !Hooks::run( 'SelfLinkBegin', [ $nt, &$html, &$trail, &$prefix, &$ret ] ) ) {
167  return $ret;
168  }
169 
170  if ( $html == '' ) {
171  $html = htmlspecialchars( $nt->getPrefixedText() );
172  }
173  list( $inside, $trail ) = self::splitTrail( $trail );
174  return "<a class=\"mw-selflink selflink\">{$prefix}{$html}{$inside}</a>{$trail}";
175  }
176 
187  public static function getInvalidTitleDescription( IContextSource $context, $namespace, $title ) {
188  // First we check whether the namespace exists or not.
189  if ( MediaWikiServices::getInstance()->getNamespaceInfo()->exists( $namespace ) ) {
190  if ( $namespace == NS_MAIN ) {
191  $name = $context->msg( 'blanknamespace' )->text();
192  } else {
193  $name = MediaWikiServices::getInstance()->getContentLanguage()->
194  getFormattedNsText( $namespace );
195  }
196  return $context->msg( 'invalidtitle-knownnamespace', $namespace, $name, $title )->text();
197  }
198 
199  return $context->msg( 'invalidtitle-unknownnamespace', $namespace, $title )->text();
200  }
201 
207  public static function normaliseSpecialPage( LinkTarget $target ) {
208  if ( $target->getNamespace() == NS_SPECIAL && !$target->isExternal() ) {
209  list( $name, $subpage ) = MediaWikiServices::getInstance()->getSpecialPageFactory()->
210  resolveAlias( $target->getDBkey() );
211  if ( $name ) {
212  return SpecialPage::getTitleValueFor( $name, $subpage, $target->getFragment() );
213  }
214  }
215 
216  return $target;
217  }
218 
227  private static function fnamePart( $url ) {
228  $basename = strrchr( $url, '/' );
229  if ( $basename === false ) {
230  $basename = $url;
231  } else {
232  $basename = substr( $basename, 1 );
233  }
234  return $basename;
235  }
236 
247  public static function makeExternalImage( $url, $alt = '' ) {
248  if ( $alt == '' ) {
249  $alt = self::fnamePart( $url );
250  }
251  $img = '';
252  $success = Hooks::run( 'LinkerMakeExternalImage', [ &$url, &$alt, &$img ] );
253  if ( !$success ) {
254  wfDebug( "Hook LinkerMakeExternalImage changed the output of external image "
255  . "with url {$url} and alt text {$alt} to {$img}\n", true );
256  return $img;
257  }
258  return Html::element( 'img',
259  [
260  'src' => $url,
261  'alt' => $alt
262  ]
263  );
264  }
265 
303  public static function makeImageLink( Parser $parser, LinkTarget $title,
304  $file, $frameParams = [], $handlerParams = [], $time = false,
305  $query = "", $widthOption = null
306  ) {
307  $title = Title::newFromLinkTarget( $title );
308  $res = null;
309  $dummy = new DummyLinker;
310  if ( !Hooks::run( 'ImageBeforeProduceHTML', [ &$dummy, &$title,
311  &$file, &$frameParams, &$handlerParams, &$time, &$res,
312  $parser, &$query, &$widthOption
313  ] ) ) {
314  return $res;
315  }
316 
317  if ( $file && !$file->allowInlineDisplay() ) {
318  wfDebug( __METHOD__ . ': ' . $title->getPrefixedDBkey() . " does not allow inline display\n" );
319  return self::link( $title );
320  }
321 
322  // Clean up parameters
323  $page = $handlerParams['page'] ?? false;
324  if ( !isset( $frameParams['align'] ) ) {
325  $frameParams['align'] = '';
326  }
327  if ( !isset( $frameParams['alt'] ) ) {
328  $frameParams['alt'] = '';
329  }
330  if ( !isset( $frameParams['title'] ) ) {
331  $frameParams['title'] = '';
332  }
333  if ( !isset( $frameParams['class'] ) ) {
334  $frameParams['class'] = '';
335  }
336 
337  $prefix = $postfix = '';
338 
339  if ( $frameParams['align'] == 'center' ) {
340  $prefix = '<div class="center">';
341  $postfix = '</div>';
342  $frameParams['align'] = 'none';
343  }
344  if ( $file && !isset( $handlerParams['width'] ) ) {
345  if ( isset( $handlerParams['height'] ) && $file->isVectorized() ) {
346  // If its a vector image, and user only specifies height
347  // we don't want it to be limited by its "normal" width.
348  global $wgSVGMaxSize;
349  $handlerParams['width'] = $wgSVGMaxSize;
350  } else {
351  $handlerParams['width'] = $file->getWidth( $page );
352  }
353 
354  if ( isset( $frameParams['thumbnail'] )
355  || isset( $frameParams['manualthumb'] )
356  || isset( $frameParams['framed'] )
357  || isset( $frameParams['frameless'] )
358  || !$handlerParams['width']
359  ) {
361 
362  if ( $widthOption === null || !isset( $wgThumbLimits[$widthOption] ) ) {
363  $widthOption = User::getDefaultOption( 'thumbsize' );
364  }
365 
366  // Reduce width for upright images when parameter 'upright' is used
367  if ( isset( $frameParams['upright'] ) && $frameParams['upright'] == 0 ) {
368  $frameParams['upright'] = $wgThumbUpright;
369  }
370 
371  // For caching health: If width scaled down due to upright
372  // parameter, round to full __0 pixel to avoid the creation of a
373  // lot of odd thumbs.
374  $prefWidth = isset( $frameParams['upright'] ) ?
375  round( $wgThumbLimits[$widthOption] * $frameParams['upright'], -1 ) :
376  $wgThumbLimits[$widthOption];
377 
378  // Use width which is smaller: real image width or user preference width
379  // Unless image is scalable vector.
380  if ( !isset( $handlerParams['height'] ) && ( $handlerParams['width'] <= 0 ||
381  $prefWidth < $handlerParams['width'] || $file->isVectorized() ) ) {
382  $handlerParams['width'] = $prefWidth;
383  }
384  }
385  }
386 
387  if ( isset( $frameParams['thumbnail'] ) || isset( $frameParams['manualthumb'] )
388  || isset( $frameParams['framed'] )
389  ) {
390  # Create a thumbnail. Alignment depends on the writing direction of
391  # the page content language (right-aligned for LTR languages,
392  # left-aligned for RTL languages)
393  # If a thumbnail width has not been provided, it is set
394  # to the default user option as specified in Language*.php
395  if ( $frameParams['align'] == '' ) {
396  $frameParams['align'] = $parser->getTargetLanguage()->alignEnd();
397  }
398  return $prefix .
399  self::makeThumbLink2( $title, $file, $frameParams, $handlerParams, $time, $query ) .
400  $postfix;
401  }
402 
403  if ( $file && isset( $frameParams['frameless'] ) ) {
404  $srcWidth = $file->getWidth( $page );
405  # For "frameless" option: do not present an image bigger than the
406  # source (for bitmap-style images). This is the same behavior as the
407  # "thumb" option does it already.
408  if ( $srcWidth && !$file->mustRender() && $handlerParams['width'] > $srcWidth ) {
409  $handlerParams['width'] = $srcWidth;
410  }
411  }
412 
413  if ( $file && isset( $handlerParams['width'] ) ) {
414  # Create a resized image, without the additional thumbnail features
415  $thumb = $file->transform( $handlerParams );
416  } else {
417  $thumb = false;
418  }
419 
420  if ( !$thumb ) {
421  $s = self::makeBrokenImageLinkObj( $title, $frameParams['title'], '', '', '', $time == true );
422  } else {
423  self::processResponsiveImages( $file, $thumb, $handlerParams );
424  $params = [
425  'alt' => $frameParams['alt'],
426  'title' => $frameParams['title'],
427  'valign' => $frameParams['valign'] ?? false,
428  'img-class' => $frameParams['class'] ];
429  if ( isset( $frameParams['border'] ) ) {
430  $params['img-class'] .= ( $params['img-class'] !== '' ? ' ' : '' ) . 'thumbborder';
431  }
432  $params = self::getImageLinkMTOParams( $frameParams, $query, $parser ) + $params;
433 
434  $s = $thumb->toHtml( $params );
435  }
436  if ( $frameParams['align'] != '' ) {
438  'div',
439  [ 'class' => 'float' . $frameParams['align'] ],
440  $s
441  );
442  }
443  return str_replace( "\n", ' ', $prefix . $s . $postfix );
444  }
445 
454  private static function getImageLinkMTOParams( $frameParams, $query = '', $parser = null ) {
455  $mtoParams = [];
456  if ( isset( $frameParams['link-url'] ) && $frameParams['link-url'] !== '' ) {
457  $mtoParams['custom-url-link'] = $frameParams['link-url'];
458  if ( isset( $frameParams['link-target'] ) ) {
459  $mtoParams['custom-target-link'] = $frameParams['link-target'];
460  }
461  if ( $parser ) {
462  $extLinkAttrs = $parser->getExternalLinkAttribs( $frameParams['link-url'] );
463  foreach ( $extLinkAttrs as $name => $val ) {
464  // Currently could include 'rel' and 'target'
465  $mtoParams['parser-extlink-' . $name] = $val;
466  }
467  }
468  } elseif ( isset( $frameParams['link-title'] ) && $frameParams['link-title'] !== '' ) {
469  $mtoParams['custom-title-link'] = Title::newFromLinkTarget(
470  self::normaliseSpecialPage( $frameParams['link-title'] )
471  );
472  } elseif ( !empty( $frameParams['no-link'] ) ) {
473  // No link
474  } else {
475  $mtoParams['desc-link'] = true;
476  $mtoParams['desc-query'] = $query;
477  }
478  return $mtoParams;
479  }
480 
493  public static function makeThumbLinkObj( LinkTarget $title, $file, $label = '', $alt = '',
494  $align = 'right', $params = [], $framed = false, $manualthumb = ""
495  ) {
496  $frameParams = [
497  'alt' => $alt,
498  'caption' => $label,
499  'align' => $align
500  ];
501  if ( $framed ) {
502  $frameParams['framed'] = true;
503  }
504  if ( $manualthumb ) {
505  $frameParams['manualthumb'] = $manualthumb;
506  }
507  return self::makeThumbLink2( $title, $file, $frameParams, $params );
508  }
509 
519  public static function makeThumbLink2( LinkTarget $title, $file, $frameParams = [],
520  $handlerParams = [], $time = false, $query = ""
521  ) {
522  $exists = $file && $file->exists();
523 
524  $page = $handlerParams['page'] ?? false;
525  if ( !isset( $frameParams['align'] ) ) {
526  $frameParams['align'] = 'right';
527  }
528  if ( !isset( $frameParams['alt'] ) ) {
529  $frameParams['alt'] = '';
530  }
531  if ( !isset( $frameParams['title'] ) ) {
532  $frameParams['title'] = '';
533  }
534  if ( !isset( $frameParams['caption'] ) ) {
535  $frameParams['caption'] = '';
536  }
537 
538  if ( empty( $handlerParams['width'] ) ) {
539  // Reduce width for upright images when parameter 'upright' is used
540  $handlerParams['width'] = isset( $frameParams['upright'] ) ? 130 : 180;
541  }
542  $thumb = false;
543  $noscale = false;
544  $manualthumb = false;
545 
546  if ( !$exists ) {
547  $outerWidth = $handlerParams['width'] + 2;
548  } else {
549  if ( isset( $frameParams['manualthumb'] ) ) {
550  # Use manually specified thumbnail
551  $manual_title = Title::makeTitleSafe( NS_FILE, $frameParams['manualthumb'] );
552  if ( $manual_title ) {
553  $manual_img = MediaWikiServices::getInstance()->getRepoGroup()
554  ->findFile( $manual_title );
555  if ( $manual_img ) {
556  $thumb = $manual_img->getUnscaledThumb( $handlerParams );
557  $manualthumb = true;
558  } else {
559  $exists = false;
560  }
561  }
562  } elseif ( isset( $frameParams['framed'] ) ) {
563  // Use image dimensions, don't scale
564  $thumb = $file->getUnscaledThumb( $handlerParams );
565  $noscale = true;
566  } else {
567  # Do not present an image bigger than the source, for bitmap-style images
568  # This is a hack to maintain compatibility with arbitrary pre-1.10 behavior
569  $srcWidth = $file->getWidth( $page );
570  if ( $srcWidth && !$file->mustRender() && $handlerParams['width'] > $srcWidth ) {
571  $handlerParams['width'] = $srcWidth;
572  }
573  $thumb = $file->transform( $handlerParams );
574  }
575 
576  if ( $thumb ) {
577  $outerWidth = $thumb->getWidth() + 2;
578  } else {
579  $outerWidth = $handlerParams['width'] + 2;
580  }
581  }
582 
583  # ThumbnailImage::toHtml() already adds page= onto the end of DjVu URLs
584  # So we don't need to pass it here in $query. However, the URL for the
585  # zoom icon still needs it, so we make a unique query for it. See T16771
586  $url = Title::newFromLinkTarget( $title )->getLocalURL( $query );
587  if ( $page ) {
588  $url = wfAppendQuery( $url, [ 'page' => $page ] );
589  }
590  if ( $manualthumb
591  && !isset( $frameParams['link-title'] )
592  && !isset( $frameParams['link-url'] )
593  && !isset( $frameParams['no-link'] ) ) {
594  $frameParams['link-url'] = $url;
595  }
596 
597  $s = "<div class=\"thumb t{$frameParams['align']}\">"
598  . "<div class=\"thumbinner\" style=\"width:{$outerWidth}px;\">";
599 
600  if ( !$exists ) {
601  $s .= self::makeBrokenImageLinkObj( $title, $frameParams['title'], '', '', '', $time == true );
602  $zoomIcon = '';
603  } elseif ( !$thumb ) {
604  $s .= wfMessage( 'thumbnail_error', '' )->escaped();
605  $zoomIcon = '';
606  } else {
607  if ( !$noscale && !$manualthumb ) {
608  self::processResponsiveImages( $file, $thumb, $handlerParams );
609  }
610  $params = [
611  'alt' => $frameParams['alt'],
612  'title' => $frameParams['title'],
613  'img-class' => ( isset( $frameParams['class'] ) && $frameParams['class'] !== ''
614  ? $frameParams['class'] . ' '
615  : '' ) . 'thumbimage'
616  ];
617  $params = self::getImageLinkMTOParams( $frameParams, $query ) + $params;
618  $s .= $thumb->toHtml( $params );
619  if ( isset( $frameParams['framed'] ) ) {
620  $zoomIcon = "";
621  } else {
622  $zoomIcon = Html::rawElement( 'div', [ 'class' => 'magnify' ],
623  Html::rawElement( 'a', [
624  'href' => $url,
625  'class' => 'internal',
626  'title' => wfMessage( 'thumbnail-more' )->text() ],
627  "" ) );
628  }
629  }
630  $s .= ' <div class="thumbcaption">' . $zoomIcon . $frameParams['caption'] . "</div></div></div>";
631  return str_replace( "\n", ' ', $s );
632  }
633 
642  public static function processResponsiveImages( $file, $thumb, $hp ) {
643  global $wgResponsiveImages;
644  if ( $wgResponsiveImages && $thumb && !$thumb->isError() ) {
645  $hp15 = $hp;
646  $hp15['width'] = round( $hp['width'] * 1.5 );
647  $hp20 = $hp;
648  $hp20['width'] = $hp['width'] * 2;
649  if ( isset( $hp['height'] ) ) {
650  $hp15['height'] = round( $hp['height'] * 1.5 );
651  $hp20['height'] = $hp['height'] * 2;
652  }
653 
654  $thumb15 = $file->transform( $hp15 );
655  $thumb20 = $file->transform( $hp20 );
656  if ( $thumb15 && !$thumb15->isError() && $thumb15->getUrl() !== $thumb->getUrl() ) {
657  $thumb->responsiveUrls['1.5'] = $thumb15->getUrl();
658  }
659  if ( $thumb20 && !$thumb20->isError() && $thumb20->getUrl() !== $thumb->getUrl() ) {
660  $thumb->responsiveUrls['2'] = $thumb20->getUrl();
661  }
662  }
663  }
664 
677  public static function makeBrokenImageLinkObj( $title, $label = '',
678  $query = '', $unused1 = '', $unused2 = '', $time = false
679  ) {
680  if ( !$title instanceof LinkTarget ) {
681  wfWarn( __METHOD__ . ': Requires $title to be a LinkTarget object.' );
682  return "<!-- ERROR -->" . htmlspecialchars( $label );
683  }
684 
686 
688  if ( $label == '' ) {
689  $label = $title->getPrefixedText();
690  }
691  $repoGroup = MediaWikiServices::getInstance()->getRepoGroup();
692  $currentExists = $time
693  && $repoGroup->findFile( $title ) !== false;
694 
695  if ( ( $wgUploadMissingFileUrl || $wgUploadNavigationUrl || $wgEnableUploads )
696  && !$currentExists
697  ) {
698  if ( $repoGroup->getLocalRepo()->checkRedirect( $title ) ) {
699  // We already know it's a redirect, so mark it accordingly
700  return self::link(
701  $title,
702  htmlspecialchars( $label ),
703  [ 'class' => 'mw-redirect' ],
704  wfCgiToArray( $query ),
705  [ 'known', 'noclasses' ]
706  );
707  }
708 
709  return Html::element( 'a', [
710  'href' => self::getUploadUrl( $title, $query ),
711  'class' => 'new',
712  'title' => $title->getPrefixedText()
713  ], $label );
714  }
715 
716  return self::link(
717  $title,
718  htmlspecialchars( $label ),
719  [],
720  wfCgiToArray( $query ),
721  [ 'known', 'noclasses' ]
722  );
723  }
724 
733  protected static function getUploadUrl( $destFile, $query = '' ) {
735  $q = 'wpDestFile=' . Title::castFromLinkTarget( $destFile )->getPartialURL();
736  if ( $query != '' ) {
737  $q .= '&' . $query;
738  }
739 
740  if ( $wgUploadMissingFileUrl ) {
741  return wfAppendQuery( $wgUploadMissingFileUrl, $q );
742  }
743 
744  if ( $wgUploadNavigationUrl ) {
745  return wfAppendQuery( $wgUploadNavigationUrl, $q );
746  }
747 
748  $upload = SpecialPage::getTitleFor( 'Upload' );
749 
750  return $upload->getLocalURL( $q );
751  }
752 
762  public static function makeMediaLinkObj( $title, $html = '', $time = false ) {
763  $img = MediaWikiServices::getInstance()->getRepoGroup()->findFile(
764  $title, [ 'time' => $time ]
765  );
766  return self::makeMediaLinkFile( $title, $img, $html );
767  }
768 
781  public static function makeMediaLinkFile( LinkTarget $title, $file, $html = '' ) {
782  if ( $file && $file->exists() ) {
783  $url = $file->getUrl();
784  $class = 'internal';
785  } else {
786  $url = self::getUploadUrl( $title );
787  $class = 'new';
788  }
789 
790  $alt = $title->getText();
791  if ( $html == '' ) {
792  $html = $alt;
793  }
794 
795  $ret = '';
796  $attribs = [
797  'href' => $url,
798  'class' => $class,
799  'title' => $alt
800  ];
801 
802  if ( !Hooks::run( 'LinkerMakeMediaLinkFile',
803  [ Title::castFromLinkTarget( $title ), $file, &$html, &$attribs, &$ret ] ) ) {
804  wfDebug( "Hook LinkerMakeMediaLinkFile changed the output of link "
805  . "with url {$url} and text {$html} to {$ret}\n", true );
806  return $ret;
807  }
808 
809  return Html::rawElement( 'a', $attribs, $html );
810  }
811 
822  public static function specialLink( $name, $key = '' ) {
823  if ( $key == '' ) {
824  $key = strtolower( $name );
825  }
826 
827  return self::linkKnown( SpecialPage::getTitleFor( $name ), wfMessage( $key )->escaped() );
828  }
829 
848  public static function makeExternalLink( $url, $text, $escape = true,
849  $linktype = '', $attribs = [], $title = null
850  ) {
851  global $wgTitle;
852  $class = "external";
853  if ( $linktype ) {
854  $class .= " $linktype";
855  }
856  if ( isset( $attribs['class'] ) && $attribs['class'] ) {
857  $class .= " {$attribs['class']}";
858  }
859  $attribs['class'] = $class;
860 
861  if ( $escape ) {
862  $text = htmlspecialchars( $text );
863  }
864 
865  if ( !$title ) {
866  $title = $wgTitle;
867  }
868  $newRel = Parser::getExternalLinkRel( $url, $title );
869  if ( !isset( $attribs['rel'] ) || $attribs['rel'] === '' ) {
870  $attribs['rel'] = $newRel;
871  } elseif ( $newRel !== '' ) {
872  // Merge the rel attributes.
873  $newRels = explode( ' ', $newRel );
874  $oldRels = explode( ' ', $attribs['rel'] );
875  $combined = array_unique( array_merge( $newRels, $oldRels ) );
876  $attribs['rel'] = implode( ' ', $combined );
877  }
878  $link = '';
879  $success = Hooks::run( 'LinkerMakeExternalLink',
880  [ &$url, &$text, &$link, &$attribs, $linktype ] );
881  if ( !$success ) {
882  wfDebug( "Hook LinkerMakeExternalLink changed the output of link "
883  . "with url {$url} and text {$text} to {$link}\n", true );
884  return $link;
885  }
886  $attribs['href'] = $url;
887  return Html::rawElement( 'a', $attribs, $text );
888  }
889 
898  public static function userLink( $userId, $userName, $altUserName = false ) {
899  if ( $userName === '' || $userName === false || $userName === null ) {
900  wfDebug( __METHOD__ . ' received an empty username. Are there database errors ' .
901  'that need to be fixed?' );
902  return wfMessage( 'empty-username' )->parse();
903  }
904 
905  $classes = 'mw-userlink';
906  $page = null;
907  if ( $userId == 0 ) {
908  $page = ExternalUserNames::getUserLinkTitle( $userName );
909 
910  if ( ExternalUserNames::isExternal( $userName ) ) {
911  $classes .= ' mw-extuserlink';
912  } elseif ( $altUserName === false ) {
913  $altUserName = IP::prettifyIP( $userName );
914  }
915  $classes .= ' mw-anonuserlink'; // Separate link class for anons (T45179)
916  } else {
917  $page = new TitleValue( NS_USER, strtr( $userName, ' ', '_' ) );
918  }
919 
920  // Wrap the output with <bdi> tags for directionality isolation
921  $linkText =
922  '<bdi>' . htmlspecialchars( $altUserName !== false ? $altUserName : $userName ) . '</bdi>';
923 
924  return $page
925  ? self::link( $page, $linkText, [ 'class' => $classes ] )
926  : Html::rawElement( 'span', [ 'class' => $classes ], $linkText );
927  }
928 
943  public static function userToolLinks(
944  $userId, $userText, $redContribsWhenNoEdits = false, $flags = 0, $edits = null,
945  $useParentheses = true
946  ) {
947  if ( $userText === '' ) {
948  wfDebug( __METHOD__ . ' received an empty username. Are there database errors ' .
949  'that need to be fixed?' );
950  return ' ' . wfMessage( 'empty-username' )->parse();
951  }
952 
953  global $wgUser, $wgDisableAnonTalk, $wgLang;
954  $talkable = !( $wgDisableAnonTalk && $userId == 0 );
955  $blockable = !( $flags & self::TOOL_LINKS_NOBLOCK );
956  $addEmailLink = $flags & self::TOOL_LINKS_EMAIL && $userId;
957 
958  if ( $userId == 0 && ExternalUserNames::isExternal( $userText ) ) {
959  // No tools for an external user
960  return '';
961  }
962 
963  $items = [];
964  if ( $talkable ) {
965  $items[] = self::userTalkLink( $userId, $userText );
966  }
967  if ( $userId ) {
968  // check if the user has an edit
969  $attribs = [];
970  $attribs['class'] = 'mw-usertoollinks-contribs';
971  if ( $redContribsWhenNoEdits ) {
972  if ( intval( $edits ) === 0 && $edits !== 0 ) {
973  $user = User::newFromId( $userId );
974  $edits = $user->getEditCount();
975  }
976  if ( $edits === 0 ) {
977  $attribs['class'] .= ' new';
978  }
979  }
980  $contribsPage = SpecialPage::getTitleFor( 'Contributions', $userText );
981 
982  $items[] = self::link( $contribsPage, wfMessage( 'contribslink' )->escaped(), $attribs );
983  }
984  $userCanBlock = MediaWikiServices::getInstance()->getPermissionManager()
985  ->userHasRight( $wgUser, 'block' );
986  if ( $blockable && $userCanBlock ) {
987  $items[] = self::blockLink( $userId, $userText );
988  }
989 
990  if ( $addEmailLink && $wgUser->canSendEmail() ) {
991  $items[] = self::emailLink( $userId, $userText );
992  }
993 
994  Hooks::run( 'UserToolLinksEdit', [ $userId, $userText, &$items ] );
995 
996  if ( !$items ) {
997  return '';
998  }
999 
1000  if ( $useParentheses ) {
1001  return wfMessage( 'word-separator' )->escaped()
1002  . '<span class="mw-usertoollinks">'
1003  . wfMessage( 'parentheses' )->rawParams( $wgLang->pipeList( $items ) )->escaped()
1004  . '</span>';
1005  }
1006 
1007  $tools = [];
1008  foreach ( $items as $tool ) {
1009  $tools[] = Html::rawElement( 'span', [], $tool );
1010  }
1011  return ' <span class="mw-usertoollinks mw-changeslist-links">' .
1012  implode( ' ', $tools ) . '</span>';
1013  }
1014 
1024  public static function userToolLinksRedContribs(
1025  $userId, $userText, $edits = null, $useParentheses = true
1026  ) {
1027  return self::userToolLinks( $userId, $userText, true, 0, $edits, $useParentheses );
1028  }
1029 
1036  public static function userTalkLink( $userId, $userText ) {
1037  if ( $userText === '' ) {
1038  wfDebug( __METHOD__ . ' received an empty username. Are there database errors ' .
1039  'that need to be fixed?' );
1040  return wfMessage( 'empty-username' )->parse();
1041  }
1042 
1043  $userTalkPage = new TitleValue( NS_USER_TALK, strtr( $userText, ' ', '_' ) );
1044  $moreLinkAttribs = [ 'class' => 'mw-usertoollinks-talk' ];
1045 
1046  return self::link( $userTalkPage,
1047  wfMessage( 'talkpagelinktext' )->escaped(),
1048  $moreLinkAttribs
1049  );
1050  }
1051 
1058  public static function blockLink( $userId, $userText ) {
1059  if ( $userText === '' ) {
1060  wfDebug( __METHOD__ . ' received an empty username. Are there database errors ' .
1061  'that need to be fixed?' );
1062  return wfMessage( 'empty-username' )->parse();
1063  }
1064 
1065  $blockPage = SpecialPage::getTitleFor( 'Block', $userText );
1066  $moreLinkAttribs = [ 'class' => 'mw-usertoollinks-block' ];
1067 
1068  return self::link( $blockPage,
1069  wfMessage( 'blocklink' )->escaped(),
1070  $moreLinkAttribs
1071  );
1072  }
1073 
1079  public static function emailLink( $userId, $userText ) {
1080  if ( $userText === '' ) {
1081  wfLogWarning( __METHOD__ . ' received an empty username. Are there database errors ' .
1082  'that need to be fixed?' );
1083  return wfMessage( 'empty-username' )->parse();
1084  }
1085 
1086  $emailPage = SpecialPage::getTitleFor( 'Emailuser', $userText );
1087  $moreLinkAttribs = [ 'class' => 'mw-usertoollinks-mail' ];
1088  return self::link( $emailPage,
1089  wfMessage( 'emaillink' )->escaped(),
1090  $moreLinkAttribs
1091  );
1092  }
1093 
1101  public static function revUserLink( $rev, $isPublic = false ) {
1102  if ( $rev->isDeleted( RevisionRecord::DELETED_USER ) && $isPublic ) {
1103  $link = wfMessage( 'rev-deleted-user' )->escaped();
1104  } elseif ( $rev->userCan( RevisionRecord::DELETED_USER ) ) {
1105  $link = self::userLink( $rev->getUser( RevisionRecord::FOR_THIS_USER ),
1106  $rev->getUserText( RevisionRecord::FOR_THIS_USER ) );
1107  } else {
1108  $link = wfMessage( 'rev-deleted-user' )->escaped();
1109  }
1110  if ( $rev->isDeleted( RevisionRecord::DELETED_USER ) ) {
1111  return '<span class="history-deleted">' . $link . '</span>';
1112  }
1113  return $link;
1114  }
1115 
1124  public static function revUserTools( $rev, $isPublic = false, $useParentheses = true ) {
1125  if ( $rev->userCan( RevisionRecord::DELETED_USER ) &&
1126  ( !$rev->isDeleted( RevisionRecord::DELETED_USER ) || !$isPublic )
1127  ) {
1128  $userId = $rev->getUser( RevisionRecord::FOR_THIS_USER );
1129  $userText = $rev->getUserText( RevisionRecord::FOR_THIS_USER );
1130  if ( $userId || (string)$userText !== '' ) {
1131  $link = self::userLink( $userId, $userText )
1132  . self::userToolLinks( $userId, $userText, false, 0, null,
1133  $useParentheses );
1134  }
1135  }
1136 
1137  if ( !isset( $link ) ) {
1138  $link = wfMessage( 'rev-deleted-user' )->escaped();
1139  }
1140 
1141  if ( $rev->isDeleted( RevisionRecord::DELETED_USER ) ) {
1142  return ' <span class="history-deleted mw-userlink">' . $link . '</span>';
1143  }
1144  return $link;
1145  }
1146 
1165  public static function formatComment(
1166  $comment, $title = null, $local = false, $wikiId = null
1167  ) {
1168  # Sanitize text a bit:
1169  $comment = str_replace( "\n", " ", $comment );
1170  # Allow HTML entities (for T15815)
1171  $comment = Sanitizer::escapeHtmlAllowEntities( $comment );
1172 
1173  # Render autocomments and make links:
1174  $comment = self::formatAutocomments( $comment, $title, $local, $wikiId );
1175  return self::formatLinksInComment( $comment, $title, $local, $wikiId );
1176  }
1177 
1195  private static function formatAutocomments(
1196  $comment, $title = null, $local = false, $wikiId = null
1197  ) {
1198  // @todo $append here is something of a hack to preserve the status
1199  // quo. Someone who knows more about bidi and such should decide
1200  // (1) what sane rendering even *is* for an LTR edit summary on an RTL
1201  // wiki, both when autocomments exist and when they don't, and
1202  // (2) what markup will make that actually happen.
1203  $append = '';
1204  $comment = preg_replace_callback(
1205  // To detect the presence of content before or after the
1206  // auto-comment, we use capturing groups inside optional zero-width
1207  // assertions. But older versions of PCRE can't directly make
1208  // zero-width assertions optional, so wrap them in a non-capturing
1209  // group.
1210  '!(?:(?<=(.)))?/\*\s*(.*?)\s*\*/(?:(?=(.)))?!',
1211  function ( $match ) use ( $title, $local, $wikiId, &$append ) {
1212  global $wgLang;
1213 
1214  // Ensure all match positions are defined
1215  $match += [ '', '', '', '' ];
1216 
1217  $pre = $match[1] !== '';
1218  $auto = $match[2];
1219  $post = $match[3] !== '';
1220  $comment = null;
1221 
1222  Hooks::run(
1223  'FormatAutocomments',
1224  [ &$comment, $pre, $auto, $post, Title::castFromLinkTarget( $title ), $local,
1225  $wikiId ]
1226  );
1227 
1228  if ( $comment === null ) {
1229  if ( $title ) {
1230  $section = $auto;
1231  # Remove links that a user may have manually put in the autosummary
1232  # This could be improved by copying as much of Parser::stripSectionName as desired.
1233  $section = str_replace( [
1234  '[[:',
1235  '[[',
1236  ']]'
1237  ], '', $section );
1238 
1239  // We don't want any links in the auto text to be linked, but we still
1240  // want to show any [[ ]]
1241  $sectionText = str_replace( '[[', '&#91;[', $auto );
1242 
1243  $section = substr( Parser::guessSectionNameFromStrippedText( $section ), 1 );
1244  if ( $section !== '' ) {
1245  if ( $local ) {
1246  $sectionTitle = new TitleValue( NS_MAIN, '', $section );
1247  } else {
1248  $sectionTitle = $title->createFragmentTarget( $section );
1249  }
1250  $auto = Linker::makeCommentLink(
1251  $sectionTitle,
1252  $wgLang->getArrow() . $wgLang->getDirMark() . $sectionText,
1253  $wikiId,
1254  'noclasses'
1255  );
1256  }
1257  }
1258  if ( $pre ) {
1259  # written summary $presep autocomment (summary /* section */)
1260  $pre = wfMessage( 'autocomment-prefix' )->inContentLanguage()->escaped();
1261  }
1262  if ( $post ) {
1263  # autocomment $postsep written summary (/* section */ summary)
1264  $auto .= wfMessage( 'colon-separator' )->inContentLanguage()->escaped();
1265  }
1266  if ( $auto ) {
1267  $auto = '<span dir="auto"><span class="autocomment">' . $auto . '</span>';
1268  $append .= '</span>';
1269  }
1270  $comment = $pre . $auto;
1271  }
1272  return $comment;
1273  },
1274  $comment
1275  );
1276  return $comment . $append;
1277  }
1278 
1298  public static function formatLinksInComment(
1299  $comment, $title = null, $local = false, $wikiId = null
1300  ) {
1301  return preg_replace_callback(
1302  '/
1303  \[\[
1304  \s*+ # ignore leading whitespace, the *+ quantifier disallows backtracking
1305  :? # ignore optional leading colon
1306  ([^\]|]+) # 1. link target; page names cannot include ] or |
1307  (?:\|
1308  # 2. link text
1309  # Stop matching at ]] without relying on backtracking.
1310  ((?:]?[^\]])*+)
1311  )?
1312  \]\]
1313  ([^[]*) # 3. link trail (the text up until the next link)
1314  /x',
1315  function ( $match ) use ( $title, $local, $wikiId ) {
1316  $services = MediaWikiServices::getInstance();
1317 
1318  $medians = '(?:';
1319  $medians .= preg_quote(
1320  $services->getNamespaceInfo()->getCanonicalName( NS_MEDIA ), '/' );
1321  $medians .= '|';
1322  $medians .= preg_quote(
1323  $services->getContentLanguage()->getNsText( NS_MEDIA ),
1324  '/'
1325  ) . '):';
1326 
1327  $comment = $match[0];
1328 
1329  # fix up urlencoded title texts (copied from Parser::replaceInternalLinks)
1330  if ( strpos( $match[1], '%' ) !== false ) {
1331  $match[1] = strtr(
1332  rawurldecode( $match[1] ),
1333  [ '<' => '&lt;', '>' => '&gt;' ]
1334  );
1335  }
1336 
1337  # Handle link renaming [[foo|text]] will show link as "text"
1338  if ( $match[2] != "" ) {
1339  $text = $match[2];
1340  } else {
1341  $text = $match[1];
1342  }
1343  $submatch = [];
1344  $thelink = null;
1345  if ( preg_match( '/^' . $medians . '(.*)$/i', $match[1], $submatch ) ) {
1346  # Media link; trail not supported.
1347  $linkRegexp = '/\[\[(.*?)\]\]/';
1348  $title = Title::makeTitleSafe( NS_FILE, $submatch[1] );
1349  if ( $title ) {
1350  $thelink = Linker::makeMediaLinkObj( $title, $text );
1351  }
1352  } else {
1353  # Other kind of link
1354  # Make sure its target is non-empty
1355  if ( isset( $match[1][0] ) && $match[1][0] == ':' ) {
1356  $match[1] = substr( $match[1], 1 );
1357  }
1358  if ( $match[1] !== false && $match[1] !== '' ) {
1359  if ( preg_match(
1360  $services->getContentLanguage()->linkTrail(),
1361  $match[3],
1362  $submatch
1363  ) ) {
1364  $trail = $submatch[1];
1365  } else {
1366  $trail = "";
1367  }
1368  $linkRegexp = '/\[\[(.*?)\]\]' . preg_quote( $trail, '/' ) . '/';
1369  list( $inside, $trail ) = Linker::splitTrail( $trail );
1370 
1371  $linkText = $text;
1372  $linkTarget = Linker::normalizeSubpageLink( $title, $match[1], $linkText );
1373 
1374  Title::newFromText( $linkTarget );
1375  try {
1376  $target = $services->getTitleParser()->
1377  parseTitle( $linkTarget );
1378 
1379  if ( $target->getText() == '' && !$target->isExternal()
1380  && !$local && $title
1381  ) {
1382  $target = $title->createFragmentTarget( $target->getFragment() );
1383  }
1384 
1385  $thelink = Linker::makeCommentLink( $target, $linkText . $inside, $wikiId ) . $trail;
1386  } catch ( MalformedTitleException $e ) {
1387  // Fall through
1388  }
1389  }
1390  }
1391  if ( $thelink ) {
1392  // If the link is still valid, go ahead and replace it in!
1393  $comment = preg_replace(
1394  $linkRegexp,
1396  $comment,
1397  1
1398  );
1399  }
1400 
1401  return $comment;
1402  },
1403  $comment
1404  );
1405  }
1406 
1420  public static function makeCommentLink(
1421  LinkTarget $linkTarget, $text, $wikiId = null, $options = []
1422  ) {
1423  if ( $wikiId !== null && !$linkTarget->isExternal() ) {
1424  $link = self::makeExternalLink(
1426  $wikiId,
1427  $linkTarget->getNamespace() === 0
1428  ? $linkTarget->getDBkey()
1429  : MediaWikiServices::getInstance()->getNamespaceInfo()->
1430  getCanonicalName( $linkTarget->getNamespace() ) .
1431  ':' . $linkTarget->getDBkey(),
1432  $linkTarget->getFragment()
1433  ),
1434  $text,
1435  /* escape = */ false // Already escaped
1436  );
1437  } else {
1438  $link = self::link( $linkTarget, $text, [], [], $options );
1439  }
1440 
1441  return $link;
1442  }
1443 
1450  public static function normalizeSubpageLink( $contextTitle, $target, &$text ) {
1451  # Valid link forms:
1452  # Foobar -- normal
1453  # :Foobar -- override special treatment of prefix (images, language links)
1454  # /Foobar -- convert to CurrentPage/Foobar
1455  # /Foobar/ -- convert to CurrentPage/Foobar, strip the initial and final / from text
1456  # ../ -- convert to CurrentPage, from CurrentPage/CurrentSubPage
1457  # ../Foobar -- convert to CurrentPage/Foobar,
1458  # (from CurrentPage/CurrentSubPage)
1459  # ../Foobar/ -- convert to CurrentPage/Foobar, use 'Foobar' as text
1460  # (from CurrentPage/CurrentSubPage)
1461 
1462  $ret = $target; # default return value is no change
1463 
1464  # Some namespaces don't allow subpages,
1465  # so only perform processing if subpages are allowed
1466  if (
1467  $contextTitle && MediaWikiServices::getInstance()->getNamespaceInfo()->
1468  hasSubpages( $contextTitle->getNamespace() )
1469  ) {
1470  $hash = strpos( $target, '#' );
1471  if ( $hash !== false ) {
1472  $suffix = substr( $target, $hash );
1473  $target = substr( $target, 0, $hash );
1474  } else {
1475  $suffix = '';
1476  }
1477  # T9425
1478  $target = trim( $target );
1479  $contextPrefixedText = MediaWikiServices::getInstance()->getTitleFormatter()->
1480  getPrefixedText( $contextTitle );
1481  # Look at the first character
1482  if ( $target != '' && $target[0] === '/' ) {
1483  # / at end means we don't want the slash to be shown
1484  $m = [];
1485  $trailingSlashes = preg_match_all( '%(/+)$%', $target, $m );
1486  if ( $trailingSlashes ) {
1487  $noslash = $target = substr( $target, 1, -strlen( $m[0][0] ) );
1488  } else {
1489  $noslash = substr( $target, 1 );
1490  }
1491 
1492  $ret = $contextPrefixedText . '/' . trim( $noslash ) . $suffix;
1493  if ( $text === '' ) {
1494  $text = $target . $suffix;
1495  } # this might be changed for ugliness reasons
1496  } else {
1497  # check for .. subpage backlinks
1498  $dotdotcount = 0;
1499  $nodotdot = $target;
1500  while ( strncmp( $nodotdot, "../", 3 ) == 0 ) {
1501  ++$dotdotcount;
1502  $nodotdot = substr( $nodotdot, 3 );
1503  }
1504  if ( $dotdotcount > 0 ) {
1505  $exploded = explode( '/', $contextPrefixedText );
1506  if ( count( $exploded ) > $dotdotcount ) { # not allowed to go below top level page
1507  $ret = implode( '/', array_slice( $exploded, 0, -$dotdotcount ) );
1508  # / at the end means don't show full path
1509  if ( substr( $nodotdot, -1, 1 ) === '/' ) {
1510  $nodotdot = rtrim( $nodotdot, '/' );
1511  if ( $text === '' ) {
1512  $text = $nodotdot . $suffix;
1513  }
1514  }
1515  $nodotdot = trim( $nodotdot );
1516  if ( $nodotdot != '' ) {
1517  $ret .= '/' . $nodotdot;
1518  }
1519  $ret .= $suffix;
1520  }
1521  }
1522  }
1523  }
1524 
1525  return $ret;
1526  }
1527 
1542  public static function commentBlock(
1543  $comment, $title = null, $local = false, $wikiId = null, $useParentheses = true
1544  ) {
1545  // '*' used to be the comment inserted by the software way back
1546  // in antiquity in case none was provided, here for backwards
1547  // compatibility, acc. to brion -√¶var
1548  if ( $comment == '' || $comment == '*' ) {
1549  return '';
1550  }
1551  $formatted = self::formatComment( $comment, $title, $local, $wikiId );
1552  if ( $useParentheses ) {
1553  $formatted = wfMessage( 'parentheses' )->rawParams( $formatted )->escaped();
1554  $classNames = 'comment';
1555  } else {
1556  $classNames = 'comment comment--without-parentheses';
1557  }
1558  return " <span class=\"$classNames\">$formatted</span>";
1559  }
1560 
1572  public static function revComment( Revision $rev, $local = false, $isPublic = false,
1573  $useParentheses = true
1574  ) {
1575  if ( $rev->getComment( RevisionRecord::RAW ) == "" ) {
1576  return "";
1577  }
1578  if ( $rev->isDeleted( RevisionRecord::DELETED_COMMENT ) && $isPublic ) {
1579  $block = " <span class=\"comment\">" . wfMessage( 'rev-deleted-comment' )->escaped() . "</span>";
1580  } elseif ( $rev->userCan( RevisionRecord::DELETED_COMMENT ) ) {
1581  $block = self::commentBlock( $rev->getComment( RevisionRecord::FOR_THIS_USER ),
1582  $rev->getTitle(), $local, null, $useParentheses );
1583  } else {
1584  $block = " <span class=\"comment\">" . wfMessage( 'rev-deleted-comment' )->escaped() . "</span>";
1585  }
1586  if ( $rev->isDeleted( RevisionRecord::DELETED_COMMENT ) ) {
1587  return " <span class=\"history-deleted comment\">$block</span>";
1588  }
1589  return $block;
1590  }
1591 
1597  public static function formatRevisionSize( $size ) {
1598  if ( $size == 0 ) {
1599  $stxt = wfMessage( 'historyempty' )->escaped();
1600  } else {
1601  $stxt = wfMessage( 'nbytes' )->numParams( $size )->escaped();
1602  }
1603  return "<span class=\"history-size mw-diff-bytes\">$stxt</span>";
1604  }
1605 
1612  public static function tocIndent() {
1613  return "\n<ul>\n";
1614  }
1615 
1623  public static function tocUnindent( $level ) {
1624  return "</li>\n" . str_repeat( "</ul>\n</li>\n", $level > 0 ? $level : 0 );
1625  }
1626 
1638  public static function tocLine( $anchor, $tocline, $tocnumber, $level, $sectionIndex = false ) {
1639  $classes = "toclevel-$level";
1640  if ( $sectionIndex !== false ) {
1641  $classes .= " tocsection-$sectionIndex";
1642  }
1643 
1644  // <li class="$classes"><a href="#$anchor"><span class="tocnumber">
1645  // $tocnumber</span> <span class="toctext">$tocline</span></a>
1646  return Html::openElement( 'li', [ 'class' => $classes ] )
1647  . Html::rawElement( 'a',
1648  [ 'href' => "#$anchor" ],
1649  Html::element( 'span', [ 'class' => 'tocnumber' ], $tocnumber )
1650  . ' '
1651  . Html::rawElement( 'span', [ 'class' => 'toctext' ], $tocline )
1652  );
1653  }
1654 
1662  public static function tocLineEnd() {
1663  return "</li>\n";
1664  }
1665 
1674  public static function tocList( $toc, Language $lang = null ) {
1675  $lang = $lang ?? RequestContext::getMain()->getLanguage();
1676 
1677  $title = wfMessage( 'toc' )->inLanguage( $lang )->escaped();
1678 
1679  return '<div id="toc" class="toc">'
1680  . Html::element( 'input', [
1681  'type' => 'checkbox',
1682  'role' => 'button',
1683  'id' => 'toctogglecheckbox',
1684  'class' => 'toctogglecheckbox',
1685  'style' => 'display:none',
1686  ] )
1687  . Html::openElement( 'div', [
1688  'class' => 'toctitle',
1689  'lang' => $lang->getHtmlCode(),
1690  'dir' => $lang->getDir(),
1691  ] )
1692  . "<h2>$title</h2>"
1693  . '<span class="toctogglespan">'
1694  . Html::label( '', 'toctogglecheckbox', [
1695  'class' => 'toctogglelabel',
1696  ] )
1697  . '</span>'
1698  . "</div>\n"
1699  . $toc
1700  . "</ul>\n</div>\n";
1701  }
1702 
1711  public static function generateTOC( $tree, Language $lang = null ) {
1712  $toc = '';
1713  $lastLevel = 0;
1714  foreach ( $tree as $section ) {
1715  if ( $section['toclevel'] > $lastLevel ) {
1716  $toc .= self::tocIndent();
1717  } elseif ( $section['toclevel'] < $lastLevel ) {
1718  $toc .= self::tocUnindent(
1719  $lastLevel - $section['toclevel'] );
1720  } else {
1721  $toc .= self::tocLineEnd();
1722  }
1723 
1724  $toc .= self::tocLine( $section['anchor'],
1725  $section['line'], $section['number'],
1726  $section['toclevel'], $section['index'] );
1727  $lastLevel = $section['toclevel'];
1728  }
1729  $toc .= self::tocLineEnd();
1730  return self::tocList( $toc, $lang );
1731  }
1732 
1749  public static function makeHeadline( $level, $attribs, $anchor, $html,
1750  $link, $fallbackAnchor = false
1751  ) {
1752  $anchorEscaped = htmlspecialchars( $anchor );
1753  $fallback = '';
1754  if ( $fallbackAnchor !== false && $fallbackAnchor !== $anchor ) {
1755  $fallbackAnchor = htmlspecialchars( $fallbackAnchor );
1756  $fallback = "<span id=\"$fallbackAnchor\"></span>";
1757  }
1758  return "<h$level$attribs"
1759  . "$fallback<span class=\"mw-headline\" id=\"$anchorEscaped\">$html</span>"
1760  . $link
1761  . "</h$level>";
1762  }
1763 
1770  static function splitTrail( $trail ) {
1771  $regex = MediaWikiServices::getInstance()->getContentLanguage()->linkTrail();
1772  $inside = '';
1773  if ( $trail !== '' && preg_match( $regex, $trail, $m ) ) {
1774  list( , $inside, $trail ) = $m;
1775  }
1776  return [ $inside, $trail ];
1777  }
1778 
1806  public static function generateRollback( $rev, IContextSource $context = null,
1807  $options = [ 'verify' ]
1808  ) {
1809  if ( $context === null ) {
1811  }
1812 
1813  $editCount = false;
1814  if ( in_array( 'verify', $options, true ) ) {
1815  $editCount = self::getRollbackEditCount( $rev, true );
1816  if ( $editCount === false ) {
1817  return '';
1818  }
1819  }
1820 
1821  $inner = self::buildRollbackLink( $rev, $context, $editCount );
1822 
1823  if ( !in_array( 'noBrackets', $options, true ) ) {
1824  $inner = $context->msg( 'brackets' )->rawParams( $inner )->escaped();
1825  }
1826 
1827  if ( $context->getUser()->getBoolOption( 'showrollbackconfirmation' ) ) {
1828  $stats = MediaWikiServices::getInstance()->getStatsdDataFactory();
1829  $stats->increment( 'rollbackconfirmation.event.load' );
1830  $context->getOutput()->addModules( 'mediawiki.page.rollback.confirmation' );
1831  }
1832 
1833  return '<span class="mw-rollback-link">' . $inner . '</span>';
1834  }
1835 
1851  public static function getRollbackEditCount( $rev, $verify ) {
1852  global $wgShowRollbackEditCount;
1853  if ( !is_int( $wgShowRollbackEditCount ) || !$wgShowRollbackEditCount > 0 ) {
1854  // Nothing has happened, indicate this by returning 'null'
1855  return null;
1856  }
1857 
1858  $dbr = wfGetDB( DB_REPLICA );
1859 
1860  // Up to the value of $wgShowRollbackEditCount revisions are counted
1862  $res = $dbr->select(
1863  $revQuery['tables'],
1864  [ 'rev_user_text' => $revQuery['fields']['rev_user_text'], 'rev_deleted' ],
1865  // $rev->getPage() returns null sometimes
1866  [ 'rev_page' => $rev->getTitle()->getArticleID() ],
1867  __METHOD__,
1868  [
1869  'USE INDEX' => [ 'revision' => 'page_timestamp' ],
1870  'ORDER BY' => 'rev_timestamp DESC',
1871  'LIMIT' => $wgShowRollbackEditCount + 1
1872  ],
1873  $revQuery['joins']
1874  );
1875 
1876  $editCount = 0;
1877  $moreRevs = false;
1878  foreach ( $res as $row ) {
1879  if ( $rev->getUserText( RevisionRecord::RAW ) != $row->rev_user_text ) {
1880  if ( $verify &&
1881  ( $row->rev_deleted & RevisionRecord::DELETED_TEXT
1882  || $row->rev_deleted & RevisionRecord::DELETED_USER
1883  ) ) {
1884  // If the user or the text of the revision we might rollback
1885  // to is deleted in some way we can't rollback. Similar to
1886  // the sanity checks in WikiPage::commitRollback.
1887  return false;
1888  }
1889  $moreRevs = true;
1890  break;
1891  }
1892  $editCount++;
1893  }
1894 
1895  if ( $verify && $editCount <= $wgShowRollbackEditCount && !$moreRevs ) {
1896  // We didn't find at least $wgShowRollbackEditCount revisions made by the current user
1897  // and there weren't any other revisions. That means that the current user is the only
1898  // editor, so we can't rollback
1899  return false;
1900  }
1901  return $editCount;
1902  }
1903 
1913  public static function buildRollbackLink( $rev, IContextSource $context = null,
1914  $editCount = false
1915  ) {
1917 
1918  // To config which pages are affected by miser mode
1919  $disableRollbackEditCountSpecialPage = [ 'Recentchanges', 'Watchlist' ];
1920 
1921  if ( $context === null ) {
1923  }
1924 
1925  $title = $rev->getTitle();
1926 
1927  $query = [
1928  'action' => 'rollback',
1929  'from' => $rev->getUserText(),
1930  'token' => $context->getUser()->getEditToken( 'rollback' ),
1931  ];
1932 
1933  $attrs = [
1934  'data-mw' => 'interface',
1935  'title' => $context->msg( 'tooltip-rollback' )->text()
1936  ];
1937 
1938  $options = [ 'known', 'noclasses' ];
1939 
1940  if ( $context->getRequest()->getBool( 'bot' ) ) {
1941  //T17999
1942  $query['hidediff'] = '1';
1943  $query['bot'] = '1';
1944  }
1945 
1946  $disableRollbackEditCount = false;
1947  if ( $wgMiserMode ) {
1948  foreach ( $disableRollbackEditCountSpecialPage as $specialPage ) {
1949  if ( $context->getTitle()->isSpecial( $specialPage ) ) {
1950  $disableRollbackEditCount = true;
1951  break;
1952  }
1953  }
1954  }
1955 
1956  if ( !$disableRollbackEditCount
1957  && is_int( $wgShowRollbackEditCount )
1958  && $wgShowRollbackEditCount > 0
1959  ) {
1960  if ( !is_numeric( $editCount ) ) {
1961  $editCount = self::getRollbackEditCount( $rev, false );
1962  }
1963 
1964  if ( $editCount > $wgShowRollbackEditCount ) {
1965  $html = $context->msg( 'rollbacklinkcount-morethan' )
1966  ->numParams( $wgShowRollbackEditCount )->parse();
1967  } else {
1968  $html = $context->msg( 'rollbacklinkcount' )->numParams( $editCount )->parse();
1969  }
1970 
1971  return self::link( $title, $html, $attrs, $query, $options );
1972  }
1973 
1974  $html = $context->msg( 'rollbacklink' )->escaped();
1975  return self::link( $title, $html, $attrs, $query, $options );
1976  }
1977 
1986  public static function formatHiddenCategories( $hiddencats ) {
1987  $outText = '';
1988  if ( count( $hiddencats ) > 0 ) {
1989  # Construct the HTML
1990  $outText = '<div class="mw-hiddenCategoriesExplanation">';
1991  $outText .= wfMessage( 'hiddencategories' )->numParams( count( $hiddencats ) )->parseAsBlock();
1992  $outText .= "</div><ul>\n";
1993 
1994  foreach ( $hiddencats as $titleObj ) {
1995  # If it's hidden, it must exist - no need to check with a LinkBatch
1996  $outText .= '<li>'
1997  . self::link( $titleObj, null, [], [], 'known' )
1998  . "</li>\n";
1999  }
2000  $outText .= '</ul>';
2001  }
2002  return $outText;
2003  }
2004 
2021  public static function titleAttrib( $name, $options = null, array $msgParams = [] ) {
2022  $message = wfMessage( "tooltip-$name", $msgParams );
2023  if ( !$message->exists() ) {
2024  $tooltip = false;
2025  } else {
2026  $tooltip = $message->text();
2027  # Compatibility: formerly some tooltips had [alt-.] hardcoded
2028  $tooltip = preg_replace( "/ ?\[alt-.\]$/", '', $tooltip );
2029  # Message equal to '-' means suppress it.
2030  if ( $tooltip == '-' ) {
2031  $tooltip = false;
2032  }
2033  }
2034 
2035  $options = (array)$options;
2036 
2037  if ( in_array( 'nonexisting', $options ) ) {
2038  $tooltip = wfMessage( 'red-link-title', $tooltip ?: '' )->text();
2039  }
2040  if ( in_array( 'withaccess', $options ) ) {
2041  $accesskey = self::accesskey( $name );
2042  if ( $accesskey !== false ) {
2043  // Should be build the same as in jquery.accessKeyLabel.js
2044  if ( $tooltip === false || $tooltip === '' ) {
2045  $tooltip = wfMessage( 'brackets', $accesskey )->text();
2046  } else {
2047  $tooltip .= wfMessage( 'word-separator' )->text();
2048  $tooltip .= wfMessage( 'brackets', $accesskey )->text();
2049  }
2050  }
2051  }
2052 
2053  return $tooltip;
2054  }
2055 
2056  public static $accesskeycache;
2057 
2069  public static function accesskey( $name ) {
2070  if ( isset( self::$accesskeycache[$name] ) ) {
2071  return self::$accesskeycache[$name];
2072  }
2073 
2074  $message = wfMessage( "accesskey-$name" );
2075 
2076  if ( !$message->exists() ) {
2077  $accesskey = false;
2078  } else {
2079  $accesskey = $message->plain();
2080  if ( $accesskey === '' || $accesskey === '-' ) {
2081  # @todo FIXME: Per standard MW behavior, a value of '-' means to suppress the
2082  # attribute, but this is broken for accesskey: that might be a useful
2083  # value.
2084  $accesskey = false;
2085  }
2086  }
2087 
2088  self::$accesskeycache[$name] = $accesskey;
2089  return self::$accesskeycache[$name];
2090  }
2091 
2105  public static function getRevDeleteLink( User $user, Revision $rev, LinkTarget $title ) {
2106  $permissionManager = MediaWikiServices::getInstance()->getPermissionManager();
2107  $canHide = $permissionManager->userHasRight( $user, 'deleterevision' );
2108  $canHideHistory = $permissionManager->userHasRight( $user, 'deletedhistory' );
2109  if ( !$canHide && !( $rev->getVisibility() && $canHideHistory ) ) {
2110  return '';
2111  }
2112 
2113  if ( !$rev->userCan( RevisionRecord::DELETED_RESTRICTED, $user ) ) {
2114  return self::revDeleteLinkDisabled( $canHide ); // revision was hidden from sysops
2115  }
2116  $prefixedDbKey = MediaWikiServices::getInstance()->getTitleFormatter()->
2117  getPrefixedDBkey( $title );
2118  if ( $rev->getId() ) {
2119  // RevDelete links using revision ID are stable across
2120  // page deletion and undeletion; use when possible.
2121  $query = [
2122  'type' => 'revision',
2123  'target' => $prefixedDbKey,
2124  'ids' => $rev->getId()
2125  ];
2126  } else {
2127  // Older deleted entries didn't save a revision ID.
2128  // We have to refer to these by timestamp, ick!
2129  $query = [
2130  'type' => 'archive',
2131  'target' => $prefixedDbKey,
2132  'ids' => $rev->getTimestamp()
2133  ];
2134  }
2135  return self::revDeleteLink( $query,
2136  $rev->isDeleted( RevisionRecord::DELETED_RESTRICTED ), $canHide );
2137  }
2138 
2149  public static function revDeleteLink( $query = [], $restricted = false, $delete = true ) {
2150  $sp = SpecialPage::getTitleFor( 'Revisiondelete' );
2151  $msgKey = $delete ? 'rev-delundel' : 'rev-showdeleted';
2152  $html = wfMessage( $msgKey )->escaped();
2153  $tag = $restricted ? 'strong' : 'span';
2154  $link = self::link( $sp, $html, [], $query, [ 'known', 'noclasses' ] );
2155  return Xml::tags(
2156  $tag,
2157  [ 'class' => 'mw-revdelundel-link' ],
2158  wfMessage( 'parentheses' )->rawParams( $link )->escaped()
2159  );
2160  }
2161 
2171  public static function revDeleteLinkDisabled( $delete = true ) {
2172  $msgKey = $delete ? 'rev-delundel' : 'rev-showdeleted';
2173  $html = wfMessage( $msgKey )->escaped();
2174  $htmlParentheses = wfMessage( 'parentheses' )->rawParams( $html )->escaped();
2175  return Xml::tags( 'span', [ 'class' => 'mw-revdelundel-link' ], $htmlParentheses );
2176  }
2177 
2190  public static function tooltipAndAccesskeyAttribs(
2191  $name,
2192  array $msgParams = [],
2193  $options = null
2194  ) {
2195  $options = (array)$options;
2196  $options[] = 'withaccess';
2197 
2198  $attribs = [
2199  'title' => self::titleAttrib( $name, $options, $msgParams ),
2200  'accesskey' => self::accesskey( $name )
2201  ];
2202  if ( $attribs['title'] === false ) {
2203  unset( $attribs['title'] );
2204  }
2205  if ( $attribs['accesskey'] === false ) {
2206  unset( $attribs['accesskey'] );
2207  }
2208  return $attribs;
2209  }
2210 
2218  public static function tooltip( $name, $options = null ) {
2219  $tooltip = self::titleAttrib( $name, $options );
2220  if ( $tooltip === false ) {
2221  return '';
2222  }
2223  return Xml::expandAttributes( [
2224  'title' => $tooltip
2225  ] );
2226  }
2227 
2228 }
static getTitleValueFor( $name, $subpage=false, $fragment='')
Get a localised TitleValue object for a specified special page name.
Definition: SpecialPage.php:98
userCan( $field, User $user=null)
Determine if the current user is allowed to view a particular field of this revision, if it&#39;s marked as deleted.
Definition: Revision.php:1022
static makeMediaLinkObj( $title, $html='', $time=false)
Create a direct link to a given uploaded file.
Definition: Linker.php:762
if(PHP_SAPI !='cli-server') if(!isset( $_SERVER['SCRIPT_FILENAME'])) $file
Item class for a filearchive table row.
Definition: router.php:42
static castFromLinkTarget( $linkTarget)
Same as newFromLinkTarget, but if passed null, returns null.
Definition: Title.php:295
static tooltip( $name, $options=null)
Returns raw bits of HTML, use titleAttrib()
Definition: Linker.php:2218
static tocLineEnd()
End a Table Of Contents line.
Definition: Linker.php:1662
wfWarn( $msg, $callerOffset=1, $level=E_USER_NOTICE)
Send a warning either to the debug log or in a PHP error depending on $wgDevelopmentWarnings.
static getRollbackEditCount( $rev, $verify)
This function will return the number of revisions which a rollback would revert and, if $verify is set it will verify that a revision can be reverted (that the user isn&#39;t the only contributor and the revision we might rollback to isn&#39;t deleted).
Definition: Linker.php:1851
static element( $element, $attribs=[], $contents='')
Identical to rawElement(), but HTML-escapes $contents (like Xml::element()).
Definition: Html.php:231
$context
Definition: load.php:45
static getExternalLinkRel( $url=false, $title=null)
Get the rel attribute for a particular external link.
Definition: Parser.php:2123
static formatRevisionSize( $size)
Definition: Linker.php:1597
const NS_MAIN
Definition: Defines.php:60
$success
static generateTOC( $tree, Language $lang=null)
Generate a table of contents from a section tree.
Definition: Linker.php:1711
static normalizeSubpageLink( $contextTitle, $target, &$text)
Definition: Linker.php:1450
getTimestamp()
Definition: Revision.php:798
static makeBrokenImageLinkObj( $title, $label='', $query='', $unused1='', $unused2='', $time=false)
Make a "broken" link to an image.
Definition: Linker.php:677
static expandAttributes( $attribs)
Given an array of (&#39;attributename&#39; => &#39;value&#39;), it generates the code to set the XML attributes : att...
Definition: Xml.php:67
static splitTrail( $trail)
Split a link trail, return the "inside" portion and the remainder of the trail as a two-element array...
Definition: Linker.php:1770
if(!isset( $args[0])) $lang
static escapeRegexReplacement( $string)
Escape a string to make it suitable for inclusion in a preg_replace() replacement parameter...
static openElement( $element, $attribs=[])
Identical to rawElement(), but has no third parameter and omits the end tag (and the self-closing &#39;/&#39;...
Definition: Html.php:251
static rawElement( $element, $attribs=[], $contents='')
Returns an HTML element in a string.
Definition: Html.php:209
static normaliseSpecialPage(LinkTarget $target)
Definition: Linker.php:207
static fnamePart( $url)
Returns the filename part of an url.
Definition: Linker.php:227
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
static accesskey( $name)
Given the id of an interface element, constructs the appropriate accesskey attribute from the system ...
Definition: Linker.php:2069
static userToolLinksRedContribs( $userId, $userText, $edits=null, $useParentheses=true)
Alias for userToolLinks( $userId, $userText, true );.
Definition: Linker.php:1024
Represents a page (or page fragment) title within MediaWiki.
Definition: TitleValue.php:36
const NS_SPECIAL
Definition: Defines.php:49
wfLogWarning( $msg, $callerOffset=1, $level=E_USER_WARNING)
Send a warning as a PHP error and the debug log.
static makeMediaLinkFile(LinkTarget $title, $file, $html='')
Create a direct link to a given uploaded file.
Definition: Linker.php:781
static emailLink( $userId, $userText)
Definition: Linker.php:1079
static buildRollbackLink( $rev, IContextSource $context=null, $editCount=false)
Build a raw rollback link, useful for collections of "tool" links.
Definition: Linker.php:1913
static generateRollback( $rev, IContextSource $context=null, $options=[ 'verify'])
Generate a rollback link for a given revision.
Definition: Linker.php:1806
getNamespace()
Get the namespace index.
static formatHiddenCategories( $hiddencats)
Returns HTML for the "hidden categories on this page" list.
Definition: Linker.php:1986
getFragment()
Get the link fragment (i.e.
isExternal()
Whether this LinkTarget has an interwiki component.
The User object encapsulates all of the user-specific settings (user_id, name, rights, email address, options, last login time).
Definition: User.php:51
$wgEnableUploads
Allow users to upload files.
static makeExternalImage( $url, $alt='')
Return the code for images which were added via external links, via Parser::maybeMakeExternalImage()...
Definition: Linker.php:247
wfAppendQuery( $url, $query)
Append a query string to an existing URL, which may or may not already have query string parameters a...
static formatLinksInComment( $comment, $title=null, $local=false, $wikiId=null)
Formats wiki links and media links in text; all other wiki formatting is ignored. ...
Definition: Linker.php:1298
static getForeignURL( $wikiID, $page, $fragmentId=null)
Convenience to get a url to a page on a foreign wiki.
Definition: WikiMap.php:171
getTitle()
Returns the title of the page associated with this entry.
Definition: Revision.php:559
$wgLang
Definition: Setup.php:857
static getMain()
Get the RequestContext object associated with the main request.
static formatComment( $comment, $title=null, $local=false, $wikiId=null)
This function is called by all recent changes variants, by the page history, and by the user contribu...
Definition: Linker.php:1165
$wgUploadMissingFileUrl
Point the upload link for missing files to an external URL, as with $wgUploadNavigationUrl.
wfCgiToArray( $query)
This is the logical opposite of wfArrayToCgi(): it accepts a query string as its argument and returns...
static makeSelfLinkObj( $nt, $html='', $query='', $trail='', $prefix='')
Make appropriate markup for a link to the current article.
Definition: Linker.php:163
static titleAttrib( $name, $options=null, array $msgParams=[])
Given the id of an interface element, constructs the appropriate title attribute from the system mess...
Definition: Linker.php:2021
Some internal bits split of from Skin.php.
Definition: Linker.php:35
isDeleted( $field)
Definition: Revision.php:692
getId()
Get revision ID.
Definition: Revision.php:442
$wgThumbUpright
Adjust width of upright images when parameter &#39;upright&#39; is used This allows a nicer look for upright ...
msg( $key,... $params)
This is the method for getting translated interface messages.
const NS_MEDIA
Definition: Defines.php:48
static userToolLinks( $userId, $userText, $redContribsWhenNoEdits=false, $flags=0, $edits=null, $useParentheses=true)
Generate standard user tool links (talk, contributions, block link, etc.)
Definition: Linker.php:943
$wgMiserMode
Disable database-intensive features.
wfDebug( $text, $dest='all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
const TOOL_LINKS_NOBLOCK
Flags for userToolLinks()
Definition: Linker.php:39
static formatAutocomments( $comment, $title=null, $local=false, $wikiId=null)
Converts autogenerated comments in edit summaries into section links.
Definition: Linker.php:1195
getDBkey()
Get the main part with underscores.
static tocLine( $anchor, $tocline, $tocnumber, $level, $sectionIndex=false)
parameter level defines if we are on an indentation level
Definition: Linker.php:1638
$wgThumbLimits
Adjust thumbnails on image pages according to a user setting.
static tags( $element, $attribs, $contents)
Same as Xml::element(), but does not escape contents.
Definition: Xml.php:130
static makeExternalLink( $url, $text, $escape=true, $linktype='', $attribs=[], $title=null)
Make an external link.
Definition: Linker.php:848
getComment( $audience=self::FOR_PUBLIC, User $user=null)
Definition: Revision.php:649
getTargetLanguage()
Get the target language for the content being parsed.
Definition: Parser.php:1061
static getUserLinkTitle( $userName)
Get a target Title to link a username.
static getQueryInfo( $options=[])
Return the tables, fields, and join conditions to be selected to create a new revision object...
Definition: Revision.php:315
const NS_FILE
Definition: Defines.php:66
static getTitleFor( $name, $subpage=false, $fragment='')
Get a localised Title object for a specified special page name If you don&#39;t need a full Title object...
Definition: SpecialPage.php:83
static makeCommentLink(LinkTarget $linkTarget, $text, $wikiId=null, $options=[])
Generates a link to the given LinkTarget.
Definition: Linker.php:1420
$wgDisableAnonTalk
Disable links to talk pages of anonymous users (IPs) in listings on special pages like page history...
$wgSVGMaxSize
Don&#39;t scale a SVG larger than this.
static getDefaultOption( $opt)
Get a given default option value.
Definition: User.php:1690
static userLink( $userId, $userName, $altUserName=false)
Make user link (or user contributions for unregistered users)
Definition: Linker.php:898
static makeTitleSafe( $ns, $title, $fragment='', $interwiki='')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:612
static newFromLinkTarget(LinkTarget $linkTarget, $forceClone='')
Returns a Title given a LinkTarget.
Definition: Title.php:271
getVisibility()
Get the deletion bitfield of the revision.
Definition: Revision.php:701
static revUserLink( $rev, $isPublic=false)
Generate a user link if the current user is allowed to view it.
Definition: Linker.php:1101
static newFromId( $id)
Static factory method for creation from a given user ID.
Definition: User.php:539
static makeImageLink(Parser $parser, LinkTarget $title, $file, $frameParams=[], $handlerParams=[], $time=false, $query="", $widthOption=null)
Given parameters derived from [[Image:Foo|options...]], generate the HTML that that syntax inserts in...
Definition: Linker.php:303
static getRevDeleteLink(User $user, Revision $rev, LinkTarget $title)
Get a revision-deletion link, or disabled link, or nothing, depending on user permissions & the setti...
Definition: Linker.php:2105
$fallback
Definition: MessagesAb.php:11
static makeHeadline( $level, $attribs, $anchor, $html, $link, $fallbackAnchor=false)
Create a headline for content.
Definition: Linker.php:1749
static userTalkLink( $userId, $userText)
Definition: Linker.php:1036
static prettifyIP( $ip)
Prettify an IP for display to end users.
Definition: IP.php:200
static linkKnown( $target, $html=null, $customAttribs=[], $query=[], $options=[ 'known'])
Identical to link(), except $options defaults to &#39;known&#39;.
Definition: Linker.php:141
static revDeleteLink( $query=[], $restricted=false, $delete=true)
Creates a (show/hide) link for deleting revisions/log entries.
Definition: Linker.php:2149
static tocList( $toc, Language $lang=null)
Wraps the TOC in a table and provides the hide/collapse javascript.
Definition: Linker.php:1674
$revQuery
getText()
Returns the link in text form, without namespace prefix or fragment.
static tocIndent()
Add another level to the Table of Contents.
Definition: Linker.php:1612
static processResponsiveImages( $file, $thumb, $hp)
Process responsive images: add 1.5x and 2x subimages to the thumbnail, where applicable.
Definition: Linker.php:642
static revComment(Revision $rev, $local=false, $isPublic=false, $useParentheses=true)
Wrap and format the given revision&#39;s comment block, if the current user is allowed to view it...
Definition: Linker.php:1572
static specialLink( $name, $key='')
Make a link to a special page given its name and, optionally, a message key from the link text...
Definition: Linker.php:822
static getImageLinkMTOParams( $frameParams, $query='', $parser=null)
Get the link parameters for MediaTransformOutput::toHtml() from given frame parameters supplied by th...
Definition: Linker.php:454
static escapeHtmlAllowEntities( $html)
Given HTML input, escape with htmlspecialchars but un-escape entities.
Definition: Sanitizer.php:1433
static getInvalidTitleDescription(IContextSource $context, $namespace, $title)
Get a message saying that an invalid title was encountered.
Definition: Linker.php:187
const DB_REPLICA
Definition: defines.php:25
$wgShowRollbackEditCount
The $wgShowRollbackEditCount variable is used to show how many edits can be rolled back...
if(! $wgRequest->checkUrlExtension()) if(isset( $_SERVER['PATH_INFO']) && $_SERVER['PATH_INFO'] !='') $wgTitle
Definition: api.php:58
wfMessage( $key,... $params)
This is the function for getting translated interface messages.
static makeThumbLinkObj(LinkTarget $title, $file, $label='', $alt='', $align='right', $params=[], $framed=false, $manualthumb="")
Make HTML for a thumbnail including image, border and caption.
Definition: Linker.php:493
static link( $target, $html=null, $customAttribs=[], $query=[], $options=[])
This function returns an HTML link to the given target.
Definition: Linker.php:85
static $accesskeycache
Definition: Linker.php:2056
static tooltipAndAccesskeyAttribs( $name, array $msgParams=[], $options=null)
Returns the attributes for the tooltip and access key.
Definition: Linker.php:2190
static guessSectionNameFromStrippedText( $text)
Like guessSectionNameFromWikiText(), but takes already-stripped text as input.
Definition: Parser.php:6210
$wgUploadNavigationUrl
Point the upload navigation link to an external URL Useful if you want to use a shared repository by ...
$wgResponsiveImages
Generate and use thumbnails suitable for screens with 1.5 and 2.0 pixel densities.
const NS_USER_TALK
Definition: Defines.php:63
static makeThumbLink2(LinkTarget $title, $file, $frameParams=[], $handlerParams=[], $time=false, $query="")
Definition: Linker.php:519
static tocUnindent( $level)
Finish one or more sublevels on the Table of Contents.
Definition: Linker.php:1623
static commentBlock( $comment, $title=null, $local=false, $wikiId=null, $useParentheses=true)
Wrap a comment in standard punctuation and formatting if it&#39;s non-empty, otherwise return empty strin...
Definition: Linker.php:1542
static blockLink( $userId, $userText)
Definition: Linker.php:1058
static run( $event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
Definition: Hooks.php:200
static revDeleteLinkDisabled( $delete=true)
Creates a dead (show/hide) link for deleting revisions/log entries.
Definition: Linker.php:2171
static getUploadUrl( $destFile, $query='')
Get the URL to upload a certain file.
Definition: Linker.php:733
const TOOL_LINKS_EMAIL
Definition: Linker.php:40
static isExternal( $username)
Tells whether the username is external or not.
static label( $label, $id, array $attribs=[])
Convenience function for generating a label for inputs.
Definition: Html.php:786
static revUserTools( $rev, $isPublic=false, $useParentheses=true)
Generate a user tool link cluster if the current user is allowed to view it.
Definition: Linker.php:1124
static newFromText( $text, $defaultNamespace=NS_MAIN)
Create a new Title from text, such as what one would find in a link.
Definition: Title.php:319