MediaWiki REL1_30
|
This class should be covered by a general architecture document which does not exist as of January 2011. More...
Public Member Functions | |
__construct (IContextSource $context=null) | |
Constructor for OutputPage. | |
adaptCdnTTL ( $mtime, $minTTL=0, $maxTTL=0) | |
Get TTL in [$minTTL,$maxTTL] in pass it to lowerCdnMaxage() | |
addAcceptLanguage () | |
T23672: Add Accept-Language to Vary and Key headers if there's no 'variant' parameter existed in GET. | |
addBacklinkSubtitle (Title $title, $query=[]) | |
Add a subtitle containing a backlink to a page. | |
addBodyClasses ( $classes) | |
Add a class to the <body> element. | |
addCategoryLinks (array $categories) | |
Add an array of categories, with names in the keys. | |
addElement ( $element, array $attribs=[], $contents='') | |
Shortcut for adding an Html::element via addHTML. | |
addExtensionStyle ( $url) | |
Register and add a stylesheet from an extension directory. | |
addFeedLink ( $format, $href) | |
Add a feed link to the page header. | |
addHeadItem ( $name, $value) | |
Add or replace a head item to the output. | |
addHeadItems ( $values) | |
Add one or more head items to the output. | |
addHelpLink ( $to, $overrideBaseUrl=false) | |
Adds help link with an icon via page indicators. | |
addHTML ( $text) | |
Append $text to the body HTML. | |
addInlineScript ( $script) | |
Add a self-contained script tag with the given contents Internal use only. | |
addInlineStyle ( $style_css, $flip='noflip') | |
Adds inline CSS styles Internal use only. | |
addJsConfigVars ( $keys, $value=null) | |
Add one or more variables to be set in mw.config in JavaScript. | |
addLanguageLinks (array $newLinkArray) | |
Add new language links. | |
addLink (array $linkarr) | |
Add a new \<link\> tag to the page header. | |
addLinkHeader ( $header) | |
Add an HTTP Link: header. | |
addMeta ( $name, $val) | |
Add a new "<meta>" tag To add an http-equiv meta tag, precede the name with "http:". | |
addMetadataLink (array $linkarr) | |
Add a new \<link\> with "rel" attribute set to "meta". | |
addModules ( $modules) | |
Add one or more modules recognized by ResourceLoader. | |
addModuleScripts ( $modules) | |
Add only JS of one or more modules recognized by ResourceLoader. | |
addModuleStyles ( $modules) | |
Add only CSS of one or more modules recognized by ResourceLoader. | |
addParserOutput ( $parserOutput) | |
Add everything from a ParserOutput object. | |
addParserOutputContent ( $parserOutput) | |
Add the HTML and enhancements for it (like ResourceLoader modules) associated with a ParserOutput object, without any other metadata. | |
addParserOutputMetadata ( $parserOutput) | |
Add all metadata associated with a ParserOutput object, but without the actual HTML. | |
addParserOutputText ( $parserOutput) | |
Add the HTML associated with a ParserOutput object, without any metadata. | |
addReturnTo ( $title, array $query=[], $text=null, $options=[]) | |
Add a "return to" link pointing to a specified title. | |
addScript ( $script) | |
Add raw HTML to the list of scripts (including \<script\> tag, etc.) Internal use only. | |
addScriptFile ( $file, $version=null) | |
Add a JavaScript file out of skins/common, or a given relative path. | |
addStyle ( $style, $media='', $condition='', $dir='') | |
Add a local or specified stylesheet, with the given media options. | |
addSubtitle ( $str) | |
Add $str to the subtitle. | |
addTemplate (&$template) | |
Add the output of a QuickTemplate to the output buffer. | |
addVaryHeader ( $header, array $option=null) | |
Add an HTTP header that will influence on the cache. | |
addWikiMsg () | |
Add a wikitext-formatted message to the output. | |
addWikiMsgArray ( $name, $args) | |
Add a wikitext-formatted message to the output. | |
addWikiText ( $text, $linestart=true, $interface=true) | |
Convert wikitext to HTML and add it to the buffer Default assumes that the current page title will be used. | |
addWikiTextTidy ( $text, $linestart=true) | |
Add wikitext with tidy enabled. | |
addWikiTextTitle ( $text, Title $title, $linestart, $tidy=false, $interface=false) | |
Add wikitext with a custom Title object. | |
addWikiTextTitleTidy ( $text, &$title, $linestart=true) | |
Add wikitext with a custom Title object and tidy enabled. | |
addWikiTextWithTitle ( $text, &$title, $linestart=true) | |
Add wikitext with a custom Title object. | |
allowClickjacking () | |
Turn off frame-breaking. | |
buildCssLinksArray () | |
checkLastModified ( $timestamp) | |
checkLastModified tells the client to use the client-cached page if possible. | |
clearHTML () | |
Clear the body HTML. | |
clearSubtitle () | |
Clear the subtitles. | |
disable () | |
Disable output completely, i.e. | |
disallowUserJs () | |
Do not allow scripts which can be modified by wiki users to load on this page; only allow scripts bundled with, or generated by, the software. | |
enableClientCache ( $state) | |
Use enableClientCache(false) to force it to send nocache headers. | |
enableOOUI () | |
Add ResourceLoader module styles for OOUI and set up the PHP implementation of it for use with MediaWiki and this OutputPage instance. | |
enableSectionEditLinks ( $flag=true) | |
Enables/disables section edit links, doesn't override NOEDITSECTION | |
forceHideNewSectionLink () | |
Forcibly hide the new section link? | |
formatPermissionsErrorMessage (array $errors, $action=null) | |
Format a list of error messages. | |
getAllowedModules ( $type) | |
Show what level of JavaScript / CSS untrustworthiness is allowed on this page. | |
getArticleBodyOnly () | |
Return whether the output will contain only the body of the article. | |
getBottomScripts () | |
JS stuff to put at the bottom of the <body> . | |
getCacheVaryCookies () | |
Get the list of cookies that will influence on the cache. | |
getCanonicalUrl () | |
Returns the URL to be used for the <link rel=canonical>> if one is set. | |
getCategories ( $type='all') | |
Get the list of category names this page belongs to. | |
getCategoryLinks () | |
Get the list of category links, in a 2-D array with the following format: $arr[$type][] = $link, where $type is either "normal" or "hidden" (for hidden categories) and $link a HTML fragment with a link to the category page. | |
getExtStyle () | |
Get all styles added by extensions. | |
getFeedAppendQuery () | |
Will currently always return null. | |
getFileSearchOptions () | |
Get the files used on this page. | |
getFileVersion () | |
Get the displayed file version. | |
getFrameOptions () | |
Get the X-Frame-Options header value (without the name part), or false if there isn't one. | |
getHeadItemsArray () | |
Get an array of head items. | |
getHeadLinksArray () | |
getHTML () | |
Get the body HTML. | |
getHTMLTitle () | |
Return the "HTML title", i.e. | |
getIndicators () | |
Get the indicators associated with this page. | |
getJsConfigVars () | |
Get the javascript config vars to include on this page. | |
getJSVars () | |
Get an array containing the variables to be set in mw.config in JavaScript. | |
getKeyHeader () | |
Get a complete Key header. | |
getLanguageLinks () | |
Get the list of language links. | |
getLinkHeader () | |
Return a Link: header. | |
getLinkTags () | |
Returns the current <link> tags. | |
getMetadataAttribute () | |
Get the value of the "rel" attribute for metadata links. | |
getMetaTags () | |
Returns the current <meta> tags. | |
getModules ( $filter=false, $position=null, $param='mModules', $type=ResourceLoaderModule::TYPE_COMBINED) | |
Get the list of modules to include on this page. | |
getModuleScripts ( $filter=false, $position=null) | |
Get the list of module JS to include on this page. | |
getModuleStyles ( $filter=false, $position=null) | |
Get the list of module CSS to include on this page. | |
getPageTitle () | |
Return the "page title", i.e. | |
getPageTitleActionText () | |
Get the value of the "action text". | |
getPreventClickjacking () | |
Get the prevent-clickjacking flag. | |
getProperty ( $name) | |
Get an additional output property. | |
getRedirect () | |
Get the URL to redirect to, or an empty string if not redirect URL set. | |
getResourceLoader () | |
Get a ResourceLoader object associated with this OutputPage. | |
getRevisionId () | |
Get the displayed revision ID. | |
getRevisionTimestamp () | |
Get the timestamp of displayed revision. | |
getRlClient () | |
Call this to freeze the module queue and JS config and create a formatter. | |
getSubtitle () | |
Get the subtitle. | |
getSyndicationLinks () | |
Return URLs for each supported syndication format for this page. | |
getTarget () | |
getTemplateIds () | |
Get the templates used on this page. | |
getVaryHeader () | |
Return a Vary: header on which to vary caches. | |
hasHeadItem ( $name) | |
Check if the header item $name is already set. | |
haveCacheVaryCookies () | |
Check if the request has a cache-varying cookie header If it does, it's very important that we don't allow public caching. | |
headElement (Skin $sk, $includeStyle=true) | |
isArticle () | |
Return whether the content displayed page is related to the source of the corresponding article on the wiki. | |
isArticleRelated () | |
Return whether this page is related an article on the wiki. | |
isDisabled () | |
Return whether the output will be completely disabled. | |
isPrintable () | |
Return whether the page is "printable". | |
isSyndicated () | |
Should we output feed links for this page? | |
isTOCEnabled () | |
Whether the output has a table of contents. | |
lowerCdnMaxage ( $maxage) | |
Lower the value of the "s-maxage" part of the "Cache-control" HTTP header. | |
makeResourceLoaderLink ( $modules, $only, array $extraQuery=[]) | |
Explicily load or embed modules on a page. | |
output ( $return=false) | |
Finally, all the text has been munged and accumulated into the object, let's actually output it: | |
parse ( $text, $linestart=true, $interface=false, $language=null) | |
Parse wikitext and return the HTML. | |
parseInline ( $text, $linestart=true, $interface=false) | |
Parse wikitext, strip paragraphs, and return the HTML. | |
parserOptions ( $options=null) | |
Get/set the ParserOptions object to use for wikitext parsing. | |
prepareErrorPage ( $pageTitle, $htmlTitle=false) | |
Prepare this object to display an error page; disable caching and indexing, clear the current text and redirect, set the page's title and optionally an custom HTML title (content of the "<title>" tag). | |
prependHTML ( $text) | |
Prepend $text to the body HTML. | |
preventClickjacking ( $enable=true) | |
Set a flag which will cause an X-Frame-Options header appropriate for edit pages to be sent. | |
rateLimited () | |
Turn off regular page output and return an error response for when rate limiting has triggered. | |
readOnlyPage () | |
Display a page stating that the Wiki is in read-only mode. | |
redirect ( $url, $responsecode='302') | |
Redirect to $url rather than displaying the normal page. | |
reduceAllowedModules ( $type, $level) | |
Limit the highest level of CSS/JS untrustworthiness allowed. | |
returnToMain ( $unused=null, $returnto=null, $returntoquery=null) | |
Add a "return to" link pointing to a specified title, or the title indicated in the request, or else the main page. | |
sectionEditLinksEnabled () | |
sendCacheControl () | |
Send cache control HTTP headers. | |
setArticleBodyOnly ( $only) | |
Set whether the output should only contain the body of the article, without any skin, sidebar, etc. | |
setArticleFlag ( $v) | |
Set whether the displayed content is related to the source of the corresponding article on the wiki Setting true will cause the change "article related" toggle to true. | |
setArticleRelated ( $v) | |
Set whether this page is related an article on the wiki Setting false will cause the change of "article flag" toggle to false. | |
setCanonicalUrl ( $url) | |
Set the URL to be used for the <link rel=canonical>>. | |
setCategoryLinks (array $categories) | |
Reset the category links (but not the category list) and add $categories. | |
setCdnMaxage ( $maxage) | |
Set the value of the "s-maxage" part of the "Cache-control" HTTP header. | |
setCopyrightUrl ( $url) | |
Set the copyright URL to send with the output. | |
setETag ( $tag) | |
setFeedAppendQuery ( $val) | |
Add default feeds to the page header This is mainly kept for backward compatibility, see OutputPage::addFeedLink() for the new version. | |
setFileVersion ( $file) | |
Set the displayed file version. | |
setFollowPolicy ( $policy) | |
Set the follow policy for the page, but leave the index policy un- touched. | |
setHTMLTitle ( $name) | |
"HTML title" means the contents of "<title>". | |
setIndexPolicy ( $policy) | |
Set the index policy for the page, but leave the follow policy un- touched. | |
setIndicators (array $indicators) | |
Add an array of indicators, with their identifiers as array keys and HTML contents as values. | |
setLanguageLinks (array $newLinkArray) | |
Reset the language links and add new language links. | |
setLastModified ( $timestamp) | |
Override the last modified timestamp. | |
setPageTitle ( $name) | |
"Page title" means the contents of \<h1\>. | |
setPageTitleActionText ( $text) | |
Set the new value of the "action text", this will be added to the "HTML title", separated from it with " - ". | |
setPrintable () | |
Set the page as printable, i.e. | |
setProperty ( $name, $value) | |
Set an additional output property. | |
setRedirectedFrom ( $t) | |
Set $mRedirectedFrom, the Title of the page which redirected us to the current page. | |
setRevisionId ( $revid) | |
Set the revision ID which will be seen by the wiki text parser for things such as embedded {{REVISIONID}} variable use. | |
setRevisionTimestamp ( $timestamp) | |
Set the timestamp of the revision which will be displayed. | |
setRobotPolicy ( $policy) | |
Set the robot policy for the page: http://www.robotstxt.org/meta.html | |
setSquidMaxage ( $maxage) | |
setStatusCode ( $statusCode) | |
Set the HTTP status code to send with the output. | |
setSubtitle ( $str) | |
Replace the subtitle with $str. | |
setSyndicated ( $show=true) | |
Add or remove feed links in the page header This is mainly kept for backward compatibility, see OutputPage::addFeedLink() for the new version. | |
setTarget ( $target) | |
Sets ResourceLoader target for load.php links. | |
setTitle (Title $t) | |
Set the Title object to use. | |
showErrorPage ( $title, $msg, $params=[]) | |
Output a standard error page. | |
showFatalError ( $message) | |
showFileCopyError ( $old, $new) | |
showFileDeleteError ( $name) | |
showFileNotFoundError ( $name) | |
showFileRenameError ( $old, $new) | |
showLagWarning ( $lag) | |
Show a warning about replica DB lag. | |
showNewSectionLink () | |
Show an "add new section" link? | |
showPermissionsErrorPage (array $errors, $action=null) | |
Output a standard permission error page. | |
showUnexpectedValueError ( $name, $val) | |
userCanPreview () | |
To make it harder for someone to slip a user a fake user-JavaScript or user-CSS preview, a random token is associated with the login session. | |
versionRequired ( $version) | |
Display an error page indicating that a given version of MediaWiki is required to use it. | |
wrapWikiMsg ( $wrap) | |
This function takes a number of message/argument specifications, wraps them in some overall structure, and then parses the result and adds it to the output. | |
Public Member Functions inherited from ContextSource | |
canUseWikiPage () | |
Check whether a WikiPage object can be get with getWikiPage(). | |
exportSession () | |
Export the resolved user IP, HTTP headers, user ID, and session ID. | |
getConfig () | |
Get the Config object. | |
getContext () | |
Get the base IContextSource object. | |
getLanguage () | |
Get the Language object. | |
getOutput () | |
Get the OutputPage object. | |
getRequest () | |
Get the WebRequest object. | |
getSkin () | |
Get the Skin object. | |
getStats () | |
Get the Stats object. | |
getTiming () | |
Get the Timing object. | |
getTitle () | |
Get the Title object. | |
getUser () | |
Get the User object. | |
getWikiPage () | |
Get the WikiPage object. | |
msg ( $key) | |
Get a Message object with context set Parameters are the same as wfMessage() | |
setContext (IContextSource $context) | |
Set the IContextSource object. | |
Static Public Member Functions | |
static | buildBacklinkSubtitle (Title $title, $query=[]) |
Build message object for a subtitle containing a backlink to a page. | |
static | setupOOUI ( $skinName='default', $dir='ltr') |
Helper function to setup the PHP implementation of OOUI to use in this request. | |
static | transformCssMedia ( $media) |
Transform "media" attribute based on request parameters. | |
static | transformFilePath ( $remotePathPrefix, $localPath, $file) |
Utility method for transformResourceFilePath(). | |
static | transformResourcePath (Config $config, $path) |
Transform path to web-accessible static resource. | |
Public Attributes | |
string | $mBodytext = '' |
Contains all of the "<body>" content. | |
bool | $mNoGallery = false |
Comes from the parser. | |
string | $mPageLinkTitle = '' |
Used by skin template. | |
string | $mPagetitle = '' |
Should be private - has getter and setter. | |
string | $mRedirect = '' |
string | $mRedirectCode = '' |
Protected Member Functions | |
addCategoryLinksToLBAndGetResult (array $categories) | |
addLogoPreloadLinkHeaders () | |
Add Link headers for preloading the wiki's logo. | |
buildExemptModules () | |
Build exempt modules and legacy non-ResourceLoader styles. | |
filterModules (array $modules, $position=null, $type=ResourceLoaderModule::TYPE_COMBINED) | |
Filter an array of modules to remove insufficiently trustworthy members, and modules which are no longer registered (eg a page is cached before an extension is disabled) | |
isUserCssPreview () | |
styleLink ( $style, array $options) | |
Generate \<link\> tags for stylesheets. | |
Static Protected Member Functions | |
static | combineWrappedStrings (array $chunks) |
Combine WrappedString chunks and filter out empty ones. | |
Protected Attributes | |
array | $mAdditionalBodyClasses = [] |
Additional <body> classes; there are also <body> classes from other sources. | |
array | $mAllowedModules |
What level of 'untrustworthiness' is allowed in CSS/JS modules loaded on this page? | |
bool | $mCanonicalUrl = false |
array | $mCategories |
array | $mCategoryLinks = [] |
int | $mCdnMaxage = 0 |
Cache stuff. | |
int | $mCdnMaxageLimit = INF |
Upper limit on mCdnMaxage. | |
int | $mContainsNewMagic = 0 |
bool | $mDoNothing = false |
Whether output is disabled. | |
$mEnableClientCache = true | |
array | $mExtStyles = [] |
Additional stylesheets. | |
$mFeedLinksAppendQuery = null | |
array | $mFileVersion = null |
array | $mHeadItems = [] |
Array of elements in "<head>". | |
bool | $mHideNewSectionLink = false |
array | $mImageTimeKeys = [] |
array | $mIndicators = [] |
string | $mInlineStyles = '' |
Inline CSS styles. | |
array | $mJsConfigVars = [] |
string | $mLastModified = '' |
Used for sending cache control. | |
array | $mLinktags = [] |
array | $mMetatags = [] |
Should be private. | |
array | $mModules = [] |
array | $mModuleScripts = [] |
array | $mModuleStyles = [] |
bool | $mNewSectionLink = false |
ParserOptions | $mParserOptions = null |
lazy initialised, use parserOptions() | |
bool | $mPreventClickjacking = true |
Controls if anti-clickjacking / frame-breaking headers will be sent. | |
ResourceLoader | $mResourceLoader |
int | $mStatusCode |
array | $mTemplateIds = [] |
array | $styles = [] |
An array of stylesheet filenames (relative from skins path), with options for CSS media, IE conditions, and RTL/LTR direction. | |
Private Member Functions | |
feedLink ( $type, $url, $text) | |
Generate a "<link rel/>" for a feed. | |
getRlClientContext () | |
isUserJsPreview () | |
warnModuleTargetFilter ( $moduleName) | |
Private Attributes | |
string null | $copyrightUrl |
The URL to send in a <link> element with rel=license. | |
array | $limitReportJSData = [] |
Profiling data. | |
bool | $mArticleBodyOnly = false |
Flag if output should only contain the body of the article. | |
bool | $mEnableSectionEditLinks = true |
Whether parser output should contain section edit links. | |
bool | $mEnableTOC = false |
Whether parser output contains a table of contents. | |
$mFeedLinks = [] | |
Handles the Atom / RSS links. | |
$mFollowPolicy = 'follow' | |
string | $mHTMLtitle = '' |
Stores contents of "<title>" tag. | |
$mIndexPolicy = 'index' | |
bool | $mIsarticle = false |
Is the displayed content related to the source of the corresponding wiki article. | |
bool | $mIsArticleRelated = true |
Stores "article flag" toggle. | |
array | $mLanguageLinks = [] |
Array of Interwiki Prefixed (non DB key) Titles (e.g. | |
$mLinkHeader = [] | |
Link: header contents. | |
string | $mPageTitleActionText = '' |
bool | $mPrintable = false |
We have to set isPrintable(). | |
$mProperties = [] | |
Additional key => value data. | |
Title | $mRedirectedFrom = null |
If the current page was reached through a redirect, $mRedirectedFrom contains the Title of the redirect. | |
int | $mRevisionId = null |
To include the variable {{REVISIONID}}. | |
string | $mRevisionTimestamp = null |
$mScripts = '' | |
Used for JavaScript (predates ResourceLoader) | |
array | $mSubtitle = [] |
Contains the page subtitle. | |
string null | $mTarget = null |
ResourceLoader target for load.php links. | |
$mVaryHeader | |
ResourceLoaderClientHtml | $rlClient |
ResourceLoaderContext | $rlClientContext |
array | $rlExemptStyleModules |
string | $rlUserModuleState |
This class should be covered by a general architecture document which does not exist as of January 2011.
This is one of the Core classes and should be read at least once by any new developers.
This class is used to prepare the final rendering. A skin is then applied to the output parameters (links, javascript, html, categories ...).
Some comments comes from a pairing session between Zak Greant and Antoine Musso in November 2010.
Definition at line 44 of file OutputPage.php.
OutputPage::__construct | ( | IContextSource | $context = null | ) |
Constructor for OutputPage.
This should not be called directly. Instead a new RequestContext should be created and it will implicitly create a OutputPage tied to that context.
IContextSource | null | $context |
Definition at line 319 of file OutputPage.php.
References ContextSource\$context, ContextSource\setContext(), and wfDeprecated().
OutputPage::adaptCdnTTL | ( | $mtime, | |
$minTTL = 0, | |||
$maxTTL = 0 ) |
Get TTL in [$minTTL,$maxTTL] in pass it to lowerCdnMaxage()
This sets and returns $minTTL if $mtime is false or null. Otherwise, the TTL is higher the older the $mtime timestamp is. Essentially, the TTL is 90% of the age of the object, subject to the min and max.
string | int | float | bool | null | $mtime | Last-Modified timestamp |
int | $minTTL | Mimimum TTL in seconds [default: 1 minute] |
int | $maxTTL | Maximum TTL in seconds [default: $wgSquidMaxage] |
Definition at line 2020 of file OutputPage.php.
References ContextSource\getConfig(), lowerCdnMaxage(), IExpiringStore\TTL_MINUTE, and wfTimestamp().
OutputPage::addAcceptLanguage | ( | ) |
T23672: Add Accept-Language to Vary and Key headers if there's no 'variant' parameter existed in GET.
For example: /w/index.php?title=Main_page should always be served; but /w/index.php?title=Main_page&variant=zh-cn should never be served.
Definition at line 2184 of file OutputPage.php.
References $lang, addVaryHeader(), ContextSource\getRequest(), ContextSource\getTitle(), and wfBCP47().
Referenced by sendCacheControl().
OutputPage::addBacklinkSubtitle | ( | Title | $title, |
$query = [] ) |
Add a subtitle containing a backlink to a page.
Title | $title | Title to link to |
array | $query | Array of additional parameters to include in the link |
Definition at line 1065 of file OutputPage.php.
References $query, and addSubtitle().
OutputPage::addBodyClasses | ( | $classes | ) |
Add a class to the <body> element.
string | string[] | $classes | One or more classes to add |
Definition at line 717 of file OutputPage.php.
OutputPage::addCategoryLinks | ( | array | $categories | ) |
Add an array of categories, with names in the keys.
array | $categories | Mapping category name => sort key |
Definition at line 1290 of file OutputPage.php.
References $linkRenderer, $res, $type, $wgContLang, addCategoryLinksToLBAndGetResult(), NS_CATEGORY, and string.
Referenced by addParserOutputMetadata(), and setCategoryLinks().
|
protected |
array | $categories |
Definition at line 1340 of file OutputPage.php.
References $dbr, $res, DB_REPLICA, NS_CATEGORY, LinkBatch\setArray(), and wfGetDB().
Referenced by addCategoryLinks().
OutputPage::addElement | ( | $element, | |
array | $attribs = [], | ||
$contents = '' ) |
Shortcut for adding an Html::element via addHTML.
string | $element | |
array | $attribs | |
string | $contents |
Definition at line 1557 of file OutputPage.php.
OutputPage::addExtensionStyle | ( | $url | ) |
Register and add a stylesheet from an extension directory.
string | $url | Path to sheet. Provide either a full url (beginning with 'http', etc) or a relative path from the document root (beginning with '/'). Otherwise it behaves identically to addStyle() and draws from the /skins folder. |
Definition at line 480 of file OutputPage.php.
References wfDeprecated().
OutputPage::addFeedLink | ( | $format, | |
$href ) |
Add a feed link to the page header.
string | $format | Feed type, should be a key of $wgFeedClasses |
string | $href | URL |
Definition at line 1179 of file OutputPage.php.
References ContextSource\getConfig().
OutputPage::addHeadItem | ( | $name, | |
$value ) |
Add or replace a head item to the output.
Whenever possible, use more specific options like ResourceLoader modules, OutputPage::addLink(), OutputPage::addMetaLink() and OutputPage::addFeedLink() Fallback options for those are: OutputPage::addStyle, OutputPage::addScript(), OutputPage::addInlineScript() and OutputPage::addInlineStyle() This would be your very LAST fallback.
string | $name | Item name |
string | $value | Raw HTML |
Definition at line 687 of file OutputPage.php.
OutputPage::addHeadItems | ( | $values | ) |
Add one or more head items to the output.
string | string[] | $values | Raw HTML |
Definition at line 697 of file OutputPage.php.
OutputPage::addHelpLink | ( | $to, | |
$overrideBaseUrl = false ) |
Adds help link with an icon via page indicators.
Link target can be overridden by a local message containing a wikilink: the message key is: lowercase action or special page name + '-helppage'.
string | $to | Target MediaWiki.org page title or encoded URL. |
bool | $overrideBaseUrl | Whether $url is a full URL, to avoid MW.o. |
Definition at line 1450 of file OutputPage.php.
References $link, addModuleStyles(), ContextSource\msg(), setIndicators(), and wfUrlencode().
OutputPage::addHTML | ( | $text | ) |
Append $text to the body HTML.
string | $text | HTML |
Definition at line 1544 of file OutputPage.php.
Referenced by addElement(), addParserOutputText(), addReturnTo(), addTemplate(), addWikiMsgArray(), showErrorPage(), showFatalError(), and showPermissionsErrorPage().
OutputPage::addInlineScript | ( | $script | ) |
Add a self-contained script tag with the given contents Internal use only.
Use OutputPage::addModules() if possible.
string | $script | JavaScript text, no script tags |
Definition at line 523 of file OutputPage.php.
OutputPage::addInlineStyle | ( | $style_css, | |
$flip = 'noflip' ) |
Adds inline CSS styles Internal use only.
Use OutputPage::addModuleStyles() if possible.
mixed | $style_css | Inline CSS |
string | $flip | Set to 'flip' to flip the CSS if needed |
Definition at line 3620 of file OutputPage.php.
References ContextSource\getLanguage().
OutputPage::addJsConfigVars | ( | $keys, | |
$value = null ) |
Add one or more variables to be set in mw.config in JavaScript.
string | array | $keys | Key or array of key/value pairs |
mixed | $value | [optional] Value of the configuration variable |
Definition at line 3118 of file OutputPage.php.
Referenced by addParserOutputContent(), and addParserOutputMetadata().
OutputPage::addLanguageLinks | ( | array | $newLinkArray | ) |
Add new language links.
string[] | $newLinkArray | Array of interwiki-prefixed (non DB key) titles (e.g. 'fr:Test page') |
Definition at line 1262 of file OutputPage.php.
OutputPage::addLink | ( | array | $linkarr | ) |
Add a new \<link\> tag to the page header.
Note: use setCanonicalUrl() for rel=canonical.
array | $linkarr | Associative array of attributes. |
Definition at line 398 of file OutputPage.php.
Referenced by addMetadataLink().
OutputPage::addLinkHeader | ( | $header | ) |
Add an HTTP Link: header.
string | $header | Header value |
Definition at line 2128 of file OutputPage.php.
References $header.
Referenced by addLogoPreloadLinkHeaders().
|
protected |
Add Link headers for preloading the wiki's logo.
Definition at line 4017 of file OutputPage.php.
References addLinkHeader(), ContextSource\getConfig(), and ResourceLoaderSkinModule\getLogo().
Referenced by output().
OutputPage::addMeta | ( | $name, | |
$val ) |
Add a new "<meta>" tag To add an http-equiv meta tag, precede the name with "http:".
string | $name | Tag name |
string | $val | Tag value |
Definition at line 377 of file OutputPage.php.
OutputPage::addMetadataLink | ( | array | $linkarr | ) |
Add a new \<link\> with "rel" attribute set to "meta".
array | $linkarr | Associative array mapping attribute names to their values, both keys and values will be escaped, and the "rel" attribute will be automatically added |
Definition at line 419 of file OutputPage.php.
References addLink(), and getMetadataAttribute().
OutputPage::addModules | ( | $modules | ) |
Add one or more modules recognized by ResourceLoader.
Modules added through this function will be loaded by ResourceLoader when the page loads.
string | array | $modules | Module name (string) or array of module names |
Definition at line 596 of file OutputPage.php.
References $modules.
Referenced by ListToggle\__construct(), addParserOutputContent(), addParserOutputMetadata(), getRlClient(), and output().
OutputPage::addModuleScripts | ( | $modules | ) |
Add only JS of one or more modules recognized by ResourceLoader.
Module scripts added through this function will be loaded by ResourceLoader when the page loads.
string | array | $modules | Module name (string) or array of module names |
Definition at line 620 of file OutputPage.php.
References $modules.
Referenced by addParserOutputContent(), and addParserOutputMetadata().
OutputPage::addModuleStyles | ( | $modules | ) |
Add only CSS of one or more modules recognized by ResourceLoader.
Module styles added through this function will be added using standard link CSS tags, rather than as a combined Javascript and CSS package. Thus, they will load when JavaScript is disabled (unless CSS also happens to be disabled).
string | array | $modules | Module name (string) or array of module names |
Definition at line 646 of file OutputPage.php.
References $modules.
Referenced by ListToggle\__construct(), addHelpLink(), addParserOutputContent(), addParserOutputMetadata(), enableOOUI(), and getRlClient().
OutputPage::addParserOutput | ( | $parserOutput | ) |
Add everything from a ParserOutput object.
ParserOutput | $parserOutput |
Definition at line 1902 of file OutputPage.php.
References addParserOutputMetadata(), and addParserOutputText().
Referenced by addWikiTextTitle().
OutputPage::addParserOutputContent | ( | $parserOutput | ) |
Add the HTML and enhancements for it (like ResourceLoader modules) associated with a ParserOutput object, without any other metadata.
ParserOutput | $parserOutput |
Definition at line 1873 of file OutputPage.php.
References addJsConfigVars(), addModules(), addModuleScripts(), addModuleStyles(), and addParserOutputText().
OutputPage::addParserOutputMetadata | ( | $parserOutput | ) |
Add all metadata associated with a ParserOutput object, but without the actual HTML.
This includes categories, language links, ResourceLoader modules, effects of certain magic words, and so on.
ParserOutput | $parserOutput |
Definition at line 1798 of file OutputPage.php.
References addCategoryLinks(), addJsConfigVars(), addModules(), addModuleScripts(), addModuleStyles(), enableClientCache(), enableOOUI(), ContextSource\getConfig(), ContextSource\getTitle(), list, and setIndicators().
Referenced by addParserOutput().
OutputPage::addParserOutputText | ( | $parserOutput | ) |
Add the HTML associated with a ParserOutput object, without any metadata.
ParserOutput | $parserOutput |
Definition at line 1889 of file OutputPage.php.
References addHTML().
Referenced by addParserOutput(), and addParserOutputContent().
OutputPage::addReturnTo | ( | $title, | |
array | $query = [], | ||
$text = null, | |||
$options = [] ) |
Add a "return to" link pointing to a specified title.
Title | $title | Title to link |
array | $query | Query string parameters |
string | $text | Text of the link (input is not escaped) |
array | $options | Options array to pass to Linker |
Definition at line 2735 of file OutputPage.php.
References $link, $linkRenderer, $options, $query, addHTML(), and ContextSource\msg().
Referenced by returnToMain().
OutputPage::addScript | ( | $script | ) |
Add raw HTML to the list of scripts (including \<script\> tag, etc.) Internal use only.
Use OutputPage::addModules() or OutputPage::addJsConfigVars() if possible.
string | $script | Raw HTML |
Definition at line 467 of file OutputPage.php.
Referenced by addScriptFile().
OutputPage::addScriptFile | ( | $file, | |
$version = null ) |
Add a JavaScript file out of skins/common, or a given relative path.
Internal use only. Use OutputPage::addModules() if possible.
string | $file | Filename in skins/common or complete on-server path (/foo/bar.js) |
string | $version | Style version of the file. Defaults to $wgStyleVersion |
Definition at line 504 of file OutputPage.php.
References addScript(), ContextSource\getConfig(), and wfAppendQuery().
OutputPage::addStyle | ( | $style, | |
$media = '', | |||
$condition = '', | |||
$dir = '' ) |
Add a local or specified stylesheet, with the given media options.
Internal use only. Use OutputPage::addModuleStyles() if possible.
string | $style | URL to the file |
string | $media | To specify a media type, 'screen', 'printable', 'handheld' or any. |
string | $condition | For IE conditional comments, specifying an IE version |
string | $dir | Set to 'rtl' or 'ltr' for direction-specific sheets |
Definition at line 3599 of file OutputPage.php.
References $dir, and $options.
Referenced by buildCssLinksArray().
OutputPage::addSubtitle | ( | $str | ) |
Add $str to the subtitle.
string | Message | $str | String or Message to add to the subtitle. String should be safe HTML. |
Definition at line 1034 of file OutputPage.php.
References ContextSource\getContext().
Referenced by addBacklinkSubtitle(), and setSubtitle().
OutputPage::addTemplate | ( | & | $template | ) |
Add the output of a QuickTemplate to the output buffer.
QuickTemplate | &$template |
Definition at line 1918 of file OutputPage.php.
OutputPage::addVaryHeader | ( | $header, | |
array | $option = null ) |
Add an HTTP header that will influence on the cache.
string | $header | Header name |
string[] | null | $option | Options for the Key header. See https://datatracker.ietf.org/doc/draft-fielding-http-key/ for the list of valid options. |
Definition at line 2095 of file OutputPage.php.
References $header.
Referenced by addAcceptLanguage(), getKeyHeader(), getVaryHeader(), output(), and sendCacheControl().
OutputPage::addWikiMsg | ( | ) |
Add a wikitext-formatted message to the output.
This is equivalent to:
$wgOut->addWikiText( wfMessage( ... )->plain() )
Definition at line 3880 of file OutputPage.php.
References $args, and addWikiMsgArray().
Referenced by versionRequired().
OutputPage::addWikiMsgArray | ( | $name, | |
$args ) |
Add a wikitext-formatted message to the output.
Like addWikiMsg() except the parameters are taken as an array instead of a variable argument list.
string | $name | |
array | $args |
Definition at line 3894 of file OutputPage.php.
References $args, addHTML(), and ContextSource\msg().
Referenced by addWikiMsg(), and showErrorPage().
Convert wikitext to HTML and add it to the buffer Default assumes that the current page title will be used.
string | $text | |
bool | $linestart | Is this the start of a line? |
bool | $interface | Is this text in the user interface language? |
MWException |
Definition at line 1720 of file OutputPage.php.
References addWikiTextTitle(), and ContextSource\getTitle().
Referenced by showPermissionsErrorPage(), and wrapWikiMsg().
OutputPage::addWikiTextTidy | ( | $text, | |
$linestart = true ) |
Add wikitext with tidy enabled.
string | $text | Wikitext |
bool | $linestart | Is this the start of a line? |
Definition at line 1756 of file OutputPage.php.
References addWikiTextTitleTidy(), and ContextSource\getTitle().
OutputPage::addWikiTextTitle | ( | $text, | |
Title | $title, | ||
$linestart, | |||
$tidy = false, | |||
$interface = false ) |
Add wikitext with a custom Title object.
string | $text | Wikitext |
Title | $title | |
bool | $linestart | Is this the start of a line? |
bool | $tidy | Whether to use tidy |
bool | $interface | Whether it is an interface message (for example disables conversion) |
Definition at line 1771 of file OutputPage.php.
References $wgParser, addParserOutput(), and parserOptions().
Referenced by addWikiText(), addWikiTextTitleTidy(), and addWikiTextWithTitle().
OutputPage::addWikiTextTitleTidy | ( | $text, | |
& | $title, | ||
$linestart = true ) |
Add wikitext with a custom Title object and tidy enabled.
string | $text | Wikitext |
Title | &$title | |
bool | $linestart | Is this the start of a line? |
Definition at line 1746 of file OutputPage.php.
References addWikiTextTitle().
Referenced by addWikiTextTidy().
OutputPage::addWikiTextWithTitle | ( | $text, | |
& | $title, | ||
$linestart = true ) |
Add wikitext with a custom Title object.
string | $text | Wikitext |
Title | &$title | |
bool | $linestart | Is this the start of a line? |
Definition at line 1735 of file OutputPage.php.
References addWikiTextTitle().
OutputPage::allowClickjacking | ( | ) |
Turn off frame-breaking.
Alias for $this->preventClickjacking(false). This can be called from pages which do not contain any CSRF-protected HTML form.
Definition at line 2232 of file OutputPage.php.
|
static |
Build message object for a subtitle containing a backlink to a page.
Title | $title | Title to link to |
array | $query | Array of additional parameters to include in the link |
Definition at line 1050 of file OutputPage.php.
References $linkRenderer, $query, and wfMessage().
Referenced by RevertAction\getDescription().
OutputPage::buildCssLinksArray | ( | ) |
Definition at line 3696 of file OutputPage.php.
References $link, $options, addStyle(), and styleLink().
Referenced by buildExemptModules().
|
protected |
Build exempt modules and legacy non-ResourceLoader styles.
Definition at line 3633 of file OutputPage.php.
References $mInlineStyles, $wgContLang, buildCssLinksArray(), combineWrappedStrings(), ContextSource\getLanguage(), ContextSource\getRequest(), ContextSource\getTitle(), isUserCssPreview(), makeResourceLoaderLink(), and ResourceLoaderModule\TYPE_STYLES.
Referenced by headElement().
OutputPage::checkLastModified | ( | $timestamp | ) |
checkLastModified tells the client to use the client-cached page if possible.
If successful, the OutputPage is disabled so that any future call to OutputPage->output() have no effect.
Side effect: sets mLastModified for Last-Modified header
string | $timestamp |
Definition at line 785 of file OutputPage.php.
References $value, disable(), ContextSource\getConfig(), ContextSource\getRequest(), ContextSource\getUser(), sendCacheControl(), wfClearOutputBuffers(), wfDebug(), and wfTimestamp().
OutputPage::clearHTML | ( | ) |
Clear the body HTML.
Definition at line 1564 of file OutputPage.php.
Referenced by prepareErrorPage().
OutputPage::clearSubtitle | ( | ) |
Clear the subtitles.
Definition at line 1072 of file OutputPage.php.
Referenced by prepareErrorPage(), and setSubtitle().
|
staticprotected |
Combine WrappedString chunks and filter out empty ones.
array | $chunks |
Definition at line 3024 of file OutputPage.php.
Referenced by buildExemptModules(), getBottomScripts(), and headElement().
OutputPage::disable | ( | ) |
Disable output completely, i.e.
calling output() will have no effect
Definition at line 1105 of file OutputPage.php.
Referenced by checkLastModified().
OutputPage::disallowUserJs | ( | ) |
Do not allow scripts which can be modified by wiki users to load on this page; only allow scripts bundled with, or generated by, the software.
Site-wide styles are controlled by a config setting, since they can be used to create a custom skin/theme, but not user-specific ones.
Definition at line 1482 of file OutputPage.php.
References ContextSource\getConfig(), ResourceLoaderModule\ORIGIN_CORE_INDIVIDUAL, ResourceLoaderModule\ORIGIN_USER_SITEWIDE, reduceAllowedModules(), ResourceLoaderModule\TYPE_SCRIPTS, and ResourceLoaderModule\TYPE_STYLES.
Referenced by output().
OutputPage::enableClientCache | ( | $state | ) |
Use enableClientCache(false) to force it to send nocache headers.
bool | $state |
Definition at line 2044 of file OutputPage.php.
References wfSetVar().
Referenced by addParserOutputMetadata(), and prepareErrorPage().
OutputPage::enableOOUI | ( | ) |
Add ResourceLoader module styles for OOUI and set up the PHP implementation of it for use with MediaWiki and this OutputPage instance.
Definition at line 3996 of file OutputPage.php.
References addModuleStyles(), ContextSource\getLanguage(), ContextSource\getSkin(), and setupOOUI().
Referenced by addParserOutputMetadata().
OutputPage::enableSectionEditLinks | ( | $flag = true | ) |
Enables/disables section edit links, doesn't override NOEDITSECTION
bool | $flag |
Definition at line 3962 of file OutputPage.php.
|
private |
Generate a "<link rel/>" for a feed.
string | $type | Feed type |
string | $url | URL to the feed |
string | $text | Value of the "title" attribute |
Definition at line 3581 of file OutputPage.php.
Referenced by getHeadLinksArray().
|
protected |
Filter an array of modules to remove insufficiently trustworthy members, and modules which are no longer registered (eg a page is cached before an extension is disabled)
array | $modules | |
string | null | $position | If not null, only return modules with this position |
string | $type |
Definition at line 535 of file OutputPage.php.
References $modules, $resourceLoader, $type, ResourceLoaderModule\getOrigin(), getResourceLoader(), and warnModuleTargetFilter().
Referenced by getModules(), getRlClient(), and makeResourceLoaderLink().
OutputPage::forceHideNewSectionLink | ( | ) |
Forcibly hide the new section link?
Definition at line 1132 of file OutputPage.php.
References $mHideNewSectionLink.
OutputPage::formatPermissionsErrorMessage | ( | array | $errors, |
$action = null ) |
Format a list of error messages.
array | $errors | Array of arrays returned by Title::getUserPermissionsErrors |
string | $action | Action that was denied or null if unknown |
Definition at line 2620 of file OutputPage.php.
References ContextSource\msg().
Referenced by showPermissionsErrorPage().
OutputPage::getAllowedModules | ( | $type | ) |
Show what level of JavaScript / CSS untrustworthiness is allowed on this page.
string | $type | ResourceLoaderModule TYPE_ constant |
Definition at line 1507 of file OutputPage.php.
References $type, ResourceLoaderModule\ORIGIN_ALL, and ResourceLoaderModule\TYPE_COMBINED.
Referenced by reduceAllowedModules().
OutputPage::getArticleBodyOnly | ( | ) |
Return whether the output will contain only the body of the article.
Definition at line 744 of file OutputPage.php.
References $mArticleBodyOnly.
OutputPage::getBottomScripts | ( | ) |
JS stuff to put at the bottom of the <body>
.
These are modules with position 'bottom', legacy scripts ($this->mScripts), and user JS.
Definition at line 3050 of file OutputPage.php.
References $mScripts, combineWrappedStrings(), ContextSource\getRequest(), getRlClient(), ContextSource\getTitle(), isUserJsPreview(), ResourceLoader\makeConfigSetScript(), ResourceLoader\makeInlineScript(), makeResourceLoaderLink(), and ResourceLoaderModule\TYPE_COMBINED.
OutputPage::getCacheVaryCookies | ( | ) |
Get the list of cookies that will influence on the cache.
Definition at line 2053 of file OutputPage.php.
References ContextSource\getConfig().
Referenced by getKeyHeader(), getVaryHeader(), and haveCacheVaryCookies().
OutputPage::getCanonicalUrl | ( | ) |
Returns the URL to be used for the <link rel=canonical>> if one is set.
Definition at line 440 of file OutputPage.php.
References $mCanonicalUrl.
OutputPage::getCategories | ( | $type = 'all' | ) |
Get the list of category names this page belongs to.
string | $type | The type of categories which should be returned. Possible values:
|
Definition at line 1401 of file OutputPage.php.
References $type.
Referenced by getJSVars().
OutputPage::getCategoryLinks | ( | ) |
Get the list of category links, in a 2-D array with the following format: $arr[$type][] = $link, where $type is either "normal" or "hidden" (for hidden categories) and $link a HTML fragment with a link to the category page.
Definition at line 1388 of file OutputPage.php.
References $mCategoryLinks.
OutputPage::getExtStyle | ( | ) |
Get all styles added by extensions.
Definition at line 491 of file OutputPage.php.
References $mExtStyles, and wfDeprecated().
OutputPage::getFeedAppendQuery | ( | ) |
Will currently always return null.
Definition at line 1206 of file OutputPage.php.
References $mFeedLinksAppendQuery.
OutputPage::getFileSearchOptions | ( | ) |
Get the files used on this page.
Definition at line 1707 of file OutputPage.php.
References $mImageTimeKeys.
OutputPage::getFileVersion | ( | ) |
Get the displayed file version.
Definition at line 1687 of file OutputPage.php.
References $mFileVersion.
OutputPage::getFrameOptions | ( | ) |
Get the X-Frame-Options header value (without the name part), or false if there isn't one.
This is used by Skin to determine whether to enable JavaScript frame-breaking, for clients that don't support X-Frame-Options.
Definition at line 2253 of file OutputPage.php.
References ContextSource\getConfig().
Referenced by getJSVars(), and output().
OutputPage::getHeadItemsArray | ( | ) |
Get an array of head items.
Definition at line 671 of file OutputPage.php.
References $mHeadItems.
OutputPage::getHeadLinksArray | ( | ) |
Definition at line 3309 of file OutputPage.php.
References $copyrightUrl, $lang, $link, $mCanonicalUrl, $query, $type, $wgVersion, feedLink(), Action\getActionName(), ContextSource\getConfig(), ContextSource\getContext(), ContextSource\getRequest(), getSyndicationLinks(), ContextSource\getTitle(), SpecialPage\getTitleFor(), ContextSource\getUser(), isArticleRelated(), ContextSource\msg(), PROTO_CANONICAL, PROTO_RELATIVE, text, wfAppendQuery(), wfBCP47(), wfExpandUrl(), and wfScript().
Referenced by headElement().
OutputPage::getHTML | ( | ) |
Get the body HTML.
Definition at line 1573 of file OutputPage.php.
References $mBodytext.
OutputPage::getHTMLTitle | ( | ) |
Return the "HTML title", i.e.
the content of the "<title>" tag.
Definition at line 961 of file OutputPage.php.
References $mHTMLtitle.
Referenced by headElement().
OutputPage::getIndicators | ( | ) |
Get the indicators associated with this page.
The array will be internally ordered by item keys.
Definition at line 1438 of file OutputPage.php.
References $mIndicators.
OutputPage::getJsConfigVars | ( | ) |
Get the javascript config vars to include on this page.
Definition at line 3108 of file OutputPage.php.
References $mJsConfigVars.
Referenced by getJSVars().
OutputPage::getJSVars | ( | ) |
Get an array containing the variables to be set in mw.config in JavaScript.
Do not add things here which can be evaluated in ResourceLoaderStartUpModule
Definition at line 3138 of file OutputPage.php.
References $lang, $type, $vars, $wgContLang, ContextSource\canUseWikiPage(), Action\getActionName(), getCategories(), ContextSource\getContext(), getFrameOptions(), getJsConfigVars(), getRevisionId(), ContextSource\getSkin(), ContextSource\getTitle(), ContextSource\getUser(), ContextSource\getWikiPage(), isArticle(), list, NS_SPECIAL, SpecialPageFactory\resolveAlias(), and wfTimestamp().
Referenced by getRlClient().
OutputPage::getKeyHeader | ( | ) |
Get a complete Key header.
Definition at line 2150 of file OutputPage.php.
References $header, $options, addVaryHeader(), and getCacheVaryCookies().
Referenced by sendCacheControl().
OutputPage::getLanguageLinks | ( | ) |
Get the list of language links.
Definition at line 1281 of file OutputPage.php.
References $mLanguageLinks.
OutputPage::getLinkHeader | ( | ) |
Return a Link: header.
Based on the values of $mLinkHeader.
Definition at line 2137 of file OutputPage.php.
Referenced by output().
OutputPage::getLinkTags | ( | ) |
Returns the current <link> tags.
Definition at line 408 of file OutputPage.php.
References $mLinktags.
OutputPage::getMetadataAttribute | ( | ) |
Get the value of the "rel" attribute for metadata links.
Definition at line 449 of file OutputPage.php.
Referenced by addMetadataLink().
OutputPage::getMetaTags | ( | ) |
Returns the current <meta> tags.
Definition at line 387 of file OutputPage.php.
References $mMetatags.
OutputPage::getModules | ( | $filter = false, | |
$position = null, | |||
$param = 'mModules', | |||
$type = ResourceLoaderModule::TYPE_COMBINED ) |
Get the list of modules to include on this page.
bool | $filter | Whether to filter out insufficiently trustworthy modules |
string | null | $position | If not null, only return modules with this position |
string | $param | |
string | $type |
Definition at line 580 of file OutputPage.php.
References $modules, $type, and filterModules().
Referenced by getModuleScripts(), getModuleStyles(), and getRlClient().
OutputPage::getModuleScripts | ( | $filter = false, | |
$position = null ) |
Get the list of module JS to include on this page.
bool | $filter | |
string | null | $position |
Definition at line 607 of file OutputPage.php.
References getModules(), and ResourceLoaderModule\TYPE_SCRIPTS.
Referenced by getRlClient().
OutputPage::getModuleStyles | ( | $filter = false, | |
$position = null ) |
Get the list of module CSS to include on this page.
bool | $filter | |
string | null | $position |
Definition at line 631 of file OutputPage.php.
References getModules(), and ResourceLoaderModule\TYPE_STYLES.
Referenced by getRlClient().
OutputPage::getPageTitle | ( | ) |
Return the "page title", i.e.
the content of the \<h1\> tag.
Definition at line 1006 of file OutputPage.php.
References $mPagetitle.
Referenced by headElement().
OutputPage::getPageTitleActionText | ( | ) |
Get the value of the "action text".
Definition at line 938 of file OutputPage.php.
References $mPageTitleActionText.
OutputPage::getPreventClickjacking | ( | ) |
Get the prevent-clickjacking flag.
Definition at line 2242 of file OutputPage.php.
References $mPreventClickjacking.
OutputPage::getProperty | ( | $name | ) |
Get an additional output property.
string | $name |
Definition at line 766 of file OutputPage.php.
References $name.
OutputPage::getRedirect | ( | ) |
Get the URL to redirect to, or an empty string if not redirect URL set.
Definition at line 345 of file OutputPage.php.
References $mRedirect.
OutputPage::getResourceLoader | ( | ) |
Get a ResourceLoader object associated with this OutputPage.
Definition at line 2988 of file OutputPage.php.
References $mResourceLoader, and ContextSource\getConfig().
Referenced by filterModules(), getRlClient(), getRlClientContext(), and warnModuleTargetFilter().
OutputPage::getRevisionId | ( | ) |
Get the displayed revision ID.
Definition at line 1643 of file OutputPage.php.
References $mRevisionId.
Referenced by getJSVars().
OutputPage::getRevisionTimestamp | ( | ) |
Get the timestamp of displayed revision.
This will be null if not filled by setRevisionTimestamp().
Definition at line 1664 of file OutputPage.php.
References $mRevisionTimestamp.
OutputPage::getRlClient | ( | ) |
Call this to freeze the module queue and JS config and create a formatter.
Depending on the Skin, this may get lazy-initialised in either headElement() or getBottomScripts(). See SkinTemplate::prepareQuickTemplate(). Calling this too early may cause unexpected side-effects since disallowUserJs() may be called at any time to change the module filters retroactively. Skins and extension hooks may also add modules until very late in the request lifecycle.
Definition at line 2810 of file OutputPage.php.
References ContextSource\$context, $dbr, $name, $rlClient, addModules(), addModuleStyles(), DB_REPLICA, filterModules(), getJSVars(), getModules(), getModuleScripts(), getModuleStyles(), getResourceLoader(), getRlClientContext(), ContextSource\getSkin(), getTarget(), isUserCssPreview(), isUserJsPreview(), ResourceLoaderWikiModule\preloadTitleInfo(), ResourceLoaderClientHtml\setConfig(), ResourceLoaderClientHtml\setExemptStates(), ResourceLoaderClientHtml\setModules(), ResourceLoaderClientHtml\setModuleScripts(), ResourceLoaderClientHtml\setModuleStyles(), and wfGetDB().
Referenced by getBottomScripts(), and headElement().
|
private |
Definition at line 2778 of file OutputPage.php.
References $query, $rlClientContext, ContextSource\getLanguage(), ContextSource\getRequest(), getResourceLoader(), ContextSource\getSkin(), ContextSource\getUser(), ResourceLoader\inDebugMode(), isPrintable(), and ResourceLoader\makeLoaderQuery().
Referenced by getRlClient(), and makeResourceLoaderLink().
OutputPage::getSubtitle | ( | ) |
OutputPage::getSyndicationLinks | ( | ) |
Return URLs for each supported syndication format for this page.
Definition at line 1197 of file OutputPage.php.
References $mFeedLinks.
Referenced by getHeadLinksArray().
OutputPage::getTarget | ( | ) |
Definition at line 653 of file OutputPage.php.
References $mTarget.
Referenced by getRlClient().
OutputPage::getTemplateIds | ( | ) |
Get the templates used on this page.
Definition at line 1697 of file OutputPage.php.
References $mTemplateIds.
OutputPage::getVaryHeader | ( | ) |
Return a Vary: header on which to vary caches.
Based on the keys of $mVaryHeader, such as Accept-Encoding or Cookie
Definition at line 2111 of file OutputPage.php.
References $header, $options, addVaryHeader(), and getCacheVaryCookies().
Referenced by sendCacheControl().
OutputPage::hasHeadItem | ( | $name | ) |
Check if the header item $name is already set.
string | $name | Item name |
Definition at line 707 of file OutputPage.php.
OutputPage::haveCacheVaryCookies | ( | ) |
Check if the request has a cache-varying cookie header If it does, it's very important that we don't allow public caching.
Definition at line 2075 of file OutputPage.php.
References $request, getCacheVaryCookies(), ContextSource\getRequest(), and wfDebug().
Definition at line 2891 of file OutputPage.php.
References $mAdditionalBodyClasses, $wgContLang, buildExemptModules(), combineWrappedStrings(), Action\getActionName(), ContextSource\getConfig(), ContextSource\getContext(), getHeadLinksArray(), getHTMLTitle(), ContextSource\getLanguage(), getPageTitle(), getRlClient(), ContextSource\getTitle(), ContextSource\getUser(), ResourceLoader\inDebugMode(), ContextSource\msg(), and setHTMLTitle().
OutputPage::isArticle | ( | ) |
Return whether the content displayed page is related to the source of the corresponding article on the wiki.
Definition at line 1230 of file OutputPage.php.
References $mIsarticle.
Referenced by getJSVars().
OutputPage::isArticleRelated | ( | ) |
Return whether this page is related an article on the wiki.
Definition at line 1252 of file OutputPage.php.
References $mIsArticleRelated.
Referenced by getHeadLinksArray().
OutputPage::isDisabled | ( | ) |
Return whether the output will be completely disabled.
Definition at line 1114 of file OutputPage.php.
References $mDoNothing.
OutputPage::isPrintable | ( | ) |
Return whether the page is "printable".
Definition at line 1098 of file OutputPage.php.
References $mPrintable.
Referenced by getRlClientContext().
OutputPage::isSyndicated | ( | ) |
Should we output feed links for this page?
Definition at line 1189 of file OutputPage.php.
OutputPage::isTOCEnabled | ( | ) |
Whether the output has a table of contents.
Definition at line 3953 of file OutputPage.php.
References $mEnableTOC.
|
protected |
Definition at line 3037 of file OutputPage.php.
References ContextSource\getConfig(), ContextSource\getTitle(), and userCanPreview().
Referenced by buildExemptModules(), and getRlClient().
|
private |
Definition at line 3030 of file OutputPage.php.
References ContextSource\getConfig(), ContextSource\getTitle(), and userCanPreview().
Referenced by getBottomScripts(), and getRlClient().
OutputPage::lowerCdnMaxage | ( | $maxage | ) |
Lower the value of the "s-maxage" part of the "Cache-control" HTTP header.
int | $maxage | Maximum cache time on the CDN, in seconds |
Definition at line 2002 of file OutputPage.php.
References setCdnMaxage().
Referenced by adaptCdnTTL().
OutputPage::makeResourceLoaderLink | ( | $modules, | |
$only, | |||
array | $extraQuery = [] ) |
Explicily load or embed modules on a page.
array | string | $modules | One or more module names |
string | $only | ResourceLoaderModule TYPE_ class constant |
array | $extraQuery | [optional] Array with extra query parameters for the request |
Definition at line 3006 of file OutputPage.php.
References $modules, filterModules(), getRlClientContext(), and ResourceLoaderClientHtml\makeLoad().
Referenced by buildExemptModules(), and getBottomScripts().
OutputPage::output | ( | $return = false | ) |
Finally, all the text has been munged and accumulated into the object, let's actually output it:
bool | $return | Set to true to get the result as a string rather than sending it |
Exception | |
FatalError | |
MWException |
Definition at line 2346 of file OutputPage.php.
References $code, $e, $mBodytext, $mRedirect, $mRedirectCode, $response, $wgContLang, addLogoPreloadLinkHeaders(), addModules(), addVaryHeader(), disallowUserJs(), ContextSource\getConfig(), getFrameOptions(), getLinkHeader(), ContextSource\getRequest(), ContextSource\getSkin(), print, PROTO_CURRENT, sendCacheControl(), wfExpandUrl(), and wfTimestamp().
OutputPage::parse | ( | $text, | |
$linestart = true, | |||
$interface = false, | |||
$language = null ) |
Parse wikitext and return the HTML.
string | $text | |
bool | $linestart | Is this the start of a line? |
bool | $interface | Use interface language ($wgLang instead of $wgContLang) while parsing language sensitive magic words like GRAMMAR and PLURAL. This also disables LanguageConverter. |
Language | $language | Target language object, will override $interface |
MWException |
Definition at line 1934 of file OutputPage.php.
References $wgParser, ContextSource\getTitle(), and parserOptions().
Referenced by parseInline(), and showPermissionsErrorPage().
OutputPage::parseInline | ( | $text, | |
$linestart = true, | |||
$interface = false ) |
Parse wikitext, strip paragraphs, and return the HTML.
string | $text | |
bool | $linestart | Is this the start of a line? |
bool | $interface | Use interface language ($wgLang instead of $wgContLang) while parsing language sensitive magic words like GRAMMAR and PLURAL |
Definition at line 1974 of file OutputPage.php.
References parse().
OutputPage::parserOptions | ( | $options = null | ) |
Get/set the ParserOptions object to use for wikitext parsing.
ParserOptions | null | $options | Either the ParserOption to use or null to only get the current ParserOption object |
Definition at line 1584 of file OutputPage.php.
References $options, ContextSource\getContext(), ContextSource\getUser(), wfGetAllCallers(), wfLogWarning(), and wfSetVar().
Referenced by addWikiTextTitle(), and parse().
OutputPage::prepareErrorPage | ( | $pageTitle, | |
$htmlTitle = false ) |
Prepare this object to display an error page; disable caching and indexing, clear the current text and redirect, set the page's title and optionally an custom HTML title (content of the "<title>" tag).
string | Message | $pageTitle | Will be passed directly to setPageTitle() |
string | Message | $htmlTitle | Will be passed directly to setHTMLTitle(); optional, if not passed the "<title>" attribute will be based on $pageTitle |
Definition at line 2477 of file OutputPage.php.
References clearHTML(), clearSubtitle(), enableClientCache(), setArticleRelated(), setHTMLTitle(), setPageTitle(), and setRobotPolicy().
Referenced by showErrorPage(), showFatalError(), showPermissionsErrorPage(), and versionRequired().
OutputPage::prependHTML | ( | $text | ) |
Prepend $text to the body HTML.
string | $text | HTML |
Definition at line 1535 of file OutputPage.php.
References $mBodytext.
OutputPage::preventClickjacking | ( | $enable = true | ) |
Set a flag which will cause an X-Frame-Options header appropriate for edit pages to be sent.
The header value is controlled by $wgEditPageFrameOptions.
This is the default for special pages. If you display a CSRF-protected form on an ordinary view page, then you need to call this function.
bool | $enable |
Definition at line 2223 of file OutputPage.php.
OutputPage::rateLimited | ( | ) |
Turn off regular page output and return an error response for when rate limiting has triggered.
Definition at line 2675 of file OutputPage.php.
References wfDeprecated().
OutputPage::readOnlyPage | ( | ) |
Display a page stating that the Wiki is in read-only mode.
Should only be called after wfReadOnly() has returned true.
Historically, this function was used to show the source of the page that the user was trying to edit and also permissions error messages. The relevant code was moved into EditPage in 1.19 (r102024 / d83c2a431c2a) and removed here in 1.25.
ReadOnlyError |
Definition at line 2661 of file OutputPage.php.
OutputPage::redirect | ( | $url, | |
$responsecode = '302' ) |
Redirect to $url rather than displaying the normal page.
string | $url | URL |
string | $responsecode | HTTP status code |
Definition at line 334 of file OutputPage.php.
OutputPage::reduceAllowedModules | ( | $type, | |
$level ) |
Limit the highest level of CSS/JS untrustworthiness allowed.
If passed the same or a higher level than the current level of untrustworthiness set, the level will remain unchanged.
string | $type | |
int | $level | ResourceLoaderModule class constant |
Definition at line 1526 of file OutputPage.php.
References $type, and getAllowedModules().
Referenced by disallowUserJs().
OutputPage::returnToMain | ( | $unused = null, | |
$returnto = null, | |||
$returntoquery = null ) |
Add a "return to" link pointing to a specified title, or the title indicated in the request, or else the main page.
mixed | $unused | |
Title | string | $returnto | Title or String to return to |
string | $returntoquery | Query string for the return to link |
Definition at line 2751 of file OutputPage.php.
References addReturnTo(), ContextSource\getRequest(), and wfCgiToArray().
Referenced by showErrorPage(), showPermissionsErrorPage(), and versionRequired().
OutputPage::sectionEditLinksEnabled | ( | ) |
Definition at line 3970 of file OutputPage.php.
References $mEnableSectionEditLinks.
OutputPage::sendCacheControl | ( | ) |
Send cache control HTTP headers.
Definition at line 2266 of file OutputPage.php.
References $response, addAcceptLanguage(), addVaryHeader(), ContextSource\getConfig(), getKeyHeader(), ContextSource\getRequest(), getVaryHeader(), and wfDebug().
Referenced by checkLastModified(), and output().
OutputPage::setArticleBodyOnly | ( | $only | ) |
Set whether the output should only contain the body of the article, without any skin, sidebar, etc.
Used e.g. when calling with "action=render".
bool | $only | Whether to output only the body of the article |
Definition at line 735 of file OutputPage.php.
OutputPage::setArticleFlag | ( | $v | ) |
Set whether the displayed content is related to the source of the corresponding article on the wiki Setting true will cause the change "article related" toggle to true.
bool | $v |
Definition at line 1217 of file OutputPage.php.
OutputPage::setArticleRelated | ( | $v | ) |
Set whether this page is related an article on the wiki Setting false will cause the change of "article flag" toggle to false.
bool | $v |
Definition at line 1240 of file OutputPage.php.
Referenced by prepareErrorPage().
OutputPage::setCanonicalUrl | ( | $url | ) |
Set the URL to be used for the <link rel=canonical>>.
This should be used in preference to addLink(), to avoid duplicate link tags.
string | $url |
Definition at line 429 of file OutputPage.php.
OutputPage::setCategoryLinks | ( | array | $categories | ) |
Reset the category links (but not the category list) and add $categories.
array | $categories | Mapping category name => sort key |
Definition at line 1375 of file OutputPage.php.
References addCategoryLinks().
OutputPage::setCdnMaxage | ( | $maxage | ) |
Set the value of the "s-maxage" part of the "Cache-control" HTTP header.
int | $maxage | Maximum cache time on the CDN, in seconds. |
Definition at line 1992 of file OutputPage.php.
Referenced by lowerCdnMaxage(), and setSquidMaxage().
OutputPage::setCopyrightUrl | ( | $url | ) |
Set the copyright URL to send with the output.
Empty string to omit, null to reset.
string | null | $url |
Definition at line 357 of file OutputPage.php.
OutputPage::setETag | ( | $tag | ) |
string | $tag |
Definition at line 725 of file OutputPage.php.
OutputPage::setFeedAppendQuery | ( | $val | ) |
Add default feeds to the page header This is mainly kept for backward compatibility, see OutputPage::addFeedLink() for the new version.
string | $val | Query to append to feed links or false to output default links |
Definition at line 1161 of file OutputPage.php.
References $query, $type, ContextSource\getConfig(), and ContextSource\getTitle().
Referenced by setSyndicated().
OutputPage::setFileVersion | ( | $file | ) |
Set the displayed file version.
File | bool | $file |
Definition at line 1674 of file OutputPage.php.
References File\exists(), and wfSetVar().
OutputPage::setFollowPolicy | ( | $policy | ) |
Set the follow policy for the page, but leave the index policy un- touched.
string | $policy | Either 'follow' or 'nofollow'. |
Definition at line 916 of file OutputPage.php.
Referenced by setRobotPolicy().
OutputPage::setHTMLTitle | ( | $name | ) |
"HTML title" means the contents of "<title>".
It is stored as plain, unescaped text and will be run through htmlspecialchars in the skin file.
string | Message | $name |
Definition at line 948 of file OutputPage.php.
References $name, and ContextSource\getContext().
Referenced by headElement(), prepareErrorPage(), and setPageTitle().
OutputPage::setIndexPolicy | ( | $policy | ) |
Set the index policy for the page, but leave the follow policy un- touched.
string | $policy | Either 'index' or 'noindex'. |
Definition at line 902 of file OutputPage.php.
Referenced by setRobotPolicy().
OutputPage::setIndicators | ( | array | $indicators | ) |
Add an array of indicators, with their identifiers as array keys and HTML contents as values.
In case of duplicate keys, existing values are overwritten.
array | $indicators |
Definition at line 1424 of file OutputPage.php.
References $mIndicators.
Referenced by addHelpLink(), and addParserOutputMetadata().
OutputPage::setLanguageLinks | ( | array | $newLinkArray | ) |
Reset the language links and add new language links.
string[] | $newLinkArray | Array of interwiki-prefixed (non DB key) titles (e.g. 'fr:Test page') |
Definition at line 1272 of file OutputPage.php.
OutputPage::setLastModified | ( | $timestamp | ) |
Override the last modified timestamp.
string | $timestamp | New timestamp, in a format readable by wfTimestamp() |
Definition at line 872 of file OutputPage.php.
References wfTimestamp().
OutputPage::setPageTitle | ( | $name | ) |
"Page title" means the contents of \<h1\>.
It is stored as a valid HTML fragment. This function allows good tags like \<sup\> in the \<h1\> tag, but not bad tags like \<script\>. This function automatically sets \<title\> to the same content as \<h1\> but with all tags removed. Bad tags that were escaped in \<h1\> will still be escaped in \<title\>, and good tags like \<i\> will be dropped entirely.
string | Message | $name |
Definition at line 984 of file OutputPage.php.
References ContextSource\getContext(), ContextSource\msg(), and setHTMLTitle().
Referenced by prepareErrorPage().
OutputPage::setPageTitleActionText | ( | $text | ) |
Set the new value of the "action text", this will be added to the "HTML title", separated from it with " - ".
string | $text | New value of the "action text" |
Definition at line 929 of file OutputPage.php.
OutputPage::setPrintable | ( | ) |
Set the page as printable, i.e.
it'll be displayed with all print styles included
Definition at line 1089 of file OutputPage.php.
OutputPage::setProperty | ( | $name, | |
$value ) |
Set an additional output property.
string | $name | |
mixed | $value |
Definition at line 755 of file OutputPage.php.
OutputPage::setRedirectedFrom | ( | $t | ) |
Set $mRedirectedFrom, the Title of the page which redirected us to the current page.
Title | $t |
Definition at line 970 of file OutputPage.php.
References $t.
OutputPage::setRevisionId | ( | $revid | ) |
Set the revision ID which will be seen by the wiki text parser for things such as embedded {{REVISIONID}} variable use.
int | null | $revid | An positive integer, or null |
Definition at line 1633 of file OutputPage.php.
References wfSetVar().
OutputPage::setRevisionTimestamp | ( | $timestamp | ) |
Set the timestamp of the revision which will be displayed.
This is used to avoid a extra DB call in Skin::lastModified().
string | null | $timestamp |
Definition at line 1654 of file OutputPage.php.
References wfSetVar().
OutputPage::setRobotPolicy | ( | $policy | ) |
Set the robot policy for the page: http://www.robotstxt.org/meta.html
string | $policy | The literal string to output as the contents of the meta tag. Will be parsed according to the spec and output in standardized form. |
Definition at line 884 of file OutputPage.php.
References Article\formatRobotPolicy(), setFollowPolicy(), and setIndexPolicy().
Referenced by prepareErrorPage().
OutputPage::setSquidMaxage | ( | $maxage | ) |
int | $maxage |
Definition at line 1983 of file OutputPage.php.
References setCdnMaxage().
OutputPage::setStatusCode | ( | $statusCode | ) |
Set the HTTP status code to send with the output.
int | $statusCode |
Definition at line 366 of file OutputPage.php.
OutputPage::setSubtitle | ( | $str | ) |
Replace the subtitle with $str.
string | Message | $str | New value of the subtitle. String should be safe HTML. |
Definition at line 1024 of file OutputPage.php.
References addSubtitle(), and clearSubtitle().
OutputPage::setSyndicated | ( | $show = true | ) |
Add or remove feed links in the page header This is mainly kept for backward compatibility, see OutputPage::addFeedLink() for the new version.
bool | $show | True: add default feeds, false: remove all feeds |
Definition at line 1144 of file OutputPage.php.
References setFeedAppendQuery().
OutputPage::setTarget | ( | $target | ) |
Sets ResourceLoader target for load.php links.
If null, will be omitted
string | null | $target |
Definition at line 662 of file OutputPage.php.
OutputPage::setTitle | ( | Title | $t | ) |
Set the Title object to use.
Title | $t |
Definition at line 1015 of file OutputPage.php.
References ContextSource\getContext().
|
static |
Helper function to setup the PHP implementation of OOUI to use in this request.
String | $skinName | The Skin name to determine the correct OOUI theme |
String | $dir | Language direction |
Definition at line 3981 of file OutputPage.php.
References $dir.
Referenced by enableOOUI(), and Parser\enableOOUI().
OutputPage::showErrorPage | ( | $title, | |
$msg, | |||
$params = [] ) |
Output a standard error page.
showErrorPage( 'titlemsg', 'pagetextmsg' ); showErrorPage( 'titlemsg', 'pagetextmsg', [ 'param1', 'param2' ] ); showErrorPage( 'titlemsg', $messageObject ); showErrorPage( $titleMessageObject, $messageObject );
string | Message | $title | Message key (string) for page title, or a Message object |
string | Message | $msg | Message key (string) for page text, or a Message object |
array | $params | Message parameters; ignored if $msg is a Message object |
Definition at line 2502 of file OutputPage.php.
References $params, addHTML(), addWikiMsgArray(), ContextSource\msg(), prepareErrorPage(), and returnToMain().
OutputPage::showFatalError | ( | $message | ) |
Definition at line 2701 of file OutputPage.php.
References addHTML(), ContextSource\msg(), and prepareErrorPage().
Referenced by showFileCopyError(), showFileDeleteError(), showFileNotFoundError(), showFileRenameError(), and showUnexpectedValueError().
OutputPage::showFileCopyError | ( | $old, | |
$new ) |
Definition at line 2711 of file OutputPage.php.
References ContextSource\msg(), showFatalError(), and text.
OutputPage::showFileDeleteError | ( | $name | ) |
Definition at line 2719 of file OutputPage.php.
References ContextSource\msg(), showFatalError(), and text.
OutputPage::showFileNotFoundError | ( | $name | ) |
Definition at line 2723 of file OutputPage.php.
References ContextSource\msg(), showFatalError(), and text.
OutputPage::showFileRenameError | ( | $old, | |
$new ) |
Definition at line 2715 of file OutputPage.php.
References ContextSource\msg(), showFatalError(), and text.
OutputPage::showLagWarning | ( | $lag | ) |
Show a warning about replica DB lag.
If the lag is higher than $wgSlaveLagCritical seconds, then the warning is a bit more obvious. If the lag is lower than $wgSlaveLagWarning, then no warning is shown.
int | $lag | Slave lag |
Definition at line 2689 of file OutputPage.php.
References ContextSource\getConfig(), ContextSource\getLanguage(), and wrapWikiMsg().
OutputPage::showNewSectionLink | ( | ) |
Show an "add new section" link?
Definition at line 1123 of file OutputPage.php.
References $mNewSectionLink.
OutputPage::showPermissionsErrorPage | ( | array | $errors, |
$action = null ) |
Output a standard permission error page.
array | $errors | Error message keys or [key, param...] arrays |
string | $action | Action that was denied or null if unknown |
Definition at line 2529 of file OutputPage.php.
References $linkRenderer, $query, $request, addHTML(), addWikiText(), array(), formatPermissionsErrorMessage(), ContextSource\getRequest(), SpecialPage\getTitleFor(), ContextSource\getUser(), ContextSource\msg(), parse(), prepareErrorPage(), returnToMain(), text, and wfArrayToCgi().
OutputPage::showUnexpectedValueError | ( | $name, | |
$val ) |
Definition at line 2707 of file OutputPage.php.
References ContextSource\msg(), showFatalError(), and text.
|
protected |
Generate \<link\> tags for stylesheets.
string | $style | URL to the file |
array | $options | Option, can contain 'condition', 'dir', 'media' keys |
Definition at line 3721 of file OutputPage.php.
References $link, $options, ContextSource\getConfig(), ContextSource\getLanguage(), and transformCssMedia().
Referenced by buildCssLinksArray().
|
static |
Transform "media" attribute based on request parameters.
string | $media | Current value of the "media" attribute |
Definition at line 3835 of file OutputPage.php.
References $wgRequest.
Referenced by OutputPageTest\assertTransformCssMediaCase(), and styleLink().
|
static |
Utility method for transformResourceFilePath().
Caller is responsible for ensuring the file exists. Emits a PHP warning otherwise.
string | $remotePathPrefix | URL path prefix that points to $localPath |
string | $localPath | File directory exposed at $remotePath |
string | $file | Path to target file relative to $localPath |
Definition at line 3819 of file OutputPage.php.
References wfLogWarning().
Referenced by CSSMin\remapOne(), and transformResourcePath().
|
static |
Transform path to web-accessible static resource.
This is used to add a validation hash as query string. This aids various behaviors:
Avoid using this for urls included in HTML as otherwise clients may get different versions of a resource when navigating the site depending on when the page was cached. If changes to the url propagate, this is not a problem (e.g. if the url is in an external stylesheet).
Config | $config | |
string | $path | Path-absolute URL to file (from document root, must start with "/") |
Definition at line 3777 of file OutputPage.php.
References $IP, $path, and transformFilePath().
Referenced by ResourceLoaderSkinModule\getLogo(), ResourceLoaderFileModule\getScriptURLsForDebug(), ResourceLoaderFileModule\getStyleURLsForDebug(), ImageMap\render(), and OutputPageTest\testTransformResourcePath().
OutputPage::userCanPreview | ( | ) |
To make it harder for someone to slip a user a fake user-JavaScript or user-CSS preview, a random token is associated with the login session.
If it's not passed back with the preview request, we won't render the code.
Definition at line 3269 of file OutputPage.php.
References $request, ContextSource\getRequest(), ContextSource\getTitle(), and ContextSource\getUser().
Referenced by isUserCssPreview(), and isUserJsPreview().
OutputPage::versionRequired | ( | $version | ) |
Display an error page indicating that a given version of MediaWiki is required to use it.
mixed | $version | The version of MediaWiki needed to use the page |
Definition at line 2606 of file OutputPage.php.
References addWikiMsg(), ContextSource\msg(), prepareErrorPage(), and returnToMain().
|
private |
Definition at line 556 of file OutputPage.php.
References $mTarget, and getResourceLoader().
Referenced by filterModules().
OutputPage::wrapWikiMsg | ( | $wrap | ) |
This function takes a number of message/argument specifications, wraps them in some overall structure, and then parses the result and adds it to the output.
In the $wrap, $1 is replaced with the first message, $2 with the second, and so on. The subsequent arguments may be either 1) strings, in which case they are message names, or 2) arrays, in which case, within each array, the first element is the message name, and subsequent elements are the parameters to that message.
Don't use this for messages that are not in the user's interface language.
For example:
$wgOut->wrapWikiMsg( "<div class='error'>\\n$1\\n</div>", 'some-error' );
Is equivalent to:
$wgOut->addWikiText( "<div class='error'>\\n" . wfMessage( 'some-error' )->plain() . "\\n</div>" );
The newline after the opening div is needed in some wikitext. See T21226.
string | $wrap |
Definition at line 3923 of file OutputPage.php.
References $args, $s, addWikiText(), ContextSource\msg(), plain, and wfDeprecated().
Referenced by showLagWarning().
|
private |
The URL to send in a <link> element with rel=license.
Definition at line 303 of file OutputPage.php.
Referenced by getHeadLinksArray().
|
private |
Profiling data.
Definition at line 306 of file OutputPage.php.
|
protected |
Additional <body> classes; there are also <body> classes from other sources.
Definition at line 143 of file OutputPage.php.
Referenced by headElement().
|
protected |
What level of 'untrustworthiness' is allowed in CSS/JS modules loaded on this page?
Definition at line 188 of file OutputPage.php.
|
private |
Flag if output should only contain the body of the article.
Definition at line 217 of file OutputPage.php.
Referenced by getArticleBodyOnly().
string OutputPage::$mBodytext = '' |
Contains all of the "<body>" content.
Should be private we got set/get accessors and the append() method.
Definition at line 69 of file OutputPage.php.
Referenced by getHTML(), output(), and prependHTML().
|
protected |
Definition at line 52 of file OutputPage.php.
Referenced by getCanonicalUrl(), and getHeadLinksArray().
|
protected |
Definition at line 111 of file OutputPage.php.
|
protected |
Definition at line 108 of file OutputPage.php.
Referenced by getCategoryLinks().
|
protected |
|
protected |
Upper limit on mCdnMaxage.
Definition at line 238 of file OutputPage.php.
|
protected |
Definition at line 198 of file OutputPage.php.
|
protected |
Whether output is disabled.
If this is true, the 'output' method will do nothing.
Definition at line 193 of file OutputPage.php.
Referenced by isDisabled().
|
protected |
Definition at line 214 of file OutputPage.php.
|
private |
Whether parser output should contain section edit links.
Definition at line 298 of file OutputPage.php.
Referenced by sectionEditLinksEnabled().
|
private |
Whether parser output contains a table of contents.
Definition at line 293 of file OutputPage.php.
Referenced by isTOCEnabled().
|
protected |
Additional stylesheets.
Looks like this is for extensions. Might be replaced by ResourceLoader.
Definition at line 58 of file OutputPage.php.
Referenced by getExtStyle().
|
private |
Handles the Atom / RSS links.
We probably only support Atom in 2011.
Definition at line 211 of file OutputPage.php.
Referenced by getSyndicationLinks().
|
protected |
Definition at line 181 of file OutputPage.php.
Referenced by getFeedAppendQuery().
|
protected |
Definition at line 254 of file OutputPage.php.
Referenced by getFileVersion().
|
private |
Definition at line 267 of file OutputPage.php.
|
protected |
Array of elements in "<head>".
Parser might add its own headers!
Definition at line 140 of file OutputPage.php.
Referenced by getHeadItemsArray().
|
protected |
Definition at line 223 of file OutputPage.php.
Referenced by forceHideNewSectionLink().
|
private |
Stores contents of "<title>" tag.
Definition at line 72 of file OutputPage.php.
Referenced by getHTMLTitle().
|
protected |
Definition at line 176 of file OutputPage.php.
Referenced by getFileSearchOptions().
|
private |
Definition at line 266 of file OutputPage.php.
|
protected |
Definition at line 117 of file OutputPage.php.
Referenced by getIndicators(), and setIndicators().
|
protected |
Inline CSS styles.
Use addInlineStyle() sparingly
Definition at line 131 of file OutputPage.php.
Referenced by buildExemptModules().
|
private |
Is the displayed content related to the source of the corresponding wiki article.
Definition at line 78 of file OutputPage.php.
Referenced by isArticle().
|
private |
Stores "article flag" toggle.
Definition at line 81 of file OutputPage.php.
Referenced by isArticleRelated().
|
protected |
Definition at line 170 of file OutputPage.php.
Referenced by getJsConfigVars().
|
private |
Array of Interwiki Prefixed (non DB key) Titles (e.g.
'fr:Test page')
Definition at line 120 of file OutputPage.php.
Referenced by getLanguageLinks().
|
protected |
Used for sending cache control.
The whole caching system should probably be moved into its own class.
Definition at line 105 of file OutputPage.php.
|
private |
Link: header contents.
Definition at line 311 of file OutputPage.php.
|
protected |
Definition at line 49 of file OutputPage.php.
Referenced by getLinkTags().
|
protected |
Should be private.
Used with addMeta() which adds "<meta>"
Definition at line 46 of file OutputPage.php.
Referenced by getMetaTags().
|
protected |
Definition at line 146 of file OutputPage.php.
|
protected |
Definition at line 149 of file OutputPage.php.
|
protected |
Definition at line 152 of file OutputPage.php.
|
protected |
Definition at line 220 of file OutputPage.php.
Referenced by showNewSectionLink().
bool OutputPage::$mNoGallery = false |
Comes from the parser.
This was probably made to load CSS/JS only if we had "<gallery>". Used directly in CategoryPage.php. Looks like ResourceLoader can replace this.
Definition at line 230 of file OutputPage.php.
string OutputPage::$mPageLinkTitle = '' |
Used by skin template.
Example: $tpl->set( 'displaytitle', $out->mPageLinkTitle );
Definition at line 137 of file OutputPage.php.
string OutputPage::$mPagetitle = '' |
Should be private - has getter and setter.
Contains the HTML title
Definition at line 63 of file OutputPage.php.
Referenced by getPageTitle().
|
private |
Definition at line 233 of file OutputPage.php.
Referenced by getPageTitleActionText().
|
protected |
lazy initialised, use parserOptions()
Definition at line 204 of file OutputPage.php.
|
protected |
Controls if anti-clickjacking / frame-breaking headers will be sent.
This should be done for pages where edit actions are possible. Setters: $this->preventClickjacking() and $this->allowClickjacking().
Definition at line 245 of file OutputPage.php.
Referenced by getPreventClickjacking().
|
private |
We have to set isPrintable().
Some pages should never be printed (ex: redirections).
Definition at line 87 of file OutputPage.php.
Referenced by isPrintable().
|
private |
Additional key => value data.
Definition at line 283 of file OutputPage.php.
string OutputPage::$mRedirect = '' |
Definition at line 96 of file OutputPage.php.
Referenced by getRedirect(), and output().
string OutputPage::$mRedirectCode = '' |
Definition at line 179 of file OutputPage.php.
Referenced by output().
|
private |
If the current page was reached through a redirect, $mRedirectedFrom contains the Title of the redirect.
Definition at line 278 of file OutputPage.php.
|
protected |
Definition at line 155 of file OutputPage.php.
Referenced by getResourceLoader().
|
private |
To include the variable {{REVISIONID}}.
Definition at line 248 of file OutputPage.php.
Referenced by getRevisionId().
|
private |
Definition at line 251 of file OutputPage.php.
Referenced by getRevisionTimestamp().
|
private |
Used for JavaScript (predates ResourceLoader)
Definition at line 128 of file OutputPage.php.
Referenced by getBottomScripts().
|
protected |
Definition at line 99 of file OutputPage.php.
|
private |
Contains the page subtitle.
Special pages usually have some links here. Don't confuse with site subtitle added by skins.
Definition at line 93 of file OutputPage.php.
|
private |
ResourceLoader target for load.php links.
If null, will be omitted
Definition at line 288 of file OutputPage.php.
Referenced by getTarget(), and warnModuleTargetFilter().
|
protected |
Definition at line 173 of file OutputPage.php.
Referenced by getTemplateIds().
|
private |
Definition at line 268 of file OutputPage.php.
|
private |
Definition at line 158 of file OutputPage.php.
Referenced by getRlClient().
|
private |
Definition at line 161 of file OutputPage.php.
Referenced by getRlClientContext().
|
private |
Definition at line 167 of file OutputPage.php.
|
private |
Definition at line 164 of file OutputPage.php.
|
protected |
An array of stylesheet filenames (relative from skins path), with options for CSS media, IE conditions, and RTL/LTR direction.
For internal use; add settings in the skin via $this->addStyle()
Style again! This seems like a code duplication since we already have mStyles. This is what makes Open Source amazing.
Definition at line 264 of file OutputPage.php.