addStyle() */ var $styles = array(); /** * Whether to load jQuery core. */ protected $mJQueryDone = false; private $mIndexPolicy = 'index'; private $mFollowPolicy = 'follow'; private $mVaryHeader = array( 'Accept-Encoding' => array( 'list-contains=gzip' ), 'Cookie' => null ); /** * Constructor * Initialise private variables */ function __construct() { global $wgAllowUserJs; $this->mAllowUserJs = $wgAllowUserJs; } /** * Redirect to $url rather than displaying the normal page * * @param $url String: URL * @param $responsecode String: HTTP status code */ public function redirect( $url, $responsecode = '302' ) { # Strip newlines as a paranoia check for header injection in PHP<5.1.2 $this->mRedirect = str_replace( "\n", '', $url ); $this->mRedirectCode = $responsecode; } /** * Get the URL to redirect to, or an empty string if not redirect URL set * * @return String */ public function getRedirect() { return $this->mRedirect; } /** * Set the HTTP status code to send with the output. * * @param $statusCode Integer * @return nothing */ public function setStatusCode( $statusCode ) { $this->mStatusCode = $statusCode; } /** * Add a new tag * To add an http-equiv meta tag, precede the name with "http:" * * @param $name tag name * @param $val tag value */ function addMeta( $name, $val ) { array_push( $this->mMetatags, array( $name, $val ) ); } /** * Add a keyword or a list of keywords in the page header * * @param $text String or array of strings */ function addKeyword( $text ) { if( is_array( $text ) ) { $this->mKeywords = array_merge( $this->mKeywords, $text ); } else { array_push( $this->mKeywords, $text ); } } /** * Add a new \ tag to the page header * * @param $linkarr Array: associative array of attributes. */ function addLink( $linkarr ) { array_push( $this->mLinktags, $linkarr ); } /** * Add a new \ with "rel" attribute set to "meta" * * @param $linkarr Array: associative array mapping attribute names to their * values, both keys and values will be escaped, and the * "rel" attribute will be automatically added */ function addMetadataLink( $linkarr ) { # note: buggy CC software only reads first "meta" link static $haveMeta = false; $linkarr['rel'] = $haveMeta ? 'alternate meta' : 'meta'; $this->addLink( $linkarr ); $haveMeta = true; } /** * Add raw HTML to the list of scripts (including \" to "<script>foo&bar</script>" # but leave "foobar" alone $nameWithTags = Sanitizer::normalizeCharReferences( Sanitizer::removeHTMLtags( $name ) ); $this->mPagetitle = $nameWithTags; $taction = $this->getPageTitleActionText(); if( !empty( $taction ) ) { $name .= ' - '.$taction; } # change "foo&bar" to "foo&bar" $this->setHTMLTitle( wfMsg( 'pagetitle', Sanitizer::stripAllTags( $nameWithTags ) ) ); } /** * Return the "page title", i.e. the content of the \
(.*)\n?<\/p>\n?/sU', $parsed, $m ) ) { $parsed = $m[1]; } return $parsed; } /** * @deprecated * * @param $article Article * @return Boolean: true if successful, else false. */ public function tryParserCache( &$article ) { wfDeprecated( __METHOD__ ); $parserOutput = ParserCache::singleton()->get( $article, $article->getParserOptions() ); if ( $parserOutput !== false ) { $this->addParserOutput( $parserOutput ); return true; } else { return false; } } /** * Set the value of the "s-maxage" part of the "Cache-control" HTTP header * * @param $maxage Integer: maximum cache time on the Squid, in seconds. */ public function setSquidMaxage( $maxage ) { $this->mSquidMaxage = $maxage; } /** * Use enableClientCache(false) to force it to send nocache headers * * @param $state ?? */ public function enableClientCache( $state ) { return wfSetVar( $this->mEnableClientCache, $state ); } /** * Get the list of cookies that will influence on the cache * * @return Array */ function getCacheVaryCookies() { global $wgCookiePrefix, $wgCacheVaryCookies; static $cookies; if ( $cookies === null ) { $cookies = array_merge( array( "{$wgCookiePrefix}Token", "{$wgCookiePrefix}LoggedOut", session_name() ), $wgCacheVaryCookies ); wfRunHooks( 'GetCacheVaryCookies', array( $this, &$cookies ) ); } return $cookies; } /** * Return whether this page is not cacheable because "useskin" or "uselang" * URL parameters were passed. * * @return Boolean */ function uncacheableBecauseRequestVars() { global $wgRequest; return $wgRequest->getText( 'useskin', false ) === false && $wgRequest->getText( 'uselang', false ) === false; } /** * Check if the request has a cache-varying cookie header * If it does, it's very important that we don't allow public caching * * @return Boolean */ function haveCacheVaryCookies() { global $wgRequest; $cookieHeader = $wgRequest->getHeader( 'cookie' ); if ( $cookieHeader === false ) { return false; } $cvCookies = $this->getCacheVaryCookies(); foreach ( $cvCookies as $cookieName ) { # Check for a simple string match, like the way squid does it if ( strpos( $cookieHeader, $cookieName ) !== false ) { wfDebug( __METHOD__ . ": found $cookieName\n" ); return true; } } wfDebug( __METHOD__ . ": no cache-varying cookies found\n" ); return false; } /** * Add an HTTP header that will influence on the cache * * @param $header String: header name * @param $option either an Array or null */ public function addVaryHeader( $header, $option = null ) { if ( !array_key_exists( $header, $this->mVaryHeader ) ) { $this->mVaryHeader[$header] = $option; } elseif( is_array( $option ) ) { if( is_array( $this->mVaryHeader[$header] ) ) { $this->mVaryHeader[$header] = array_merge( $this->mVaryHeader[$header], $option ); } else { $this->mVaryHeader[$header] = $option; } } $this->mVaryHeader[$header] = array_unique( $this->mVaryHeader[$header] ); } /** * Get a complete X-Vary-Options header * * @return String */ public function getXVO() { $cvCookies = $this->getCacheVaryCookies(); $cookiesOption = array(); foreach ( $cvCookies as $cookieName ) { $cookiesOption[] = 'string-contains=' . $cookieName; } $this->addVaryHeader( 'Cookie', $cookiesOption ); $headers = array(); foreach( $this->mVaryHeader as $header => $option ) { $newheader = $header; if( is_array( $option ) ) { $newheader .= ';' . implode( ';', $option ); } $headers[] = $newheader; } $xvo = 'X-Vary-Options: ' . implode( ',', $headers ); return $xvo; } /** * bug 21672: Add Accept-Language to Vary and XVO 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. */ function addAcceptLanguage() { global $wgRequest, $wgContLang; if( !$wgRequest->getCheck( 'variant' ) && $wgContLang->hasVariants() ) { $variants = $wgContLang->getVariants(); $aloption = array(); foreach ( $variants as $variant ) { if( $variant === $wgContLang->getCode() ) { continue; } else { $aloption[] = "string-contains=$variant"; } } $this->addVaryHeader( 'Accept-Language', $aloption ); } } /** * Send cache control HTTP headers */ public function sendCacheControl() { global $wgUseSquid, $wgUseESI, $wgUseETag, $wgSquidMaxage, $wgRequest, $wgUseXVO; $response = $wgRequest->response(); if ( $wgUseETag && $this->mETag ) { $response->header( "ETag: $this->mETag" ); } $this->addAcceptLanguage(); # don't serve compressed data to clients who can't handle it # maintain different caches for logged-in users and non-logged in ones $response->header( 'Vary: ' . join( ', ', array_keys( $this->mVaryHeader ) ) ); if ( $wgUseXVO ) { # Add an X-Vary-Options header for Squid with Wikimedia patches $response->header( $this->getXVO() ); } if( !$this->uncacheableBecauseRequestVars() && $this->mEnableClientCache ) { if( $wgUseSquid && session_id() == '' && !$this->isPrintable() && $this->mSquidMaxage != 0 && !$this->haveCacheVaryCookies() ) { if ( $wgUseESI ) { # We'll purge the proxy cache explicitly, but require end user agents # to revalidate against the proxy on each visit. # Surrogate-Control controls our Squid, Cache-Control downstream caches wfDebug( __METHOD__ . ": proxy caching with ESI; {$this->mLastModified} **\n", false ); # start with a shorter timeout for initial testing # header( 'Surrogate-Control: max-age=2678400+2678400, content="ESI/1.0"'); $response->header( 'Surrogate-Control: max-age='.$wgSquidMaxage.'+'.$this->mSquidMaxage.', content="ESI/1.0"'); $response->header( 'Cache-Control: s-maxage=0, must-revalidate, max-age=0' ); } else { # We'll purge the proxy cache for anons explicitly, but require end user agents # to revalidate against the proxy on each visit. # IMPORTANT! The Squid needs to replace the Cache-Control header with # Cache-Control: s-maxage=0, must-revalidate, max-age=0 wfDebug( __METHOD__ . ": local proxy caching; {$this->mLastModified} **\n", false ); # start with a shorter timeout for initial testing # header( "Cache-Control: s-maxage=2678400, must-revalidate, max-age=0" ); $response->header( 'Cache-Control: s-maxage='.$this->mSquidMaxage.', must-revalidate, max-age=0' ); } } else { # We do want clients to cache if they can, but they *must* check for updates # on revisiting the page. wfDebug( __METHOD__ . ": private caching; {$this->mLastModified} **\n", false ); $response->header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', 0 ) . ' GMT' ); $response->header( "Cache-Control: private, must-revalidate, max-age=0" ); } if($this->mLastModified) { $response->header( "Last-Modified: {$this->mLastModified}" ); } } else { wfDebug( __METHOD__ . ": no caching **\n", false ); # In general, the absence of a last modified header should be enough to prevent # the client from using its cache. We send a few other things just to make sure. $response->header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', 0 ) . ' GMT' ); $response->header( 'Cache-Control: no-cache, no-store, max-age=0, must-revalidate' ); $response->header( 'Pragma: no-cache' ); } } /** * Get the message associed with the HTTP response code $code * * @param $code Integer: status code * @return String or null: message or null if $code is not in the list of * messages */ public static function getStatusMessage( $code ) { static $statusMessage = array( 100 => 'Continue', 101 => 'Switching Protocols', 102 => 'Processing', 200 => 'OK', 201 => 'Created', 202 => 'Accepted', 203 => 'Non-Authoritative Information', 204 => 'No Content', 205 => 'Reset Content', 206 => 'Partial Content', 207 => 'Multi-Status', 300 => 'Multiple Choices', 301 => 'Moved Permanently', 302 => 'Found', 303 => 'See Other', 304 => 'Not Modified', 305 => 'Use Proxy', 307 => 'Temporary Redirect', 400 => 'Bad Request', 401 => 'Unauthorized', 402 => 'Payment Required', 403 => 'Forbidden', 404 => 'Not Found', 405 => 'Method Not Allowed', 406 => 'Not Acceptable', 407 => 'Proxy Authentication Required', 408 => 'Request Timeout', 409 => 'Conflict', 410 => 'Gone', 411 => 'Length Required', 412 => 'Precondition Failed', 413 => 'Request Entity Too Large', 414 => 'Request-URI Too Large', 415 => 'Unsupported Media Type', 416 => 'Request Range Not Satisfiable', 417 => 'Expectation Failed', 422 => 'Unprocessable Entity', 423 => 'Locked', 424 => 'Failed Dependency', 500 => 'Internal Server Error', 501 => 'Not Implemented', 502 => 'Bad Gateway', 503 => 'Service Unavailable', 504 => 'Gateway Timeout', 505 => 'HTTP Version Not Supported', 507 => 'Insufficient Storage' ); return isset( $statusMessage[$code] ) ? $statusMessage[$code] : null; } /** * Finally, all the text has been munged and accumulated into * the object, let's actually output it: */ public function output() { global $wgUser, $wgOutputEncoding, $wgRequest; global $wgLanguageCode, $wgDebugRedirects, $wgMimeType; global $wgUseAjax, $wgAjaxWatch; global $wgEnableMWSuggest, $wgUniversalEditButton; global $wgArticle; if( $this->mDoNothing ) { return; } wfProfileIn( __METHOD__ ); if ( $this->mRedirect != '' ) { # Standards require redirect URLs to be absolute $this->mRedirect = wfExpandUrl( $this->mRedirect ); if( $this->mRedirectCode == '301' || $this->mRedirectCode == '303' ) { if( !$wgDebugRedirects ) { $message = self::getStatusMessage( $this->mRedirectCode ); $wgRequest->response()->header( "HTTP/1.1 {$this->mRedirectCode} $message" ); } $this->mLastModified = wfTimestamp( TS_RFC2822 ); } $this->sendCacheControl(); $wgRequest->response()->header( "Content-Type: text/html; charset=utf-8" ); if( $wgDebugRedirects ) { $url = htmlspecialchars( $this->mRedirect ); print "\n
\nLocation: $url
\n"; print "\n\n"; } else { $wgRequest->response()->header( 'Location: ' . $this->mRedirect ); } wfProfileOut( __METHOD__ ); return; } elseif ( $this->mStatusCode ) { $message = self::getStatusMessage( $this->mStatusCode ); if ( $message ) { $wgRequest->response()->header( 'HTTP/1.1 ' . $this->mStatusCode . ' ' . $message ); } } $sk = $wgUser->getSkin(); // Add base resources $this->addModules( array( 'mediawiki.legacy.wikibits' ) ); // Add various resources if required if ( $wgUseAjax ) { $this->addModules( 'mediawiki.legacy.ajax' ); wfRunHooks( 'AjaxAddScript', array( &$this ) ); if( $wgAjaxWatch && $wgUser->isLoggedIn() ) { $this->addModules( 'mediawiki.legacy.ajaxwatch' ); } if ( $wgEnableMWSuggest && !$wgUser->getOption( 'disablesuggest', false ) ) { $this->addModules( 'mediawiki.legacy.mwsuggest' ); } } if( $wgUser->getBoolOption( 'editsectiononrightclick' ) ) { $this->addModules( 'mediawiki.legacy.rightclickedit' ); } if( $wgUniversalEditButton ) { if( isset( $wgArticle ) && $this->getTitle() && $this->getTitle()->quickUserCan( 'edit' ) && ( $this->getTitle()->exists() || $this->getTitle()->quickUserCan( 'create' ) ) ) { // Original UniversalEditButton $msg = wfMsg( 'edit' ); $this->addLink( array( 'rel' => 'alternate', 'type' => 'application/x-wiki', 'title' => $msg, 'href' => $this->getTitle()->getLocalURL( 'action=edit' ) ) ); // Alternate edit link $this->addLink( array( 'rel' => 'edit', 'title' => $msg, 'href' => $this->getTitle()->getLocalURL( 'action=edit' ) ) ); } } # Buffer output; final headers may depend on later processing ob_start(); $wgRequest->response()->header( "Content-type: $wgMimeType; charset={$wgOutputEncoding}" ); $wgRequest->response()->header( 'Content-language: ' . $wgLanguageCode ); if ( $this->mArticleBodyOnly ) { $this->out( $this->mBodytext ); } else { // Hook that allows last minute changes to the output page, e.g. // adding of CSS or Javascript by extensions. wfRunHooks( 'BeforePageDisplay', array( &$this, &$sk ) ); wfProfileIn( 'Output-skin' ); $sk->outputPage( $this ); wfProfileOut( 'Output-skin' ); } $this->sendCacheControl(); ob_end_flush(); wfProfileOut( __METHOD__ ); } /** * Actually output something with print(). Performs an iconv to the * output encoding, if needed. * * @param $ins String: the string to output */ public function out( $ins ) { global $wgInputEncoding, $wgOutputEncoding, $wgContLang; if ( 0 == strcmp( $wgInputEncoding, $wgOutputEncoding ) ) { $outs = $ins; } else { $outs = $wgContLang->iconv( $wgInputEncoding, $wgOutputEncoding, $ins ); if ( false === $outs ) { $outs = $ins; } } print $outs; } /** * @todo document */ public static function setEncodings() { global $wgInputEncoding, $wgOutputEncoding; $wgInputEncoding = strtolower( $wgInputEncoding ); if ( empty( $_SERVER['HTTP_ACCEPT_CHARSET'] ) ) { $wgOutputEncoding = strtolower( $wgOutputEncoding ); return; } $wgOutputEncoding = $wgInputEncoding; } /** * @deprecated use wfReportTime() instead. * * @return String */ public function reportTime() { wfDeprecated( __METHOD__ ); $time = wfReportTime(); return $time; } /** * Produce a "user is blocked" page. * * @param $return Boolean: whether to have a "return to $wgTitle" message or not. * @return nothing */ function blockedPage( $return = true ) { global $wgUser, $wgContLang, $wgLang; $this->setPageTitle( wfMsg( 'blockedtitle' ) ); $this->setRobotPolicy( 'noindex,nofollow' ); $this->setArticleRelated( false ); $name = User::whoIs( $wgUser->blockedBy() ); $reason = $wgUser->blockedFor(); if( $reason == '' ) { $reason = wfMsg( 'blockednoreason' ); } $blockTimestamp = $wgLang->timeanddate( wfTimestamp( TS_MW, $wgUser->mBlock->mTimestamp ), true ); $ip = wfGetIP(); $link = '[[' . $wgContLang->getNsText( NS_USER ) . ":{$name}|{$name}]]"; $blockid = $wgUser->mBlock->mId; $blockExpiry = $wgUser->mBlock->mExpiry; if ( $blockExpiry == 'infinity' ) { // Entry in database (table ipblocks) is 'infinity' but 'ipboptions' uses 'infinite' or 'indefinite' // Search for localization in 'ipboptions' $scBlockExpiryOptions = wfMsg( 'ipboptions' ); foreach ( explode( ',', $scBlockExpiryOptions ) as $option ) { if ( strpos( $option, ':' ) === false ) { continue; } list( $show, $value ) = explode( ':', $option ); if ( $value == 'infinite' || $value == 'indefinite' ) { $blockExpiry = $show; break; } } } else { $blockExpiry = $wgLang->timeanddate( wfTimestamp( TS_MW, $blockExpiry ), true ); } if ( $wgUser->mBlock->mAuto ) { $msg = 'autoblockedtext'; } else { $msg = 'blockedtext'; } /* $ip returns who *is* being blocked, $intended contains who was meant to be blocked. * This could be a username, an IP range, or a single IP. */ $intended = $wgUser->mBlock->mAddress; $this->addWikiMsg( $msg, $link, $reason, $ip, $name, $blockid, $blockExpiry, $intended, $blockTimestamp ); # Don't auto-return to special pages if( $return ) { $return = $this->getTitle()->getNamespace() > -1 ? $this->getTitle() : null; $this->returnToMain( null, $return ); } } /** * Output a standard error page * * @param $title String: message key for page title * @param $msg String: message key for page text * @param $params Array: message parameters */ public function showErrorPage( $title, $msg, $params = array() ) { if ( $this->getTitle() ) { $this->mDebugtext .= 'Original title: ' . $this->getTitle()->getPrefixedText() . "\n"; } $this->setPageTitle( wfMsg( $title ) ); $this->setHTMLTitle( wfMsg( 'errorpagetitle' ) ); $this->setRobotPolicy( 'noindex,nofollow' ); $this->setArticleRelated( false ); $this->enableClientCache( false ); $this->mRedirect = ''; $this->mBodytext = ''; array_unshift( $params, 'parse' ); array_unshift( $params, $msg ); $this->addHTML( call_user_func_array( 'wfMsgExt', $params ) ); $this->returnToMain(); } /** * Output a standard permission error page * * @param $errors Array: error message keys * @param $action String: action that was denied or null if unknown */ public function showPermissionsErrorPage( $errors, $action = null ) { $this->mDebugtext .= 'Original title: ' . $this->getTitle()->getPrefixedText() . "\n"; $this->setPageTitle( wfMsg( 'permissionserrors' ) ); $this->setHTMLTitle( wfMsg( 'permissionserrors' ) ); $this->setRobotPolicy( 'noindex,nofollow' ); $this->setArticleRelated( false ); $this->enableClientCache( false ); $this->mRedirect = ''; $this->mBodytext = ''; $this->addWikiText( $this->formatPermissionsErrorMessage( $errors, $action ) ); } /** * Display an error page indicating that a given version of MediaWiki is * required to use it * * @param $version Mixed: the version of MediaWiki needed to use the page */ public function versionRequired( $version ) { $this->setPageTitle( wfMsg( 'versionrequired', $version ) ); $this->setHTMLTitle( wfMsg( 'versionrequired', $version ) ); $this->setRobotPolicy( 'noindex,nofollow' ); $this->setArticleRelated( false ); $this->mBodytext = ''; $this->addWikiMsg( 'versionrequiredtext', $version ); $this->returnToMain(); } /** * Display an error page noting that a given permission bit is required. * * @param $permission String: key required */ public function permissionRequired( $permission ) { global $wgLang; $this->setPageTitle( wfMsg( 'badaccess' ) ); $this->setHTMLTitle( wfMsg( 'errorpagetitle' ) ); $this->setRobotPolicy( 'noindex,nofollow' ); $this->setArticleRelated( false ); $this->mBodytext = ''; $groups = array_map( array( 'User', 'makeGroupLinkWiki' ), User::getGroupsWithPermission( $permission ) ); if( $groups ) { $this->addWikiMsg( 'badaccess-groups', $wgLang->commaList( $groups ), count( $groups ) ); } else { $this->addWikiMsg( 'badaccess-group0' ); } $this->returnToMain(); } /** * Produce the stock "please login to use the wiki" page */ public function loginToUse() { global $wgUser; if( $wgUser->isLoggedIn() ) { $this->permissionRequired( 'read' ); return; } $skin = $wgUser->getSkin(); $this->setPageTitle( wfMsg( 'loginreqtitle' ) ); $this->setHtmlTitle( wfMsg( 'errorpagetitle' ) ); $this->setRobotPolicy( 'noindex,nofollow' ); $this->setArticleFlag( false ); $loginTitle = SpecialPage::getTitleFor( 'Userlogin' ); $loginLink = $skin->link( $loginTitle, wfMsgHtml( 'loginreqlink' ), array(), array( 'returnto' => $this->getTitle()->getPrefixedText() ), array( 'known', 'noclasses' ) ); $this->addHTML( wfMsgWikiHtml( 'loginreqpagetext', $loginLink ) ); $this->addHTML( "\n' ); # Don't return to the main page if the user can't read it # otherwise we'll end up in a pointless loop $mainPage = Title::newMainPage(); if( $mainPage->userCanRead() ) { $this->returnToMain( null, $mainPage ); } } /** * Format a list of error messages * * @param $errors An array of arrays returned by Title::getUserPermissionsErrors * @param $action String: action that was denied or null if unknown * @return String: the wikitext error-messages, formatted into a list. */ public function formatPermissionsErrorMessage( $errors, $action = null ) { if ( $action == null ) { $text = wfMsgNoTrans( 'permissionserrorstext', count( $errors ) ) . "\n\n"; } else { $action_desc = wfMsgNoTrans( "action-$action" ); $text = wfMsgNoTrans( 'permissionserrorstext-withaction', count( $errors ), $action_desc ) . "\n\n"; } if ( count( $errors ) > 1 ) { $text .= ' '; } else { $text .= " "; } return $text; } /** * Display a page stating that the Wiki is in read-only mode, * and optionally show the source of the page that the user * was trying to edit. Should only be called (for this * purpose) after wfReadOnly() has returned true. * * For historical reasons, this function is _also_ used to * show the error message when a user tries to edit a page * they are not allowed to edit. (Unless it's because they're * blocked, then we show blockedPage() instead.) In this * case, the second parameter should be set to true and a list * of reasons supplied as the third parameter. * * @todo Needs to be split into multiple functions. * * @param $source String: source code to show (or null). * @param $protected Boolean: is this a permissions error? * @param $reasons Array: list of reasons for this error, as returned by Title::getUserPermissionsErrors(). * @param $action String: action that was denied or null if unknown */ public function readOnlyPage( $source = null, $protected = false, $reasons = array(), $action = null ) { global $wgUser; $skin = $wgUser->getSkin(); $this->setRobotPolicy( 'noindex,nofollow' ); $this->setArticleRelated( false ); // If no reason is given, just supply a default "I can't let you do // that, Dave" message. Should only occur if called by legacy code. if ( $protected && empty( $reasons ) ) { $reasons[] = array( 'badaccess-group0' ); } if ( !empty( $reasons ) ) { // Permissions error if( $source ) { $this->setPageTitle( wfMsg( 'viewsource' ) ); $this->setSubtitle( wfMsg( 'viewsourcefor', $skin->linkKnown( $this->getTitle() ) ) ); } else { $this->setPageTitle( wfMsg( 'badaccess' ) ); } $this->addWikiText( $this->formatPermissionsErrorMessage( $reasons, $action ) ); } else { // Wiki is read only $this->setPageTitle( wfMsg( 'readonly' ) ); $reason = wfReadOnlyReason(); $this->wrapWikiMsg( "{$link}
\n" ); } /** * Add a "return to" link pointing to a specified title, * or the title indicated in the request, or else the main page * * @param $unused No longer used * @param $returnto Title or String to return to * @param $returntoquery String: query string for the return to link */ public function returnToMain( $unused = null, $returnto = null, $returntoquery = null ) { global $wgRequest; if ( $returnto == null ) { $returnto = $wgRequest->getText( 'returnto' ); } if ( $returntoquery == null ) { $returntoquery = $wgRequest->getText( 'returntoquery' ); } if ( $returnto === '' ) { $returnto = Title::newMainPage(); } if ( is_object( $returnto ) ) { $titleObj = $returnto; } else { $titleObj = Title::newFromText( $returnto ); } if ( !is_object( $titleObj ) ) { $titleObj = Title::newMainPage(); } $this->addReturnTo( $titleObj, $returntoquery ); } /** * @param $sk Skin The given Skin * @param $includeStyle Boolean: unused * @return String: The doctype, opening , and head element. */ public function headElement( Skin $sk, $includeStyle = true ) { global $wgOutputEncoding, $wgMimeType; global $wgUseTrackbacks, $wgHtml5; global $wgUser, $wgRequest, $wgLang; if ( $sk->commonPrintStylesheet() ) { $this->addStyle( 'common/wikiprintable.css', 'print' ); } $sk->setupUserCss( $this ); $ret = Html::htmlHeader( array( 'lang' => wfUILang()->getCode() ) ); if ( $this->getHTMLTitle() == '' ) { $this->setHTMLTitle( wfMsg( 'pagetitle', $this->getPageTitle() ) ); } $openHead = Html::openElement( 'head' ); if ( $openHead ) { # Don't bother with the newline if $head == '' $ret .= "$openHead\n"; } if ( $wgHtml5 ) { # More succinct than , has the # same effect $ret .= Html::element( 'meta', array( 'charset' => $wgOutputEncoding ) ) . "\n"; } else { $this->addMeta( 'http:Content-Type', "$wgMimeType; charset=$wgOutputEncoding" ); } $ret .= Html::element( 'title', null, $this->getHTMLTitle() ) . "\n"; $ret .= implode( "\n", array( $this->getHeadLinks( $sk ), $this->buildCssLinks(), $this->getHeadItems(), ) ); if ( $sk->usercss ) { $ret .= Html::inlineStyle( $sk->usercss ); } if ( $wgUseTrackbacks && $this->isArticleRelated() ) { $ret .= $this->getTitle()->trackbackRDF(); } $closeHead = Html::closeElement( 'head' ); if ( $closeHead ) { $ret .= "$closeHead\n"; } $bodyAttrs = array(); # Crazy edit-on-double-click stuff $action = $wgRequest->getVal( 'action', 'view' ); if ( $this->getTitle()->getNamespace() != NS_SPECIAL && !in_array( $action, array( 'edit', 'submit' ) ) && $wgUser->getOption( 'editondblclick' ) ) { $bodyAttrs['ondblclick'] = "document.location = '" . Xml::escapeJsString( $this->getTitle()->getEditURL() ) . "'"; } # Class bloat $dir = wfUILang()->getDir(); $bodyAttrs['class'] = "mediawiki $dir"; if ( $wgLang->capitalizeAllNouns() ) { # A class is probably not the best way to do this . . . $bodyAttrs['class'] .= ' capitalize-all-nouns'; } $bodyAttrs['class'] .= ' ns-' . $this->getTitle()->getNamespace(); if ( $this->getTitle()->getNamespace() == NS_SPECIAL ) { $bodyAttrs['class'] .= ' ns-special'; } elseif ( $this->getTitle()->isTalkPage() ) { $bodyAttrs['class'] .= ' ns-talk'; } else { $bodyAttrs['class'] .= ' ns-subject'; } $bodyAttrs['class'] .= ' ' . Sanitizer::escapeClass( 'page-' . $this->getTitle()->getPrefixedText() ); $bodyAttrs['class'] .= ' skin-' . Sanitizer::escapeClass( $wgUser->getSkin()->getSkinName() ); $ret .= Html::openElement( 'body', $bodyAttrs ) . "\n"; return $ret; } static function makeResourceLoaderLink( $skin, $modules, $only ) { global $wgUser, $wgLang, $wgRequest, $wgScriptPath; // TODO: Should this be a static function of ResourceLoader instead? $query = array( 'modules' => implode( '|', array_unique( (array) $modules ) ), 'lang' => $wgLang->getCode(), 'debug' => $wgRequest->getBool( 'debug' ) && $wgRequest->getVal( 'debug' ) !== 'false', 'skin' => $wgUser->getSkin()->getSkinName(), 'only' => $only, ); // Automatically select style/script elements if ( $only === 'styles' ) { return Html::linkedStyle( wfAppendQuery( wfScript( 'load' ), $query ) ); } else { return Html::linkedScript( wfAppendQuery( wfScript( 'load' ), $query ) ); } } /** * Gets the global variables and mScripts; also adds userjs to the end if * enabled. Despite the name, these scripts are no longer put in the * but at the bottom of the * * @param $sk Skin object to use * @return String: HTML fragment */ function getHeadScripts( Skin $sk ) { global $wgUser, $wgRequest, $wgJsMimeType; global $wgUseSiteJs; // Statup - this will immediately load jquery and mediawiki modules $scripts = self::makeResourceLoaderLink( $sk, 'startup', 'scripts' ); // Configuration $scripts .= Skin::makeGlobalVariablesScript( $sk->getSkinName() ) . "\n"; // Support individual script requests in debug mode if ( $wgRequest->getBool( 'debug' ) && $wgRequest->getVal( 'debug' ) !== 'false' ) { // Scripts foreach ( $this->getModuleScripts() as $name ) { $scripts .= self::makeResourceLoaderLink( $sk, $name, 'scripts' ); } // Messages foreach ( $this->getModuleMessages() as $name ) { $scripts .= self::makeResourceLoaderLink( $sk, $name, 'messages' ); } } else { // Scripts if ( count( $this->getModuleScripts() ) ) { $scripts .= self::makeResourceLoaderLink( $sk, $this->getModuleScripts(), 'scripts' ); } // Messages if ( count( $this->getModuleMessages() ) ) { $scripts .= self::makeResourceLoaderLink( $sk, $this->getModuleMessages(), 'messages' ); } } if ( $this->getModules() ) { // Modules - let the client calculate dependencies and batch requests as it likes $modules = FormatJson::encode( $this->getModules() ); $scripts .= Html::inlineScript( "if ( mediaWiki !== undefined ) { mediaWiki.loader.load( {$modules} ); }" ); } // TODO: User Scripts should be included using the resource loader // Add user JS if enabled if( $this->isUserJsAllowed() && $wgUser->isLoggedIn() ) { $action = $wgRequest->getVal( 'action', 'view' ); if( $this->mTitle && $this->mTitle->isJsSubpage() && $sk->userCanPreview( $action ) ) { # XXX: additional security check/prompt? $this->addInlineScript( $wgRequest->getText( 'wpTextbox1' ) ); } else { $userpage = $wgUser->getUserPage(); foreach( array( 'common', $sk->getSkinName() ) as $name ) { $scriptpage = Title::makeTitleSafe( NS_USER, $userpage->getDBkey() . '/' . $name . '.js' ); if ( $scriptpage && $scriptpage->exists() && ( $scriptpage->getLength() > 0 ) ) { $userjs = $scriptpage->getLocalURL( 'action=raw&ctype=' . $wgJsMimeType ); $this->addScriptFile( $userjs, $scriptpage->getLatestRevID() ); } } } } $scripts .= "\n" . $this->mScripts; // This should be at the bottom of the body - below ALL other scripts $scripts .= Html::inlineScript( "if ( mediaWiki !== undefined ) { mediaWiki.loader.go(); }" ); // Add site JS if enabled if ( $wgUseSiteJs ) { $scripts .= self::makeResourceLoaderLink( $sk, 'sitejs', 'scripts' ); } return $scripts; } /** * Add default \ tags */ protected function addDefaultMeta() { global $wgVersion, $wgHtml5; static $called = false; if ( $called ) { # Don't run this twice return; } $called = true; if ( !$wgHtml5 ) { $this->addMeta( 'http:Content-Style-Type', 'text/css' ); // bug 15835 } $this->addMeta( 'generator', "MediaWiki $wgVersion" ); $p = "{$this->mIndexPolicy},{$this->mFollowPolicy}"; if( $p !== 'index,follow' ) { // http://www.robotstxt.org/wc/meta-user.html // Only show if it's different from the default robots policy $this->addMeta( 'robots', $p ); } if ( count( $this->mKeywords ) > 0 ) { $strip = array( "/<.*?" . ">/" => '', "/_/" => ' ' ); $this->addMeta( 'keywords', preg_replace( array_keys( $strip ), array_values( $strip ), implode( ',', $this->mKeywords ) ) ); } } /** * @return string HTML tag links to be put in the header. */ public function getHeadLinks( $sk ) { global $wgFeed, $wgRequest; // Ideally this should happen earlier, somewhere. :P $this->addDefaultMeta(); $tags = array(); foreach ( $this->mMetatags as $tag ) { if ( 0 == strcasecmp( 'http:', substr( $tag[0], 0, 5 ) ) ) { $a = 'http-equiv'; $tag[0] = substr( $tag[0], 5 ); } else { $a = 'name'; } $tags[] = Html::element( 'meta', array( $a => $tag[0], 'content' => $tag[1] ) ); } foreach ( $this->mLinktags as $tag ) { $tags[] = Html::element( 'link', $tag ); } if( $wgFeed ) { foreach( $this->getSyndicationLinks() as $format => $link ) { # Use the page name for the title (accessed through $wgTitle since # there's no other way). In principle, this could lead to issues # with having the same name for different feeds corresponding to # the same page, but we can't avoid that at this low a level. $tags[] = $this->feedLink( $format, $link, # Used messages: 'page-rss-feed' and 'page-atom-feed' (for an easier grep) wfMsg( "page-{$format}-feed", $this->getTitle()->getPrefixedText() ) ); } # Recent changes feed should appear on every page (except recentchanges, # that would be redundant). Put it after the per-page feed to avoid # changing existing behavior. It's still available, probably via a # menu in your browser. Some sites might have a different feed they'd # like to promote instead of the RC feed (maybe like a "Recent New Articles" # or "Breaking news" one). For this, we see if $wgOverrideSiteFeed is defined. # If so, use it instead. global $wgOverrideSiteFeed, $wgSitename, $wgAdvertisedFeedTypes; $rctitle = SpecialPage::getTitleFor( 'Recentchanges' ); if ( $wgOverrideSiteFeed ) { foreach ( $wgOverrideSiteFeed as $type => $feedUrl ) { $tags[] = $this->feedLink( $type, htmlspecialchars( $feedUrl ), wfMsg( "site-{$type}-feed", $wgSitename ) ); } } elseif ( $this->getTitle()->getPrefixedText() != $rctitle->getPrefixedText() ) { foreach ( $wgAdvertisedFeedTypes as $format ) { $tags[] = $this->feedLink( $format, $rctitle->getLocalURL( "feed={$format}" ), wfMsg( "site-{$format}-feed", $wgSitename ) # For grep: 'site-rss-feed', 'site-atom-feed'. ); } } } // Support individual script requests in debug mode if ( $wgRequest->getBool( 'debug' ) && $wgRequest->getVal( 'debug' ) !== 'false' ) { foreach ( $this->getModuleStyles() as $name ) { $tags[] = self::makeResourceLoaderLink( $sk, $name, 'styles' ); } } else { if ( count( $this->getModuleStyles() ) ) { $tags[] = self::makeResourceLoaderLink( $sk, $this->getModuleStyles(), 'styles' ); } } return implode( "\n", $tags ); } /** * Generate a for a feed. * * @param $type String: feed type * @param $url String: URL to the feed * @param $text String: value of the "title" attribute * @return String: HTML fragment */ private function feedLink( $type, $url, $text ) { return Html::element( 'link', array( 'rel' => 'alternate', 'type' => "application/$type+xml", 'title' => $text, 'href' => $url ) ); } /** * Add a local or specified stylesheet, with the given media options. * Meant primarily for internal use... * * @param $style String: URL to the file * @param $media String: to specify a media type, 'screen', 'printable', 'handheld' or any. * @param $condition String: for IE conditional comments, specifying an IE version * @param $dir String: set to 'rtl' or 'ltr' for direction-specific sheets */ public function addStyle( $style, $media = '', $condition = '', $dir = '' ) { $options = array(); // Even though we expect the media type to be lowercase, but here we // force it to lowercase to be safe. if( $media ) { $options['media'] = $media; } if( $condition ) { $options['condition'] = $condition; } if( $dir ) { $options['dir'] = $dir; } $this->styles[$style] = $options; } /** * Adds inline CSS styles * @param $style_css Mixed: inline CSS */ public function addInlineStyle( $style_css ){ $this->mScripts .= Html::inlineStyle( $style_css ); } /** * Build a set of s for the stylesheets specified in the $this->styles array. * These will be applied to various media & IE conditionals. */ public function buildCssLinks() { return implode( "\n", $this->buildCssLinksArray() ); } public function buildCssLinksArray() { $links = array(); foreach( $this->styles as $file => $options ) { $link = $this->styleLink( $file, $options ); if( $link ) { $links[$file] = $link; } } return $links; } /** * Generate \ tags for stylesheets * * @param $style String: URL to the file * @param $options Array: option, can contain 'condition', 'dir', 'media' * keys * @return String: HTML fragment */ protected function styleLink( $style, $options ) { if( isset( $options['dir'] ) ) { $siteDir = wfUILang()->getDir(); if( $siteDir != $options['dir'] ) { return ''; } } if( isset( $options['media'] ) ) { $media = $this->transformCssMedia( $options['media'] ); if( is_null( $media ) ) { return ''; } } else { $media = 'all'; } if( substr( $style, 0, 1 ) == '/' || substr( $style, 0, 5 ) == 'http:' || substr( $style, 0, 6 ) == 'https:' ) { $url = $style; } else { global $wgStylePath, $wgStyleVersion; $url = $wgStylePath . '/' . $style . '?' . $wgStyleVersion; } $link = Html::linkedStyle( $url, $media ); if( isset( $options['condition'] ) ) { $condition = htmlspecialchars( $options['condition'] ); $link = ""; } return $link; } /** * Transform "media" attribute based on request parameters * * @param $media String: current value of the "media" attribute * @return String: modified value of the "media" attribute */ function transformCssMedia( $media ) { global $wgRequest, $wgHandheldForIPhone; // Switch in on-screen display for media testing $switches = array( 'printable' => 'print', 'handheld' => 'handheld', ); foreach( $switches as $switch => $targetMedia ) { if( $wgRequest->getBool( $switch ) ) { if( $media == $targetMedia ) { $media = ''; } elseif( $media == 'screen' ) { return null; } } } // Expand longer media queries as iPhone doesn't grok 'handheld' if( $wgHandheldForIPhone ) { $mediaAliases = array( 'screen' => 'screen and (min-device-width: 481px)', 'handheld' => 'handheld, only screen and (max-device-width: 480px)', ); if( isset( $mediaAliases[$media] ) ) { $media = $mediaAliases[$media]; } } return $media; } /** * Turn off regular page output and return an error reponse * for when rate limiting has triggered. */ public function rateLimited() { $this->setPageTitle( wfMsg( 'actionthrottled' ) ); $this->setRobotPolicy( 'noindex,follow' ); $this->setArticleRelated( false ); $this->enableClientCache( false ); $this->mRedirect = ''; $this->clearHTML(); $this->setStatusCode( 503 ); $this->addWikiMsg( 'actionthrottledtext' ); $this->returnToMain( null, $this->getTitle() ); } /** * Show a warning about slave 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. * * @param $lag Integer: slave lag */ public function showLagWarning( $lag ) { global $wgSlaveLagWarning, $wgSlaveLagCritical, $wgLang; if( $lag >= $wgSlaveLagWarning ) { $message = $lag < $wgSlaveLagCritical ? 'lag-warn-normal' : 'lag-warn-high'; $wrap = Html::rawElement( 'div', array( 'class' => "mw-{$message}" ), "\n$1\n" ); $this->wrapWikiMsg( "$wrap\n", array( $message, $wgLang->formatNum( $lag ) ) ); } } /** * Add a wikitext-formatted message to the output. * This is equivalent to: * * $wgOut->addWikiText( wfMsgNoTrans( ... ) ) */ public function addWikiMsg( /*...*/ ) { $args = func_get_args(); $name = array_shift( $args ); $this->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. * * $options is passed through to wfMsgExt(), see that function for details. */ public function addWikiMsgArray( $name, $args, $options = array() ) { $options[] = 'parse'; $text = wfMsgExt( $name, $options, $args ); $this->addHTML( $text ); } /** * 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 either be strings, in which case they are the * message names, or arrays, in which case the first element is the message name, * and subsequent elements are the parameters to that message. * * The special named parameter 'options' in a message specification array is passed * through to the $options parameter of wfMsgExt(). * * Don't use this for messages that are not in users interface language. * * For example: * * $wgOut->wrapWikiMsg( "