MediaWiki REL1_32
|
Some internal bits split of from Skin.php. More...
Static Public Member Functions | |
static | accesskey ( $name) |
Given the id of an interface element, constructs the appropriate accesskey attribute from the system messages. | |
static | blockLink ( $userId, $userText) |
static | buildRollbackLink ( $rev, IContextSource $context=null, $editCount=false) |
Build a raw rollback link, useful for collections of "tool" links. | |
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 string. | |
static | emailLink ( $userId, $userText) |
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 contributions list. | |
static | formatHiddenCategories ( $hiddencats) |
Returns HTML for the "hidden categories on this page" list. | |
static | formatLinksInComment ( $comment, $title=null, $local=false, $wikiId=null) |
Formats wiki links and media links in text; all other wiki formatting is ignored. | |
static | formatRevisionSize ( $size) |
static | formatSize ( $size) |
static | formatTemplates ( $templates, $preview=false, $section=false, $more=null) |
static | generateRollback ( $rev, IContextSource $context=null, $options=[ 'verify']) |
Generate a rollback link for a given revision. | |
static | generateTOC ( $tree, $lang=false) |
Generate a table of contents from a section tree. | |
static | getInvalidTitleDescription (IContextSource $context, $namespace, $title) |
Get a message saying that an invalid title was encountered. | |
static | getRevDeleteLink (User $user, Revision $rev, Title $title) |
Get a revision-deletion link, or disabled link, or nothing, depending on user permissions & the settings on the revision. | |
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 | link ( $target, $html=null, $customAttribs=[], $query=[], $options=[]) |
This function returns an HTML link to the given target. | |
static | linkKnown ( $target, $html=null, $customAttribs=[], $query=[], $options=[ 'known']) |
Identical to link(), except $options defaults to 'known'. | |
static | makeBrokenImageLinkObj ( $title, $label='', $query='', $unused1='', $unused2='', $time=false) |
Make a "broken" link to an image. | |
static | makeCommentLink (LinkTarget $linkTarget, $text, $wikiId=null, $options=[]) |
Generates a link to the given Title. | |
static | makeExternalImage ( $url, $alt='') |
Return the code for images which were added via external links, via Parser::maybeMakeExternalImage(). | |
static | makeExternalLink ( $url, $text, $escape=true, $linktype='', $attribs=[], $title=null) |
Make an external link. | |
static | makeHeadline ( $level, $attribs, $anchor, $html, $link, $fallbackAnchor=false) |
Create a headline for content. | |
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 the page. | |
static | makeMediaLinkFile (Title $title, $file, $html='') |
Create a direct link to a given uploaded file. | |
static | makeMediaLinkObj ( $title, $html='', $time=false) |
Create a direct link to a given uploaded file. | |
static | makeSelfLinkObj ( $nt, $html='', $query='', $trail='', $prefix='') |
Make appropriate markup for a link to the current article. | |
static | makeThumbLink2 (Title $title, $file, $frameParams=[], $handlerParams=[], $time=false, $query="") |
static | makeThumbLinkObj (Title $title, $file, $label='', $alt='', $align='right', $params=[], $framed=false, $manualthumb="") |
Make HTML for a thumbnail including image, border and caption. | |
static | normaliseSpecialPage (LinkTarget $target) |
static | normalizeSubpageLink ( $contextTitle, $target, &$text) |
static | processResponsiveImages ( $file, $thumb, $hp) |
Process responsive images: add 1.5x and 2x subimages to the thumbnail, where applicable. | |
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. | |
static | revDeleteLink ( $query=[], $restricted=false, $delete=true) |
Creates a (show/hide) link for deleting revisions/log entries. | |
static | revDeleteLinkDisabled ( $delete=true) |
Creates a dead (show/hide) link for deleting revisions/log entries. | |
static | revUserLink ( $rev, $isPublic=false) |
Generate a user link if the current user is allowed to view it. | |
static | revUserTools ( $rev, $isPublic=false) |
Generate a user tool link cluster if the current user is allowed to view it. | |
static | specialLink ( $name, $key='') |
Make a link to a special page given its name and, optionally, a message key from the link text. | |
static | splitTrail ( $trail) |
Split a link trail, return the "inside" portion and the remainder of the trail as a two-element array. | |
static | titleAttrib ( $name, $options=null, array $msgParams=[]) |
Given the id of an interface element, constructs the appropriate title attribute from the system messages. | |
static | tocIndent () |
Add another level to the Table of Contents. | |
static | tocLine ( $anchor, $tocline, $tocnumber, $level, $sectionIndex=false) |
parameter level defines if we are on an indentation level | |
static | tocLineEnd () |
End a Table Of Contents line. | |
static | tocList ( $toc, $lang=false) |
Wraps the TOC in a table and provides the hide/collapse javascript. | |
static | tocUnindent ( $level) |
Finish one or more sublevels on the Table of Contents. | |
static | tooltip ( $name, $options=null) |
Returns raw bits of HTML, use titleAttrib() | |
static | tooltipAndAccesskeyAttribs ( $name, array $msgParams=[], $options=null) |
Returns the attributes for the tooltip and access key. | |
static | userLink ( $userId, $userName, $altUserName=false) |
Make user link (or user contributions for unregistered users) | |
static | userTalkLink ( $userId, $userText) |
static | userToolLinks ( $userId, $userText, $redContribsWhenNoEdits=false, $flags=0, $edits=null) |
Generate standard user tool links (talk, contributions, block link, etc.) | |
static | userToolLinksRedContribs ( $userId, $userText, $edits=null) |
Alias for userToolLinks( $userId, $userText, true );. | |
Public Attributes | |
const | TOOL_LINKS_EMAIL = 2 |
const | TOOL_LINKS_NOBLOCK = 1 |
Flags for userToolLinks() | |
Static Public Attributes | |
static | $accesskeycache |
Static Protected Member Functions | |
static | getUploadUrl ( $destFile, $query='') |
Get the URL to upload a certain file. | |
Static Private Member Functions | |
static | fnamePart ( $url) |
Returns the filename part of an url. | |
static | formatAutocomments ( $comment, $title=null, $local=false, $wikiId=null) |
Converts autogenerated comments in edit summaries into section links. | |
static | getImageLinkMTOParams ( $frameParams, $query='', $parser=null) |
Get the link parameters for MediaTransformOutput::toHtml() from given frame parameters supplied by the Parser. | |
Some internal bits split of from Skin.php.
These functions are used for primarily page content: links, embedded images, table of contents. Links are also used in the skin.
Definition at line 34 of file Linker.php.
|
static |
Given the id of an interface element, constructs the appropriate accesskey attribute from the system messages.
(Note, this is usually the id but isn't always, because sometimes the accesskey needs to go on a different element than the id, for reverse-compatibility, etc.)
string | $name | Id of the element, minus prefixes. |
Definition at line 2015 of file Linker.php.
References $name, and wfMessage().
Referenced by DummyLinker\accesskey(), OOUIHTMLForm\getButtons(), EditPage\getEditButtons(), EditPage\getSummaryInputWidget(), HTMLFormField\getTooltipAndAccessKeyOOUI(), titleAttrib(), and tooltipAndAccesskeyAttribs().
|
static |
int | $userId | |
string | $userText | User name in database. |
Definition at line 1001 of file Linker.php.
References link, and wfMessage().
Referenced by DummyLinker\blockLink(), and userToolLinks().
|
static |
Build a raw rollback link, useful for collections of "tool" links.
Revision | $rev | |
IContextSource | null | $context | Context to use or null for the main context. |
int | $editCount | Number of edits that would be reverted |
Definition at line 1805 of file Linker.php.
References $context, $html, $options, $query, $rev, $wgMiserMode, $wgShowRollbackEditCount, getRollbackEditCount(), and link.
Referenced by DummyLinker\buildRollbackLink(), and generateRollback().
|
static |
Wrap a comment in standard punctuation and formatting if it's non-empty, otherwise return empty string.
string | $comment | |
Title | null | $title | Title object (to generate link to section in autocomment) or null |
bool | $local | Whether section links should refer to local page |
string | null | $wikiId | Id (as used by WikiMap) of the wiki to generate links to. For use with external changes. |
Definition at line 1441 of file Linker.php.
References formatComment(), and wfMessage().
Referenced by DummyLinker\commentBlock(), LogFormatter\getComment(), RevDelFileItem\getComment(), SpecialUndelete\getFileComment(), McrUndoAction\getFormFields(), RevDelLogItem\getHTML(), EditPage\getSummaryPreview(), ChangesList\insertComment(), revComment(), and LogFormatterTest\testLogComment().
|
static |
int | $userId | |
string | $userText | User name in database. |
Definition at line 1015 of file Linker.php.
References link, and wfMessage().
Referenced by DummyLinker\emailLink(), and userToolLinks().
|
staticprivate |
Returns the filename part of an url.
Used as alternative text for external images.
string | $url |
Definition at line 228 of file Linker.php.
Referenced by makeExternalImage().
|
staticprivate |
Converts autogenerated comments in edit summaries into section links.
The pattern for autogen comments is / * foo * /, which makes for some nasty regex. We look for all comments, match any text before and after the comment, add a separator where needed and format the comment itself with CSS Called by Linker::formatComment.
string | $comment | Comment text |
Title | null | $title | An optional title object used to links to sections |
bool | $local | Whether section links should refer to local page |
string | null | $wikiId | Id of the wiki to link to (if not the local wiki), as used by WikiMap. |
Definition at line 1120 of file Linker.php.
References $auto, $link, $pre, $section, $wgLang, makeCommentLink(), NS_MAIN, and wfMessage().
Referenced by formatComment().
|
static |
This function is called by all recent changes variants, by the page history, and by the user contributions list.
It is responsible for formatting edit summaries. It escapes any HTML in the summary, but adds some CSS to format auto-generated comments (from section editing) and formats [[wikilinks]].
string | $comment | |
Title | null | $title | Title object (to generate link to the section in autocomment) or null |
bool | $local | Whether section links should refer to local page |
string | null | $wikiId | Id (as used by WikiMap) of the wiki to generate links to. For use with external changes. |
Definition at line 1088 of file Linker.php.
References formatAutocomments(), and formatLinksInComment().
Referenced by commentBlock(), ApiQueryDeletedrevs\execute(), ApiQueryFilearchive\execute(), ApiQueryWatchlist\extractOutputData(), ApiQueryRevisionsBase\extractRevisionInfo(), ApiQueryLogEvents\extractRowInfo(), ApiQueryRecentChanges\extractRowInfo(), ApiQueryUserContribs\extractRowInfo(), DummyLinker\formatComment(), FeedUtils\formatDiffRow(), ApiParse\formatSummary(), ImageListPager\formatValue(), ProtectedPagesPager\formatValue(), BlockListPager\formatValue(), ApiQueryImageInfo\getInfo(), ImageHistoryList\imageHistoryLine(), RollbackAction\onView(), ApiQueryProtectedTitles\run(), ParserTestRunner\runTest(), ApiComparePages\setVals(), and LinkerTest\testFormatComment().
|
static |
Returns HTML for the "hidden categories on this page" list.
array | $hiddencats | Array of hidden categories from Article::getHiddenCategories or similar |
Definition at line 1915 of file Linker.php.
References link, and wfMessage().
Referenced by DummyLinker\formatHiddenCategories(), InfoAction\pageInfo(), and EditPage\showEditForm().
|
static |
Formats wiki links and media links in text; all other wiki formatting is ignored.
string | $comment | Text to format links in. WARNING! Since the output of this function is html, $comment must be sanitized for use as html. You probably want to pass $comment through Sanitizer::escapeHtmlAllowEntities() before calling this function. |
Title | null | $title | An optional title object used to links to sections |
bool | $local | Whether section links should refer to local page |
string | null | $wikiId | Id of the wiki to link to (if not the local wiki), as used by WikiMap. |
Definition at line 1214 of file Linker.php.
References StringUtils\escapeRegexReplacement(), list, makeCommentLink(), makeMediaLinkObj(), normalizeSubpageLink(), NS_FILE, NS_MEDIA, and splitTrail().
Referenced by formatComment(), DummyLinker\formatLinksInComment(), and LinkerTest\testFormatLinksInComment().
|
static |
int | $size |
Definition at line 1489 of file Linker.php.
References wfMessage().
Referenced by SpecialMergeHistory\formatRevisionRow(), SpecialUndelete\formatRevisionRow(), DummyLinker\formatRevisionSize(), ContribsPager\formatRow(), ProtectedPagesPager\formatValue(), and HistoryPager\historyLine().
|
static |
Format a size in bytes for output, using an appropriate unit (B, KB, MB or GB) according to the magnitude in question
int | $size | Size to format |
Definition at line 1944 of file Linker.php.
References $wgLang, and wfDeprecated().
Referenced by DummyLinker\formatSize().
|
static |
Returns HTML for the "templates used on this page" list.
Make an HTML list of templates, and then add a "More..." link at the bottom. If $more is null, do not add a "More..." link. If $more is a Title, make a link to that title and use it. If $more is a string, directly paste it in as the link (escaping needs to be done manually). Finally, if $more is a Message, call toString().
Title[] | $templates | Array of templates |
bool | $preview | Whether this is for a preview |
bool | $section | Whether this is for a section edit |
Title | Message | string | null | $more | An escaped link for "More..." of the templates |
Definition at line 1884 of file Linker.php.
References $section, $type, and wfDeprecated().
Referenced by DummyLinker\formatTemplates().
|
static |
Generate a rollback link for a given revision.
Currently it's the caller's responsibility to ensure that the revision is the top one. If it's not, of course, the user will get an error message.
If the calling page is called with the parameter &bot=1, all rollback links also get that parameter. It causes the edit itself and the rollback to be marked as "bot" edits. Bot edits are hidden by default from recent changes, so this allows sysops to combat a busy vandal without bothering other users.
If the option verify is set this function will return the link only in case the revision can be reverted. Please note that due to performance limitations it might be assumed that a user isn't the only contributor of a page while (s)he is, which will lead to useless rollback links. Furthermore this wont work if $wgShowRollbackEditCount is disabled, so this can only function as an additional check.
If the option noBrackets is set the rollback link wont be enclosed in "[]".
Revision | $rev | |
IContextSource | null | $context | Context to use or null for the main context. |
array | $options |
Definition at line 1704 of file Linker.php.
References $context, $options, $rev, buildRollbackLink(), and getRollbackEditCount().
Referenced by ContribsPager\formatRow(), DummyLinker\generateRollback(), HistoryPager\historyLine(), ChangesList\insertRollback(), and DifferenceEngine\showDiffPage().
|
static |
Generate a table of contents from a section tree.
array | $tree | Return value of ParserOutput::getSections() |
string | Language | bool | $lang | Language for the toc title, defaults to user language |
Definition at line 1603 of file Linker.php.
References $lang, $section, tocIndent(), tocLine(), tocLineEnd(), tocList(), and tocUnindent().
Referenced by DummyLinker\generateTOC(), and ApiHelp\getHelp().
|
staticprivate |
Get the link parameters for MediaTransformOutput::toHtml() from given frame parameters supplied by the Parser.
array | $frameParams | The frame parameters |
string | $query | An optional query string to add to description page links |
Parser | null | $parser |
Definition at line 451 of file Linker.php.
References $name, $parser, and $query.
Referenced by makeImageLink(), and makeThumbLink2().
|
static |
Get a message saying that an invalid title was encountered.
This should be called after a method like Title::makeTitleSafe() returned a value indicating that the title object is invalid.
IContextSource | $context | Context to use to get the messages |
int | $namespace | Namespace number |
string | $title | Text of the title, without the namespace part |
Definition at line 186 of file Linker.php.
References $context, and NS_MAIN.
Referenced by FewestrevisionsPage\formatResult(), MostcategoriesPage\formatResult(), MostinterwikisPage\formatResult(), MostlinkedPage\formatResult(), MostlinkedCategoriesPage\formatResult(), MostlinkedTemplatesPage\formatResult(), ShortPagesPage\formatResult(), UnwatchedpagesPage\formatResult(), PageQueryPage\formatResult(), SpecialProtectedtitles\formatRow(), ProtectedPagesPager\formatValue(), DummyLinker\getInvalidTitleDescription(), and SpecialUndelete\showList().
Get a revision-deletion link, or disabled link, or nothing, depending on user permissions & the settings on the revision.
Will use forward-compatible revision ID in the Special:RevDelete link if possible, otherwise the timestamp-based ID which may break after undeletion.
Definition at line 2051 of file Linker.php.
References $query, $rev, Revision\DELETED_RESTRICTED, revDeleteLink(), and revDeleteLinkDisabled().
Referenced by SpecialUndelete\diffHeader(), DeletedContribsPager\formatRevisionRow(), ContribsPager\formatRow(), DummyLinker\getRevDeleteLink(), DifferenceEngine\revisionDeleteLink(), Article\setOldSubtitle(), and SpecialUndelete\showRevision().
|
static |
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).
These checks can only function as an additional check as this function only checks against the last $wgShowRollbackEditCount edits.
Returns null if $wgShowRollbackEditCount is disabled or false if $verify is set and the user is the only contributor of the page.
Revision | $rev | |
bool | $verify | Try to verify that this revision can really be rolled back |
Definition at line 1743 of file Linker.php.
References $dbr, $res, $rev, $revQuery, $wgShowRollbackEditCount, DB_REPLICA, Revision\DELETED_TEXT, Revision\DELETED_USER, Revision\getQueryInfo(), Revision\RAW, and wfGetDB().
Referenced by buildRollbackLink(), generateRollback(), and DummyLinker\getRollbackEditCount().
|
staticprotected |
Get the URL to upload a certain file.
Title | $destFile | Title object of the file to upload |
string | $query | Urlencoded query string to prepend |
Definition at line 723 of file Linker.php.
References $query, $wgUploadMissingFileUrl, $wgUploadNavigationUrl, and wfAppendQuery().
Referenced by makeBrokenImageLinkObj(), and makeMediaLinkFile().
|
static |
This function returns an HTML link to the given target.
It serves a few purposes: 1) If $target is a Title, the correct URL to link to will be figured out automatically. 2) It automatically adds the usual classes for various types of link targets: "new" for red links, "stub" for short articles, etc. 3) It escapes all attribute values safely so there's no risk of XSS. 4) It provides a default tooltip if the target is a Title (the page name of the target). link() replaces the old functions in the makeLink() family.
LinkTarget | $target | Can currently only be a LinkTarget, but this may change to support Images, literal URLs, etc. |
string | $html | The HTML contents of the element, i.e., the link text. This is raw HTML and will not be escaped. If null, defaults to the prefixed text of the Title; or if the Title is just a fragment, the contents of the fragment. |
array | $customAttribs | A key => value array of extra HTML attributes, such as title and class. (href is ignored.) Classes will be merged with the default classes, while other attributes will replace default attributes. All passed attribute values will be HTML-escaped. A false attribute value means to suppress that attribute. |
array | $query | The query string to append to the URL you're linking to, in key => value array form. Query keys and values will be URL-encoded. |
string | array | $options | String or array of strings: 'known': Page is known to exist, so don't check if it does. 'broken': Page is known not to exist, so don't check if it does. 'noclasses': Don't add any classes automatically (includes "new", "stub", "mw-redirect", "extiw"). Only use the class attribute provided, if any, so you get a simple blue link with no funny i- cons. 'forcearticlepath': Use the article path always, even with a querystring. Has compatibility issues on some setups, so avoid wherever possible. 'http': Force a full URL with http:// as the scheme. 'https': Force a full URL with https:// as the scheme. 'stubThreshold' => (int): Stub threshold to use when determining link classes. |
Definition at line 84 of file Linker.php.
References $customAttribs, $html, $linkRenderer, $options, $query, $services, array(), wfCgiToArray(), wfDeprecated(), and wfWarn().
Referenced by Skin\doEditSectionLink(), Skin\drawCategoryBrowser(), Skin\getCategoryLinks(), UserGroupMembership\getLink(), Article\getRedirectHeaderHtml(), DummyLinker\link(), ReplaceTextUtils\link(), LinkerTest\testLinkBeginHook(), LinkerTest\testLinkEndHook(), LogFormatterTest\testLogParamsTypeRaw(), LogFormatterTest\testLogParamsTypeTitleLink(), and LogFormatterTest\testNormalLogParams().
|
static |
Identical to link(), except $options defaults to 'known'.
Title | $target | |
string | $html | |
array | $customAttribs | |
array | $query | |
string | array | $options |
Definition at line 141 of file Linker.php.
References $customAttribs, $html, $options, $query, and link.
Referenced by Article\confirmDelete(), Article\delete(), Skin\footerLink(), TraditionalImageGallery\getCaptionHtml(), Skin\getCopyright(), Skin\getNewtalks(), DifferenceEngine\getRevisionHeader(), Skin\getUndeleteLink(), ImagePage\imageDupes(), ImageHistoryList\imageHistoryLine(), ImagePage\imageLinks(), DummyLinker\linkKnown(), Skin\mainPageLink(), IndexPager\makeLink(), DifferenceEngine\markPatrolledLink(), ImagePage\openShowImage(), Article\setOldSubtitle(), DifferenceEngine\showDiffPage(), Article\showPatrolFooter(), Article\showRedirectedFromHeader(), specialLink(), Skin\subPageSubtitle(), and TraditionalImageGallery\toHTML().
|
static |
Make a "broken" link to an image.
Title | $title | |
string | $label | Link label (plain text) |
string | $query | Query string |
string | $unused1 | Unused parameter kept for b/c |
string | $unused2 | Unused parameter kept for b/c |
bool | $time | A file of a certain timestamp was requested |
Definition at line 673 of file Linker.php.
References $query, $time, $wgEnableUploads, $wgUploadMissingFileUrl, $wgUploadNavigationUrl, false, getUploadUrl(), link, RepoGroup\singleton(), wfCgiToArray(), wfFindFile(), and wfWarn().
Referenced by DummyLinker\makeBrokenImageLinkObj(), makeImageLink(), and makeThumbLink2().
|
static |
Generates a link to the given Title.
LinkTarget | $linkTarget | |
string | $text | |
string | null | $wikiId | Id of the wiki to link to (if not the local wiki), as used by WikiMap. |
string | string[] | $options | See the $options parameter in Linker::link. |
Definition at line 1326 of file Linker.php.
References $link, $options, MediaWiki\Linker\LinkTarget\getDBkey(), WikiMap\getForeignURL(), MediaWiki\Linker\LinkTarget\getFragment(), MediaWiki\Linker\LinkTarget\getNamespace(), MediaWiki\Linker\LinkTarget\isExternal(), link, and makeExternalLink().
Referenced by formatAutocomments(), formatLinksInComment(), and DummyLinker\makeCommentLink().
|
static |
Return the code for images which were added via external links, via Parser::maybeMakeExternalImage().
string | $url | |
string | $alt |
Definition at line 248 of file Linker.php.
References $success, fnamePart(), and wfDebug().
Referenced by DummyLinker\makeExternalImage(), and Parser\maybeMakeExternalImage().
|
static |
Make an external link.
string | $url | URL to link to |
string | $text | Text of link |
bool | $escape | Do we escape the link text? |
string | $linktype | Type of external link. Gets added to the classes |
array | $attribs | Array of extra attributes to |
Title | null | $title | Title object used for title specific link attributes |
Definition at line 826 of file Linker.php.
References $attribs, $link, $success, $wgTitle, and wfDebug().
Referenced by LinkSearchPage\formatResult(), AllMessagesTablePager\formatValue(), Skin\getCopyright(), SpecialVersion\getCreditsForExtension(), SpecialVersion\getExternalLibraries(), SpecialVersion\getParserFunctionHooks(), SpecialVersion\getParserTags(), ImagePage\imageDupes(), Parser\magicLinkCallback(), makeCommentLink(), DummyLinker\makeExternalLink(), WikiMap\makeForeignLink(), Parser\makeFreeExternalLink(), Parser\replaceExternalLinks(), Article\showRedirectedFromHeader(), and ImagePage\uploadLinksBox().
|
static |
Create a headline for content.
int | $level | The level of the headline (1-6) |
string | $attribs | Any attributes for the headline, starting with a space and ending with '>' This must be at least '>' for no attribs |
string | $anchor | The anchor to give the headline (the bit after the #) |
string | $html | HTML for the text of the header |
string | $link | HTML to add for the section edit link |
string | bool | $fallbackAnchor | A second, optional anchor to give for backward compatibility (false to omit) |
Definition at line 1641 of file Linker.php.
References $fallback, $link, and $ret.
Referenced by Parser\formatHeadings(), DummyLinker\makeHeadline(), and ApiMain\modifyHelp().
|
static |
Given parameters derived from [[Image:Foo|options...]], generate the HTML that that syntax inserts in the page.
Parser | $parser | |
Title | $title | Title object of the file (not the currently viewed page) |
File | $file | File object, or false if it doesn't exist |
array | $frameParams | Associative array of parameters external to the media handler. Boolean parameters are indicated by presence or absence, the value is arbitrary and will often be false. thumbnail If present, downscale and frame manualthumb Image name to use as a thumbnail, instead of automatic scaling framed Shows image in original size in a frame frameless Downscale but don't frame upright If present, tweak default sizes for portrait orientation upright_factor Fudge factor for "upright" tweak (default 0.75) border If present, show a border around the image align Horizontal alignment (left, right, center, none) valign Vertical alignment (baseline, sub, super, top, text-top, middle, bottom, text-bottom) alt Alternate text for image (i.e. alt attribute). Plain text. class HTML for image classes. Plain text. caption HTML for image caption. link-url URL to link to link-title Title object to link to link-target Value for the target attribute, only with link-url no-link Boolean, suppress description link |
array | $handlerParams | Associative array of media handler parameters, to be passed to transform(). Typical keys are "width" and "page". |
string | bool | $time | Timestamp of the file, set as false for current |
string | $query | Query params for desc url |
int | null | $widthOption | Used by the parser to remember the user preference thumbnailsize |
Definition at line 301 of file Linker.php.
References $handlerParams, $params, $parser, $query, $res, $s, $time, $wgSVGMaxSize, $wgThumbLimits, $wgThumbUpright, User\getDefaultOption(), getImageLinkMTOParams(), link, makeBrokenImageLinkObj(), makeThumbLink2(), processResponsiveImages(), and wfDebug().
Referenced by Parser\makeImage(), and DummyLinker\makeImageLink().
|
static |
Create a direct link to a given uploaded file.
This will make a broken link if $file is false.
Definition at line 766 of file Linker.php.
References $attribs, $html, $ret, getUploadUrl(), and wfDebug().
Referenced by DummyLinker\makeMediaLinkFile(), and makeMediaLinkObj().
|
static |
Create a direct link to a given uploaded file.
Title | $title | |
string | $html | Pre-sanitized HTML |
string | $time | MW timestamp of file creation time |
Definition at line 749 of file Linker.php.
References $html, $time, makeMediaLinkFile(), and wfFindFile().
Referenced by formatLinksInComment(), MIMEsearchPage\formatResult(), and DummyLinker\makeMediaLinkObj().
|
static |
Make appropriate markup for a link to the current article.
This is since MediaWiki 1.29.0 rendered as an tag without an href and with a class showing the link text. The calling sequence is the same as for the other make*LinkObj static functions, but $query is not used.
Title | $nt | |
string | $html | [optional] |
string | $query | [optional] |
string | $trail | [optional] |
string | $prefix | [optional] |
Definition at line 163 of file Linker.php.
References $html, $ret, list, and splitTrail().
Referenced by DummyLinker\makeSelfLinkObj(), and LinkHolderArray\replaceInternal().
|
static |
Definition at line 516 of file Linker.php.
References $handlerParams, $params, $query, $s, $time, getImageLinkMTOParams(), makeBrokenImageLinkObj(), NS_FILE, processResponsiveImages(), text, wfAppendQuery(), wfFindFile(), and wfMessage().
Referenced by makeImageLink(), DummyLinker\makeThumbLink2(), and makeThumbLinkObj().
|
static |
Make HTML for a thumbnail including image, border and caption.
Title | $title | |
File | bool | $file | File object or false if it doesn't exist |
string | $label | |
string | $alt | |
string | $align | |
array | $params | |
bool | $framed | |
string | $manualthumb |
Definition at line 490 of file Linker.php.
References $params, and makeThumbLink2().
Referenced by DummyLinker\makeThumbLinkObj(), ImagePage\openShowImage(), and CreatePdfThumbnailsJob\run().
|
static |
LinkTarget | $target |
Definition at line 206 of file Linker.php.
References $ret, MediaWiki\Linker\LinkTarget\getDBkey(), MediaWiki\Linker\LinkTarget\getFragment(), MediaWiki\Linker\LinkTarget\getNamespace(), MediaWiki\Linker\LinkTarget\isExternal(), list, and NS_SPECIAL.
Referenced by DummyLinker\normaliseSpecialPage(), and MediaWiki\Linker\LinkRenderer\normalizeTarget().
|
static |
Title | $contextTitle | |
string | $target | |
string | &$text |
Definition at line 1355 of file Linker.php.
References $ret.
Referenced by formatLinksInComment(), Parser\maybeDoSubpageLink(), and DummyLinker\normalizeSubpageLink().
|
static |
Process responsive images: add 1.5x and 2x subimages to the thumbnail, where applicable.
File | $file | |
MediaTransformOutput | $thumb | |
array | $hp | Image parameters |
Definition at line 638 of file Linker.php.
References $wgResponsiveImages.
Referenced by makeImageLink(), makeThumbLink2(), ImagePage\openShowImage(), DummyLinker\processResponsiveImages(), and TraditionalImageGallery\toHTML().
|
static |
Wrap and format the given revision's comment block, if the current user is allowed to view it.
Revision | $rev | |
bool | $local | Whether section links should refer to local page |
bool | $isPublic | Show only if all users can see it |
Definition at line 1466 of file Linker.php.
References $rev, commentBlock(), Revision\DELETED_COMMENT, Revision\FOR_THIS_USER, Revision\RAW, and wfMessage().
Referenced by SpecialUndelete\diffHeader(), DeletedContribsPager\formatRevisionRow(), SpecialMergeHistory\formatRevisionRow(), SpecialUndelete\formatRevisionRow(), SpecialNewpages\formatRow(), ContribsPager\formatRow(), ChangeTagsRevisionItem\getHTML(), RevDelRevisionItem\getHTML(), RevisionItem\getHTML(), HistoryPager\historyLine(), DummyLinker\revComment(), Article\setOldSubtitle(), and DifferenceEngine\showDiffPage().
|
static |
Creates a (show/hide) link for deleting revisions/log entries.
array | $query | Query parameters to be passed to link() |
bool | $restricted | Set to true to use a "<strong>" instead of a "<span>" |
bool | $delete | Set to true to use (show/hide) rather than (show) |
Definition at line 2092 of file Linker.php.
References $html, $link, $query, link, and wfMessage().
Referenced by SpecialUndelete\formatFileRow(), getRevDeleteLink(), LogEventsList\getShowHideLinks(), HistoryPager\historyLine(), ImageHistoryList\imageHistoryLine(), and DummyLinker\revDeleteLink().
|
static |
Creates a dead (show/hide) link for deleting revisions/log entries.
bool | $delete | Set to true to use (show/hide) rather than (show) |
Definition at line 2114 of file Linker.php.
References $html, and wfMessage().
Referenced by SpecialUndelete\formatFileRow(), getRevDeleteLink(), LogEventsList\getShowHideLinks(), HistoryPager\historyLine(), ImageHistoryList\imageHistoryLine(), and DummyLinker\revDeleteLinkDisabled().
|
static |
Generate a user link if the current user is allowed to view it.
Revision | $rev | |
bool | $isPublic | Show only if all users can see it |
Definition at line 1031 of file Linker.php.
References $link, $rev, Revision\DELETED_USER, Revision\FOR_THIS_USER, userLink(), and wfMessage().
Referenced by ChangeTagsRevisionItem\getHTML(), RevDelRevisionItem\getHTML(), RevisionItem\getHTML(), and DummyLinker\revUserLink().
|
static |
Generate a user tool link cluster if the current user is allowed to view it.
Revision | $rev | |
bool | $isPublic | Show only if all users can see it |
Definition at line 1053 of file Linker.php.
References $link, $rev, Revision\DELETED_USER, Revision\FOR_THIS_USER, userLink(), userToolLinks(), and wfMessage().
Referenced by SpecialUndelete\diffHeader(), SpecialMergeHistory\formatRevisionRow(), SpecialUndelete\formatRevisionRow(), SpecialNewpages\formatRow(), HistoryPager\historyLine(), RollbackAction\onView(), InfoAction\pageInfo(), DummyLinker\revUserTools(), Article\setOldSubtitle(), DifferenceEngine\showDiffPage(), and SpecialUndelete\showRevision().
|
static |
Make a link to a special page given its name and, optionally, a message key from the link text.
Usage example: Linker::specialLink( 'Recentchanges' )
string | $name | |
string | $key |
Definition at line 807 of file Linker.php.
References linkKnown(), and wfMessage().
Referenced by DummyLinker\specialLink().
|
static |
Split a link trail, return the "inside" portion and the remainder of the trail as a two-element array.
string | $trail |
Definition at line 1664 of file Linker.php.
Referenced by formatLinksInComment(), LinkHolderArray\makeHolder(), Parser\makeKnownLinkHolder(), makeSelfLinkObj(), Parser\replaceExternalLinks(), and DummyLinker\splitTrail().
|
static |
Given the id of an interface element, constructs the appropriate title attribute from the system messages.
(Note, this is usually the id but isn't always, because sometimes the accesskey needs to go on a different element than the id, for reverse-compatibility, etc.)
string | $name | Id of the element, minus prefixes. |
string | array | null | $options | Null, string or array with some of the following options:
|
array | $msgParams | Parameters to pass to the message |
Definition at line 1967 of file Linker.php.
References $options, accesskey(), array(), text, and wfMessage().
Referenced by OOUIHTMLForm\getButtons(), EditPage\getCheckboxesWidget(), EditPage\getEditButtons(), TimelessTemplate\getPortlet(), MonoBookTemplate\getPortlet(), EditPage\getSummaryInputWidget(), HTMLFormField\getTooltipAndAccessKeyOOUI(), BaseTemplate\makeLink(), DifferenceEngine\showDiffPage(), EditPage\showEditForm(), DummyLinker\titleAttrib(), tooltip(), and tooltipAndAccesskeyAttribs().
|
static |
Add another level to the Table of Contents.
Definition at line 1505 of file Linker.php.
Referenced by Parser\formatHeadings(), generateTOC(), SpecialEditWatchlist\getNormalForm(), and DummyLinker\tocIndent().
|
static |
parameter level defines if we are on an indentation level
string | $anchor | |
string | $tocline | |
string | $tocnumber | |
string | $level | |
string | bool | $sectionIndex |
Definition at line 1531 of file Linker.php.
Referenced by Parser\formatHeadings(), generateTOC(), SpecialEditWatchlist\getNormalForm(), and DummyLinker\tocLine().
|
static |
End a Table Of Contents line.
tocUnindent() will be used instead if we're ending a line below the new level.
Definition at line 1555 of file Linker.php.
Referenced by Parser\formatHeadings(), generateTOC(), SpecialEditWatchlist\getNormalForm(), and DummyLinker\tocLineEnd().
|
static |
Wraps the TOC in a table and provides the hide/collapse javascript.
string | $toc | Html of the Table Of Contents |
string | Language | bool | $lang | Language for the toc title, defaults to user language |
Definition at line 1567 of file Linker.php.
References $lang, wfGetLangObj(), and wfMessage().
Referenced by Parser\formatHeadings(), generateTOC(), SpecialEditWatchlist\getNormalForm(), and DummyLinker\tocList().
|
static |
Finish one or more sublevels on the Table of Contents.
int | $level |
Definition at line 1516 of file Linker.php.
Referenced by Parser\formatHeadings(), generateTOC(), and DummyLinker\tocUnindent().
|
static |
Returns raw bits of HTML, use titleAttrib()
string | $name | |
array | null | $options |
Definition at line 2161 of file Linker.php.
References $options, and titleAttrib().
Referenced by VectorTemplate\renderPortal(), and DummyLinker\tooltip().
|
static |
Returns the attributes for the tooltip and access key.
string | $name | |
array | $msgParams | Params for constructing the message |
string | array | null | $options | Options to be passed to titleAttrib. |
Definition at line 2133 of file Linker.php.
References $attribs, $options, accesskey(), array(), and titleAttrib().
Referenced by McrUndoAction\alterForm(), MonoBookTemplate\execute(), VectorTemplate\execute(), HTMLForm\getButtons(), VFormHTMLForm\getButtons(), TimelessTemplate\getLogo(), HistoryPager\getStartBody(), HTMLFormField\getTooltipAndAccessKey(), BaseTemplate\makeLink(), BaseTemplate\makeSearchButton(), BaseTemplate\makeSearchInput(), UserrightsPage\showEditUserGroupsForm(), SpecialImport\showForm(), and DummyLinker\tooltipAndAccesskeyAttribs().
|
static |
Make user link (or user contributions for unregistered users)
int | $userId | User id in database. |
string | $userName | User name in database. |
string | $altUserName | Text to display instead of the user name (optional) |
Definition at line 876 of file Linker.php.
References ExternalUserNames\getUserLinkTitle(), ExternalUserNames\isExternal(), and link.
Referenced by FileDuplicateSearchPage\formatResult(), ActiveUsersPager\formatRow(), ContribsPager\formatRow(), UsersPager\formatRow(), ProtectedPagesPager\formatValue(), BlockListPager\formatValue(), SpecialUndelete\getFileUser(), RCCacheEntryFactory\getUserLink(), RevDelFileItem\getUserTools(), ImageHistoryList\imageHistoryLine(), ChangesList\insertUserRelatedLinks(), LogFormatter\makeUserLink(), revUserLink(), revUserTools(), LogFormatterTest\testLogParamsTypeUserLink(), LogFormatterTest\testNormalLogParams(), LinkerTest\testUserLink(), and DummyLinker\userLink().
|
static |
Definition at line 986 of file Linker.php.
References link, NS_USER_TALK, and wfMessage().
Referenced by ContribsPager\formatRow(), DummyLinker\userTalkLink(), and userToolLinks().
|
static |
Generate standard user tool links (talk, contributions, block link, etc.)
int | $userId | User identifier |
string | $userText | User name or IP address |
bool | $redContribsWhenNoEdits | Should the contributions link be red if the user has no edits? |
int | $flags | Customisation flags (e.g. Linker::TOOL_LINKS_NOBLOCK and Linker::TOOL_LINKS_EMAIL). |
int | null | $edits | User edit count (optional, for performance) |
Definition at line 914 of file Linker.php.
References $attribs, $wgDisableAnonTalk, $wgLang, blockLink(), emailLink(), ExternalUserNames\isExternal(), link, User\newFromId(), TOOL_LINKS_NOBLOCK, userTalkLink(), and wfMessage().
Referenced by FileDuplicateSearchPage\formatResult(), ActiveUsersPager\formatRow(), ProtectedPagesPager\formatValue(), BlockListPager\formatValue(), SpecialUndelete\getFileUser(), RevDelFileItem\getUserTools(), ImageHistoryList\imageHistoryLine(), ChangesList\insertUserRelatedLinks(), LogFormatter\makeUserLink(), RCCacheEntryFactory\newFromRecentChange(), revUserTools(), UserrightsPage\showEditUserGroupsForm(), DummyLinker\userToolLinks(), and userToolLinksRedContribs().
|
static |
Alias for userToolLinks( $userId, $userText, true );.
int | $userId | User identifier |
string | $userText | User name or IP address |
int | null | $edits | User edit count (optional, for performance) |
Definition at line 976 of file Linker.php.
References userToolLinks().
Referenced by UsersPager\formatRow(), LogFormatterTest\testNormalLogParams(), and DummyLinker\userToolLinksRedContribs().
|
static |
Definition at line 2002 of file Linker.php.
const Linker::TOOL_LINKS_EMAIL = 2 |
Definition at line 39 of file Linker.php.
Referenced by UserrightsPage\showEditUserGroupsForm().
const Linker::TOOL_LINKS_NOBLOCK = 1 |
Flags for userToolLinks()
Definition at line 38 of file Linker.php.
Referenced by BlockListPager\formatValue(), BlockLogFormatter\getMessageParameters(), and userToolLinks().