57 # @todo FIXME: We have a whole bunch of handling here that doesn't happen in
58 # getExternalLinkAttributes, why?
63 return self::getLinkAttributesInternal(
$title, $class );
82 return self::getLinkAttributesInternal(
$title, $class );
102 $title = $nt->getPrefixedText();
104 return self::getLinkAttributesInternal(
$title, $class );
121 $class = htmlspecialchars( $class );
123 if ( $class !=
'' ) {
124 $r .=
" class=\"$class\"";
127 $r .=
" title=\"$title\"";
141 if (
$t->isRedirect() ) {
143 $colour =
'mw-redirect';
144 } elseif ( $threshold > 0 &&
$t->isContentPage() &&
145 $t->exists() &&
$t->getLength() < $threshold
198 if ( !$target instanceof
Title ) {
199 wfWarn( __METHOD__ .
': Requires $target to be a Title object.', 2 );
200 return "<!-- ERROR -->$html";
203 if ( is_string(
$query ) ) {
205 wfDeprecated( __METHOD__ .
' with parameter $query as string (should be array)',
'1.20' );
219 # Normalize the Title if it's a special page
220 $target = self::normaliseSpecialPage( $target );
222 # If we don't know whether the page exists, let's find out.
223 if ( !in_array(
'known',
$options,
true ) && !in_array(
'broken',
$options,
true ) ) {
224 if ( $target->isKnown() ) {
237 # Note: we want the href attribute first, for prettiness.
239 if ( in_array(
'forcearticlepath',
$options,
true ) && $oldquery ) {
247 if ( is_null(
$html ) ) {
248 $html = self::linkText( $target );
280 # We don't want to include fragments for broken links, because they
281 # generally make no sense.
286 # If it's a broken link, add the appropriate query pieces, unless
287 # there's already an action specified, or unless 'edit' makes no sense
288 # (i.e., for a nonexistent special page).
289 if ( in_array(
'broken',
$options,
true ) && empty(
$query[
'action'] )
291 $query[
'action'] =
'edit';
295 if ( in_array(
'http',
$options,
true ) ) {
297 } elseif ( in_array(
'https',
$options,
true ) ) {
321 if ( !in_array(
'noclasses',
$options,
true ) ) {
322 # Now build the classes.
325 if ( in_array(
'broken',
$options,
true ) ) {
329 if ( $target->isExternal() ) {
330 $classes[] =
'extiw';
334 $colour = self::getLinkColour(
336 isset(
$options[
'stubThreshold'] ) ?
$options[
'stubThreshold'] : $wgUser->getStubThreshold()
338 if ( $colour !==
'' ) {
342 if ( $classes != [] ) {
343 $defaults[
'class'] = implode(
' ', $classes );
347 # Get a default title attribute.
348 if ( $target->getPrefixedText() ==
'' ) {
349 # A link like [[#Foo]]. This used to mean an empty title
350 # attribute, but that's silly. Just don't output a title.
351 } elseif ( in_array(
'known',
$options,
true ) ) {
352 $defaults[
'title'] = $target->getPrefixedText();
355 $defaults[
'title'] =
wfMessage(
'red-link-title', $target->getPrefixedText() )
356 ->inContentLanguage()
360 # Finally, merge the custom attribs with the default ones, and iterate
361 # over that, deleting all "false" attributes.
364 foreach ( $merged
as $key => $val ) {
365 # A false value suppresses the attribute, and we don't want the
366 # href attribute to be overridden.
367 if (
$key !=
'href' && $val !==
false ) {
382 if ( !$target instanceof
Title ) {
383 wfWarn( __METHOD__ .
': Requires $target to be a Title object.' );
388 if ( $target->getPrefixedText() ===
'' && $target->hasFragment() ) {
389 return htmlspecialchars( $target->getFragment() );
392 return htmlspecialchars( $target->getPrefixedText() );
410 $ret =
"<strong class=\"selflink\">{$prefix}{$html}</strong>{$trail}";
416 $html = htmlspecialchars( $nt->getPrefixedText() );
418 list( $inside, $trail ) = self::splitTrail( $trail );
419 return "<strong class=\"selflink\">{$prefix}{$html}{$inside}</strong>{$trail}";
438 $name = $context->
msg(
'blanknamespace' )->text();
440 $name = $wgContLang->getFormattedNsText( $namespace );
442 return $context->
msg(
'invalidtitle-knownnamespace', $namespace,
$name,
$title )->text();
444 return $context->
msg(
'invalidtitle-unknownnamespace', $namespace,
$title )->text();
474 $basename = strrchr( $url,
'/' );
475 if (
false === $basename ) {
478 $basename = substr( $basename, 1 );
494 $alt = self::fnamePart( $url );
499 wfDebug(
"Hook LinkerMakeExternalImage changed the output of external image "
500 .
"with url {$url} and alt text {$alt} to {$img}\n",
true );
547 $query =
"", $widthOption = null
551 if ( !
Hooks::run(
'ImageBeforeProduceHTML', [ &$dummy, &$title,
556 if ( $file && !$file->allowInlineDisplay() ) {
566 $page = isset( $hp[
'page'] ) ? $hp[
'page'] :
false;
567 if ( !isset( $fp[
'align'] ) ) {
570 if ( !isset( $fp[
'alt'] ) ) {
573 if ( !isset( $fp[
'title'] ) ) {
576 if ( !isset( $fp[
'class'] ) ) {
580 $prefix = $postfix =
'';
582 if (
'center' == $fp[
'align'] ) {
583 $prefix =
'<div class="center">';
585 $fp[
'align'] =
'none';
587 if ( $file && !isset( $hp[
'width'] ) ) {
588 if ( isset( $hp[
'height'] ) && $file->isVectorized() ) {
594 $hp[
'width'] = $file->getWidth(
$page );
597 if ( isset( $fp[
'thumbnail'] )
598 || isset( $fp[
'manualthumb'] )
599 || isset( $fp[
'framed'] )
600 || isset( $fp[
'frameless'] )
605 if ( $widthOption === null || !isset( $wgThumbLimits[$widthOption] ) ) {
610 if ( isset( $fp[
'upright'] ) && $fp[
'upright'] == 0 ) {
617 $prefWidth = isset( $fp[
'upright'] ) ?
618 round( $wgThumbLimits[$widthOption] * $fp[
'upright'], -1 ) :
619 $wgThumbLimits[$widthOption];
623 if ( !isset( $hp[
'height'] ) && ( $hp[
'width'] <= 0 ||
624 $prefWidth < $hp[
'width'] || $file->isVectorized() ) ) {
625 $hp[
'width'] = $prefWidth;
630 if ( isset( $fp[
'thumbnail'] ) || isset( $fp[
'manualthumb'] ) || isset( $fp[
'framed'] ) ) {
631 # Create a thumbnail. Alignment depends on the writing direction of
632 # the page content language (right-aligned for LTR languages,
633 # left-aligned for RTL languages)
634 # If a thumbnail width has not been provided, it is set
635 # to the default user option as specified in Language*.php
636 if ( $fp[
'align'] ==
'' ) {
639 return $prefix . self::makeThumbLink2( $title, $file, $fp, $hp,
$time,
$query ) . $postfix;
642 if ( $file && isset( $fp[
'frameless'] ) ) {
643 $srcWidth = $file->getWidth(
$page );
644 # For "frameless" option: do not present an image bigger than the
645 # source (for bitmap-style images). This is the same behavior as the
646 # "thumb" option does it already.
647 if ( $srcWidth && !$file->mustRender() && $hp[
'width'] > $srcWidth ) {
648 $hp[
'width'] = $srcWidth;
652 if ( $file && isset( $hp[
'width'] ) ) {
653 # Create a resized image, without the additional thumbnail features
654 $thumb = $file->transform( $hp );
660 $s = self::makeBrokenImageLinkObj( $title, $fp[
'title'],
'',
'',
'',
$time ==
true );
662 self::processResponsiveImages( $file, $thumb, $hp );
665 'title' => $fp[
'title'],
666 'valign' => isset( $fp[
'valign'] ) ? $fp[
'valign'] :
false,
667 'img-class' => $fp[
'class'] ];
668 if ( isset( $fp[
'border'] ) ) {
669 $params[
'img-class'] .= (
$params[
'img-class'] !==
'' ?
' ' :
'' ) .
'thumbborder';
675 if ( $fp[
'align'] !=
'' ) {
676 $s =
"<div class=\"float{$fp['align']}\">{$s}</div>";
678 return str_replace(
"\n",
' ', $prefix .
$s . $postfix );
691 if ( isset( $frameParams[
'link-url'] ) && $frameParams[
'link-url'] !==
'' ) {
692 $mtoParams[
'custom-url-link'] = $frameParams[
'link-url'];
693 if ( isset( $frameParams[
'link-target'] ) ) {
694 $mtoParams[
'custom-target-link'] = $frameParams[
'link-target'];
697 $extLinkAttrs =
$parser->getExternalLinkAttribs( $frameParams[
'link-url'] );
698 foreach ( $extLinkAttrs
as $name => $val ) {
700 $mtoParams[
'parser-extlink-' .
$name] = $val;
703 } elseif ( isset( $frameParams[
'link-title'] ) && $frameParams[
'link-title'] !==
'' ) {
704 $mtoParams[
'custom-title-link'] = self::normaliseSpecialPage( $frameParams[
'link-title'] );
705 } elseif ( !empty( $frameParams[
'no-link'] ) ) {
708 $mtoParams[
'desc-link'] =
true;
709 $mtoParams[
'desc-query'] =
$query;
727 $align =
'right',
$params = [], $framed =
false, $manualthumb =
""
735 $frameParams[
'framed'] =
true;
737 if ( $manualthumb ) {
738 $frameParams[
'manualthumb'] = $manualthumb;
740 return self::makeThumbLink2( $title, $file, $frameParams,
$params );
755 $exists = $file && $file->exists();
761 $page = isset( $hp[
'page'] ) ? $hp[
'page'] :
false;
762 if ( !isset( $fp[
'align'] ) ) {
763 $fp[
'align'] =
'right';
765 if ( !isset( $fp[
'alt'] ) ) {
768 if ( !isset( $fp[
'title'] ) ) {
771 if ( !isset( $fp[
'caption'] ) ) {
775 if ( empty( $hp[
'width'] ) ) {
777 $hp[
'width'] = isset( $fp[
'upright'] ) ? 130 : 180;
781 $manualthumb =
false;
784 $outerWidth = $hp[
'width'] + 2;
786 if ( isset( $fp[
'manualthumb'] ) ) {
787 # Use manually specified thumbnail
789 if ( $manual_title ) {
792 $thumb = $manual_img->getUnscaledThumb( $hp );
798 } elseif ( isset( $fp[
'framed'] ) ) {
800 $thumb = $file->getUnscaledThumb( $hp );
803 # Do not present an image bigger than the source, for bitmap-style images
804 # This is a hack to maintain compatibility with arbitrary pre-1.10 behavior
805 $srcWidth = $file->getWidth(
$page );
806 if ( $srcWidth && !$file->mustRender() && $hp[
'width'] > $srcWidth ) {
807 $hp[
'width'] = $srcWidth;
809 $thumb = $file->transform( $hp );
813 $outerWidth = $thumb->getWidth() + 2;
815 $outerWidth = $hp[
'width'] + 2;
819 # ThumbnailImage::toHtml() already adds page= onto the end of DjVu URLs
820 # So we don't need to pass it here in $query. However, the URL for the
821 # zoom icon still needs it, so we make a unique query for it. See bug 14771
827 && !isset( $fp[
'link-title'] )
828 && !isset( $fp[
'link-url'] )
829 && !isset( $fp[
'no-link'] ) ) {
830 $fp[
'link-url'] = $url;
833 $s =
"<div class=\"thumb t{$fp['align']}\">"
834 .
"<div class=\"thumbinner\" style=\"width:{$outerWidth}px;\">";
837 $s .= self::makeBrokenImageLinkObj( $title, $fp[
'title'],
'',
'',
'',
$time ==
true );
839 } elseif ( !$thumb ) {
840 $s .=
wfMessage(
'thumbnail_error',
'' )->escaped();
843 if ( !$noscale && !$manualthumb ) {
844 self::processResponsiveImages( $file, $thumb, $hp );
848 'title' => $fp[
'title'],
849 'img-class' => ( isset( $fp[
'class'] ) && $fp[
'class'] !==
''
851 :
'' ) .
'thumbimage'
855 if ( isset( $fp[
'framed'] ) ) {
861 'class' =>
'internal',
866 $s .=
' <div class="thumbcaption">' . $zoomIcon . $fp[
'caption'] .
"</div></div></div>";
867 return str_replace(
"\n",
' ',
$s );
880 if ( $wgResponsiveImages && $thumb && !$thumb->isError() ) {
882 $hp15[
'width'] = round( $hp[
'width'] * 1.5 );
884 $hp20[
'width'] = $hp[
'width'] * 2;
885 if ( isset( $hp[
'height'] ) ) {
886 $hp15[
'height'] = round( $hp[
'height'] * 1.5 );
887 $hp20[
'height'] = $hp[
'height'] * 2;
890 $thumb15 = $file->transform( $hp15 );
891 $thumb20 = $file->transform( $hp20 );
892 if ( $thumb15 && !$thumb15->isError() && $thumb15->getUrl() !== $thumb->getUrl() ) {
893 $thumb->responsiveUrls[
'1.5'] = $thumb15->getUrl();
895 if ( $thumb20 && !$thumb20->isError() && $thumb20->getUrl() !== $thumb->getUrl() ) {
896 $thumb->responsiveUrls[
'2'] = $thumb20->getUrl();
913 $query =
'', $unused1 =
'', $unused2 =
'',
$time =
false
916 wfWarn( __METHOD__ .
': Requires $title to be a Title object.' );
917 return "<!-- ERROR -->" . htmlspecialchars( $label );
921 if ( $label ==
'' ) {
922 $label =
$title->getPrefixedText();
924 $encLabel = htmlspecialchars( $label );
927 if ( ( $wgUploadMissingFileUrl || $wgUploadNavigationUrl || $wgEnableUploads )
938 return '<a href="' . htmlspecialchars( $href ) .
'" class="new" title="' .
939 htmlspecialchars(
$title->getPrefixedText(), ENT_QUOTES ) .
'">' .
955 $q =
'wpDestFile=' . $destFile->getPartialURL();
960 if ( $wgUploadMissingFileUrl ) {
962 } elseif ( $wgUploadNavigationUrl ) {
966 return $upload->getLocalURL( $q );
980 return self::makeMediaLinkFile(
$title, $img,
$html );
995 if ( $file && $file->exists() ) {
996 $url = $file->getUrl();
999 $url = self::getUploadUrl( $title );
1004 if (
$html ==
'' ) {
1017 wfDebug(
"Hook LinkerMakeMediaLinkFile changed the output of link "
1018 .
"with url {$url} and text {$html} to {$ret}\n",
true );
1056 $class =
"external";
1058 $class .=
" $linktype";
1061 $class .=
" {$attribs['class']}";
1066 $text = htmlspecialchars( $text );
1075 } elseif ( $newRel !==
'' ) {
1077 $newRels = explode(
' ', $newRel );
1078 $oldRels = explode(
' ',
$attribs[
'rel'] );
1079 $combined = array_unique( array_merge( $newRels, $oldRels ) );
1080 $attribs[
'rel'] = implode(
' ', $combined );
1086 wfDebug(
"Hook LinkerMakeExternalLink changed the output of link "
1087 .
"with url {$url} and text {$text} to {$link}\n",
true );
1102 public static function userLink( $userId, $userName, $altUserName =
false ) {
1103 $classes =
'mw-userlink';
1104 if ( $userId == 0 ) {
1106 if ( $altUserName ===
false ) {
1109 $classes .=
' mw-anonuserlink';
1116 htmlspecialchars( $altUserName !==
false ? $altUserName : $userName ),
1117 [
'class' => $classes ]
1134 $userId, $userText, $redContribsWhenNoEdits =
false,
$flags = 0, $edits = null
1137 $talkable = !( $wgDisableAnonTalk && 0 == $userId );
1138 $blockable = !(
$flags & self::TOOL_LINKS_NOBLOCK );
1139 $addEmailLink =
$flags & self::TOOL_LINKS_EMAIL && $userId;
1143 $items[] = self::userTalkLink( $userId, $userText );
1148 if ( $redContribsWhenNoEdits ) {
1149 if ( intval( $edits ) === 0 && $edits !== 0 ) {
1151 $edits =
$user->getEditCount();
1153 if ( $edits === 0 ) {
1161 if ( $blockable && $wgUser->isAllowed(
'block' ) ) {
1162 $items[] = self::blockLink( $userId, $userText );
1165 if ( $addEmailLink && $wgUser->canSendEmail() ) {
1166 $items[] = self::emailLink( $userId, $userText );
1169 Hooks::run(
'UserToolLinksEdit', [ $userId, $userText, &$items ] );
1172 return wfMessage(
'word-separator' )->escaped()
1173 .
'<span class="mw-usertoollinks">'
1174 .
wfMessage(
'parentheses' )->rawParams( $wgLang->pipeList( $items ) )->escaped()
1189 return self::userToolLinks( $userId, $userText,
true, 0, $edits );
1200 return $userTalkLink;
1241 return '<span class="history-deleted">' .
$link .
'</span>';
1258 $link = self::userLink( $userId, $userText )
1259 . self::userToolLinks( $userId, $userText );
1264 return ' <span class="history-deleted">' .
$link .
'</span>';
1293 # Sanitize text a bit:
1295 # Allow HTML entities (for bug 13815)
1298 # Render autocomments and make links:
1337 '!(?:(?<=(.)))?/\*\s*(.*?)\s*\*/(?:(?=(.)))?!',
1338 function ( $match )
use (
$title, $local, $wikiId, &$append ) {
1342 $match += [
'',
'',
'',
'' ];
1344 $pre = $match[1] !==
'';
1346 $post = $match[3] !==
'';
1350 'FormatAutocomments',
1358 # Remove links that a user may have manually put in the autosummary
1359 # This could be improved by copying as much of Parser::stripSectionName as desired.
1371 if ( $sectionTitle ) {
1378 # written summary $presep autocomment (summary )
1379 $pre =
wfMessage(
'autocomment-prefix' )->inContentLanguage()->escaped();
1382 # autocomment $postsep written summary ( summary)
1383 $auto .=
wfMessage(
'colon-separator' )->inContentLanguage()->escaped();
1385 $auto =
'<span class="autocomment">' .
$auto .
'</span>';
1387 .
'<span dir="auto">' .
$auto;
1388 $append .=
'</span>';
1416 return preg_replace_callback(
1419 :? # ignore optional leading colon
1420 ([^\]|]+) # 1. link target; page names cannot include ] or |
1422 # 2. a pipe-separated substring; only the last is captured
1423 # Stop matching at | and ]] without relying on backtracking.
1427 ([^[]*) # 3. link trail (the text up until the next link)
1429 function ( $match )
use (
$title, $local, $wikiId ) {
1433 $medians .= preg_quote( $wgContLang->getNsText(
NS_MEDIA ),
'/' ) .
'):';
1437 # fix up urlencoded title texts (copied from Parser::replaceInternalLinks)
1438 if ( strpos( $match[1],
'%' ) !==
false ) {
1440 rawurldecode( $match[1] ),
1441 [
'<' =>
'<',
'>' =>
'>' ]
1445 # Handle link renaming [[foo|text]] will show link as "text"
1446 if ( $match[2] !=
"" ) {
1453 if ( preg_match(
'/^' . $medians .
'(.*)$/i', $match[1], $submatch ) ) {
1454 # Media link; trail not supported.
1455 $linkRegexp =
'/\[\[(.*?)\]\]/';
1461 # Other kind of link
1462 # Make sure its target is non-empty
1463 if ( isset( $match[1][0] ) && $match[1][0] ==
':' ) {
1464 $match[1] = substr( $match[1], 1 );
1466 if ( $match[1] !==
false && $match[1] !==
'' ) {
1467 if ( preg_match( $wgContLang->linkTrail(), $match[3], $submatch ) ) {
1468 $trail = $submatch[1];
1472 $linkRegexp =
'/\[\[(.*?)\]\]' . preg_quote( $trail,
'/' ) .
'/';
1480 if ( $target->getText() ==
'' && !$target->isExternal()
1483 $newTarget = clone
$title;
1484 $newTarget->setFragment(
'#' . $target->getFragment() );
1485 $target = $newTarget;
1494 $comment = preg_replace(
1524 if ( $wikiId !== null && !$title->
isExternal() ) {
1550 # :Foobar -- override special treatment of prefix (images, language links)
1551 # /Foobar -- convert to CurrentPage/Foobar
1552 # /Foobar/ -- convert to CurrentPage/Foobar, strip the initial and final / from text
1553 # ../ -- convert to CurrentPage, from CurrentPage/CurrentSubPage
1554 # ../Foobar -- convert to CurrentPage/Foobar,
1555 # (from CurrentPage/CurrentSubPage)
1556 # ../Foobar/ -- convert to CurrentPage/Foobar, use 'Foobar' as text
1557 # (from CurrentPage/CurrentSubPage)
1561 # Some namespaces don't allow subpages,
1562 # so only perform processing if subpages are allowed
1564 $hash = strpos( $target,
'#' );
1565 if ( $hash !==
false ) {
1566 $suffix = substr( $target, $hash );
1567 $target = substr( $target, 0, $hash );
1572 $target = trim( $target );
1573 # Look at the first character
1574 if ( $target !=
'' && $target[0] ===
'/' ) {
1575 # / at end means we don't want the slash to be shown
1577 $trailingSlashes = preg_match_all(
'%(/+)$%', $target, $m );
1578 if ( $trailingSlashes ) {
1579 $noslash = $target = substr( $target, 1, -strlen( $m[0][0] ) );
1581 $noslash = substr( $target, 1 );
1584 $ret = $contextTitle->getPrefixedText() .
'/' . trim( $noslash ) . $suffix;
1585 if ( $text ===
'' ) {
1586 $text = $target . $suffix;
1587 } #
this might be changed
for ugliness
reasons
1589 # check for .. subpage backlinks
1591 $nodotdot = $target;
1592 while ( strncmp( $nodotdot,
"../", 3 ) == 0 ) {
1594 $nodotdot = substr( $nodotdot, 3 );
1596 if ( $dotdotcount > 0 ) {
1597 $exploded = explode(
'/', $contextTitle->getPrefixedText() );
1598 if ( count( $exploded ) > $dotdotcount ) { # not allowed to go
below top level
page
1599 $ret = implode(
'/', array_slice( $exploded, 0, -$dotdotcount ) );
1600 # / at the end means don't show full path
1601 if ( substr( $nodotdot, -1, 1 ) ===
'/' ) {
1602 $nodotdot = rtrim( $nodotdot,
'/' );
1603 if ( $text ===
'' ) {
1604 $text = $nodotdot . $suffix;
1607 $nodotdot = trim( $nodotdot );
1608 if ( $nodotdot !=
'' ) {
1609 $ret .=
'/' . $nodotdot;
1641 $formatted = self::formatComment(
$comment,
$title, $local, $wikiId );
1642 $formatted =
wfMessage(
'parentheses' )->rawParams( $formatted )->escaped();
1643 return " <span class=\"comment\">$formatted</span>";
1661 $block =
" <span class=\"comment\">" .
wfMessage(
'rev-deleted-comment' )->escaped() .
"</span>";
1666 $block =
" <span class=\"comment\">" .
wfMessage(
'rev-deleted-comment' )->escaped() .
"</span>";
1669 return " <span class=\"history-deleted\">$block</span>";
1680 $stxt =
wfMessage(
'historyempty' )->escaped();
1682 $stxt =
wfMessage(
'nbytes' )->numParams( $size )->escaped();
1683 $stxt =
wfMessage(
'parentheses' )->rawParams( $stxt )->escaped();
1685 return "<span class=\"history-size\">$stxt</span>";
1704 return "</li>\n" . str_repeat(
"</ul>\n</li>\n", $level > 0 ? $level : 0 );
1717 public static function tocLine( $anchor, $tocline, $tocnumber, $level, $sectionIndex =
false ) {
1718 $classes =
"toclevel-$level";
1719 if ( $sectionIndex !==
false ) {
1720 $classes .=
" tocsection-$sectionIndex";
1722 return "\n<li class=\"$classes\"><a href=\"#" .
1723 $anchor .
'"><span class="tocnumber">' .
1724 $tocnumber .
'</span> <span class="toctext">' .
1725 $tocline .
'</span></a>';
1749 return '<div id="toc" class="toc">'
1750 .
'<div id="toctitle"><h2>' .
$title .
"</h2></div>\n"
1752 .
"</ul>\n</div>\n";
1766 if ( $section[
'toclevel'] > $lastLevel ) {
1767 $toc .= self::tocIndent();
1768 } elseif ( $section[
'toclevel'] < $lastLevel ) {
1769 $toc .= self::tocUnindent(
1770 $lastLevel - $section[
'toclevel'] );
1772 $toc .= self::tocLineEnd();
1775 $toc .= self::tocLine( $section[
'anchor'],
1776 $section[
'line'], $section[
'number'],
1777 $section[
'toclevel'], $section[
'index'] );
1778 $lastLevel = $section[
'toclevel'];
1780 $toc .= self::tocLineEnd();
1781 return self::tocList( $toc,
$lang );
1800 $link, $legacyAnchor =
false
1802 $ret =
"<h$level$attribs"
1803 .
"<span class=\"mw-headline\" id=\"$anchor\">$html</span>"
1806 if ( $legacyAnchor !==
false ) {
1807 $ret =
"<div id=\"$legacyAnchor\"></div>$ret";
1820 $regex = $wgContLang->linkTrail();
1822 if ( $trail !==
'' ) {
1824 if ( preg_match( $regex, $trail, $m ) ) {
1829 return [ $inside, $trail ];
1865 if ( in_array(
'verify',
$options,
true ) ) {
1866 $editCount = self::getRollbackEditCount(
$rev,
true );
1867 if ( $editCount ===
false ) {
1872 $inner = self::buildRollbackLink(
$rev,
$context, $editCount );
1874 if ( !in_array(
'noBrackets',
$options,
true ) ) {
1875 $inner =
$context->msg(
'brackets' )->rawParams( $inner )->escaped();
1878 return '<span class="mw-rollback-link">' . $inner .
'</span>';
1898 if ( !is_int( $wgShowRollbackEditCount ) || !$wgShowRollbackEditCount > 0 ) {
1908 [
'rev_user_text',
'rev_deleted' ],
1910 [
'rev_page' =>
$rev->getTitle()->getArticleID() ],
1913 'USE INDEX' => [
'revision' =>
'page_timestamp' ],
1914 'ORDER BY' =>
'rev_timestamp DESC',
1915 'LIMIT' => $wgShowRollbackEditCount + 1
1921 foreach (
$res as $row ) {
1938 if ( $verify && $editCount <= $wgShowRollbackEditCount && !$moreRevs ) {
1961 $disableRollbackEditCountSpecialPage = [
'Recentchanges',
'Watchlist' ];
1969 'action' =>
'rollback',
1970 'from' =>
$rev->getUserText(),
1971 'token' =>
$context->getUser()->getEditToken( [
1972 $title->getPrefixedText(),
1976 if (
$context->getRequest()->getBool(
'bot' ) ) {
1978 $query[
'hidediff'] =
'1';
1981 $disableRollbackEditCount =
false;
1982 if ( $wgMiserMode ) {
1983 foreach ( $disableRollbackEditCountSpecialPage
as $specialPage ) {
1984 if (
$context->getTitle()->isSpecial( $specialPage ) ) {
1985 $disableRollbackEditCount =
true;
1991 if ( !$disableRollbackEditCount
1992 && is_int( $wgShowRollbackEditCount )
1993 && $wgShowRollbackEditCount > 0
1995 if ( !is_numeric( $editCount ) ) {
1996 $editCount = self::getRollbackEditCount(
$rev,
false );
1999 if ( $editCount > $wgShowRollbackEditCount ) {
2000 $editCount_output =
$context->msg(
'rollbacklinkcount-morethan' )
2001 ->numParams( $wgShowRollbackEditCount )->parse();
2003 $editCount_output =
$context->msg(
'rollbacklinkcount' )->numParams( $editCount )->parse();
2009 [
'title' =>
$context->msg(
'tooltip-rollback' )->text() ],
2011 [
'known',
'noclasses' ]
2016 $context->msg(
'rollbacklink' )->escaped(),
2017 [
'title' =>
$context->msg(
'tooltip-rollback' )->text() ],
2019 [
'known',
'noclasses' ]
2045 if ( count( $templates ) > 0 ) {
2046 # Do a batch existence check
2049 $batch->addObj( $title );
2053 # Construct the HTML
2054 $outText =
'<div class="mw-templatesUsedExplanation">';
2056 $outText .=
wfMessage(
'templatesusedpreview' )->numParams( count( $templates ) )
2059 $outText .=
wfMessage(
'templatesusedsection' )->numParams( count( $templates ) )
2062 $outText .=
wfMessage(
'templatesused' )->numParams( count( $templates ) )
2065 $outText .=
"</div><ul>\n";
2067 usort( $templates,
'Title::compare' );
2068 foreach ( $templates
as $titleObj ) {
2070 $restrictions = $titleObj->getRestrictions(
'edit' );
2071 if ( $restrictions ) {
2074 if ( $restrictions === [
'sysop' ] ) {
2075 $msg =
wfMessage(
'template-protected' );
2076 } elseif ( $restrictions === [
'autoconfirmed' ] ) {
2077 $msg =
wfMessage(
'template-semiprotected' );
2079 if ( $msg && !$msg->isDisabled() ) {
2080 $protected = $msg->parse();
2085 foreach ( $restrictions
as $r ) {
2086 $msgs[] =
wfMessage(
"restriction-level-$r" )->parse();
2089 ->rawParams( $wgLang->commaList( $msgs ) )->escaped();
2092 if ( $titleObj->quickUserCan(
'edit' ) ) {
2097 [
'action' =>
'edit' ]
2102 wfMessage(
'viewsourcelink' )->escaped(),
2104 [
'action' =>
'edit' ]
2108 .
wfMessage(
'word-separator' )->escaped()
2109 .
wfMessage(
'parentheses' )->rawParams( $editLink )->escaped()
2110 .
wfMessage(
'word-separator' )->escaped()
2111 . $protected .
'</li>';
2114 if ( $more instanceof
Title ) {
2116 } elseif ( $more ) {
2117 $outText .=
"<li>$more</li>";
2120 $outText .=
'</ul>';
2135 if ( count( $hiddencats ) > 0 ) {
2136 # Construct the HTML
2137 $outText =
'<div class="mw-hiddenCategoriesExplanation">';
2138 $outText .=
wfMessage(
'hiddencategories' )->numParams( count( $hiddencats ) )->parseAsBlock();
2139 $outText .=
"</div><ul>\n";
2141 foreach ( $hiddencats
as $titleObj ) {
2142 # If it's hidden, it must exist - no need to check with a LinkBatch
2144 .
self::link( $titleObj, null, [], [],
'known' )
2147 $outText .=
'</ul>';
2161 return htmlspecialchars( $wgLang->formatSize( $size ) );
2179 $message =
wfMessage(
"tooltip-$name", $msgParams );
2180 if ( !$message->exists() ) {
2183 $tooltip = $message->text();
2184 # Compatibility: formerly some tooltips had [alt-.] hardcoded
2185 $tooltip = preg_replace(
"/ ?\[alt-.\]$/",
'', $tooltip );
2186 # Message equal to '-' means suppress it.
2187 if ( $tooltip ==
'-' ) {
2193 $accesskey = self::accesskey(
$name );
2194 if ( $accesskey !==
false ) {
2196 if ( $tooltip ===
false || $tooltip ===
'' ) {
2197 $tooltip =
wfMessage(
'brackets', $accesskey )->text();
2199 $tooltip .=
wfMessage(
'word-separator' )->text();
2200 $tooltip .=
wfMessage(
'brackets', $accesskey )->text();
2221 if ( isset( self::$accesskeycache[
$name] ) ) {
2222 return self::$accesskeycache[
$name];
2225 $message =
wfMessage(
"accesskey-$name" );
2227 if ( !$message->exists() ) {
2230 $accesskey = $message->plain();
2231 if ( $accesskey ===
'' || $accesskey ===
'-' ) {
2232 # @todo FIXME: Per standard MW behavior, a value of '-' means to suppress the
2233 # attribute, but this is broken for accesskey: that might be a useful
2239 self::$accesskeycache[
$name] = $accesskey;
2240 return self::$accesskeycache[
$name];
2257 $canHide = $user->
isAllowed(
'deleterevision' );
2265 if ( $rev->
getId() ) {
2269 'type' =>
'revision',
2271 'ids' => $rev->
getId()
2277 'type' =>
'archive',
2299 $msgKey = $delete ?
'rev-delundel' :
'rev-showdeleted';
2301 $tag = $restricted ?
'strong' :
'span';
2305 [
'class' =>
'mw-revdelundel-link' ],
2319 $msgKey = $delete ?
'rev-delundel' :
'rev-showdeleted';
2321 $htmlParentheses =
wfMessage(
'parentheses' )->rawParams(
$html )->escaped();
2322 return Xml::tags(
'span', [
'class' =>
'mw-revdelundel-link' ], $htmlParentheses );
2336 # @todo FIXME: If Sanitizer::expandAttributes() treated "false" as "output
2337 # no attribute" instead of "output '' as value for attribute", this
2338 # would be three lines.
2340 'title' => self::titleAttrib(
$name,
'withaccess', $msgParams ),
2341 'accesskey' => self::accesskey(
$name )
2343 if (
$attribs[
'title'] ===
false ) {
2346 if (
$attribs[
'accesskey'] ===
false ) {
2359 # @todo FIXME: If Sanitizer::expandAttributes() treated "false" as "output
2360 # no attribute" instead of "output '' as value for attribute", this
2361 # would be two lines.
2363 if ( $tooltip ===
false ) {
static generateTOC($tree, $lang=false)
Generate a table of contents from a section tree.
getFragment()
Get the Title fragment (i.e.
static tocLineEnd()
End a Table Of Contents line.
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses & $html
Interface for objects which can provide a MediaWiki context on request.
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
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...
wfGetDB($db, $groups=[], $wiki=false)
Get a Database object.
static tocList($toc, $lang=false)
Wraps the TOC in a table and provides the hide/collapse javascript.
static formatAutocomments($comment, $title=null, $local=false, $wikiId=null)
Converts autogenerated comments in edit summaries into section links.
static processResponsiveImages($file, $thumb, $hp)
Process responsive images: add 1.5x and 2x subimages to the thumbnail, where applicable.
the array() calling protocol came about after MediaWiki 1.4rc1.
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
static linkKnown($target, $html=null, $customAttribs=[], $query=[], $options=[ 'known', 'noclasses'])
Identical to link(), except $options defaults to 'known'.
magic word the default is to use $key to get the and $key value or $key value text $key value html to format the value $key
static getRevDeleteLink(User $user, Revision $rev, Title $title)
Get a revision-deletion link, or disabled link, or nothing, depending on user permissions & the setti...
getText()
Get the text form (spaces not underscores) of the main part.
static linkText($target)
Default text of the links to the Title $target.
static buildRollbackLink($rev, IContextSource $context=null, $editCount=false)
Build a raw rollback link, useful for collections of "tool" links.
Apache License January AND DISTRIBUTION Definitions License shall mean the terms and conditions for use
static getTitleFor($name, $subpage=false, $fragment= '')
Get a localised Title object for a specified special page name.
We use the convention $dbr for read and $dbw for write to help you keep track of whether the database object is a the world will explode Or to be a subsequent write query which succeeded on the master may fail when replicated to the slave due to a unique key collision Replication on the slave will stop and it may take hours to repair the database and get it back online Setting read_only in my cnf on the slave will avoid this but given the dire we prefer to have as many checks as possible We provide a but the wrapper functions like please read the documentation for except in special pages derived from QueryPage It s a common pitfall for new developers to submit code containing SQL queries which examine huge numbers of rows Remember that COUNT * is(N), counting rows in atable is like counting beans in a bucket.------------------------------------------------------------------------Replication------------------------------------------------------------------------The largest installation of MediaWiki, Wikimedia, uses a large set ofslave MySQL servers replicating writes made to a master MySQL server.Itis important to understand the issues associated with this setup if youwant to write code destined for Wikipedia.It's often the case that the best algorithm to use for a given taskdepends on whether or not replication is in use.Due to our unabashedWikipedia-centrism, we often just use the replication-friendly version, but if you like, you can use wfGetLB() ->getServerCount() > 1 tocheck to see if replication is in use.===Lag===Lag primarily occurs when large write queries are sent to the master.Writes on the master are executed in parallel, but they are executed inserial when they are replicated to the slaves.The master writes thequery to the binlog when the transaction is committed.The slaves pollthe binlog and start executing the query as soon as it appears.They canservice reads while they are performing a write query, but will not readanything more from the binlog and thus will perform no more writes.Thismeans that if the write query runs for a long time, the slaves will lagbehind the master for the time it takes for the write query to complete.Lag can be exacerbated by high read load.MediaWiki's load balancer willstop sending reads to a slave when it is lagged by more than 30 seconds.If the load ratios are set incorrectly, or if there is too much loadgenerally, this may lead to a slave permanently hovering around 30seconds lag.If all slaves are lagged by more than 30 seconds, MediaWiki will stopwriting to the database.All edits and other write operations will berefused, with an error returned to the user.This gives the slaves achance to catch up.Before we had this mechanism, the slaves wouldregularly lag by several minutes, making review of recent editsdifficult.In addition to this, MediaWiki attempts to ensure that the user seesevents occurring on the wiki in chronological order.A few seconds of lagcan be tolerated, as long as the user sees a consistent picture fromsubsequent requests.This is done by saving the master binlog positionin the session, and then at the start of each request, waiting for theslave to catch up to that position before doing any reads from it.Ifthis wait times out, reads are allowed anyway, but the request isconsidered to be in"lagged slave mode".Lagged slave mode can bechecked by calling wfGetLB() ->getLaggedSlaveMode().The onlypractical consequence at present is a warning displayed in the pagefooter.===Lag avoidance===To avoid excessive lag, queries which write large numbers of rows shouldbe split up, generally to write one row at a time.Multi-row INSERT...SELECT queries are the worst offenders should be avoided altogether.Instead do the select first and then the insert.===Working with lag===Despite our best efforts, it's not practical to guarantee a low-lagenvironment.Lag will usually be less than one second, but mayoccasionally be up to 30 seconds.For scalability, it's very importantto keep load on the master low, so simply sending all your queries tothe master is not the answer.So when you have a genuine need forup-to-date data, the following approach is advised:1) Do a quick query to the master for a sequence number or timestamp 2) Run the full query on the slave and check if it matches the data you gotfrom the master 3) If it doesn't, run the full query on the masterTo avoid swamping the master every time the slaves lag, use of thisapproach should be kept to a minimum.In most cases you should just readfrom the slave and let the user deal with the delay.------------------------------------------------------------------------Lock contention------------------------------------------------------------------------Due to the high write rate on Wikipedia(and some other wikis), MediaWiki developers need to be very careful to structure their writesto avoid long-lasting locks.By default, MediaWiki opens a transactionat the first query, and commits it before the output is sent.Locks willbe held from the time when the query is done until the commit.So youcan reduce lock time by doing as much processing as possible before youdo your write queries.Often this approach is not good enough, and it becomes necessary toenclose small groups of queries in their own transaction.Use thefollowing syntax:$dbw=wfGetDB(DB_MASTER
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses & $ret
msg()
Get a Message object with context set.
static rawElement($element, $attribs=[], $contents= '')
Returns an HTML element in a string.
static expandAttributes($attribs)
Given an array of ('attributename' => 'value'), it generates the code to set the XML attributes : att...
if(!isset($args[0])) $lang
processing should stop and the error should be shown to the user * false
static formatRevisionSize($size)
static normaliseSpecialPage(LinkTarget $target)
static fnamePart($url)
Returns the filename part of an url.
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 in any and then calling but I prefer the flexibility This should also do the output encoding The system allocates a global one in $wgOut Title Represents the title of an and does all the work of translating among various forms such as plain database etc For and for historical reasons
static makeSelfLinkObj($nt, $html= '', $query= '', $trail= '', $prefix= '')
Make appropriate markup for a link to the current article.
static newFromId($id)
Static factory method for creation from a given user ID.
it s the revision text itself In either if gzip is the revision text is gzipped $flags
static escapeRegexReplacement($string)
Escape a string to make it suitable for inclusion in a preg_replace() replacement parameter...
getPrefixedText()
Get the prefixed title with spaces.
static exists($index)
Returns whether the specified namespace exists.
static newFromText($text, $defaultNamespace=NS_MAIN)
Create a new Title from text, such as what one would find in a link.
Represents a title within MediaWiki.
when a variable name is used in a it is silently declared as a new local masking the global
static newFromLinkTarget(LinkTarget $linkTarget)
Create a new Title from a LinkTarget.
static blockLink($userId, $userText)
static tooltipAndAccesskeyAttribs($name, array $msgParams=[])
Returns the attributes for the tooltip and access key.
see documentation in includes Linker php for Linker::makeImageLink & $time
static formatTemplates($templates, $preview=false, $section=false, $more=null)
Returns HTML for the "templates used on this page" list.
wfDebug($text, $dest= 'all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
this class mediates it Skin Encapsulates a look and feel for the wiki All of the functions that render HTML and make choices about how to render it are here and are called from various other places when and is meant to be subclassed with other skins that may override some of its functions The User object contains a reference to a and so rather than having a global skin object we just rely on the global User and get the skin with $wgUser and also has some character encoding functions and other locale stuff The current user interface language is instantiated as $wgLang
the value to return A Title object or null for latest to be modified or replaced by the hook handler or if authentication is not possible after cache objects are set for highlighting & $link
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't the only contributor and the revision we might rollback to isn't deleted).
static splitTrail($trail)
Split a link trail, return the "inside" portion and the remainder of the trail as a two-element array...
$wgEnableUploads
Uploads have to be specially set up to be secure.
static makeMediaLinkObj($title, $html= '', $time=false)
Create a direct link to a given uploaded file.
static makeBrokenImageLinkObj($title, $label= '', $query= '', $unused1= '', $unused2= '', $time=false)
Make a "broken" link to an image.
Class representing a list of titles The execute() method checks them all for existence and adds them ...
static getLinkAttributesInternal($title, $class)
Common code for getLinkAttributesX functions.
null means default & $customAttribs
wfCgiToArray($query)
This is the logical opposite of wfArrayToCgi(): it accepts a query string as its argument and returns...
static normalizeSectionNameWhitespace($section)
Normalizes whitespace in a section name, such as might be returned by Parser::stripSectionName(), for use in the id's that are used for section links.
static getForeignURL($wikiID, $page, $fragmentId=null)
Convenience to get a url to a page on a foreign wiki.
getTitle()
Returns the title of the page associated with this entry or null.
isExternal()
Is this Title interwiki?
static getMain()
Static methods.
$wgUploadMissingFileUrl
Point the upload link for missing files to an external URL, as with $wgUploadNavigationUrl.
static normalizeSubpageLink($contextTitle, $target, &$text)
static getCanonicalName($index)
Returns the canonical (English) name for a given index.
wfAppendQuery($url, $query)
Append a query string to an existing URL, which may or may not already have query string parameters a...
static titleAttrib($name, $options=null, array $msgParams=[])
Given the id of an interface element, constructs the appropriate title attribute from the system mess...
isAllowed($action= '')
Internal mechanics of testing a permission.
static formatLinksInComment($comment, $title=null, $local=false, $wikiId=null)
Formats wiki links and media links in text; all other wiki formatting is ignored. ...
Some internal bits split of from Skin.php.
wfWarn($msg, $callerOffset=1, $level=E_USER_NOTICE)
Send a warning either to the debug log or in a PHP error depending on $wgDevelopmentWarnings.
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 $options
$wgThumbUpright
Adjust width of upright images when parameter 'upright' is used This allows a nicer look for upright ...
static escapeHtmlAllowEntities($html)
Given HTML input, escape with htmlspecialchars but un-escape entities.
getLocalURL($query= '', $query2=false)
Get a URL with no fragment or server name (relative URL) from a Title object.
static singleton()
Get a RepoGroup instance.
$wgMiserMode
Disable database-intensive features.
static accesskey($name)
Given the id of an interface element, constructs the appropriate accesskey attribute from the system ...
static mergeAttributes($a, $b)
Merge two sets of HTML attributes.
static emailLink($userId, $userText)
const TOOL_LINKS_NOBLOCK
Flags for userToolLinks()
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing after in associative array form externallinks including delete and has completed for all link tables whether this was an auto creation default is conds Array Extra conditions for the No matching items in log is displayed if loglist is empty msgKey Array If you want a nice box with a set this to the key of the message First element is the message additional optional elements are parameters for the key that are processed with wfMessage() -> params() ->parseAsBlock()-offset Set to overwrite offset parameter in $wgRequest set to ''to unsetoffset-wrap String Wrap the message in html(usually something like"<
static revDeleteLinkDisabled($delete=true)
Creates a dead (show/hide) link for deleting revisions/log entries.
static makeHeadline($level, $attribs, $anchor, $html, $link, $legacyAnchor=false)
Create a headline for content.
$wgThumbLimits
Adjust thumbnails on image pages according to a user setting.
wfDeprecated($function, $version=false, $component=false, $callerOffset=2)
Throws a warning that $function is deprecated.
userCan($field, User $user=null)
Determine if the current user is allowed to view a particular field of this revision, if it's marked as deleted.
getComment($audience=self::FOR_PUBLIC, User $user=null)
Fetch revision comment if it's available to the specified audience.
static makeTitleSafe($ns, $title, $fragment= '', $interwiki= '')
Create a new Title from a namespace index and a DB key.
Some information about database access in MediaWiki By Tim January Database layout For information about the MediaWiki database such as a description of the tables and their please see
getTargetLanguage()
Get the target language for the content being parsed.
namespace and then decline to actually register it file or subcat img or subcat $title
static hasSubpages($index)
Does the namespace allow subpages?
static tocUnindent($level)
Finish one or more sublevels on the Table of Contents.
static run($event, array $args=[], $deprecatedVersion=null)
Call hook functions defined in Hooks::register and $wgHooks.
static tocLine($anchor, $tocline, $tocnumber, $level, $sectionIndex=false)
parameter level defines if we are on an indentation level
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
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 $tag
static makeImageLink(Parser $parser, Title $title, $file, $frameParams=[], $handlerParams=[], $time=false, $query="", $widthOption=null)
Given parameters derived from [[Image:Foo|options...]], generate the HTML that that syntax inserts in...
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
static makeCommentLink(Title $title, $text, $wikiId=null, $options=[])
Generates a link to the given Title.
static userToolLinksRedContribs($userId, $userText, $edits=null)
Alias for userToolLinks( $userId, $userText, true );.
static revUserLink($rev, $isPublic=false)
Generate a user link if the current user is allowed to view it.
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
return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers temp or archived zone change it to an object instance and return false override the list derivative used the name of the old file when set the default code will be skipped true if there is text before this autocomment $auto
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...
usually copyright or history_copyright This message must be in HTML not wikitext if the section is included from a template $section
please add to it if you re going to add events to the MediaWiki code where normally authentication against an external auth plugin would be creating a local account $user
static link($target, $html=null, $customAttribs=[], $query=[], $options=[])
This function returns an HTML link to the given target.
$wgSVGMaxSize
Don't scale a SVG larger than this.
static getImageLinkMTOParams($frameParams, $query= '', $parser=null)
Get the link parameters for MediaTransformOutput::toHtml() from given frame parameters supplied by th...
static tooltip($name, $options=null)
Returns raw bits of HTML, use titleAttrib()
static userLink($userId, $userName, $altUserName=false)
Make user link (or user contributions for unregistered users)
static makeExternalLink($url, $text, $escape=true, $linktype= '', $attribs=[], $title=null)
Make an external link.
static getExternalLinkRel($url=false, $title=null)
Get the rel attribute for a particular external link.
getVisibility()
Get the deletion bitfield of the revision.
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
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 change
static tags($element, $attribs=null, $contents)
Same as Xml::element(), but does not escape contents.
controlled by $wgMainCacheType controlled by $wgParserCacheType controlled by $wgMessageCacheType If you set CACHE_NONE to one of the three control default value for MediaWiki still create a but requests to it are no ops and we always fall through to the database If the cache daemon can t be it should also disable itself fairly smoothly By $wgMemc is used but when it is $parserMemc or $messageMemc this is mentioned below
static getInternalLinkAttributesObj($nt, $unused=null, $class= '', $title=false)
Get the appropriate HTML attributes to add to the "a" element of an internal link, given the Title object for the page we want to link to.
static resolveAlias($alias)
Given a special page name with a possible subpage, return an array where the first element is the spe...
static generateRollback($rev, IContextSource $context=null, $options=[ 'verify'])
Generate a rollback link for a given revision.
static formatHiddenCategories($hiddencats)
Returns HTML for the "hidden categories on this page" list.
static makeThumbLink2(Title $title, $file, $frameParams=[], $handlerParams=[], $time=false, $query="")
static userTalkLink($userId, $userText)
Cache for article titles (prefixed DB keys) and ids linked from one source.
static getUploadUrl($destFile, $query= '')
Get the URL to upload a certain file.
static makeMediaLinkFile(Title $title, $file, $html= '')
Create a direct link to a given uploaded file.
static userToolLinks($userId, $userText, $redContribsWhenNoEdits=false, $flags=0, $edits=null)
Generate standard user tool links (talk, contributions, block link, etc.)
usually copyright or history_copyright This message must be in HTML not wikitext if the section is included from a template to be included in the link
this class mediates it Skin Encapsulates a look and feel for the wiki All of the functions that render HTML and make choices about how to render it are here and are called from various other places when and is meant to be subclassed with other skins that may override some of its functions The User object contains a reference to a and so rather than having a global skin object we just rely on the global User and get the skin with $wgUser and also has some character encoding functions and other locale stuff The current user interface language is instantiated as and the local content language as $wgContLang
static formatSize($size)
Format a size in bytes for output, using an appropriate unit (B, KB, MB or GB) according to the magni...
see documentation in includes Linker php for Linker::makeImageLink & $handlerParams
static tocIndent()
Add another level to the Table of Contents.
This list may contain false positives That usually means there is additional text with links below the first Each row contains links to the first and second redirect
static getInterwikiLinkAttributes($title, $unused=null, $class= 'external')
Get the appropriate HTML attributes to add to the "a" element of an interwiki link.
static getInternalLinkAttributes($title, $unused=null, $class= '')
Get the appropriate HTML attributes to add to the "a" element of an internal link.
static getInvalidTitleDescription(IContextSource $context, $namespace, $title)
Get a message saying that an invalid title was encountered.
$wgShowRollbackEditCount
The $wgShowRollbackEditCount variable is used to show how many edits can be rolled back...
if(!$wgRequest->checkUrlExtension()) if(!$wgEnableAPI) $wgTitle
static commentBlock($comment, $title=null, $local=false, $wikiId=null)
Wrap a comment in standard punctuation and formatting if it's non-empty, otherwise return empty strin...
static makeThumbLinkObj(Title $title, $file, $label= '', $alt, $align= 'right', $params=[], $framed=false, $manualthumb="")
Make HTML for a thumbnail including image, border and caption.
static getDefaultOption($opt)
Get a given default option value.
$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.
static linkAttribs($target, $attribs, $options)
Returns the array of attributes used when linking to the Title $target.
static revUserTools($rev, $isPublic=false)
Generate a user tool link cluster if the current user is allowed to view it.
return true to allow those checks to and false if checking is done remove or add to the links of a group of changes in EnhancedChangesList Hook subscribers can return false to omit this line from recentchanges use this to change the tables headers temp or archived zone change it to an object instance and return false override the list derivative used the name of the old file when set the default code will be skipped $pre
static makeExternalImage($url, $alt= '')
Return the code for images which were added via external links, via Parser::maybeMakeExternalImage()...
static specialLink($name, $key= '')
Make a link to a special page given its name and, optionally, a message key from the link text...
static element($element, $attribs=[], $contents= '')
Identical to rawElement(), but HTML-escapes $contents (like Xml::element()).
wfFindFile($title, $options=[])
Find a file.
static revDeleteLink($query=[], $restricted=false, $delete=true)
Creates a (show/hide) link for deleting revisions/log entries.
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 page
static getLinkColour($t, $threshold)
Return the CSS colour of a known link.
static & makeTitle($ns, $title, $fragment= '', $interwiki= '')
Create a new Title from a namespace index and a DB key.
null means default in associative array with keys and values unescaped Should be merged with default with a value of false meaning to suppress the attribute in associative array with keys and values unescaped noclasses just before the function returns a value If you return an< a > element with HTML attributes $attribs and contents $html will be returned If you return $ret will be returned and may include noclasses after processing & $attribs
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 $page
wfGetLangObj($langcode=false)
Return a Language object from $langcode.
getPrefixedDBkey()
Get the prefixed database key form.
static prettifyIP($ip)
Prettify an IP for display to end users.
static linkUrl(LinkTarget $target, $query, $options)
Returns the Url used to link to a Title.
Allows to change the fields on the form that will be generated $name