MediaWiki  master
OutputPage.php
Go to the documentation of this file.
1 <?php
23 use MediaWiki\HookContainer\ProtectedHookAccessorTrait;
31 use Wikimedia\RelPath;
32 use Wikimedia\WrappedString;
33 use Wikimedia\WrappedStringList;
34 
50 class OutputPage extends ContextSource {
51  use ProtectedHookAccessorTrait;
52 
54  protected $mMetatags = [];
55 
57  protected $mLinktags = [];
58 
60  protected $mCanonicalUrl = false;
61 
65  private $mPageTitle = '';
66 
74  private $displayTitle;
75 
77  private $cacheIsFinal = false;
78 
83  public $mBodytext = '';
84 
86  private $mHTMLtitle = '';
87 
92  private $mIsArticle = false;
93 
95  private $mIsArticleRelated = true;
96 
98  private $mHasCopyright = false;
99 
104  private $mPrintable = false;
105 
110  private $mSubtitle = [];
111 
113  public $mRedirect = '';
114 
116  protected $mStatusCode;
117 
122  protected $mLastModified = '';
123 
125  protected $mCategoryLinks = [];
126 
128  protected $mCategories = [
129  'hidden' => [],
130  'normal' => [],
131  ];
132 
134  protected $mIndicators = [];
135 
137  private $mLanguageLinks = [];
138 
145  private $mScripts = '';
146 
148  protected $mInlineStyles = '';
149 
154  public $mPageLinkTitle = '';
155 
160  protected $mAdditionalHtmlClasses = [];
161 
163  protected $mHeadItems = [];
164 
166  protected $mAdditionalBodyClasses = [];
167 
169  protected $mModules = [];
170 
172  protected $mModuleStyles = [];
173 
175  protected $mResourceLoader;
176 
178  private $rlClient;
179 
182 
185 
187  protected $mJsConfigVars = [];
188 
190  protected $mTemplateIds = [];
191 
193  protected $mImageTimeKeys = [];
194 
196  public $mRedirectCode = '';
197 
198  protected $mFeedLinksAppendQuery = null;
199 
205  protected $mAllowedModules = [
206  ResourceLoaderModule::TYPE_COMBINED => ResourceLoaderModule::ORIGIN_ALL,
207  ];
208 
210  protected $mDoNothing = false;
211 
212  // Parser related.
213 
215  protected $mContainsNewMagic = 0;
216 
221  protected $mParserOptions = null;
222 
228  private $mFeedLinks = [];
229 
231  protected $mEnableClientCache = true;
232 
234  private $mArticleBodyOnly = false;
235 
237  protected $mNewSectionLink = false;
238 
240  protected $mHideNewSectionLink = false;
241 
247  public $mNoGallery = false;
248 
250  protected $mCdnMaxage = 0;
252  protected $mCdnMaxageLimit = INF;
253 
259  protected $mPreventClickjacking = true;
260 
262  private $mRevisionId = null;
263 
265  private $mRevisionTimestamp = null;
266 
268  protected $mFileVersion = null;
269 
278  protected $styles = [];
279 
280  private $mIndexPolicy = 'index';
281  private $mFollowPolicy = 'follow';
282 
288  private $mVaryHeader = [
289  'Accept-Encoding' => null,
290  ];
291 
298  private $mRedirectedFrom = null;
299 
303  private $mProperties = [];
304 
308  private $mTarget = null;
309 
313  private $mEnableTOC = false;
314 
318  private $copyrightUrl;
319 
321  private $limitReportJSData = [];
322 
324  private $contentOverrides = [];
325 
328 
332  private $mLinkHeader = [];
333 
337  private $CSP;
338 
342  private static $cacheVaryCookies = null;
343 
350  public function __construct( IContextSource $context ) {
351  $this->setContext( $context );
352  $this->CSP = new ContentSecurityPolicy(
353  $context->getRequest()->response(),
354  $context->getConfig(),
355  $this->getHookContainer()
356  );
357  }
358 
365  public function redirect( $url, $responsecode = '302' ) {
366  # Strip newlines as a paranoia check for header injection in PHP<5.1.2
367  $this->mRedirect = str_replace( "\n", '', $url );
368  $this->mRedirectCode = (string)$responsecode;
369  }
370 
376  public function getRedirect() {
377  return $this->mRedirect;
378  }
379 
388  public function setCopyrightUrl( $url ) {
389  $this->copyrightUrl = $url;
390  }
391 
397  public function setStatusCode( $statusCode ) {
398  $this->mStatusCode = $statusCode;
399  }
400 
408  public function addMeta( $name, $val ) {
409  $this->mMetatags[] = [ $name, $val ];
410  }
411 
418  public function getMetaTags() {
419  return $this->mMetatags;
420  }
421 
429  public function addLink( array $linkarr ) {
430  $this->mLinktags[] = $linkarr;
431  }
432 
439  public function getLinkTags() {
440  return $this->mLinktags;
441  }
442 
448  public function setCanonicalUrl( $url ) {
449  $this->mCanonicalUrl = $url;
450  }
451 
459  public function getCanonicalUrl() {
460  return $this->mCanonicalUrl;
461  }
462 
470  public function addScript( $script ) {
471  $this->mScripts .= $script;
472  }
473 
482  public function addScriptFile( $file, $unused = null ) {
483  $this->addScript( Html::linkedScript( $file, $this->CSP->getNonce() ) );
484  }
485 
492  public function addInlineScript( $script ) {
493  $this->mScripts .= Html::inlineScript( "\n$script\n", $this->CSP->getNonce() ) . "\n";
494  }
495 
504  protected function filterModules( array $modules, $position = null,
505  $type = ResourceLoaderModule::TYPE_COMBINED
506  ) {
507  $resourceLoader = $this->getResourceLoader();
508  $filteredModules = [];
509  foreach ( $modules as $val ) {
510  $module = $resourceLoader->getModule( $val );
511  if ( $module instanceof ResourceLoaderModule
512  && $module->getOrigin() <= $this->getAllowedModules( $type )
513  ) {
514  if ( $this->mTarget && !in_array( $this->mTarget, $module->getTargets() ) ) {
515  $this->warnModuleTargetFilter( $module->getName() );
516  continue;
517  }
518  $filteredModules[] = $val;
519  }
520  }
521  return $filteredModules;
522  }
523 
524  private function warnModuleTargetFilter( $moduleName ) {
525  static $warnings = [];
526  if ( isset( $warnings[$this->mTarget][$moduleName] ) ) {
527  return;
528  }
529  $warnings[$this->mTarget][$moduleName] = true;
530  $this->getResourceLoader()->getLogger()->debug(
531  'Module "{module}" not loadable on target "{target}".',
532  [
533  'module' => $moduleName,
534  'target' => $this->mTarget,
535  ]
536  );
537  }
538 
548  public function getModules( $filter = false, $position = null, $param = 'mModules',
549  $type = ResourceLoaderModule::TYPE_COMBINED
550  ) {
551  $modules = array_values( array_unique( $this->$param ) );
552  return $filter
553  ? $this->filterModules( $modules, null, $type )
554  : $modules;
555  }
556 
562  public function addModules( $modules ) {
563  $this->mModules = array_merge( $this->mModules, (array)$modules );
564  }
565 
573  public function getModuleStyles( $filter = false, $position = null ) {
574  return $this->getModules( $filter, null, 'mModuleStyles',
575  ResourceLoaderModule::TYPE_STYLES
576  );
577  }
578 
588  public function addModuleStyles( $modules ) {
589  $this->mModuleStyles = array_merge( $this->mModuleStyles, (array)$modules );
590  }
591 
595  public function getTarget() {
596  return $this->mTarget;
597  }
598 
604  public function setTarget( $target ) {
605  $this->mTarget = $target;
606  }
607 
615  public function addContentOverride( $target, Content $content ) {
616  if ( !$this->contentOverrides ) {
617  // Register a callback for $this->contentOverrides on the first call
618  $this->addContentOverrideCallback( function ( $target ) {
619  $key = $target->getNamespace() . ':' . $target->getDBkey();
620  return $this->contentOverrides[$key] ?? null;
621  } );
622  }
623 
624  $key = $target->getNamespace() . ':' . $target->getDBkey();
625  $this->contentOverrides[$key] = $content;
626  }
627 
635  public function addContentOverrideCallback( callable $callback ) {
636  $this->contentOverrideCallbacks[] = $callback;
637  }
638 
646  public function addHtmlClasses( $classes ) {
647  $this->mAdditionalHtmlClasses = array_merge( $this->mAdditionalHtmlClasses, (array)$classes );
648  }
649 
655  public function getHeadItemsArray() {
656  return $this->mHeadItems;
657  }
658 
671  public function addHeadItem( $name, $value ) {
672  $this->mHeadItems[$name] = $value;
673  }
674 
681  public function addHeadItems( $values ) {
682  $this->mHeadItems = array_merge( $this->mHeadItems, (array)$values );
683  }
684 
691  public function hasHeadItem( $name ) {
692  return isset( $this->mHeadItems[$name] );
693  }
694 
701  public function addBodyClasses( $classes ) {
702  $this->mAdditionalBodyClasses = array_merge( $this->mAdditionalBodyClasses, (array)$classes );
703  }
704 
712  public function setArticleBodyOnly( $only ) {
713  $this->mArticleBodyOnly = $only;
714  }
715 
721  public function getArticleBodyOnly() {
723  }
724 
732  public function setProperty( $name, $value ) {
733  $this->mProperties[$name] = $value;
734  }
735 
743  public function getProperty( $name ) {
744  return $this->mProperties[$name] ?? null;
745  }
746 
758  public function checkLastModified( $timestamp ) {
759  if ( !$timestamp || $timestamp == '19700101000000' ) {
760  wfDebug( __METHOD__ . ": CACHE DISABLED, NO TIMESTAMP" );
761  return false;
762  }
763  $config = $this->getConfig();
764  if ( !$config->get( 'CachePages' ) ) {
765  wfDebug( __METHOD__ . ": CACHE DISABLED" );
766  return false;
767  }
768 
769  $timestamp = wfTimestamp( TS_MW, $timestamp );
770  $modifiedTimes = [
771  'page' => $timestamp,
772  'user' => $this->getUser()->getTouched(),
773  'epoch' => $config->get( 'CacheEpoch' )
774  ];
775  if ( $config->get( 'UseCdn' ) ) {
776  $modifiedTimes['sepoch'] = wfTimestamp( TS_MW, $this->getCdnCacheEpoch(
777  time(),
778  $config->get( 'CdnMaxAge' )
779  ) );
780  }
781  $this->getHookRunner()->onOutputPageCheckLastModified( $modifiedTimes, $this );
782 
783  $maxModified = max( $modifiedTimes );
784  $this->mLastModified = wfTimestamp( TS_RFC2822, $maxModified );
785 
786  $clientHeader = $this->getRequest()->getHeader( 'If-Modified-Since' );
787  if ( $clientHeader === false ) {
788  wfDebug( __METHOD__ . ": client did not send If-Modified-Since header", 'private' );
789  return false;
790  }
791 
792  # IE sends sizes after the date like this:
793  # Wed, 20 Aug 2003 06:51:19 GMT; length=5202
794  # this breaks strtotime().
795  $clientHeader = preg_replace( '/;.*$/', '', $clientHeader );
796 
797  Wikimedia\suppressWarnings(); // E_STRICT system time warnings
798  $clientHeaderTime = strtotime( $clientHeader );
799  Wikimedia\restoreWarnings();
800  if ( !$clientHeaderTime ) {
801  wfDebug( __METHOD__
802  . ": unable to parse the client's If-Modified-Since header: $clientHeader" );
803  return false;
804  }
805  $clientHeaderTime = wfTimestamp( TS_MW, $clientHeaderTime );
806 
807  # Make debug info
808  $info = '';
809  foreach ( $modifiedTimes as $name => $value ) {
810  if ( $info !== '' ) {
811  $info .= ', ';
812  }
813  $info .= "$name=" . wfTimestamp( TS_ISO_8601, $value );
814  }
815 
816  wfDebug( __METHOD__ . ": client sent If-Modified-Since: " .
817  wfTimestamp( TS_ISO_8601, $clientHeaderTime ), 'private' );
818  wfDebug( __METHOD__ . ": effective Last-Modified: " .
819  wfTimestamp( TS_ISO_8601, $maxModified ), 'private' );
820  if ( $clientHeaderTime < $maxModified ) {
821  wfDebug( __METHOD__ . ": STALE, $info", 'private' );
822  return false;
823  }
824 
825  # Not modified
826  # Give a 304 Not Modified response code and disable body output
827  wfDebug( __METHOD__ . ": NOT MODIFIED, $info", 'private' );
828  ini_set( 'zlib.output_compression', 0 );
829  $this->getRequest()->response()->statusHeader( 304 );
830  $this->sendCacheControl();
831  $this->disable();
832 
833  // Don't output a compressed blob when using ob_gzhandler;
834  // it's technically against HTTP spec and seems to confuse
835  // Firefox when the response gets split over two packets.
836  wfResetOutputBuffers( false );
837 
838  return true;
839  }
840 
846  private function getCdnCacheEpoch( $reqTime, $maxAge ) {
847  // Ensure Last-Modified is never more than $wgCdnMaxAge in the past,
848  // because even if the wiki page content hasn't changed since, static
849  // resources may have changed (skin HTML, interface messages, urls, etc.)
850  // and must roll-over in a timely manner (T46570)
851  return $reqTime - $maxAge;
852  }
853 
860  public function setLastModified( $timestamp ) {
861  $this->mLastModified = wfTimestamp( TS_RFC2822, $timestamp );
862  }
863 
871  public function setRobotPolicy( $policy ) {
872  $policy = Article::formatRobotPolicy( $policy );
873 
874  if ( isset( $policy['index'] ) ) {
875  $this->setIndexPolicy( $policy['index'] );
876  }
877  if ( isset( $policy['follow'] ) ) {
878  $this->setFollowPolicy( $policy['follow'] );
879  }
880  }
881 
888  public function getRobotPolicy() {
889  return "{$this->mIndexPolicy},{$this->mFollowPolicy}";
890  }
891 
898  public function setIndexPolicy( $policy ) {
899  $policy = trim( $policy );
900  if ( in_array( $policy, [ 'index', 'noindex' ] ) ) {
901  $this->mIndexPolicy = $policy;
902  }
903  }
904 
910  public function getIndexPolicy() {
911  return $this->mIndexPolicy;
912  }
913 
920  public function setFollowPolicy( $policy ) {
921  $policy = trim( $policy );
922  if ( in_array( $policy, [ 'follow', 'nofollow' ] ) ) {
923  $this->mFollowPolicy = $policy;
924  }
925  }
926 
932  public function getFollowPolicy() {
933  return $this->mFollowPolicy;
934  }
935 
942  public function setHTMLTitle( $name ) {
943  if ( $name instanceof Message ) {
944  $this->mHTMLtitle = $name->setContext( $this->getContext() )->text();
945  } else {
946  $this->mHTMLtitle = $name;
947  }
948  }
949 
955  public function getHTMLTitle() {
956  return $this->mHTMLtitle;
957  }
958 
964  public function setRedirectedFrom( PageReference $t ) {
965  $this->mRedirectedFrom = $t;
966  }
967 
980  public function setPageTitle( $name ) {
981  if ( $name instanceof Message ) {
982  $name = $name->setContext( $this->getContext() )->text();
983  }
984 
985  # change "<script>foo&bar</script>" to "&lt;script&gt;foo&amp;bar&lt;/script&gt;"
986  # but leave "<i>foobar</i>" alone
988  $this->mPageTitle = $nameWithTags;
989 
990  # change "<i>foo&amp;bar</i>" to "foo&bar"
991  $this->setHTMLTitle(
992  $this->msg( 'pagetitle' )->plaintextParams( Sanitizer::stripAllTags( $nameWithTags ) )
993  ->inContentLanguage()
994  );
995  }
996 
1002  public function getPageTitle() {
1003  return $this->mPageTitle;
1004  }
1005 
1013  public function setDisplayTitle( $html ) {
1014  $this->displayTitle = $html;
1015  }
1016 
1025  public function getDisplayTitle() {
1026  $html = $this->displayTitle;
1027  if ( $html === null ) {
1028  $html = $this->getTitle()->getPrefixedText();
1029  }
1030 
1032  }
1033 
1040  public function getUnprefixedDisplayTitle() {
1041  $text = $this->getDisplayTitle();
1042  $nsPrefix = $this->getTitle()->getNsText() . ':';
1043  $prefix = preg_quote( $nsPrefix, '/' );
1044 
1045  return preg_replace( "/^$prefix/i", '', $text );
1046  }
1047 
1053  public function setTitle( PageReference $t ) {
1055 
1056  // @phan-suppress-next-next-line PhanUndeclaredMethod
1057  // @fixme Not all implementations of IContextSource have this method!
1058  $this->getContext()->setTitle( $t );
1059  }
1060 
1066  public function setSubtitle( $str ) {
1067  $this->clearSubtitle();
1068  $this->addSubtitle( $str );
1069  }
1070 
1076  public function addSubtitle( $str ) {
1077  if ( $str instanceof Message ) {
1078  $this->mSubtitle[] = $str->setContext( $this->getContext() )->parse();
1079  } else {
1080  $this->mSubtitle[] = $str;
1081  }
1082  }
1083 
1092  public static function buildBacklinkSubtitle( PageReference $page, $query = [] ) {
1093  if ( $page instanceof PageRecord || $page instanceof Title ) {
1094  // Callers will typically have a PageRecord
1095  if ( $page->isRedirect() ) {
1096  $query['redirect'] = 'no';
1097  }
1098  } elseif ( $page->getNamespace() !== NS_SPECIAL ) {
1099  // We don't know whether it's a redirect, so add the parameter, just to be sure.
1100  $query['redirect'] = 'no';
1101  }
1102 
1103  $target = TitleValue::castPageToLinkTarget( $page );
1104  $linkRenderer = MediaWikiServices::getInstance()->getLinkRenderer();
1105  return wfMessage( 'backlinksubtitle' )
1106  ->rawParams( $linkRenderer->makeLink( $target, null, [], $query ) );
1107  }
1108 
1115  public function addBacklinkSubtitle( PageReference $title, $query = [] ) {
1116  $this->addSubtitle( self::buildBacklinkSubtitle( $title, $query ) );
1117  }
1118 
1122  public function clearSubtitle() {
1123  $this->mSubtitle = [];
1124  }
1125 
1129  public function getSubtitle() {
1130  return implode( "<br />\n\t\t\t\t", $this->mSubtitle );
1131  }
1132 
1137  public function setPrintable() {
1138  $this->mPrintable = true;
1139  }
1140 
1146  public function isPrintable() {
1147  return $this->mPrintable;
1148  }
1149 
1153  public function disable() {
1154  $this->mDoNothing = true;
1155  }
1156 
1162  public function isDisabled() {
1163  return $this->mDoNothing;
1164  }
1165 
1171  public function showNewSectionLink() {
1172  return $this->mNewSectionLink;
1173  }
1174 
1180  public function forceHideNewSectionLink() {
1182  }
1183 
1192  public function setSyndicated( $show = true ) {
1193  if ( $show ) {
1194  $this->setFeedAppendQuery( false );
1195  } else {
1196  $this->mFeedLinks = [];
1197  }
1198  }
1199 
1206  protected function getAdvertisedFeedTypes() {
1207  if ( $this->getConfig()->get( 'Feed' ) ) {
1208  return $this->getConfig()->get( 'AdvertisedFeedTypes' );
1209  } else {
1210  return [];
1211  }
1212  }
1213 
1223  public function setFeedAppendQuery( $val ) {
1224  $this->mFeedLinks = [];
1225 
1226  foreach ( $this->getAdvertisedFeedTypes() as $type ) {
1227  $query = "feed=$type";
1228  if ( is_string( $val ) ) {
1229  $query .= '&' . $val;
1230  }
1231  $this->mFeedLinks[$type] = $this->getTitle()->getLocalURL( $query );
1232  }
1233  }
1234 
1241  public function addFeedLink( $format, $href ) {
1242  if ( in_array( $format, $this->getAdvertisedFeedTypes() ) ) {
1243  $this->mFeedLinks[$format] = $href;
1244  }
1245  }
1246 
1251  public function isSyndicated() {
1252  return count( $this->mFeedLinks ) > 0;
1253  }
1254 
1259  public function getSyndicationLinks() {
1260  return $this->mFeedLinks;
1261  }
1262 
1268  public function getFeedAppendQuery() {
1270  }
1271 
1279  public function setArticleFlag( $newVal ) {
1280  $this->mIsArticle = $newVal;
1281  if ( $newVal ) {
1282  $this->mIsArticleRelated = $newVal;
1283  }
1284  }
1285 
1292  public function isArticle() {
1293  return $this->mIsArticle;
1294  }
1295 
1302  public function setArticleRelated( $newVal ) {
1303  $this->mIsArticleRelated = $newVal;
1304  if ( !$newVal ) {
1305  $this->mIsArticle = false;
1306  }
1307  }
1308 
1314  public function isArticleRelated() {
1315  return $this->mIsArticleRelated;
1316  }
1317 
1323  public function setCopyright( $hasCopyright ) {
1324  $this->mHasCopyright = $hasCopyright;
1325  }
1326 
1336  public function showsCopyright() {
1337  return $this->isArticle() || $this->mHasCopyright;
1338  }
1339 
1346  public function addLanguageLinks( array $newLinkArray ) {
1347  $this->mLanguageLinks = array_merge( $this->mLanguageLinks, $newLinkArray );
1348  }
1349 
1356  public function setLanguageLinks( array $newLinkArray ) {
1357  $this->mLanguageLinks = $newLinkArray;
1358  }
1359 
1365  public function getLanguageLinks() {
1366  return $this->mLanguageLinks;
1367  }
1368 
1374  public function addCategoryLinks( array $categories ) {
1375  if ( !$categories ) {
1376  return;
1377  }
1378 
1379  $res = $this->addCategoryLinksToLBAndGetResult( $categories );
1380 
1381  # Set all the values to 'normal'.
1382  $categories = array_fill_keys( array_keys( $categories ), 'normal' );
1383 
1384  # Mark hidden categories
1385  foreach ( $res as $row ) {
1386  if ( isset( $row->pp_value ) ) {
1387  $categories[$row->page_title] = 'hidden';
1388  }
1389  }
1390 
1391  # Add the remaining categories to the skin
1392  if ( $this->getHookRunner()->onOutputPageMakeCategoryLinks(
1393  $this, $categories, $this->mCategoryLinks )
1394  ) {
1395  $services = MediaWikiServices::getInstance();
1396  $linkRenderer = $services->getLinkRenderer();
1397  $languageConverter = $services->getLanguageConverterFactory()
1398  ->getLanguageConverter( $services->getContentLanguage() );
1399  foreach ( $categories as $category => $type ) {
1400  // array keys will cast numeric category names to ints, so cast back to string
1401  $category = (string)$category;
1402  $origcategory = $category;
1403  $title = Title::makeTitleSafe( NS_CATEGORY, $category );
1404  if ( !$title ) {
1405  continue;
1406  }
1407  $languageConverter->findVariantLink( $category, $title, true );
1408 
1409  if ( $category != $origcategory && array_key_exists( $category, $categories ) ) {
1410  continue;
1411  }
1412  $text = $languageConverter->convertHtml( $title->getText() );
1413  $this->mCategories[$type][] = $title->getText();
1414  $this->mCategoryLinks[$type][] = $linkRenderer->makeLink( $title, new HtmlArmor( $text ) );
1415  }
1416  }
1417  }
1418 
1423  protected function addCategoryLinksToLBAndGetResult( array $categories ) {
1424  # Add the links to a LinkBatch
1425  $arr = [ NS_CATEGORY => $categories ];
1426  $linkBatchFactory = MediaWikiServices::getInstance()->getLinkBatchFactory();
1427  $lb = $linkBatchFactory->newLinkBatch();
1428  $lb->setArray( $arr );
1429 
1430  # Fetch existence plus the hiddencat property
1431  $dbr = wfGetDB( DB_REPLICA );
1432  $fields = array_merge(
1434  [ 'page_namespace', 'page_title', 'pp_value' ]
1435  );
1436 
1437  $res = $dbr->select( [ 'page', 'page_props' ],
1438  $fields,
1439  $lb->constructSet( 'page', $dbr ),
1440  __METHOD__,
1441  [],
1442  [ 'page_props' => [ 'LEFT JOIN', [
1443  'pp_propname' => 'hiddencat',
1444  'pp_page = page_id'
1445  ] ] ]
1446  );
1447 
1448  # Add the results to the link cache
1449  $linkCache = MediaWikiServices::getInstance()->getLinkCache();
1450  $lb->addResultToCache( $linkCache, $res );
1451 
1452  return $res;
1453  }
1454 
1460  public function setCategoryLinks( array $categories ) {
1461  $this->mCategoryLinks = [];
1462  $this->addCategoryLinks( $categories );
1463  }
1464 
1473  public function getCategoryLinks() {
1474  return $this->mCategoryLinks;
1475  }
1476 
1486  public function getCategories( $type = 'all' ) {
1487  if ( $type === 'all' ) {
1488  $allCategories = [];
1489  foreach ( $this->mCategories as $categories ) {
1490  $allCategories = array_merge( $allCategories, $categories );
1491  }
1492  return $allCategories;
1493  }
1494  if ( !isset( $this->mCategories[$type] ) ) {
1495  throw new InvalidArgumentException( 'Invalid category type given: ' . $type );
1496  }
1497  return $this->mCategories[$type];
1498  }
1499 
1509  public function setIndicators( array $indicators ) {
1510  $this->mIndicators = $indicators + $this->mIndicators;
1511  // Keep ordered by key
1512  ksort( $this->mIndicators );
1513  }
1514 
1523  public function getIndicators() {
1524  return $this->mIndicators;
1525  }
1526 
1535  public function addHelpLink( $to, $overrideBaseUrl = false ) {
1536  $this->addModuleStyles( 'mediawiki.helplink' );
1537  $text = $this->msg( 'helppage-top-gethelp' )->escaped();
1538 
1539  if ( $overrideBaseUrl ) {
1540  $helpUrl = $to;
1541  } else {
1542  $toUrlencoded = wfUrlencode( str_replace( ' ', '_', $to ) );
1543  $helpUrl = "https://www.mediawiki.org/wiki/Special:MyLanguage/$toUrlencoded";
1544  }
1545 
1546  $link = Html::rawElement(
1547  'a',
1548  [
1549  'href' => $helpUrl,
1550  'target' => '_blank',
1551  'class' => 'mw-helplink',
1552  ],
1553  $text
1554  );
1555 
1556  $this->setIndicators( [ 'mw-helplink' => $link ] );
1557  }
1558 
1567  public function disallowUserJs() {
1568  $this->reduceAllowedModules(
1569  ResourceLoaderModule::TYPE_SCRIPTS,
1570  ResourceLoaderModule::ORIGIN_CORE_INDIVIDUAL
1571  );
1572 
1573  // Site-wide styles are controlled by a config setting, see T73621
1574  // for background on why. User styles are never allowed.
1575  if ( $this->getConfig()->get( 'AllowSiteCSSOnRestrictedPages' ) ) {
1576  $styleOrigin = ResourceLoaderModule::ORIGIN_USER_SITEWIDE;
1577  } else {
1578  $styleOrigin = ResourceLoaderModule::ORIGIN_CORE_INDIVIDUAL;
1579  }
1580  $this->reduceAllowedModules(
1581  ResourceLoaderModule::TYPE_STYLES,
1582  $styleOrigin
1583  );
1584  }
1585 
1592  public function getAllowedModules( $type ) {
1593  if ( $type == ResourceLoaderModule::TYPE_COMBINED ) {
1594  return min( array_values( $this->mAllowedModules ) );
1595  } else {
1596  return $this->mAllowedModules[$type] ?? ResourceLoaderModule::ORIGIN_ALL;
1597  }
1598  }
1599 
1609  public function reduceAllowedModules( $type, $level ) {
1610  $this->mAllowedModules[$type] = min( $this->getAllowedModules( $type ), $level );
1611  }
1612 
1618  public function prependHTML( $text ) {
1619  $this->mBodytext = $text . $this->mBodytext;
1620  }
1621 
1627  public function addHTML( $text ) {
1628  $this->mBodytext .= $text;
1629  }
1630 
1640  public function addElement( $element, array $attribs = [], $contents = '' ) {
1641  $this->addHTML( Html::element( $element, $attribs, $contents ) );
1642  }
1643 
1647  public function clearHTML() {
1648  $this->mBodytext = '';
1649  }
1650 
1656  public function getHTML() {
1657  return $this->mBodytext;
1658  }
1659 
1666  public function parserOptions() {
1667  if ( !$this->mParserOptions ) {
1668  if ( !$this->getUser()->isSafeToLoad() ) {
1669  // Context user isn't unstubbable yet, so don't try to get a
1670  // ParserOptions for it. And don't cache this ParserOptions
1671  // either.
1673  $po->setAllowUnsafeRawHtml( false );
1674  $po->isBogus = true;
1675  return $po;
1676  }
1677 
1678  $this->mParserOptions = ParserOptions::newFromContext( $this->getContext() );
1679  $this->mParserOptions->setAllowUnsafeRawHtml( false );
1680  }
1681 
1682  return $this->mParserOptions;
1683  }
1684 
1692  public function setRevisionId( $revid ) {
1693  $val = $revid === null ? null : intval( $revid );
1694  return wfSetVar( $this->mRevisionId, $val, true );
1695  }
1696 
1702  public function getRevisionId() {
1703  return $this->mRevisionId;
1704  }
1705 
1712  public function isRevisionCurrent() {
1713  return $this->mRevisionId == 0 || $this->mRevisionId == $this->getTitle()->getLatestRevID();
1714  }
1715 
1723  public function setRevisionTimestamp( $timestamp ) {
1724  return wfSetVar( $this->mRevisionTimestamp, $timestamp, true );
1725  }
1726 
1733  public function getRevisionTimestamp() {
1735  }
1736 
1743  public function setFileVersion( $file ) {
1744  $val = null;
1745  if ( $file instanceof File && $file->exists() ) {
1746  $val = [ 'time' => $file->getTimestamp(), 'sha1' => $file->getSha1() ];
1747  }
1748  return wfSetVar( $this->mFileVersion, $val, true );
1749  }
1750 
1756  public function getFileVersion() {
1757  return $this->mFileVersion;
1758  }
1759 
1766  public function getTemplateIds() {
1767  return $this->mTemplateIds;
1768  }
1769 
1776  public function getFileSearchOptions() {
1777  return $this->mImageTimeKeys;
1778  }
1779 
1796  public function addWikiTextAsInterface(
1797  $text, $linestart = true, PageReference $title = null
1798  ) {
1799  if ( $title === null ) {
1800  $title = $this->getTitle();
1801  }
1802  if ( !$title ) {
1803  throw new MWException( 'Title is null' );
1804  }
1805  $this->addWikiTextTitleInternal( $text, $title, $linestart, /*interface*/true );
1806  }
1807 
1821  public function wrapWikiTextAsInterface(
1822  $wrapperClass, $text
1823  ) {
1824  $this->addWikiTextTitleInternal(
1825  $text, $this->getTitle(),
1826  /*linestart*/true, /*interface*/true,
1827  $wrapperClass
1828  );
1829  }
1830 
1846  public function addWikiTextAsContent(
1847  $text, $linestart = true, PageReference $title = null
1848  ) {
1849  if ( $title === null ) {
1850  $title = $this->getTitle();
1851  }
1852  if ( !$title ) {
1853  throw new MWException( 'Title is null' );
1854  }
1855  $this->addWikiTextTitleInternal( $text, $title, $linestart, /*interface*/false );
1856  }
1857 
1870  private function addWikiTextTitleInternal(
1871  $text, PageReference $title, $linestart, $interface, $wrapperClass = null
1872  ) {
1873  $parserOutput = $this->parseInternal(
1874  $text, $title, $linestart, $interface
1875  );
1876 
1877  $this->addParserOutput( $parserOutput, [
1878  'enableSectionEditLinks' => false,
1879  'wrapperDivClass' => $wrapperClass ?? '',
1880  ] );
1881  }
1882 
1891  public function addParserOutputMetadata( ParserOutput $parserOutput ) {
1892  $this->mLanguageLinks =
1893  array_merge( $this->mLanguageLinks, $parserOutput->getLanguageLinks() );
1894  $this->addCategoryLinks( $parserOutput->getCategories() );
1895  $this->setIndicators( $parserOutput->getIndicators() );
1896  $this->mNewSectionLink = $parserOutput->getNewSection();
1897  $this->mHideNewSectionLink = $parserOutput->getHideNewSection();
1898 
1899  if ( !$parserOutput->isCacheable() ) {
1900  $this->enableClientCache( false );
1901  }
1902  $this->mNoGallery = $parserOutput->getNoGallery();
1903  $this->mHeadItems = array_merge( $this->mHeadItems, $parserOutput->getHeadItems() );
1904  $this->addModules( $parserOutput->getModules() );
1905  $this->addModuleStyles( $parserOutput->getModuleStyles() );
1906  $this->addJsConfigVars( $parserOutput->getJsConfigVars() );
1907  $this->mPreventClickjacking = $this->mPreventClickjacking
1908  || $parserOutput->preventClickjacking();
1909  $scriptSrcs = $parserOutput->getExtraCSPScriptSrcs();
1910  foreach ( $scriptSrcs as $src ) {
1911  $this->getCSP()->addScriptSrc( $src );
1912  }
1913  $defaultSrcs = $parserOutput->getExtraCSPDefaultSrcs();
1914  foreach ( $defaultSrcs as $src ) {
1915  $this->getCSP()->addDefaultSrc( $src );
1916  }
1917  $styleSrcs = $parserOutput->getExtraCSPStyleSrcs();
1918  foreach ( $styleSrcs as $src ) {
1919  $this->getCSP()->addStyleSrc( $src );
1920  }
1921 
1922  // If $wgImagePreconnect is true, and if the output contains
1923  // images, give the user-agent a hint about foreign repos from
1924  // which those images may be served. See T123582.
1925  //
1926  // TODO: We don't have an easy way to know from which remote(s)
1927  // the image(s) will be served. For now, we only hint the first
1928  // valid one.
1929  if ( $this->getConfig()->get( 'ImagePreconnect' ) && count( $parserOutput->getImages() ) ) {
1930  $preconnect = [];
1931  $repoGroup = MediaWikiServices::getInstance()->getRepoGroup();
1932  $repoGroup->forEachForeignRepo( static function ( $repo ) use ( &$preconnect ) {
1933  $preconnect[] = wfParseUrl( $repo->getZoneUrl( 'thumb' ) )['host'];
1934  } );
1935  $preconnect[] = wfParseUrl( $repoGroup->getLocalRepo()->getZoneUrl( 'thumb' ) )['host'];
1936  foreach ( $preconnect as $host ) {
1937  if ( $host ) {
1938  $this->addLink( [ 'rel' => 'preconnect', 'href' => '//' . $host ] );
1939  break;
1940  }
1941  }
1942  }
1943 
1944  // Template versioning...
1945  foreach ( (array)$parserOutput->getTemplateIds() as $ns => $dbks ) {
1946  if ( isset( $this->mTemplateIds[$ns] ) ) {
1947  $this->mTemplateIds[$ns] = $dbks + $this->mTemplateIds[$ns];
1948  } else {
1949  $this->mTemplateIds[$ns] = $dbks;
1950  }
1951  }
1952  // File versioning...
1953  foreach ( (array)$parserOutput->getFileSearchOptions() as $dbk => $data ) {
1954  $this->mImageTimeKeys[$dbk] = $data;
1955  }
1956 
1957  // Hooks registered in the object
1958  $parserOutputHooks = $this->getConfig()->get( 'ParserOutputHooks' );
1959  foreach ( $parserOutput->getOutputHooks() as $hookInfo ) {
1960  list( $hookName, $data ) = $hookInfo;
1961  if ( isset( $parserOutputHooks[$hookName] ) ) {
1962  $parserOutputHooks[$hookName]( $this, $parserOutput, $data );
1963  }
1964  }
1965 
1966  // Enable OOUI if requested via ParserOutput
1967  if ( $parserOutput->getEnableOOUI() ) {
1968  $this->enableOOUI();
1969  }
1970 
1971  // Include parser limit report
1972  if ( !$this->limitReportJSData ) {
1973  $this->limitReportJSData = $parserOutput->getLimitReportJSData();
1974  }
1975 
1976  // Link flags are ignored for now, but may in the future be
1977  // used to mark individual language links.
1978  $linkFlags = [];
1979  $this->getHookRunner()->onLanguageLinks( $this->getTitle(), $this->mLanguageLinks, $linkFlags );
1980  $this->getHookRunner()->onOutputPageParserOutput( $this, $parserOutput );
1981 
1982  // This check must be after 'OutputPageParserOutput' runs in addParserOutputMetadata
1983  // so that extensions may modify ParserOutput to toggle TOC.
1984  // This cannot be moved to addParserOutputText because that is not
1985  // called by EditPage for Preview.
1986  if ( $parserOutput->getTOCHTML() ) {
1987  $this->mEnableTOC = true;
1988  }
1989  }
1990 
1999  public function addParserOutputContent( ParserOutput $parserOutput, $poOptions = [] ) {
2000  $this->addParserOutputText( $parserOutput, $poOptions );
2001 
2002  $this->addModules( $parserOutput->getModules() );
2003  $this->addModuleStyles( $parserOutput->getModuleStyles() );
2004 
2005  $this->addJsConfigVars( $parserOutput->getJsConfigVars() );
2006  }
2007 
2015  public function addParserOutputText( ParserOutput $parserOutput, $poOptions = [] ) {
2016  $text = $parserOutput->getText( $poOptions );
2017  $this->getHookRunner()->onOutputPageBeforeHTML( $this, $text );
2018  $this->addHTML( $text );
2019  }
2020 
2027  public function addParserOutput( ParserOutput $parserOutput, $poOptions = [] ) {
2028  $this->addParserOutputMetadata( $parserOutput );
2029  $this->addParserOutputText( $parserOutput, $poOptions );
2030  }
2031 
2037  public function addTemplate( &$template ) {
2038  $this->addHTML( $template->getHTML() );
2039  }
2040 
2052  public function parseAsContent( $text, $linestart = true ) {
2053  return $this->parseInternal(
2054  $text, $this->getTitle(), $linestart, /*interface*/false
2055  )->getText( [
2056  'enableSectionEditLinks' => false,
2057  'wrapperDivClass' => ''
2058  ] );
2059  }
2060 
2073  public function parseAsInterface( $text, $linestart = true ) {
2074  return $this->parseInternal(
2075  $text, $this->getTitle(), $linestart, /*interface*/true
2076  )->getText( [
2077  'enableSectionEditLinks' => false,
2078  'wrapperDivClass' => ''
2079  ] );
2080  }
2081 
2096  public function parseInlineAsInterface( $text, $linestart = true ) {
2098  $this->parseAsInterface( $text, $linestart )
2099  );
2100  }
2101 
2114  private function parseInternal( $text, $title, $linestart, $interface ) {
2115  if ( $title === null ) {
2116  throw new MWException( 'Empty $mTitle in ' . __METHOD__ );
2117  }
2118 
2119  $popts = $this->parserOptions();
2120 
2121  $oldInterface = $popts->setInterfaceMessage( (bool)$interface );
2122 
2123  $parserOutput = MediaWikiServices::getInstance()->getParser()->getFreshParser()->parse(
2124  $text, $title, $popts,
2125  $linestart, true, $this->mRevisionId
2126  );
2127 
2128  $popts->setInterfaceMessage( $oldInterface );
2129 
2130  return $parserOutput;
2131  }
2132 
2138  public function setCdnMaxage( $maxage ) {
2139  $this->mCdnMaxage = min( $maxage, $this->mCdnMaxageLimit );
2140  }
2141 
2151  public function lowerCdnMaxage( $maxage ) {
2152  $this->mCdnMaxageLimit = min( $maxage, $this->mCdnMaxageLimit );
2153  $this->setCdnMaxage( $this->mCdnMaxage );
2154  }
2155 
2168  public function adaptCdnTTL( $mtime, $minTTL = 0, $maxTTL = 0 ) {
2169  $minTTL = $minTTL ?: IExpiringStore::TTL_MINUTE;
2170  $maxTTL = $maxTTL ?: $this->getConfig()->get( 'CdnMaxAge' );
2171 
2172  if ( $mtime === null || $mtime === false ) {
2173  return; // entity does not exist
2174  }
2175 
2176  $age = MWTimestamp::time() - (int)wfTimestamp( TS_UNIX, $mtime );
2177  $adaptiveTTL = max( 0.9 * $age, $minTTL );
2178  $adaptiveTTL = min( $adaptiveTTL, $maxTTL );
2179 
2180  $this->lowerCdnMaxage( (int)$adaptiveTTL );
2181  }
2182 
2190  public function enableClientCache( $state ) {
2191  return wfSetVar( $this->mEnableClientCache, $state );
2192  }
2193 
2200  public function couldBePublicCached() {
2201  if ( !$this->cacheIsFinal ) {
2202  // - The entry point handles its own caching and/or doesn't use OutputPage.
2203  // (such as load.php, AjaxDispatcher, or MediaWiki\Rest\EntryPoint).
2204  //
2205  // - Or, we haven't finished processing the main part of the request yet
2206  // (e.g. Action::show, SpecialPage::execute), and the state may still
2207  // change via enableClientCache().
2208  return true;
2209  }
2210  // e.g. various error-type pages disable all client caching
2212  }
2213 
2223  public function considerCacheSettingsFinal() {
2224  $this->cacheIsFinal = true;
2225  }
2226 
2232  public function getCacheVaryCookies() {
2233  if ( self::$cacheVaryCookies === null ) {
2234  $config = $this->getConfig();
2235  self::$cacheVaryCookies = array_values( array_unique( array_merge(
2236  SessionManager::singleton()->getVaryCookies(),
2237  [
2238  'forceHTTPS',
2239  ],
2240  $config->get( 'CacheVaryCookies' )
2241  ) ) );
2242  $this->getHookRunner()->onGetCacheVaryCookies( $this, self::$cacheVaryCookies );
2243  }
2244  return self::$cacheVaryCookies;
2245  }
2246 
2253  public function haveCacheVaryCookies() {
2254  $request = $this->getRequest();
2255  foreach ( $this->getCacheVaryCookies() as $cookieName ) {
2256  if ( $request->getCookie( $cookieName, '', '' ) !== '' ) {
2257  wfDebug( __METHOD__ . ": found $cookieName" );
2258  return true;
2259  }
2260  }
2261  wfDebug( __METHOD__ . ": no cache-varying cookies found" );
2262  return false;
2263  }
2264 
2274  public function addVaryHeader( $header, array $option = null ) {
2275  if ( $option !== null && count( $option ) > 0 ) {
2277  'The $option parameter to addVaryHeader is ignored since MediaWiki 1.34',
2278  '1.34' );
2279  }
2280  if ( !array_key_exists( $header, $this->mVaryHeader ) ) {
2281  $this->mVaryHeader[$header] = null;
2282  }
2283  }
2284 
2291  public function getVaryHeader() {
2292  // If we vary on cookies, let's make sure it's always included here too.
2293  if ( $this->getCacheVaryCookies() ) {
2294  $this->addVaryHeader( 'Cookie' );
2295  }
2296 
2297  foreach ( SessionManager::singleton()->getVaryHeaders() as $header => $options ) {
2298  $this->addVaryHeader( $header, $options );
2299  }
2300  return 'Vary: ' . implode( ', ', array_keys( $this->mVaryHeader ) );
2301  }
2302 
2308  public function addLinkHeader( $header ) {
2309  $this->mLinkHeader[] = $header;
2310  }
2311 
2317  public function getLinkHeader() {
2318  if ( !$this->mLinkHeader ) {
2319  return false;
2320  }
2321 
2322  return 'Link: ' . implode( ',', $this->mLinkHeader );
2323  }
2324 
2332  private function addAcceptLanguage() {
2333  $title = $this->getTitle();
2334  if ( !$title instanceof Title ) {
2335  return;
2336  }
2337 
2338  $languageConverter = MediaWikiServices::getInstance()->getLanguageConverterFactory()
2339  ->getLanguageConverter( $title->getPageLanguage() );
2340  if ( !$this->getRequest()->getCheck( 'variant' ) && $languageConverter->hasVariants() ) {
2341  $this->addVaryHeader( 'Accept-Language' );
2342  }
2343  }
2344 
2355  public function preventClickjacking( $enable = true ) {
2356  $this->mPreventClickjacking = $enable;
2357  }
2358 
2364  public function allowClickjacking() {
2365  $this->mPreventClickjacking = false;
2366  }
2367 
2374  public function getPreventClickjacking() {
2376  }
2377 
2385  public function getFrameOptions() {
2386  $config = $this->getConfig();
2387  if ( $config->get( 'BreakFrames' ) ) {
2388  return 'DENY';
2389  } elseif ( $this->mPreventClickjacking && $config->get( 'EditPageFrameOptions' ) ) {
2390  return $config->get( 'EditPageFrameOptions' );
2391  }
2392  return false;
2393  }
2394 
2401  private function getOriginTrials() {
2402  $config = $this->getConfig();
2403 
2404  return $config->get( 'OriginTrials' );
2405  }
2406 
2407  private function getReportTo() {
2408  $config = $this->getConfig();
2409 
2410  $expiry = $config->get( 'ReportToExpiry' );
2411 
2412  if ( !$expiry ) {
2413  return false;
2414  }
2415 
2416  $endpoints = $config->get( 'ReportToEndpoints' );
2417 
2418  if ( !$endpoints ) {
2419  return false;
2420  }
2421 
2422  $output = [ 'max_age' => $expiry, 'endpoints' => [] ];
2423 
2424  foreach ( $endpoints as $endpoint ) {
2425  $output['endpoints'][] = [ 'url' => $endpoint ];
2426  }
2427 
2428  return json_encode( $output, JSON_UNESCAPED_SLASHES );
2429  }
2430 
2431  private function getFeaturePolicyReportOnly() {
2432  $config = $this->getConfig();
2433 
2434  $features = $config->get( 'FeaturePolicyReportOnly' );
2435  return implode( ';', $features );
2436  }
2437 
2441  public function sendCacheControl() {
2442  $response = $this->getRequest()->response();
2443  $config = $this->getConfig();
2444 
2445  $this->addVaryHeader( 'Cookie' );
2446  $this->addAcceptLanguage();
2447 
2448  # don't serve compressed data to clients who can't handle it
2449  # maintain different caches for logged-in users and non-logged in ones
2450  $response->header( $this->getVaryHeader() );
2451 
2452  if ( $this->mEnableClientCache ) {
2453  if ( !$config->get( 'UseCdn' ) ) {
2454  $privateReason = 'config';
2455  } elseif ( $response->hasCookies() ) {
2456  $privateReason = 'set-cookies';
2457  // The client might use methods other than cookies to appear logged-in.
2458  // E.g. HTTP headers, or query parameter tokens, OAuth, etc.
2459  } elseif ( SessionManager::getGlobalSession()->isPersistent() ) {
2460  $privateReason = 'session';
2461  } elseif ( $this->isPrintable() ) {
2462  $privateReason = 'printable';
2463  } elseif ( $this->mCdnMaxage == 0 ) {
2464  $privateReason = 'no-maxage';
2465  } elseif ( $this->haveCacheVaryCookies() ) {
2466  $privateReason = 'cache-vary-cookies';
2467  } else {
2468  $privateReason = false;
2469  }
2470 
2471  if ( $privateReason === false ) {
2472  # We'll purge the proxy cache for anons explicitly, but require end user agents
2473  # to revalidate against the proxy on each visit.
2474  # IMPORTANT! The CDN needs to replace the Cache-Control header with
2475  # Cache-Control: s-maxage=0, must-revalidate, max-age=0
2476  wfDebug( __METHOD__ .
2477  ": local proxy caching; {$this->mLastModified} **", 'private' );
2478  # start with a shorter timeout for initial testing
2479  # header( "Cache-Control: s-maxage=2678400, must-revalidate, max-age=0" );
2480  $response->header( "Cache-Control: " .
2481  "s-maxage={$this->mCdnMaxage}, must-revalidate, max-age=0" );
2482  } else {
2483  # We do want clients to cache if they can, but they *must* check for updates
2484  # on revisiting the page, after the max-age period.
2485  wfDebug( __METHOD__ . ": private caching ($privateReason); {$this->mLastModified} **", 'private' );
2486 
2487  if ( $response->hasCookies() || SessionManager::getGlobalSession()->isPersistent() ) {
2488  $response->header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', 0 ) . ' GMT' );
2489  $response->header( "Cache-Control: private, must-revalidate, max-age=0" );
2490  } else {
2491  $response->header(
2492  'Expires: ' . gmdate( 'D, d M Y H:i:s', time() + $config->get( 'LoggedOutMaxAge' ) ) . ' GMT'
2493  );
2494  $response->header(
2495  "Cache-Control: private, must-revalidate, max-age={$config->get( 'LoggedOutMaxAge' )}"
2496  );
2497  }
2498  }
2499  if ( $this->mLastModified ) {
2500  $response->header( "Last-Modified: {$this->mLastModified}" );
2501  }
2502  } else {
2503  wfDebug( __METHOD__ . ": no caching **", 'private' );
2504 
2505  # In general, the absence of a last modified header should be enough to prevent
2506  # the client from using its cache. We send a few other things just to make sure.
2507  $response->header( 'Expires: ' . gmdate( 'D, d M Y H:i:s', 0 ) . ' GMT' );
2508  $response->header( 'Cache-Control: no-cache, no-store, max-age=0, must-revalidate' );
2509  $response->header( 'Pragma: no-cache' );
2510  }
2511  }
2512 
2518  public function loadSkinModules( $sk ) {
2519  foreach ( $sk->getDefaultModules() as $group => $modules ) {
2520  if ( $group === 'styles' ) {
2521  foreach ( $modules as $key => $moduleMembers ) {
2522  $this->addModuleStyles( $moduleMembers );
2523  }
2524  } else {
2525  $this->addModules( $modules );
2526  }
2527  }
2528  }
2529 
2540  public function output( $return = false ) {
2541  if ( $this->mDoNothing ) {
2542  return $return ? '' : null;
2543  }
2544 
2545  $response = $this->getRequest()->response();
2546  $config = $this->getConfig();
2547 
2548  if ( $this->mRedirect != '' ) {
2549  # Standards require redirect URLs to be absolute
2550  $this->mRedirect = wfExpandUrl( $this->mRedirect, PROTO_CURRENT );
2551 
2552  $redirect = $this->mRedirect;
2553  $code = $this->mRedirectCode;
2554  $content = '';
2555 
2556  if ( $this->getHookRunner()->onBeforePageRedirect( $this, $redirect, $code ) ) {
2557  if ( $code == '301' || $code == '303' ) {
2558  if ( !$config->get( 'DebugRedirects' ) ) {
2559  $response->statusHeader( $code );
2560  }
2561  $this->mLastModified = wfTimestamp( TS_RFC2822 );
2562  }
2563  if ( $config->get( 'VaryOnXFP' ) ) {
2564  $this->addVaryHeader( 'X-Forwarded-Proto' );
2565  }
2566  $this->sendCacheControl();
2567 
2568  $response->header( "Content-Type: text/html; charset=utf-8" );
2569  if ( $config->get( 'DebugRedirects' ) ) {
2570  $url = htmlspecialchars( $redirect );
2571  $content = "<!DOCTYPE html>\n<html>\n<head>\n"
2572  . "<title>Redirect</title>\n</head>\n<body>\n"
2573  . "<p>Location: <a href=\"$url\">$url</a></p>\n"
2574  . "</body>\n</html>\n";
2575 
2576  if ( !$return ) {
2577  print $content;
2578  }
2579 
2580  } else {
2581  $response->header( 'Location: ' . $redirect );
2582  }
2583  }
2584 
2585  return $return ? $content : null;
2586  } elseif ( $this->mStatusCode ) {
2587  $response->statusHeader( $this->mStatusCode );
2588  }
2589 
2590  # Buffer output; final headers may depend on later processing
2591  ob_start();
2592 
2593  $response->header( 'Content-type: ' . $config->get( 'MimeType' ) . '; charset=UTF-8' );
2594  $response->header( 'Content-language: ' .
2595  MediaWikiServices::getInstance()->getContentLanguage()->getHtmlCode() );
2596 
2597  $linkHeader = $this->getLinkHeader();
2598  if ( $linkHeader ) {
2599  $response->header( $linkHeader );
2600  }
2601 
2602  // Prevent framing, if requested
2603  $frameOptions = $this->getFrameOptions();
2604  if ( $frameOptions ) {
2605  $response->header( "X-Frame-Options: $frameOptions" );
2606  }
2607 
2608  $originTrials = $this->getOriginTrials();
2609  foreach ( $originTrials as $originTrial ) {
2610  $response->header( "Origin-Trial: $originTrial", false );
2611  }
2612 
2613  $reportTo = $this->getReportTo();
2614  if ( $reportTo ) {
2615  $response->header( "Report-To: $reportTo" );
2616  }
2617 
2618  $featurePolicyReportOnly = $this->getFeaturePolicyReportOnly();
2619  if ( $featurePolicyReportOnly ) {
2620  $response->header( "Feature-Policy-Report-Only: $featurePolicyReportOnly" );
2621  }
2622 
2623  if ( $this->mArticleBodyOnly ) {
2624  $this->CSP->sendHeaders();
2625  echo $this->mBodytext;
2626  } else {
2627  // Enable safe mode if requested (T152169)
2628  if ( $this->getRequest()->getBool( 'safemode' ) ) {
2629  $this->disallowUserJs();
2630  }
2631 
2632  $sk = $this->getSkin();
2633  $this->loadSkinModules( $sk );
2634 
2635  MWDebug::addModules( $this );
2636 
2637  // Hook that allows last minute changes to the output page, e.g.
2638  // adding of CSS or Javascript by extensions, adding CSP sources.
2639  $this->getHookRunner()->onBeforePageDisplay( $this, $sk );
2640 
2641  $this->CSP->sendHeaders();
2642 
2643  try {
2644  $sk->outputPage();
2645  } catch ( Exception $e ) {
2646  ob_end_clean(); // bug T129657
2647  throw $e;
2648  }
2649  }
2650 
2651  try {
2652  // This hook allows last minute changes to final overall output by modifying output buffer
2653  $this->getHookRunner()->onAfterFinalPageOutput( $this );
2654  } catch ( Exception $e ) {
2655  ob_end_clean(); // bug T129657
2656  throw $e;
2657  }
2658 
2659  $this->sendCacheControl();
2660 
2661  if ( $return ) {
2662  return ob_get_clean();
2663  } else {
2664  ob_end_flush();
2665  return null;
2666  }
2667  }
2668 
2679  public function prepareErrorPage( $pageTitle, $htmlTitle = false ) {
2680  $this->setPageTitle( $pageTitle );
2681  if ( $htmlTitle !== false ) {
2682  $this->setHTMLTitle( $htmlTitle );
2683  }
2684  $this->setRobotPolicy( 'noindex,nofollow' );
2685  $this->setArticleRelated( false );
2686  $this->enableClientCache( false );
2687  $this->mRedirect = '';
2688  $this->clearSubtitle();
2689  $this->clearHTML();
2690  }
2691 
2704  public function showErrorPage( $title, $msg, $params = [] ) {
2705  if ( !$title instanceof Message ) {
2706  $title = $this->msg( $title );
2707  }
2708 
2709  $this->prepareErrorPage( $title );
2710 
2711  if ( $msg instanceof Message ) {
2712  if ( $params !== [] ) {
2713  trigger_error( 'Argument ignored: $params. The message parameters argument '
2714  . 'is discarded when the $msg argument is a Message object instead of '
2715  . 'a string.', E_USER_NOTICE );
2716  }
2717  $this->addHTML( $msg->parseAsBlock() );
2718  } else {
2719  $this->addWikiMsgArray( $msg, $params );
2720  }
2721 
2722  $this->returnToMain();
2723  }
2724 
2731  public function showPermissionsErrorPage( array $errors, $action = null ) {
2732  $services = MediaWikiServices::getInstance();
2733  $permissionManager = $services->getPermissionManager();
2734  foreach ( $errors as $key => $error ) {
2735  $errors[$key] = (array)$error;
2736  }
2737 
2738  // For some action (read, edit, create and upload), display a "login to do this action"
2739  // error if all of the following conditions are met:
2740  // 1. the user is not logged in
2741  // 2. the only error is insufficient permissions (i.e. no block or something else)
2742  // 3. the error can be avoided simply by logging in
2743 
2744  if ( in_array( $action, [ 'read', 'edit', 'createpage', 'createtalk', 'upload' ] )
2745  && $this->getUser()->isAnon() && count( $errors ) == 1 && isset( $errors[0][0] )
2746  && ( $errors[0][0] == 'badaccess-groups' || $errors[0][0] == 'badaccess-group0' )
2747  && ( $permissionManager->groupHasPermission( 'user', $action )
2748  || $permissionManager->groupHasPermission( 'autoconfirmed', $action ) )
2749  ) {
2750  $displayReturnto = null;
2751 
2752  # Due to T34276, if a user does not have read permissions,
2753  # $this->getTitle() will just give Special:Badtitle, which is
2754  # not especially useful as a returnto parameter. Use the title
2755  # from the request instead, if there was one.
2756  $request = $this->getRequest();
2757  $returnto = Title::newFromText( $request->getVal( 'title', '' ) );
2758  if ( $action == 'edit' ) {
2759  $msg = 'whitelistedittext';
2760  $displayReturnto = $returnto;
2761  } elseif ( $action == 'createpage' || $action == 'createtalk' ) {
2762  $msg = 'nocreatetext';
2763  } elseif ( $action == 'upload' ) {
2764  $msg = 'uploadnologintext';
2765  } else { # Read
2766  $msg = 'loginreqpagetext';
2767  $displayReturnto = Title::newMainPage();
2768  }
2769 
2770  $query = [];
2771 
2772  if ( $returnto ) {
2773  $query['returnto'] = $returnto->getPrefixedText();
2774 
2775  if ( !$request->wasPosted() ) {
2776  $returntoquery = $request->getValues();
2777  unset( $returntoquery['title'] );
2778  unset( $returntoquery['returnto'] );
2779  unset( $returntoquery['returntoquery'] );
2780  $query['returntoquery'] = wfArrayToCgi( $returntoquery );
2781  }
2782  }
2783 
2784  $title = SpecialPage::getTitleFor( 'Userlogin' );
2785  $linkRenderer = $services->getLinkRenderer();
2786  $loginUrl = $title->getLinkURL( $query, false, PROTO_RELATIVE );
2787  $loginLink = $linkRenderer->makeKnownLink(
2788  $title,
2789  $this->msg( 'loginreqlink' )->text(),
2790  [],
2791  $query
2792  );
2793 
2794  $this->prepareErrorPage( $this->msg( 'loginreqtitle' ) );
2795  $this->addHTML( $this->msg( $msg )->rawParams( $loginLink )->params( $loginUrl )->parse() );
2796 
2797  # Don't return to a page the user can't read otherwise
2798  # we'll end up in a pointless loop
2799  if ( $displayReturnto && $this->getAuthority()->probablyCan( 'read', $displayReturnto ) ) {
2800  $this->returnToMain( null, $displayReturnto );
2801  }
2802  } else {
2803  $this->prepareErrorPage( $this->msg( 'permissionserrors' ) );
2804  $this->addWikiTextAsInterface( $this->formatPermissionsErrorMessage( $errors, $action ) );
2805  }
2806  }
2807 
2814  public function versionRequired( $version ) {
2815  $this->prepareErrorPage( $this->msg( 'versionrequired', $version ) );
2816 
2817  $this->addWikiMsg( 'versionrequiredtext', $version );
2818  $this->returnToMain();
2819  }
2820 
2828  public function formatPermissionStatus( PermissionStatus $status, string $action = null ): string {
2829  if ( $status->isGood() ) {
2830  return '';
2831  }
2832  return $this->formatPermissionsErrorMessage( $status->toLegacyErrorArray(), $action );
2833  }
2834 
2843  public function formatPermissionsErrorMessage( array $errors, $action = null ) {
2844  if ( $action == null ) {
2845  $text = $this->msg( 'permissionserrorstext', count( $errors ) )->plain() . "\n\n";
2846  } else {
2847  $action_desc = $this->msg( "action-$action" )->plain();
2848  $text = $this->msg(
2849  'permissionserrorstext-withaction',
2850  count( $errors ),
2851  $action_desc
2852  )->plain() . "\n\n";
2853  }
2854 
2855  if ( count( $errors ) > 1 ) {
2856  $text .= '<ul class="permissions-errors">' . "\n";
2857 
2858  foreach ( $errors as $error ) {
2859  $text .= '<li>';
2860  $text .= $this->msg( ...$error )->plain();
2861  $text .= "</li>\n";
2862  }
2863  $text .= '</ul>';
2864  } else {
2865  $text .= "<div class=\"permissions-errors\">\n" .
2866  $this->msg( ...reset( $errors ) )->plain() .
2867  "\n</div>";
2868  }
2869 
2870  return $text;
2871  }
2872 
2882  public function showLagWarning( $lag ) {
2883  $config = $this->getConfig();
2884  if ( $lag >= $config->get( 'DatabaseReplicaLagWarning' ) ) {
2885  $lag = floor( $lag ); // floor to avoid nano seconds to display
2886  $message = $lag < $config->get( 'DatabaseReplicaLagCritical' )
2887  ? 'lag-warn-normal'
2888  : 'lag-warn-high';
2889  // For grep: mw-lag-warn-normal, mw-lag-warn-high
2890  $wrap = Html::rawElement( 'div', [ 'class' => "mw-{$message}" ], "\n$1\n" );
2891  $this->wrapWikiMsg( "$wrap\n", [ $message, $this->getLanguage()->formatNum( $lag ) ] );
2892  }
2893  }
2894 
2901  public function showFatalError( $message ) {
2902  $this->prepareErrorPage( $this->msg( 'internalerror' ) );
2903 
2904  $this->addHTML( $message );
2905  }
2906 
2915  public function addReturnTo( $title, array $query = [], $text = null, $options = [] ) {
2916  $linkRenderer = MediaWikiServices::getInstance()
2917  ->getLinkRendererFactory()->createFromLegacyOptions( $options );
2918  $link = $this->msg( 'returnto' )->rawParams(
2919  $linkRenderer->makeLink( $title, $text, [], $query ) )->escaped();
2920  $this->addHTML( "<p id=\"mw-returnto\">{$link}</p>\n" );
2921  }
2922 
2931  public function returnToMain( $unused = null, $returnto = null, $returntoquery = null ) {
2932  if ( $returnto == null ) {
2933  $returnto = $this->getRequest()->getText( 'returnto' );
2934  }
2935 
2936  if ( $returntoquery == null ) {
2937  $returntoquery = $this->getRequest()->getText( 'returntoquery' );
2938  }
2939 
2940  if ( $returnto === '' ) {
2941  $returnto = Title::newMainPage();
2942  }
2943 
2944  if ( is_object( $returnto ) ) {
2945  $linkTarget = TitleValue::castPageToLinkTarget( $returnto );
2946  } else {
2947  $linkTarget = Title::newFromText( $returnto );
2948  }
2949 
2950  // We don't want people to return to external interwiki. That
2951  // might potentially be used as part of a phishing scheme
2952  if ( !is_object( $linkTarget ) || $linkTarget->isExternal() ) {
2953  $linkTarget = Title::newMainPage();
2954  }
2955 
2956  $this->addReturnTo( $linkTarget, wfCgiToArray( $returntoquery ) );
2957  }
2958 
2959  private function getRlClientContext() {
2960  if ( !$this->rlClientContext ) {
2962  [], // modules; not relevant
2963  $this->getLanguage()->getCode(),
2964  $this->getSkin()->getSkinName(),
2965  $this->getUser()->isRegistered() ? $this->getUser()->getName() : null,
2966  null, // version; not relevant
2968  null, // only; not relevant
2969  $this->isPrintable(),
2970  $this->getRequest()->getBool( 'handheld' )
2971  );
2972  $this->rlClientContext = new ResourceLoaderContext(
2973  $this->getResourceLoader(),
2974  new FauxRequest( $query )
2975  );
2976  if ( $this->contentOverrideCallbacks ) {
2977  $this->rlClientContext = new DerivativeResourceLoaderContext( $this->rlClientContext );
2978  $this->rlClientContext->setContentOverrideCallback( function ( $title ) {
2979  foreach ( $this->contentOverrideCallbacks as $callback ) {
2980  $content = $callback( $title );
2981  if ( $content !== null ) {
2983  if ( strpos( $text, '</script>' ) !== false ) {
2984  // Proactively replace this so that we can display a message
2985  // to the user, instead of letting it go to Html::inlineScript(),
2986  // where it would be considered a server-side issue.
2988  Xml::encodeJsCall( 'mw.log.error', [
2989  "Cannot preview $title due to script-closing tag."
2990  ] )
2991  );
2992  }
2993  return $content;
2994  }
2995  }
2996  return null;
2997  } );
2998  }
2999  }
3000  return $this->rlClientContext;
3001  }
3002 
3014  public function getRlClient() {
3015  if ( !$this->rlClient ) {
3016  $context = $this->getRlClientContext();
3017  $rl = $this->getResourceLoader();
3018  $this->addModules( [
3019  'user',
3020  'user.options',
3021  ] );
3022  $this->addModuleStyles( [
3023  'site.styles',
3024  'noscript',
3025  'user.styles',
3026  ] );
3027  $this->getSkin()->doSetupSkinUserCss( $this );
3028 
3029  // Prepare exempt modules for buildExemptModules()
3030  $exemptGroups = [ 'site' => [], 'noscript' => [], 'private' => [], 'user' => [] ];
3031  $exemptStates = [];
3032  $moduleStyles = $this->getModuleStyles( /*filter*/ true );
3033 
3034  // Preload getTitleInfo for isKnownEmpty calls below and in ResourceLoaderClientHtml
3035  // Separate user-specific batch for improved cache-hit ratio.
3036  $userBatch = [ 'user.styles', 'user' ];
3037  $siteBatch = array_diff( $moduleStyles, $userBatch );
3038  $dbr = wfGetDB( DB_REPLICA );
3041 
3042  // Filter out modules handled by buildExemptModules()
3043  $moduleStyles = array_filter( $moduleStyles,
3044  static function ( $name ) use ( $rl, $context, &$exemptGroups, &$exemptStates ) {
3045  $module = $rl->getModule( $name );
3046  if ( $module ) {
3047  $group = $module->getGroup();
3048  if ( isset( $exemptGroups[$group] ) ) {
3049  $exemptStates[$name] = 'ready';
3050  if ( !$module->isKnownEmpty( $context ) ) {
3051  // E.g. Don't output empty <styles>
3052  $exemptGroups[$group][] = $name;
3053  }
3054  return false;
3055  }
3056  }
3057  return true;
3058  }
3059  );
3060  $this->rlExemptStyleModules = $exemptGroups;
3061 
3063  'target' => $this->getTarget(),
3064  'nonce' => $this->CSP->getNonce(),
3065  // When 'safemode', disallowUserJs(), or reduceAllowedModules() is used
3066  // to only restrict modules to ORIGIN_CORE (ie. disallow ORIGIN_USER), the list of
3067  // modules enqueud for loading on this page is filtered to just those.
3068  // However, to make sure we also apply the restriction to dynamic dependencies and
3069  // lazy-loaded modules at run-time on the client-side, pass 'safemode' down to the
3070  // StartupModule so that the client-side registry will not contain any restricted
3071  // modules either. (T152169, T185303)
3072  'safemode' => ( $this->getAllowedModules( ResourceLoaderModule::TYPE_COMBINED )
3073  <= ResourceLoaderModule::ORIGIN_CORE_INDIVIDUAL
3074  ) ? '1' : null,
3075  ] );
3076  $rlClient->setConfig( $this->getJSVars() );
3077  $rlClient->setModules( $this->getModules( /*filter*/ true ) );
3078  $rlClient->setModuleStyles( $moduleStyles );
3079  $rlClient->setExemptStates( $exemptStates );
3080  $this->rlClient = $rlClient;
3081  }
3082  return $this->rlClient;
3083  }
3084 
3090  public function headElement( Skin $sk, $includeStyle = true ) {
3091  $config = $this->getConfig();
3092  $userdir = $this->getLanguage()->getDir();
3093  $services = MediaWikiServices::getInstance();
3094  $sitedir = $services->getContentLanguage()->getDir();
3095 
3096  $pieces = [];
3098  $this->getRlClient()->getDocumentAttributes(),
3100  ), [ 'class' => implode( ' ', $this->mAdditionalHtmlClasses ) ] );
3101  $pieces[] = Html::htmlHeader( $htmlAttribs );
3102  $pieces[] = Html::openElement( 'head' );
3103 
3104  if ( $this->getHTMLTitle() == '' ) {
3105  $this->setHTMLTitle( $this->msg( 'pagetitle', $this->getPageTitle() )->inContentLanguage() );
3106  }
3107 
3108  if ( !Html::isXmlMimeType( $config->get( 'MimeType' ) ) ) {
3109  // Add <meta charset="UTF-8">
3110  // This should be before <title> since it defines the charset used by
3111  // text including the text inside <title>.
3112  // The spec recommends defining XHTML5's charset using the XML declaration
3113  // instead of meta.
3114  // Our XML declaration is output by Html::htmlHeader.
3115  // https://html.spec.whatwg.org/multipage/semantics.html#attr-meta-http-equiv-content-type
3116  // https://html.spec.whatwg.org/multipage/semantics.html#charset
3117  $pieces[] = Html::element( 'meta', [ 'charset' => 'UTF-8' ] );
3118  }
3119 
3120  $pieces[] = Html::element( 'title', null, $this->getHTMLTitle() );
3121  $pieces[] = $this->getRlClient()->getHeadHtml( $htmlAttribs['class'] ?? null );
3122  $pieces[] = $this->buildExemptModules();
3123  $pieces = array_merge( $pieces, array_values( $this->getHeadLinksArray() ) );
3124  $pieces = array_merge( $pieces, array_values( $this->mHeadItems ) );
3125 
3126  $pieces[] = Html::closeElement( 'head' );
3127 
3128  $bodyClasses = $this->mAdditionalBodyClasses;
3129  $bodyClasses[] = 'mediawiki';
3130 
3131  # Classes for LTR/RTL directionality support
3132  $bodyClasses[] = $userdir;
3133  $bodyClasses[] = "sitedir-$sitedir";
3134 
3135  $underline = $services->getUserOptionsLookup()->getOption( $this->getUser(), 'underline' );
3136  if ( $underline < 2 ) {
3137  // The following classes can be used here:
3138  // * mw-underline-always
3139  // * mw-underline-never
3140  $bodyClasses[] = 'mw-underline-' . ( $underline ? 'always' : 'never' );
3141  }
3142 
3143  if ( $this->getLanguage()->capitalizeAllNouns() ) {
3144  # A <body> class is probably not the best way to do this . . .
3145  $bodyClasses[] = 'capitalize-all-nouns';
3146  }
3147 
3148  // Parser feature migration class
3149  // The idea is that this will eventually be removed, after the wikitext
3150  // which requires it is cleaned up.
3151  $bodyClasses[] = 'mw-hide-empty-elt';
3152 
3153  $bodyClasses[] = $sk->getPageClasses( $this->getTitle() );
3154  $bodyClasses[] = 'skin-' . Sanitizer::escapeClass( $sk->getSkinName() );
3155  $bodyClasses[] =
3156  'action-' . Sanitizer::escapeClass( Action::getActionName( $this->getContext() ) );
3157 
3158  if ( $sk->isResponsive() ) {
3159  $bodyClasses[] = 'skin--responsive';
3160  }
3161 
3162  $bodyAttrs = [];
3163  // While the implode() is not strictly needed, it's used for backwards compatibility
3164  // (this used to be built as a string and hooks likely still expect that).
3165  $bodyAttrs['class'] = implode( ' ', $bodyClasses );
3166 
3167  // Allow skins and extensions to add body attributes they need
3168  // Get ones from deprecated method
3169  if ( method_exists( $sk, 'addToBodyAttributes' ) ) {
3171  $sk->addToBodyAttributes( $this, $bodyAttrs );
3172  wfDeprecated( 'Skin::addToBodyAttributes method to add body attributes', '1.35' );
3173  }
3174 
3175  // Then run the hook, the recommended way of adding body attributes now
3176  $this->getHookRunner()->onOutputPageBodyAttributes( $this, $sk, $bodyAttrs );
3177 
3178  $pieces[] = Html::openElement( 'body', $bodyAttrs );
3179 
3180  return self::combineWrappedStrings( $pieces );
3181  }
3182 
3188  public function getResourceLoader() {
3189  if ( $this->mResourceLoader === null ) {
3190  // Lazy-initialise as needed
3191  $this->mResourceLoader = MediaWikiServices::getInstance()->getResourceLoader();
3192  }
3193  return $this->mResourceLoader;
3194  }
3195 
3204  public function makeResourceLoaderLink( $modules, $only, array $extraQuery = [] ) {
3205  // Apply 'target' and 'origin' filters
3206  $modules = $this->filterModules( (array)$modules, null, $only );
3207 
3209  $this->getRlClientContext(),
3210  $modules,
3211  $only,
3212  $extraQuery,
3213  $this->CSP->getNonce()
3214  );
3215  }
3216 
3223  protected static function combineWrappedStrings( array $chunks ) {
3224  // Filter out empty values
3225  $chunks = array_filter( $chunks, 'strlen' );
3226  return WrappedString::join( "\n", $chunks );
3227  }
3228 
3235  public function getBottomScripts() {
3236  $chunks = [];
3237  $chunks[] = $this->getRlClient()->getBodyHtml();
3238 
3239  // Legacy non-ResourceLoader scripts
3240  $chunks[] = $this->mScripts;
3241 
3242  if ( $this->limitReportJSData ) {
3245  [ 'wgPageParseReport' => $this->limitReportJSData ]
3246  ),
3247  $this->CSP->getNonce()
3248  );
3249  }
3250 
3251  return self::combineWrappedStrings( $chunks );
3252  }
3253 
3260  public function getJsConfigVars() {
3261  return $this->mJsConfigVars;
3262  }
3263 
3270  public function addJsConfigVars( $keys, $value = null ) {
3271  if ( is_array( $keys ) ) {
3272  foreach ( $keys as $key => $value ) {
3273  $this->mJsConfigVars[$key] = $value;
3274  }
3275  return;
3276  }
3277 
3278  $this->mJsConfigVars[$keys] = $value;
3279  }
3280 
3290  public function getJSVars() {
3291  $curRevisionId = 0;
3292  $articleId = 0;
3293  $canonicalSpecialPageName = false; # T23115
3294  $services = MediaWikiServices::getInstance();
3295 
3296  $title = $this->getTitle();
3297  $ns = $title->getNamespace();
3298  $nsInfo = $services->getNamespaceInfo();
3299  $canonicalNamespace = $nsInfo->exists( $ns )
3300  ? $nsInfo->getCanonicalName( $ns )
3301  : $title->getNsText();
3302 
3303  $sk = $this->getSkin();
3304  // Get the relevant title so that AJAX features can use the correct page name
3305  // when making API requests from certain special pages (T36972).
3306  $relevantTitle = $sk->getRelevantTitle();
3307 
3308  if ( $ns === NS_SPECIAL ) {
3309  list( $canonicalSpecialPageName, /*...*/ ) =
3310  $services->getSpecialPageFactory()->
3311  resolveAlias( $title->getDBkey() );
3312  } elseif ( $this->canUseWikiPage() ) {
3313  $wikiPage = $this->getWikiPage();
3314  $curRevisionId = $wikiPage->getLatest();
3315  $articleId = $wikiPage->getId();
3316  }
3317 
3318  $lang = $title->getPageViewLanguage();
3319 
3320  // Pre-process information
3321  $separatorTransTable = $lang->separatorTransformTable();
3322  $separatorTransTable = $separatorTransTable ?: [];
3323  $compactSeparatorTransTable = [
3324  implode( "\t", array_keys( $separatorTransTable ) ),
3325  implode( "\t", $separatorTransTable ),
3326  ];
3327  $digitTransTable = $lang->digitTransformTable();
3328  $digitTransTable = $digitTransTable ?: [];
3329  $compactDigitTransTable = [
3330  implode( "\t", array_keys( $digitTransTable ) ),
3331  implode( "\t", $digitTransTable ),
3332  ];
3333 
3334  $user = $this->getUser();
3335 
3336  // Internal variables for MediaWiki core
3337  $vars = [
3338  // @internal For mediawiki.page.ready
3339  'wgBreakFrames' => $this->getFrameOptions() == 'DENY',
3340 
3341  // @internal For jquery.tablesorter
3342  'wgSeparatorTransformTable' => $compactSeparatorTransTable,
3343  'wgDigitTransformTable' => $compactDigitTransTable,
3344  'wgDefaultDateFormat' => $lang->getDefaultDateFormat(),
3345  'wgMonthNames' => $lang->getMonthNamesArray(),
3346 
3347  // @internal For debugging purposes
3348  'wgRequestId' => WebRequest::getRequestId(),
3349 
3350  // @internal For mw.loader
3351  'wgCSPNonce' => $this->CSP->getNonce(),
3352  ];
3353 
3354  // Start of supported and stable config vars (for use by extensions/gadgets).
3355  $vars += [
3356  'wgCanonicalNamespace' => $canonicalNamespace,
3357  'wgCanonicalSpecialPageName' => $canonicalSpecialPageName,
3358  'wgNamespaceNumber' => $title->getNamespace(),
3359  'wgPageName' => $title->getPrefixedDBkey(),
3360  'wgTitle' => $title->getText(),
3361  'wgCurRevisionId' => $curRevisionId,
3362  'wgRevisionId' => (int)$this->getRevisionId(),
3363  'wgArticleId' => $articleId,
3364  'wgIsArticle' => $this->isArticle(),
3365  'wgIsRedirect' => $title->isRedirect(),
3366  'wgAction' => Action::getActionName( $this->getContext() ),
3367  'wgUserName' => $user->isAnon() ? null : $user->getName(),
3368  'wgUserGroups' => $services->getUserGroupManager()->getUserEffectiveGroups( $user ),
3369  'wgCategories' => $this->getCategories(),
3370  'wgPageContentLanguage' => $lang->getCode(),
3371  'wgPageContentModel' => $title->getContentModel(),
3372  'wgRelevantPageName' => $relevantTitle->getPrefixedDBkey(),
3373  'wgRelevantArticleId' => $relevantTitle->getArticleID(),
3374  ];
3375  if ( $user->isRegistered() ) {
3376  $vars['wgUserId'] = $user->getId();
3377  $vars['wgUserEditCount'] = $user->getEditCount();
3378  $userReg = $user->getRegistration();
3379  $vars['wgUserRegistration'] = $userReg ? (int)wfTimestamp( TS_UNIX, $userReg ) * 1000 : null;
3380  // Get the revision ID of the oldest new message on the user's talk
3381  // page. This can be used for constructing new message alerts on
3382  // the client side.
3383  $userNewMsgRevId = $this->getLastSeenUserTalkRevId();
3384  // Only occupy precious space in the <head> when it is non-null (T53640)
3385  // mw.config.get returns null by default.
3386  if ( $userNewMsgRevId ) {
3387  $vars['wgUserNewMsgRevisionId'] = $userNewMsgRevId;
3388  }
3389  }
3390  $languageConverter = $services->getLanguageConverterFactory()
3391  ->getLanguageConverter( $services->getContentLanguage() );
3392  if ( $languageConverter->hasVariants() ) {
3393  $vars['wgUserVariant'] = $languageConverter->getPreferredVariant();
3394  }
3395  // Same test as SkinTemplate
3396  $vars['wgIsProbablyEditable'] = $this->getAuthority()->probablyCan( 'edit', $title );
3397  $vars['wgRelevantPageIsProbablyEditable'] = $relevantTitle &&
3398  $this->getAuthority()->probablyCan( 'edit', $relevantTitle );
3399  foreach ( $title->getRestrictionTypes() as $type ) {
3400  // Following keys are set in $vars:
3401  // wgRestrictionCreate, wgRestrictionEdit, wgRestrictionMove, wgRestrictionUpload
3402  $vars['wgRestriction' . ucfirst( $type )] = $title->getRestrictions( $type );
3403  }
3404  if ( $title->isMainPage() ) {
3405  $vars['wgIsMainPage'] = true;
3406  }
3407 
3408  $relevantUser = $sk->getRelevantUser();
3409  if ( $relevantUser ) {
3410  $vars['wgRelevantUserName'] = $relevantUser->getName();
3411  }
3412  // End of stable config vars
3413 
3414  $titleFormatter = $services->getTitleFormatter();
3415 
3416  if ( $this->mRedirectedFrom ) {
3417  // @internal For skin JS
3418  $vars['wgRedirectedFrom'] = $titleFormatter->getPrefixedDBkey( $this->mRedirectedFrom );
3419  }
3420 
3421  // Allow extensions to add their custom variables to the mw.config map.
3422  // Use the 'ResourceLoaderGetConfigVars' hook if the variable is not
3423  // page-dependent but site-wide (without state).
3424  // Alternatively, you may want to use OutputPage->addJsConfigVars() instead.
3425  $this->getHookRunner()->onMakeGlobalVariablesScript( $vars, $this );
3426 
3427  // Merge in variables from addJsConfigVars last
3428  return array_merge( $vars, $this->getJsConfigVars() );
3429  }
3430 
3436  private function getLastSeenUserTalkRevId() {
3437  $services = MediaWikiServices::getInstance();
3438  $user = $this->getUser();
3439  $userHasNewMessages = $services
3440  ->getTalkPageNotificationManager()
3441  ->userHasNewMessages( $user );
3442  if ( !$userHasNewMessages ) {
3443  return null;
3444  }
3445 
3446  $timestamp = $services
3447  ->getTalkPageNotificationManager()
3448  ->getLatestSeenMessageTimestamp( $user );
3449 
3450  if ( !$timestamp ) {
3451  return null;
3452  }
3453 
3454  $revRecord = $services->getRevisionLookup()->getRevisionByTimestamp(
3455  $user->getTalkPage(),
3456  $timestamp
3457  );
3458 
3459  if ( !$revRecord ) {
3460  return null;
3461  }
3462 
3463  return $revRecord->getId();
3464  }
3465 
3475  public function userCanPreview() {
3476  $request = $this->getRequest();
3477  if (
3478  $request->getVal( 'action' ) !== 'submit' ||
3479  !$request->wasPosted()
3480  ) {
3481  return false;
3482  }
3483 
3484  $user = $this->getUser();
3485 
3486  if ( !$user->isRegistered() ) {
3487  // Anons have predictable edit tokens
3488  return false;
3489  }
3490  if ( !$this->getCsrfTokenSet()->matchTokenField() ) {
3491  return false;
3492  }
3493 
3494  $title = $this->getTitle();
3495  if ( !$this->getAuthority()->probablyCan( 'edit', $title ) ) {
3496  return false;
3497  }
3498 
3499  return true;
3500  }
3501 
3505  public function getHeadLinksArray() {
3506  $tags = [];
3507  $config = $this->getConfig();
3508 
3509  $canonicalUrl = $this->mCanonicalUrl;
3510 
3511  $tags['meta-generator'] = Html::element( 'meta', [
3512  'name' => 'generator',
3513  'content' => 'MediaWiki ' . MW_VERSION,
3514  ] );
3515 
3516  if ( $config->get( 'ReferrerPolicy' ) !== false ) {
3517  // Per https://w3c.github.io/webappsec-referrer-policy/#unknown-policy-values
3518  // fallbacks should come before the primary value so we need to reverse the array.
3519  foreach ( array_reverse( (array)$config->get( 'ReferrerPolicy' ) ) as $i => $policy ) {
3520  $tags["meta-referrer-$i"] = Html::element( 'meta', [
3521  'name' => 'referrer',
3522  'content' => $policy,
3523  ] );
3524  }
3525  }
3526 
3527  $p = "{$this->mIndexPolicy},{$this->mFollowPolicy}";
3528  if ( $p !== 'index,follow' ) {
3529  // http://www.robotstxt.org/wc/meta-user.html
3530  // Only show if it's different from the default robots policy
3531  $tags['meta-robots'] = Html::element( 'meta', [
3532  'name' => 'robots',
3533  'content' => $p,
3534  ] );
3535  }
3536 
3537  # Browser based phonenumber detection
3538  if ( $config->get( 'BrowserFormatDetection' ) !== false ) {
3539  $tags['meta-format-detection'] = Html::element( 'meta', [
3540  'name' => 'format-detection',
3541  'content' => $config->get( 'BrowserFormatDetection' ),
3542  ] );
3543  }
3544 
3545  foreach ( $this->mMetatags as $tag ) {
3546  if ( strncasecmp( $tag[0], 'http:', 5 ) === 0 ) {
3547  $a = 'http-equiv';
3548  $tag[0] = substr( $tag[0], 5 );
3549  } elseif ( strncasecmp( $tag[0], 'og:', 3 ) === 0 ) {
3550  $a = 'property';
3551  } else {
3552  $a = 'name';
3553  }
3554  $tagName = "meta-{$tag[0]}";
3555  if ( isset( $tags[$tagName] ) ) {
3556  $tagName .= $tag[1];
3557  }
3558  $tags[$tagName] = Html::element( 'meta',
3559  [
3560  $a => $tag[0],
3561  'content' => $tag[1]
3562  ]
3563  );
3564  }
3565 
3566  foreach ( $this->mLinktags as $tag ) {
3567  $tags[] = Html::element( 'link', $tag );
3568  }
3569 
3570  # Universal edit button
3571  if ( $config->get( 'UniversalEditButton' ) && $this->isArticleRelated() ) {
3572  if ( $this->getAuthority()->probablyCan( 'edit', $this->getTitle() ) ) {
3573  // Original UniversalEditButton
3574  $msg = $this->msg( 'edit' )->text();
3575  $tags['universal-edit-button'] = Html::element( 'link', [
3576  'rel' => 'alternate',
3577  'type' => 'application/x-wiki',
3578  'title' => $msg,
3579  'href' => $this->getTitle()->getEditURL(),
3580  ] );
3581  // Alternate edit link
3582  $tags['alternative-edit'] = Html::element( 'link', [
3583  'rel' => 'edit',
3584  'title' => $msg,
3585  'href' => $this->getTitle()->getEditURL(),
3586  ] );
3587  }
3588  }
3589 
3590  # Generally the order of the favicon and apple-touch-icon links
3591  # should not matter, but Konqueror (3.5.9 at least) incorrectly
3592  # uses whichever one appears later in the HTML source. Make sure
3593  # apple-touch-icon is specified first to avoid this.
3594  if ( $config->get( 'AppleTouchIcon' ) !== false ) {
3595  $tags['apple-touch-icon'] = Html::element( 'link', [
3596  'rel' => 'apple-touch-icon',
3597  'href' => $config->get( 'AppleTouchIcon' )
3598  ] );
3599  }
3600 
3601  if ( $config->get( 'Favicon' ) !== false ) {
3602  $tags['favicon'] = Html::element( 'link', [
3603  'rel' => 'shortcut icon',
3604  'href' => $config->get( 'Favicon' )
3605  ] );
3606  }
3607 
3608  # OpenSearch description link
3609  $tags['opensearch'] = Html::element( 'link', [
3610  'rel' => 'search',
3611  'type' => 'application/opensearchdescription+xml',
3612  'href' => wfScript( 'opensearch_desc' ),
3613  'title' => $this->msg( 'opensearch-desc' )->inContentLanguage()->text(),
3614  ] );
3615 
3616  # Real Simple Discovery link, provides auto-discovery information
3617  # for the MediaWiki API (and potentially additional custom API
3618  # support such as WordPress or Twitter-compatible APIs for a
3619  # blogging extension, etc)
3620  $tags['rsd'] = Html::element( 'link', [
3621  'rel' => 'EditURI',
3622  'type' => 'application/rsd+xml',
3623  // Output a protocol-relative URL here if $wgServer is protocol-relative.
3624  // Whether RSD accepts relative or protocol-relative URLs is completely
3625  // undocumented, though.
3626  'href' => wfExpandUrl( wfAppendQuery(
3627  wfScript( 'api' ),
3628  [ 'action' => 'rsd' ] ),
3630  ),
3631  ] );
3632 
3633  # Language variants
3634  $services = MediaWikiServices::getInstance();
3635  $languageConverterFactory = $services->getLanguageConverterFactory();
3636  $disableLangConversion = $languageConverterFactory->isConversionDisabled();
3637  if ( !$disableLangConversion ) {
3638  $lang = $this->getTitle()->getPageLanguage();
3639  $languageConverter = $languageConverterFactory->getLanguageConverter( $lang );
3640  if ( $languageConverter->hasVariants() ) {
3641  $variants = $languageConverter->getVariants();
3642  foreach ( $variants as $variant ) {
3643  $tags["variant-$variant"] = Html::element( 'link', [
3644  'rel' => 'alternate',
3645  'hreflang' => LanguageCode::bcp47( $variant ),
3646  'href' => $this->getTitle()->getLocalURL(
3647  [ 'variant' => $variant ] )
3648  ]
3649  );
3650  }
3651  # x-default link per https://support.google.com/webmasters/answer/189077?hl=en
3652  $tags["variant-x-default"] = Html::element( 'link', [
3653  'rel' => 'alternate',
3654  'hreflang' => 'x-default',
3655  'href' => $this->getTitle()->getLocalURL() ] );
3656  }
3657  }
3658 
3659  # Copyright
3660  if ( $this->copyrightUrl !== null ) {
3661  $copyright = $this->copyrightUrl;
3662  } else {
3663  $copyright = '';
3664  if ( $config->get( 'RightsPage' ) ) {
3665  $copy = Title::newFromText( $config->get( 'RightsPage' ) );
3666 
3667  if ( $copy ) {
3668  $copyright = $copy->getLocalURL();
3669  }
3670  }
3671 
3672  if ( !$copyright && $config->get( 'RightsUrl' ) ) {
3673  $copyright = $config->get( 'RightsUrl' );
3674  }
3675  }
3676 
3677  if ( $copyright ) {
3678  $tags['copyright'] = Html::element( 'link', [
3679  'rel' => 'license',
3680  'href' => $copyright ]
3681  );
3682  }
3683 
3684  # Feeds
3685  if ( $config->get( 'Feed' ) ) {
3686  $feedLinks = [];
3687 
3688  foreach ( $this->getSyndicationLinks() as $format => $link ) {
3689  # Use the page name for the title. In principle, this could
3690  # lead to issues with having the same name for different feeds
3691  # corresponding to the same page, but we can't avoid that at
3692  # this low a level.
3693 
3694  $feedLinks[] = $this->feedLink(
3695  $format,
3696  $link,
3697  # Used messages: 'page-rss-feed' and 'page-atom-feed' (for an easier grep)
3698  $this->msg(
3699  "page-{$format}-feed", $this->getTitle()->getPrefixedText()
3700  )->text()
3701  );
3702  }
3703 
3704  # Recent changes feed should appear on every page (except recentchanges,
3705  # that would be redundant). Put it after the per-page feed to avoid
3706  # changing existing behavior. It's still available, probably via a
3707  # menu in your browser. Some sites might have a different feed they'd
3708  # like to promote instead of the RC feed (maybe like a "Recent New Articles"
3709  # or "Breaking news" one). For this, we see if $wgOverrideSiteFeed is defined.
3710  # If so, use it instead.
3711  $sitename = $config->get( 'Sitename' );
3712  $overrideSiteFeed = $config->get( 'OverrideSiteFeed' );
3713  if ( $overrideSiteFeed ) {
3714  foreach ( $overrideSiteFeed as $type => $feedUrl ) {
3715  // Note, this->feedLink escapes the url.
3716  $feedLinks[] = $this->feedLink(
3717  $type,
3718  $feedUrl,
3719  $this->msg( "site-{$type}-feed", $sitename )->text()
3720  );
3721  }
3722  } elseif ( !$this->getTitle()->isSpecial( 'Recentchanges' ) ) {
3723  $rctitle = SpecialPage::getTitleFor( 'Recentchanges' );
3724  foreach ( $this->getAdvertisedFeedTypes() as $format ) {
3725  $feedLinks[] = $this->feedLink(
3726  $format,
3727  $rctitle->getLocalURL( [ 'feed' => $format ] ),
3728  # For grep: 'site-rss-feed', 'site-atom-feed'
3729  $this->msg( "site-{$format}-feed", $sitename )->text()
3730  );
3731  }
3732  }
3733 
3734  # Allow extensions to change the list pf feeds. This hook is primarily for changing,
3735  # manipulating or removing existing feed tags. If you want to add new feeds, you should
3736  # use OutputPage::addFeedLink() instead.
3737  $this->getHookRunner()->onAfterBuildFeedLinks( $feedLinks );
3738 
3739  $tags += $feedLinks;
3740  }
3741 
3742  # Canonical URL
3743  if ( $config->get( 'EnableCanonicalServerLink' ) ) {
3744  if ( $canonicalUrl !== false ) {
3745  $canonicalUrl = wfExpandUrl( $canonicalUrl, PROTO_CANONICAL );
3746  } elseif ( $this->isArticleRelated() ) {
3747  // This affects all requests where "setArticleRelated" is true. This is
3748  // typically all requests that show content (query title, curid, oldid, diff),
3749  // and all wikipage actions (edit, delete, purge, info, history etc.).
3750  // It does not apply to File pages and Special pages.
3751  // 'history' and 'info' actions address page metadata rather than the page
3752  // content itself, so they may not be canonicalized to the view page url.
3753  // TODO: this ought to be better encapsulated in the Action class.
3754  $action = Action::getActionName( $this->getContext() );
3755  if ( in_array( $action, [ 'history', 'info' ] ) ) {
3756  $query = "action={$action}";
3757  } else {
3758  $query = '';
3759  }
3760  $canonicalUrl = $this->getTitle()->getCanonicalURL( $query );
3761  } else {
3762  $reqUrl = $this->getRequest()->getRequestURL();
3763  $canonicalUrl = wfExpandUrl( $reqUrl, PROTO_CANONICAL );
3764  }
3765  }
3766  if ( $canonicalUrl !== false ) {
3767  $tags[] = Html::element( 'link', [
3768  'rel' => 'canonical',
3769  'href' => $canonicalUrl
3770  ] );
3771  }
3772 
3773  // Allow extensions to add, remove and/or otherwise manipulate these links
3774  // If you want only to *add* <head> links, please use the addHeadItem()
3775  // (or addHeadItems() for multiple items) method instead.
3776  // This hook is provided as a last resort for extensions to modify these
3777  // links before the output is sent to client.
3778  $this->getHookRunner()->onOutputPageAfterGetHeadLinksArray( $tags, $this );
3779 
3780  return $tags;
3781  }
3782 
3791  private function feedLink( $type, $url, $text ) {
3792  return Html::element( 'link', [
3793  'rel' => 'alternate',
3794  'type' => "application/$type+xml",
3795  'title' => $text,
3796  'href' => $url ]
3797  );
3798  }
3799 
3809  public function addStyle( $style, $media = '', $condition = '', $dir = '' ) {
3810  $options = [];
3811  if ( $media ) {
3812  $options['media'] = $media;
3813  }
3814  if ( $condition ) {
3815  $options['condition'] = $condition;
3816  }
3817  if ( $dir ) {
3818  $options['dir'] = $dir;
3819  }
3820  $this->styles[$style] = $options;
3821  }
3822 
3830  public function addInlineStyle( $style_css, $flip = 'noflip' ) {
3831  if ( $flip === 'flip' && $this->getLanguage()->isRTL() ) {
3832  # If wanted, and the interface is right-to-left, flip the CSS
3833  $style_css = CSSJanus::transform( $style_css, true, false );
3834  }
3835  $this->mInlineStyles .= Html::inlineStyle( $style_css );
3836  }
3837 
3843  protected function buildExemptModules() {
3844  $chunks = [];
3845 
3846  // Requirements:
3847  // - Within modules provided by the software (core, skin, extensions),
3848  // styles from skin stylesheets should be overridden by styles
3849  // from modules dynamically loaded with JavaScript.
3850  // - Styles from site-specific, private, and user modules should override
3851  // both of the above.
3852  //
3853  // The effective order for stylesheets must thus be:
3854  // 1. Page style modules, formatted server-side by ResourceLoaderClientHtml.
3855  // 2. Dynamically-loaded styles, inserted client-side by mw.loader.
3856  // 3. Styles that are site-specific, private or from the user, formatted
3857  // server-side by this function.
3858  //
3859  // The 'ResourceLoaderDynamicStyles' marker helps JavaScript know where
3860  // point #2 is.
3861 
3862  // Add legacy styles added through addStyle()/addInlineStyle() here
3863  $chunks[] = implode( '', $this->buildCssLinksArray() ) . $this->mInlineStyles;
3864 
3865  // Things that go after the ResourceLoaderDynamicStyles marker
3866  $append = [];
3867  $separateReq = [ 'site.styles', 'user.styles' ];
3868  foreach ( $this->rlExemptStyleModules as $group => $moduleNames ) {
3869  if ( $moduleNames ) {
3870  $append[] = $this->makeResourceLoaderLink(
3871  array_diff( $moduleNames, $separateReq ),
3872  ResourceLoaderModule::TYPE_STYLES
3873  );
3874 
3875  foreach ( array_intersect( $moduleNames, $separateReq ) as $name ) {
3876  // These require their own dedicated request in order to support "@import"
3877  // syntax, which is incompatible with concatenation. (T147667, T37562)
3878  $append[] = $this->makeResourceLoaderLink( $name,
3879  ResourceLoaderModule::TYPE_STYLES
3880  );
3881  }
3882  }
3883  }
3884  if ( $append ) {
3885  $chunks[] = Html::element(
3886  'meta',
3887  [ 'name' => 'ResourceLoaderDynamicStyles', 'content' => '' ]
3888  );
3889  $chunks = array_merge( $chunks, $append );
3890  }
3891 
3892  return self::combineWrappedStrings( $chunks );
3893  }
3894 
3898  public function buildCssLinksArray() {
3899  $links = [];
3900 
3901  foreach ( $this->styles as $file => $options ) {
3902  $link = $this->styleLink( $file, $options );
3903  if ( $link ) {
3904  $links[$file] = $link;
3905  }
3906  }
3907  return $links;
3908  }
3909 
3917  protected function styleLink( $style, array $options ) {
3918  if ( isset( $options['dir'] ) && $this->getLanguage()->getDir() != $options['dir'] ) {
3919  return '';
3920  }
3921 
3922  if ( isset( $options['media'] ) ) {
3923  $media = self::transformCssMedia( $options['media'] );
3924  if ( $media === null ) {
3925  return '';
3926  }
3927  } else {
3928  $media = 'all';
3929  }
3930 
3931  if ( substr( $style, 0, 1 ) == '/' ||
3932  substr( $style, 0, 5 ) == 'http:' ||
3933  substr( $style, 0, 6 ) == 'https:' ) {
3934  $url = $style;
3935  } else {
3936  $config = $this->getConfig();
3937  // Append file hash as query parameter
3939  $config,
3940  $config->get( 'StylePath' ) . '/' . $style
3941  );
3942  }
3943 
3944  $link = Html::linkedStyle( $url, $media );
3945 
3946  if ( isset( $options['condition'] ) ) {
3947  $condition = htmlspecialchars( $options['condition'] );
3948  $link = "<!--[if $condition]>$link<![endif]-->";
3949  }
3950  return $link;
3951  }
3952 
3974  public static function transformResourcePath( Config $config, $path ) {
3975  global $IP;
3976 
3977  $localDir = $IP;
3978  $remotePathPrefix = $config->get( 'ResourceBasePath' );
3979  if ( $remotePathPrefix === '' ) {
3980  // The configured base path is required to be empty string for
3981  // wikis in the domain root
3982  $remotePath = '/';
3983  } else {
3984  $remotePath = $remotePathPrefix;
3985  }
3986  if ( strpos( $path, $remotePath ) !== 0 || substr( $path, 0, 2 ) === '//' ) {
3987  // - Path is outside wgResourceBasePath, ignore.
3988  // - Path is protocol-relative. Fixes T155310. Not supported by RelPath lib.
3989  return $path;
3990  }
3991  // For files in resources, extensions/ or skins/, ResourceBasePath is preferred here.
3992  // For other misc files in $IP, we'll fallback to that as well. There is, however, a fourth
3993  // supported dir/path pair in the configuration (wgUploadDirectory, wgUploadPath)
3994  // which is not expected to be in wgResourceBasePath on CDNs. (T155146)
3995  $uploadPath = $config->get( 'UploadPath' );
3996  if ( strpos( $path, $uploadPath ) === 0 ) {
3997  $localDir = $config->get( 'UploadDirectory' );
3998  $remotePathPrefix = $remotePath = $uploadPath;
3999  }
4000 
4001  $path = RelPath::getRelativePath( $path, $remotePath );
4002  return self::transformFilePath( $remotePathPrefix, $localDir, $path );
4003  }
4004 
4016  public static function transformFilePath( $remotePathPrefix, $localPath, $file ) {
4017  // This MUST match the equivalent logic in CSSMin::remapOne()
4018  $localFile = "$localPath/$file";
4019  $url = "$remotePathPrefix/$file";
4020  if ( file_exists( $localFile ) ) {
4021  $hash = md5_file( $localFile );
4022  if ( $hash === false ) {
4023  wfLogWarning( __METHOD__ . ": Failed to hash $localFile" );
4024  $hash = '';
4025  }
4026  $url .= '?' . substr( $hash, 0, 5 );
4027  }
4028  return $url;
4029  }
4030 
4038  public static function transformCssMedia( $media ) {
4039  global $wgRequest;
4040 
4041  // https://www.w3.org/TR/css3-mediaqueries/#syntax
4042  $screenMediaQueryRegex = '/^(?:only\s+)?screen\b/i';
4043 
4044  // Switch in on-screen display for media testing
4045  $switches = [
4046  'printable' => 'print',
4047  'handheld' => 'handheld',
4048  ];
4049  foreach ( $switches as $switch => $targetMedia ) {
4050  if ( $wgRequest->getBool( $switch ) ) {
4051  if ( $media == $targetMedia ) {
4052  $media = '';
4053  } elseif ( preg_match( $screenMediaQueryRegex, $media ) === 1 ) {
4054  /* This regex will not attempt to understand a comma-separated media_query_list
4055  *
4056  * Example supported values for $media:
4057  * 'screen', 'only screen', 'screen and (min-width: 982px)' ),
4058  * Example NOT supported value for $media:
4059  * '3d-glasses, screen, print and resolution > 90dpi'
4060  *
4061  * If it's a print request, we never want any kind of screen stylesheets
4062  * If it's a handheld request (currently the only other choice with a switch),
4063  * we don't want simple 'screen' but we might want screen queries that
4064  * have a max-width or something, so we'll pass all others on and let the
4065  * client do the query.
4066  */
4067  if ( $targetMedia == 'print' || $media == 'screen' ) {
4068  return null;
4069  }
4070  }
4071  }
4072  }
4073 
4074  return $media;
4075  }
4076 
4085  public function addWikiMsg( ...$args ) {
4086  $name = array_shift( $args );
4087  $this->addWikiMsgArray( $name, $args );
4088  }
4089 
4098  public function addWikiMsgArray( $name, $args ) {
4099  $this->addHTML( $this->msg( $name, $args )->parseAsBlock() );
4100  }
4101 
4128  public function wrapWikiMsg( $wrap, ...$msgSpecs ) {
4129  $s = $wrap;
4130  foreach ( $msgSpecs as $n => $spec ) {
4131  if ( is_array( $spec ) ) {
4132  $args = $spec;
4133  $name = array_shift( $args );
4134  } else {
4135  $args = [];
4136  $name = $spec;
4137  }
4138  $s = str_replace( '$' . ( $n + 1 ), $this->msg( $name, $args )->plain(), $s );
4139  }
4140  $this->addWikiTextAsInterface( $s );
4141  }
4142 
4148  public function isTOCEnabled() {
4149  return $this->mEnableTOC;
4150  }
4151 
4159  public static function setupOOUI( $skinName = 'default', $dir = 'ltr' ) {
4161  $theme = $themes[$skinName] ?? $themes['default'];
4162  // For example, 'OOUI\WikimediaUITheme'.
4163  $themeClass = "OOUI\\{$theme}Theme";
4164  OOUI\Theme::setSingleton( new $themeClass() );
4165  OOUI\Element::setDefaultDir( $dir );
4166  }
4167 
4174  public function enableOOUI() {
4176  strtolower( $this->getSkin()->getSkinName() ),
4177  $this->getLanguage()->getDir()
4178  );
4179  $this->addModuleStyles( [
4180  'oojs-ui-core.styles',
4181  'oojs-ui.styles.indicators',
4182  'mediawiki.widgets.styles',
4183  'oojs-ui-core.icons',
4184  ] );
4185  }
4186 
4197  public function getCSPNonce() {
4198  return $this->CSP->getNonce();
4199  }
4200 
4207  public function getCSP() {
4208  return $this->CSP;
4209  }
4210 }
Action\getActionName
static getActionName(IContextSource $context)
Get the action that will be executed, not necessarily the one passed passed through the "action" requ...
Definition: Action.php:143
OutputPage\preventClickjacking
preventClickjacking( $enable=true)
Set a flag which will cause an X-Frame-Options header appropriate for edit pages to be sent.
Definition: OutputPage.php:2355
OutputPage\output
output( $return=false)
Finally, all the text has been munged and accumulated into the object, let's actually output it:
Definition: OutputPage.php:2540
ParserOutput\getEnableOOUI
getEnableOOUI()
Definition: ParserOutput.php:693
OutputPage\$mCategoryLinks
string[][] $mCategoryLinks
Definition: OutputPage.php:125
OutputPage\$mLastModified
string $mLastModified
Used for sending cache control.
Definition: OutputPage.php:122
ParserOptions
Set options of the Parser.
Definition: ParserOptions.php:45
OutputPage\getCategoryLinks
getCategoryLinks()
Get the list of category links, in a 2-D array with the following format: $arr[$type][] = $link,...
Definition: OutputPage.php:1473
OutputPage\addMeta
addMeta( $name, $val)
Add a new "<meta>" tag To add an http-equiv meta tag, precede the name with "http:".
Definition: OutputPage.php:408
ContextSource\$context
IContextSource $context
Definition: ContextSource.php:39
ContextSource\getConfig
getConfig()
Definition: ContextSource.php:72
OutputPage\getTarget
getTarget()
Definition: OutputPage.php:595
ResourceLoaderContext
Context object that contains information about the state of a specific ResourceLoader web request.
Definition: ResourceLoaderContext.php:34
OutputPage\getSubtitle
getSubtitle()
Definition: OutputPage.php:1129
Page\PageRecord
Data record representing a page that is (or used to be, or could be) an editable page on a wiki.
Definition: PageRecord.php:28
OutputPage\parseAsInterface
parseAsInterface( $text, $linestart=true)
Parse wikitext in the user interface language and return the HTML.
Definition: OutputPage.php:2073
FauxRequest
WebRequest clone which takes values from a provided array.
Definition: FauxRequest.php:35
OutputPage\enableClientCache
enableClientCache( $state)
Use enableClientCache(false) to force it to send nocache headers.
Definition: OutputPage.php:2190
Title\newFromText
static newFromText( $text, $defaultNamespace=NS_MAIN)
Create a new Title from text, such as what one would find in a link.
Definition: Title.php:415
ContextSource\getContext
getContext()
Get the base IContextSource object.
Definition: ContextSource.php:47
wfResetOutputBuffers
wfResetOutputBuffers( $resetGzipEncoding=true)
Clear away any user-level output buffers, discarding contents.
Definition: GlobalFunctions.php:1604
OutputPage\getLanguageLinks
getLanguageLinks()
Get the list of language links.
Definition: OutputPage.php:1365
HtmlArmor
Marks HTML that shouldn't be escaped.
Definition: HtmlArmor.php:30
ResourceLoaderClientHtml
Load and configure a ResourceLoader client on an HTML page.
Definition: ResourceLoaderClientHtml.php:30
OutputPage\reduceAllowedModules
reduceAllowedModules( $type, $level)
Limit the highest level of CSS/JS untrustworthiness allowed.
Definition: OutputPage.php:1609
OutputPage\$mModuleStyles
array $mModuleStyles
Definition: OutputPage.php:172
OutputPage\addSubtitle
addSubtitle( $str)
Add $str to the subtitle.
Definition: OutputPage.php:1076
OutputPage\addScriptFile
addScriptFile( $file, $unused=null)
Add a JavaScript file to be loaded as <script> on this page.
Definition: OutputPage.php:482
OutputPage\addAcceptLanguage
addAcceptLanguage()
T23672: Add Accept-Language to Vary header if there's no 'variant' parameter in GET.
Definition: OutputPage.php:2332
ParserOutput
Definition: ParserOutput.php:31
Article\formatRobotPolicy
static formatRobotPolicy( $policy)
Converts a String robot policy into an associative array, to allow merging of several policies using ...
Definition: Article.php:1026
OutputPage\getJSVars
getJSVars()
Get an array containing the variables to be set in mw.config in JavaScript.
Definition: OutputPage.php:3290
ResourceLoader\makeConfigSetScript
static makeConfigSetScript(array $configuration)
Return JS code which will set the MediaWiki configuration array to the given value.
Definition: ResourceLoader.php:1665
OutputPage\getRlClientContext
getRlClientContext()
Definition: OutputPage.php:2959
OutputPage\getDisplayTitle
getDisplayTitle()
Returns page display title.
Definition: OutputPage.php:1025
Sanitizer\stripAllTags
static stripAllTags( $html)
Take a fragment of (potentially invalid) HTML and return a version with any tags removed,...
Definition: Sanitizer.php:1576
OutputPage\$mVaryHeader
array $mVaryHeader
Headers that cause the cache to vary.
Definition: OutputPage.php:288
OutputPage\showsCopyright
showsCopyright()
Return whether the standard copyright should be shown for the current page.
Definition: OutputPage.php:1336
OutputPage\addLink
addLink(array $linkarr)
Add a new <link> tag to the page header.
Definition: OutputPage.php:429
OutputPage\addCategoryLinksToLBAndGetResult
addCategoryLinksToLBAndGetResult(array $categories)
Definition: OutputPage.php:1423
OutputPage\parserOptions
parserOptions()
Get/set the ParserOptions object to use for wikitext parsing.
Definition: OutputPage.php:1666
OutputPage\hasHeadItem
hasHeadItem( $name)
Check if the header item $name is already set.
Definition: OutputPage.php:691
MediaWiki\MediaWikiServices
MediaWikiServices is the service locator for the application scope of MediaWiki.
Definition: MediaWikiServices.php:184
$lang
if(!isset( $args[0])) $lang
Definition: testCompression.php:37
OutputPage\getMetaTags
getMetaTags()
Returns the current <meta> tags.
Definition: OutputPage.php:418
OutputPage\addLanguageLinks
addLanguageLinks(array $newLinkArray)
Add new language links.
Definition: OutputPage.php:1346
OutputPage\addLinkHeader
addLinkHeader( $header)
Add an HTTP Link: header.
Definition: OutputPage.php:2308
OutputPage\addModuleStyles
addModuleStyles( $modules)
Load the styles of one or more style-only ResourceLoader modules on this page.
Definition: OutputPage.php:588
OutputPage\$mNewSectionLink
bool $mNewSectionLink
Definition: OutputPage.php:237
wfSetVar
wfSetVar(&$dest, $source, $force=false)
Sets dest to source and returns the original value of dest If source is NULL, it just returns the val...
Definition: GlobalFunctions.php:1512
OutputPage\getCSP
getCSP()
Get the ContentSecurityPolicy object.
Definition: OutputPage.php:4207
OutputPage\isArticleRelated
isArticleRelated()
Return whether this page is related an article on the wiki.
Definition: OutputPage.php:1314
OutputPage\setArticleBodyOnly
setArticleBodyOnly( $only)
Set whether the output should only contain the body of the article, without any skin,...
Definition: OutputPage.php:712
OutputPage\getFrameOptions
getFrameOptions()
Get the X-Frame-Options header value (without the name part), or false if there isn't one.
Definition: OutputPage.php:2385
OutputPage\__construct
__construct(IContextSource $context)
Constructor for OutputPage.
Definition: OutputPage.php:350
ResourceLoader\makeInlineScript
static makeInlineScript( $script, $nonce=null)
Make an HTML script that runs given JS code after startup and base modules.
Definition: ResourceLoader.php:1638
OutputPage\$mRedirectCode
string $mRedirectCode
Definition: OutputPage.php:196
Sanitizer\removeHTMLtags
static removeHTMLtags( $text, $processCallback=null, $args=[], $extratags=[], $removetags=[])
Cleans up HTML, removes dangerous tags and attributes, and removes HTML comments.
Definition: Sanitizer.php:239
OutputPage\getRevisionId
getRevisionId()
Get the displayed revision ID.
Definition: OutputPage.php:1702
OutputPage\clearHTML
clearHTML()
Clear the body HTML.
Definition: OutputPage.php:1647
OutputPage\addScript
addScript( $script)
Add raw HTML to the list of scripts (including <script> tag, etc.) Internal use only.
Definition: OutputPage.php:470
ParserOutput\getModules
getModules()
Definition: ParserOutput.php:646
wfTimestamp
wfTimestamp( $outputtype=TS_UNIX, $ts=0)
Get a timestamp string in one of various formats.
Definition: GlobalFunctions.php:1692
ParserOutput\getImages
& getImages()
Definition: ParserOutput.php:622
OutputPage\returnToMain
returnToMain( $unused=null, $returnto=null, $returntoquery=null)
Add a "return to" link pointing to a specified title, or the title indicated in the request,...
Definition: OutputPage.php:2931
OutputPage\buildCssLinksArray
buildCssLinksArray()
Definition: OutputPage.php:3898
OutputPage\addParserOutputMetadata
addParserOutputMetadata(ParserOutput $parserOutput)
Add all metadata associated with a ParserOutput object, but without the actual HTML.
Definition: OutputPage.php:1891
OutputPage\combineWrappedStrings
static combineWrappedStrings(array $chunks)
Combine WrappedString chunks and filter out empty ones.
Definition: OutputPage.php:3223
Sanitizer\mergeAttributes
static mergeAttributes( $a, $b)
Merge two sets of HTML attributes.
Definition: Sanitizer.php:541
MW_VERSION
const MW_VERSION
The running version of MediaWiki.
Definition: Defines.php:36
OutputPage\$mHideNewSectionLink
bool $mHideNewSectionLink
Definition: OutputPage.php:240
OutputPage\$contentOverrides
array $contentOverrides
Map Title to Content.
Definition: OutputPage.php:324
OutputPage\$mBodytext
string $mBodytext
Contains all of the "<body>" content.
Definition: OutputPage.php:83
OutputPage\getOriginTrials
getOriginTrials()
Get the Origin-Trial header values.
Definition: OutputPage.php:2401
ParserOutput\getJsConfigVars
getJsConfigVars()
Definition: ParserOutput.php:658
wfUrlencode
wfUrlencode( $s)
We want some things to be included as literal characters in our title URLs for prettiness,...
Definition: GlobalFunctions.php:292
OutputPage\getBottomScripts
getBottomScripts()
JS stuff to put at the bottom of the <body>.
Definition: OutputPage.php:3235
OutputPage\$mEnableClientCache
bool $mEnableClientCache
Gwicke work on squid caching? Roughly from 2003.
Definition: OutputPage.php:231
ParserOptions\newFromAnon
static newFromAnon()
Get a ParserOptions object for an anonymous user.
Definition: ParserOptions.php:1052
OutputPage\couldBePublicCached
couldBePublicCached()
Whether the output might become publicly cached.
Definition: OutputPage.php:2200
OutputPage\addHeadItems
addHeadItems( $values)
Add one or more head items to the output.
Definition: OutputPage.php:681
OutputPage\getModuleStyles
getModuleStyles( $filter=false, $position=null)
Get the list of style-only modules to load on this page.
Definition: OutputPage.php:573
OutputPage\getFeaturePolicyReportOnly
getFeaturePolicyReportOnly()
Definition: OutputPage.php:2431
$file
if(PHP_SAPI !='cli-server') if(!isset( $_SERVER['SCRIPT_FILENAME'])) $file
Item class for a filearchive table row.
Definition: router.php:42
Html\htmlHeader
static htmlHeader(array $attribs=[])
Constructs the opening html-tag with necessary doctypes depending on global variables.
Definition: Html.php:968
OutputPage\versionRequired
versionRequired( $version)
Display an error page indicating that a given version of MediaWiki is required to use it.
Definition: OutputPage.php:2814
ResourceLoaderClientHtml\setExemptStates
setExemptStates(array $states)
Set state of special modules that are handled by the caller manually.
Definition: ResourceLoaderClientHtml.php:108
wfMessage
wfMessage( $key,... $params)
This is the function for getting translated interface messages.
Definition: GlobalFunctions.php:1182
MediaWiki\Permissions\PermissionStatus\toLegacyErrorArray
toLegacyErrorArray()
Returns this permission status in legacy error array format.
Definition: PermissionStatus.php:78
SpecialPage\getTitleFor
static getTitleFor( $name, $subpage=false, $fragment='')
Get a localised Title object for a specified special page name If you don't need a full Title object,...
Definition: SpecialPage.php:107
Sanitizer\escapeClass
static escapeClass( $class)
Given a value, escape it so that it can be used as a CSS class and return it.
Definition: Sanitizer.php:972
OutputPage\getFileVersion
getFileVersion()
Get the displayed file version.
Definition: OutputPage.php:1756
OutputPage\getSyndicationLinks
getSyndicationLinks()
Return URLs for each supported syndication format for this page.
Definition: OutputPage.php:1259
ContextSource\canUseWikiPage
canUseWikiPage()
Check whether a WikiPage object can be get with getWikiPage().
Definition: ContextSource.php:103
wfLogWarning
wfLogWarning( $msg, $callerOffset=1, $level=E_USER_WARNING)
Send a warning as a PHP error and the debug log.
Definition: GlobalFunctions.php:1056
ContextSource\getRequest
getRequest()
Definition: ContextSource.php:81
Title\newMainPage
static newMainPage(MessageLocalizer $localizer=null)
Create a new Title for the Main Page.
Definition: Title.php:742
OutputPage\getRedirect
getRedirect()
Get the URL to redirect to, or an empty string if not redirect URL set.
Definition: OutputPage.php:376
OutputPage\setCanonicalUrl
setCanonicalUrl( $url)
Set the URL to be used for the <link rel=canonical>>.
Definition: OutputPage.php:448
$res
$res
Definition: testCompression.php:57
ParserOutput\getHeadItems
getHeadItems()
Definition: ParserOutput.php:642
ContextSource\getUser
getUser()
Definition: ContextSource.php:136
ContextSource\getTitle
getTitle()
Definition: ContextSource.php:90
OutputPage\$mLinktags
array $mLinktags
Definition: OutputPage.php:57
OutputPage\$mIndexPolicy
$mIndexPolicy
Definition: OutputPage.php:280
Skin\getHtmlElementAttributes
getHtmlElementAttributes()
Return values for <html> element.
Definition: Skin.php:553
OutputPage\setIndicators
setIndicators(array $indicators)
Add an array of indicators, with their identifiers as array keys and HTML contents as values.
Definition: OutputPage.php:1509
Page\PageReference
Interface for objects (potentially) representing a page that can be viewable and linked to on a wiki.
Definition: PageReference.php:49
LinkCache\getSelectFields
static getSelectFields()
Fields that LinkCache needs to select.
Definition: LinkCache.php:353
OutputPage\addHTML
addHTML( $text)
Append $text to the body HTML.
Definition: OutputPage.php:1627
OutputPage\parseInternal
parseInternal( $text, $title, $linestart, $interface)
Parse wikitext and return the HTML (internal implementation helper)
Definition: OutputPage.php:2114
OutputPage\getReportTo
getReportTo()
Definition: OutputPage.php:2407
OutputPage\addHeadItem
addHeadItem( $name, $value)
Add or replace a head item to the output.
Definition: OutputPage.php:671
OutputPage\addContentOverrideCallback
addContentOverrideCallback(callable $callback)
Add a callback for mapping from a Title to a Content object, for things like page preview.
Definition: OutputPage.php:635
OutputPage\getRevisionTimestamp
getRevisionTimestamp()
Get the timestamp of displayed revision.
Definition: OutputPage.php:1733
OutputPage\addWikiMsgArray
addWikiMsgArray( $name, $args)
Add a wikitext-formatted message to the output.
Definition: OutputPage.php:4098
OutputPage\transformCssMedia
static transformCssMedia( $media)
Transform "media" attribute based on request parameters.
Definition: OutputPage.php:4038
OutputPage\setLastModified
setLastModified( $timestamp)
Override the last modified timestamp.
Definition: OutputPage.php:860
$dbr
$dbr
Definition: testCompression.php:54
ResourceLoaderClientHtml\setConfig
setConfig(array $vars)
Set mw.config variables.
Definition: ResourceLoaderClientHtml.php:77
ContextSource\getLanguage
getLanguage()
Definition: ContextSource.php:153
OutputPage\$mImageTimeKeys
array $mImageTimeKeys
Definition: OutputPage.php:193
NS_SPECIAL
const NS_SPECIAL
Definition: Defines.php:53
OutputPage\showPermissionsErrorPage
showPermissionsErrorPage(array $errors, $action=null)
Output a standard permission error page.
Definition: OutputPage.php:2731
wfAppendQuery
wfAppendQuery( $url, $query)
Append a query string to an existing URL, which may or may not already have query string parameters a...
Definition: GlobalFunctions.php:422
ParserOutput\getModuleStyles
getModuleStyles()
Definition: ParserOutput.php:650
OutputPage\getLinkTags
getLinkTags()
Returns the current <link> tags.
Definition: OutputPage.php:439
OutputPage\forceHideNewSectionLink
forceHideNewSectionLink()
Forcibly hide the new section link?
Definition: OutputPage.php:1180
Html\closeElement
static closeElement( $element)
Returns "</$element>".
Definition: Html.php:318
Xml\encodeJsCall
static encodeJsCall( $name, $args, $pretty=false)
Create a call to a JavaScript function.
Definition: Xml.php:690
OutputPage\$rlClientContext
ResourceLoaderContext $rlClientContext
Definition: OutputPage.php:181
Html\isXmlMimeType
static isXmlMimeType( $mimetype)
Determines if the given MIME type is xml.
Definition: Html.php:1006
OutputPage\setArticleRelated
setArticleRelated( $newVal)
Set whether this page is related an article on the wiki Setting false will cause the change of "artic...
Definition: OutputPage.php:1302
OutputPage\addElement
addElement( $element, array $attribs=[], $contents='')
Shortcut for adding an Html::element via addHTML.
Definition: OutputPage.php:1640
OutputPage\addParserOutputContent
addParserOutputContent(ParserOutput $parserOutput, $poOptions=[])
Add the HTML and enhancements for it (like ResourceLoader modules) associated with a ParserOutput obj...
Definition: OutputPage.php:1999
Config
Interface for configuration instances.
Definition: Config.php:30
ParserOutput\getExtraCSPDefaultSrcs
getExtraCSPDefaultSrcs()
Get extra Content-Security-Policy 'default-src' directives.
Definition: ParserOutput.php:702
StatusValue\isGood
isGood()
Returns whether the operation completed and didn't have any error or warnings.
Definition: StatusValue.php:122
wfParseUrl
wfParseUrl( $url)
parse_url() work-alike, but non-broken.
Definition: GlobalFunctions.php:776
PROTO_RELATIVE
const PROTO_RELATIVE
Definition: Defines.php:194
File
Implements some public methods and some protected utility functions which are required by multiple ch...
Definition: File.php:66
OutputPage\addWikiTextAsInterface
addWikiTextAsInterface( $text, $linestart=true, PageReference $title=null)
Convert wikitext in the user interface language to HTML and add it to the buffer.
Definition: OutputPage.php:1796
ParserOutput\getLimitReportJSData
getLimitReportJSData()
Definition: ParserOutput.php:689
TitleValue\castPageToLinkTarget
static castPageToLinkTarget(?PageReference $page)
Casts a PageReference to a LinkTarget.
Definition: TitleValue.php:136
Html\linkedScript
static linkedScript( $url, $nonce=null)
Output a "<script>" tag linking to the given URL, e.g., "<script src=foo.js></script>".
Definition: Html.php:599
OutputPage\feedLink
feedLink( $type, $url, $text)
Generate a "<link rel/>" for a feed.
Definition: OutputPage.php:3791
wfDeprecatedMsg
wfDeprecatedMsg( $msg, $version=false, $component=false, $callerOffset=2)
Log a deprecation warning with arbitrary message text.
Definition: GlobalFunctions.php:1028
MWException
MediaWiki exception.
Definition: MWException.php:29
OutputPage\considerCacheSettingsFinal
considerCacheSettingsFinal()
Set the expectation that cache control will not change after this point.
Definition: OutputPage.php:2223
OutputPage\getModules
getModules( $filter=false, $position=null, $param='mModules', $type=ResourceLoaderModule::TYPE_COMBINED)
Get the list of modules to include on this page.
Definition: OutputPage.php:548
OutputPage\addStyle
addStyle( $style, $media='', $condition='', $dir='')
Add a local or specified stylesheet, with the given media options.
Definition: OutputPage.php:3809
OutputPage\sendCacheControl
sendCacheControl()
Send cache control HTTP headers.
Definition: OutputPage.php:2441
wfDeprecated
wfDeprecated( $function, $version=false, $component=false, $callerOffset=2)
Logs a warning that $function is deprecated.
Definition: GlobalFunctions.php:996
OutputPage\$mCdnMaxageLimit
int $mCdnMaxageLimit
Upper limit on mCdnMaxage.
Definition: OutputPage.php:252
OutputPage\getLastSeenUserTalkRevId
getLastSeenUserTalkRevId()
Get the revision ID for the last user talk page revision viewed by the talk page owner.
Definition: OutputPage.php:3436
OutputPage\$mTemplateIds
array $mTemplateIds
Definition: OutputPage.php:190
wfScript
wfScript( $script='index')
Get the path to a specified script file, respecting file extensions; this is a wrapper around $wgScri...
Definition: GlobalFunctions.php:2306
Wikimedia\Rdbms\IResultWrapper
Result wrapper for grabbing data queried from an IDatabase object.
Definition: IResultWrapper.php:24
ResourceLoaderWikiModule\preloadTitleInfo
static preloadTitleInfo(ResourceLoaderContext $context, IDatabase $db, array $moduleNames)
Definition: ResourceLoaderWikiModule.php:478
OutputPage\styleLink
styleLink( $style, array $options)
Generate <link> tags for stylesheets.
Definition: OutputPage.php:3917
OutputPage\$mEnableTOC
bool $mEnableTOC
Whether parser output contains a table of contents.
Definition: OutputPage.php:313
Page\PageReference\getNamespace
getNamespace()
Returns the page's namespace number.
Config\get
get( $name)
Get a configuration variable such as "Sitename" or "UploadMaintenance.".
OutputPage\$mSubtitle
array $mSubtitle
Contains the page subtitle.
Definition: OutputPage.php:110
OutputPage\setFileVersion
setFileVersion( $file)
Set the displayed file version.
Definition: OutputPage.php:1743
wfGetDB
wfGetDB( $db, $groups=[], $wiki=false)
Get a Database object.
Definition: GlobalFunctions.php:2226
OutputPage\getLinkHeader
getLinkHeader()
Return a Link: header.
Definition: OutputPage.php:2317
OutputPage\getResourceLoader
getResourceLoader()
Get a ResourceLoader object associated with this OutputPage.
Definition: OutputPage.php:3188
OutputPage\isTOCEnabled
isTOCEnabled()
Whether the output has a table of contents.
Definition: OutputPage.php:4148
ContextSource
The simplest way of implementing IContextSource is to hold a RequestContext as a member variable and ...
Definition: ContextSource.php:33
ContextSource\getWikiPage
getWikiPage()
Get the WikiPage object.
Definition: ContextSource.php:117
OutputPage\setFeedAppendQuery
setFeedAppendQuery( $val)
Add default feeds to the page header This is mainly kept for backward compatibility,...
Definition: OutputPage.php:1223
OutputPage\setDisplayTitle
setDisplayTitle( $html)
Same as page title but only contains name of the page, not any other text.
Definition: OutputPage.php:1013
$modules
$modules
Definition: HTMLFormElement.php:15
OutputPage\isDisabled
isDisabled()
Return whether the output will be completely disabled.
Definition: OutputPage.php:1162
OutputPage\setRevisionId
setRevisionId( $revid)
Set the revision ID which will be seen by the wiki text parser for things such as embedded {{REVISION...
Definition: OutputPage.php:1692
OutputPage\$mCategories
string[][] $mCategories
Definition: OutputPage.php:128
OutputPage\setArticleFlag
setArticleFlag( $newVal)
Set whether the displayed content is related to the source of the corresponding article on the wiki S...
Definition: OutputPage.php:1279
OutputPage\setRedirectedFrom
setRedirectedFrom(PageReference $t)
Set $mRedirectedFrom, the page which redirected us to the current page.
Definition: OutputPage.php:964
OutputPage\disallowUserJs
disallowUserJs()
Do not allow scripts which can be modified by wiki users to load on this page; only allow scripts bun...
Definition: OutputPage.php:1567
ContextSource\getSkin
getSkin()
Definition: ContextSource.php:162
OutputPage\setSubtitle
setSubtitle( $str)
Replace the subtitle with $str.
Definition: OutputPage.php:1066
$args
if( $line===false) $args
Definition: mcc.php:124
OutputPage\$mInlineStyles
string $mInlineStyles
Inline CSS styles.
Definition: OutputPage.php:148
wfCgiToArray
wfCgiToArray( $query)
This is the logical opposite of wfArrayToCgi(): it accepts a query string as its argument and returns...
Definition: GlobalFunctions.php:375
OutputPage\getVaryHeader
getVaryHeader()
Return a Vary: header on which to vary caches.
Definition: OutputPage.php:2291
OutputPage\addModules
addModules( $modules)
Load one or more ResourceLoader modules on this page.
Definition: OutputPage.php:562
OutputPage\showLagWarning
showLagWarning( $lag)
Show a warning about replica DB lag.
Definition: OutputPage.php:2882
$title
$title
Definition: testCompression.php:38
OutputPage\getCacheVaryCookies
getCacheVaryCookies()
Get the list of cookie names that will influence the cache.
Definition: OutputPage.php:2232
OutputPage\setCopyrightUrl
setCopyrightUrl( $url)
Set the copyright URL to send with the output.
Definition: OutputPage.php:388
OutputPage\$mFollowPolicy
$mFollowPolicy
Definition: OutputPage.php:281
OutputPage\$rlClient
ResourceLoaderClientHtml $rlClient
Definition: OutputPage.php:178
OutputPage\addHtmlClasses
addHtmlClasses( $classes)
Add a class to the <html> element.
Definition: OutputPage.php:646
DB_REPLICA
const DB_REPLICA
Definition: defines.php:25
PROTO_CANONICAL
const PROTO_CANONICAL
Definition: Defines.php:196
ResourceLoader\makeLoaderQuery
static makeLoaderQuery(array $modules, $lang, $skin, $user=null, $version=null, $debug=ResourceLoaderContext::DEBUG_OFF, $only=null, $printable=false, $handheld=false, array $extraQuery=[])
Build a query array (array representation of query string) for load.php.
Definition: ResourceLoader.php:1841
OutputPage\getIndexPolicy
getIndexPolicy()
Get the current index policy for the page as a string.
Definition: OutputPage.php:910
OutputPage\buildBacklinkSubtitle
static buildBacklinkSubtitle(PageReference $page, $query=[])
Build message object for a subtitle containing a backlink to a page.
Definition: OutputPage.php:1092
OutputPage\addBodyClasses
addBodyClasses( $classes)
Add a class to the <body> element.
Definition: OutputPage.php:701
ParserOutput\getIndicators
getIndicators()
Definition: ParserOutput.php:590
ResourceLoaderModule\getOrigin
getOrigin()
Get this module's origin.
Definition: ResourceLoaderModule.php:148
wfDebug
wfDebug( $text, $dest='all', array $context=[])
Sends a line to the debug log if enabled or, optionally, to a comment in output.
Definition: GlobalFunctions.php:894
ContextSource\setContext
setContext(IContextSource $context)
Definition: ContextSource.php:63
OutputPage\isArticle
isArticle()
Return whether the content displayed page is related to the source of the corresponding article on th...
Definition: OutputPage.php:1292
OutputPage
This is one of the Core classes and should be read at least once by any new developers.
Definition: OutputPage.php:50
ParserOutput\getLanguageLinks
& getLanguageLinks()
Definition: ParserOutput.php:570
OutputPage\addWikiTextAsContent
addWikiTextAsContent( $text, $linestart=true, PageReference $title=null)
Convert wikitext in the page content language to HTML and add it to the buffer.
Definition: OutputPage.php:1846
OutputPage\showErrorPage
showErrorPage( $title, $msg, $params=[])
Output a standard error page.
Definition: OutputPage.php:2704
OutputPage\addParserOutputText
addParserOutputText(ParserOutput $parserOutput, $poOptions=[])
Add the HTML associated with a ParserOutput object, without any metadata.
Definition: OutputPage.php:2015
OutputPage\addBacklinkSubtitle
addBacklinkSubtitle(PageReference $title, $query=[])
Add a subtitle containing a backlink to a page.
Definition: OutputPage.php:1115
OutputPage\getCSPNonce
getCSPNonce()
Get (and set if not yet set) the CSP nonce.
Definition: OutputPage.php:4197
OutputPage\$mParserOptions
ParserOptions $mParserOptions
lazy initialised, use parserOptions()
Definition: OutputPage.php:221
OutputPage\$mContainsNewMagic
int $mContainsNewMagic
Definition: OutputPage.php:215
JavaScriptContent
Content for JavaScript pages.
Definition: JavaScriptContent.php:36
OutputPage\$limitReportJSData
array $limitReportJSData
Profiling data.
Definition: OutputPage.php:321
OutputPage\addInlineScript
addInlineScript( $script)
Add a self-contained script tag with the given contents Internal use only.
Definition: OutputPage.php:492
ParserOutput\getTemplateIds
& getTemplateIds()
Definition: ParserOutput.php:618
OutputPage\getArticleBodyOnly
getArticleBodyOnly()
Return whether the output will contain only the body of the article.
Definition: OutputPage.php:721
OutputPage\getPreventClickjacking
getPreventClickjacking()
Get the prevent-clickjacking flag.
Definition: OutputPage.php:2374
ParserOutput\getTOCHTML
getTOCHTML()
Definition: ParserOutput.php:674
OutputPage\$mModules
array $mModules
Definition: OutputPage.php:169
ParserOutput\getExtraCSPScriptSrcs
getExtraCSPScriptSrcs()
Get extra Content-Security-Policy 'script-src' directives.
Definition: ParserOutput.php:711
OutputPage\getCanonicalUrl
getCanonicalUrl()
Returns the URL to be used for the <link rel=canonical>> if one is set.
Definition: OutputPage.php:459
OutputPage\wrapWikiMsg
wrapWikiMsg( $wrap,... $msgSpecs)
This function takes a number of message/argument specifications, wraps them in some overall structure...
Definition: OutputPage.php:4128
OutputPage\setStatusCode
setStatusCode( $statusCode)
Set the HTTP status code to send with the output.
Definition: OutputPage.php:397
PROTO_CURRENT
const PROTO_CURRENT
Definition: Defines.php:195
OutputPage\$mRedirect
string $mRedirect
Definition: OutputPage.php:113
Html\inlineStyle
static inlineStyle( $contents, $media='all', $attribs=[])
Output a "<style>" tag with the given contents for the given media type (if any).
Definition: Html.php:622
ContextSource\msg
msg( $key,... $params)
Get a Message object with context set Parameters are the same as wfMessage()
Definition: ContextSource.php:197
OutputPage\$mIsArticle
bool $mIsArticle
Is the displayed content related to the source of the corresponding wiki article.
Definition: OutputPage.php:92
OutputPage\haveCacheVaryCookies
haveCacheVaryCookies()
Check if the request has a cache-varying cookie header If it does, it's very important that we don't ...
Definition: OutputPage.php:2253
OutputPage\getPageTitle
getPageTitle()
Return the "page title", i.e.
Definition: OutputPage.php:1002
OutputPage\disable
disable()
Disable output completely, i.e.
Definition: OutputPage.php:1153
OutputPage\setIndexPolicy
setIndexPolicy( $policy)
Set the index policy for the page, but leave the follow policy un- touched.
Definition: OutputPage.php:898
Title\makeTitleSafe
static makeTitleSafe( $ns, $title, $fragment='', $interwiki='')
Create a new Title from a namespace index and a DB key.
Definition: Title.php:706
OutputPage\$mResourceLoader
ResourceLoader $mResourceLoader
Definition: OutputPage.php:175
ParserOutput\getNewSection
getNewSection()
Definition: ParserOutput.php:804
$content
$content
Definition: router.php:76
Skin\getPageClasses
getPageClasses( $title)
TODO: document.
Definition: Skin.php:518
OutputPage\addCategoryLinks
addCategoryLinks(array $categories)
Add an array of categories, with names in the keys.
Definition: OutputPage.php:1374
OutputPage\setRevisionTimestamp
setRevisionTimestamp( $timestamp)
Set the timestamp of the revision which will be displayed.
Definition: OutputPage.php:1723
$s
foreach( $mmfl['setupFiles'] as $fileName) if( $queue) if(empty( $mmfl['quiet'])) $s
Definition: mergeMessageFileList.php:206
OutputPage\getHeadItemsArray
getHeadItemsArray()
Get an array of head items.
Definition: OutputPage.php:655
OutputPage\$CSP
ContentSecurityPolicy $CSP
Definition: OutputPage.php:337
OutputPage\addReturnTo
addReturnTo( $title, array $query=[], $text=null, $options=[])
Add a "return to" link pointing to a specified title.
Definition: OutputPage.php:2915
OutputPage\buildExemptModules
buildExemptModules()
Build exempt modules and legacy non-ResourceLoader styles.
Definition: OutputPage.php:3843
OutputPage\$copyrightUrl
string null $copyrightUrl
The URL to send in a <link> element with rel=license.
Definition: OutputPage.php:318
OutputPage\getProperty
getProperty( $name)
Get an additional output property.
Definition: OutputPage.php:743
ParserOptions\newFromContext
static newFromContext(IContextSource $context)
Get a ParserOptions object from a IContextSource object.
Definition: ParserOptions.php:1091
OutputPage\addWikiMsg
addWikiMsg(... $args)
Add a wikitext-formatted message to the output.
Definition: OutputPage.php:4085
Html\inlineScript
static inlineScript( $contents, $nonce=null)
Output an HTML script tag with the given contents.
Definition: Html.php:575
ContextSource\getAuthority
getAuthority()
Definition: ContextSource.php:144
$header
$header
Definition: updateCredits.php:37
OutputPage\addHelpLink
addHelpLink( $to, $overrideBaseUrl=false)
Adds help link with an icon via page indicators.
Definition: OutputPage.php:1535
OutputPage\formatPermissionsErrorMessage
formatPermissionsErrorMessage(array $errors, $action=null)
Format a list of error messages.
Definition: OutputPage.php:2843
ParserOutput\getOutputHooks
getOutputHooks()
Definition: ParserOutput.php:662
ContextSource\getCsrfTokenSet
getCsrfTokenSet()
Get a repository to obtain and match CSRF tokens.
Definition: ContextSource.php:219
OutputPage\setTarget
setTarget( $target)
Sets ResourceLoader target for load.php links.
Definition: OutputPage.php:604
OutputPage\getRobotPolicy
getRobotPolicy()
Get the current robot policy for the page as a string in the form <index policy>,<follow policy>.
Definition: OutputPage.php:888
ParserOutput\getHideNewSection
getHideNewSection()
Definition: ParserOutput.php:800
OutputPage\setTitle
setTitle(PageReference $t)
Set the Title object to use.
Definition: OutputPage.php:1053
MediaWiki\Session\SessionManager
This serves as the entry point to the MediaWiki session handling system.
Definition: SessionManager.php:83
OutputPage\addContentOverride
addContentOverride( $target, Content $content)
Force the given Content object for the given page, for things like page preview.
Definition: OutputPage.php:615
OutputPage\$contentOverrideCallbacks
callable[] $contentOverrideCallbacks
Definition: OutputPage.php:327
OutputPage\setHTMLTitle
setHTMLTitle( $name)
"HTML title" means the contents of "<title>".
Definition: OutputPage.php:942
DerivativeResourceLoaderContext
A mutable version of ResourceLoaderContext.
Definition: DerivativeResourceLoaderContext.php:33
OutputPage\$mMetatags
string[][] $mMetatags
Should be private.
Definition: OutputPage.php:54
OutputPage\setLanguageLinks
setLanguageLinks(array $newLinkArray)
Reset the language links and add new language links.
Definition: OutputPage.php:1356
OutputPage\setupOOUI
static setupOOUI( $skinName='default', $dir='ltr')
Helper function to setup the PHP implementation of OOUI to use in this request.
Definition: OutputPage.php:4159
OutputPage\$rlExemptStyleModules
array $rlExemptStyleModules
Definition: OutputPage.php:184
OutputPage\$mAdditionalHtmlClasses
array $mAdditionalHtmlClasses
Additional <html> classes; This should be rarely modified; prefer mAdditionalBodyClasses.
Definition: OutputPage.php:160
OutputPage\$mProperties
$mProperties
Additional key => value data.
Definition: OutputPage.php:303
OutputPage\prependHTML
prependHTML( $text)
Prepend $text to the body HTML.
Definition: OutputPage.php:1618
ParserOutput\getNoGallery
getNoGallery()
Definition: ParserOutput.php:638
OutputPage\getHTMLTitle
getHTMLTitle()
Return the "HTML title", i.e.
Definition: OutputPage.php:955
OutputPage\$cacheIsFinal
bool $cacheIsFinal
See OutputPage::couldBePublicCached.
Definition: OutputPage.php:77
OutputPage\clearSubtitle
clearSubtitle()
Clear the subtitles.
Definition: OutputPage.php:1122
OutputPage\warnModuleTargetFilter
warnModuleTargetFilter( $moduleName)
Definition: OutputPage.php:524
OutputPage\$mCdnMaxage
int $mCdnMaxage
Cache stuff.
Definition: OutputPage.php:250
OutputPage\enableOOUI
enableOOUI()
Add ResourceLoader module styles for OOUI and set up the PHP implementation of it for use with MediaW...
Definition: OutputPage.php:4174
OutputPage\$cacheVaryCookies
static array $cacheVaryCookies
A cache of the names of the cookies that will influence the cache.
Definition: OutputPage.php:342
OutputPage\$mScripts
$mScripts
Used for JavaScript (predates ResourceLoader)
Definition: OutputPage.php:145
OutputPage\$mAllowedModules
array $mAllowedModules
What level of 'untrustworthiness' is allowed in CSS/JS modules loaded on this page?
Definition: OutputPage.php:205
getSkinThemeMap
static getSkinThemeMap()
Return a map of skin names (in lowercase) to OOUI theme names, defining which theme a given skin shou...
Definition: ResourceLoaderOOUIModule.php:76
OutputPage\$mPrintable
bool $mPrintable
We have to set isPrintable().
Definition: OutputPage.php:104
IContextSource
Interface for objects which can provide a MediaWiki context on request.
Definition: IContextSource.php:58
OutputPage\$mLanguageLinks
array $mLanguageLinks
Array of Interwiki Prefixed (non DB key) Titles (e.g.
Definition: OutputPage.php:137
MediaWiki\Permissions\PermissionStatus
A StatusValue for permission errors.
Definition: PermissionStatus.php:35
OutputPage\setCategoryLinks
setCategoryLinks(array $categories)
Reset the category links (but not the category list) and add $categories.
Definition: OutputPage.php:1460
OutputPage\setFollowPolicy
setFollowPolicy( $policy)
Set the follow policy for the page, but leave the index policy un- touched.
Definition: OutputPage.php:920
Content
Base interface for content objects.
Definition: Content.php:35
OutputPage\setPageTitle
setPageTitle( $name)
"Page title" means the contents of <h1>.
Definition: OutputPage.php:980
OutputPage\getRlClient
getRlClient()
Call this to freeze the module queue and JS config and create a formatter.
Definition: OutputPage.php:3014
ResourceLoaderClientHtml\makeLoad
static makeLoad(ResourceLoaderContext $mainContext, array $modules, $only, array $extraQuery=[], $nonce=null)
Explicitly load or embed modules on a page.
Definition: ResourceLoaderClientHtml.php:388
OutputPage\$mFileVersion
array $mFileVersion
Definition: OutputPage.php:268
OutputPage\checkLastModified
checkLastModified( $timestamp)
checkLastModified tells the client to use the client-cached page if possible.
Definition: OutputPage.php:758
OutputPage\$mNoGallery
bool $mNoGallery
Comes from the parser.
Definition: OutputPage.php:247
OutputPage\$mHeadItems
array $mHeadItems
Array of elements in "<head>".
Definition: OutputPage.php:163
OutputPage\$mRevisionTimestamp
string $mRevisionTimestamp
Definition: OutputPage.php:265
OutputPage\$displayTitle
string $displayTitle
The displayed title of the page.
Definition: OutputPage.php:74
ParserOutput\getFileSearchOptions
& getFileSearchOptions()
Definition: ParserOutput.php:626
Title
Represents a title within MediaWiki.
Definition: Title.php:49
ResourceLoaderModule
Abstraction for ResourceLoader modules, with name registration and maxage functionality.
Definition: ResourceLoaderModule.php:39
OutputPage\setCdnMaxage
setCdnMaxage( $maxage)
Set the value of the "s-maxage" part of the "Cache-control" HTTP header.
Definition: OutputPage.php:2138
Parser\stripOuterParagraph
static stripOuterParagraph( $html)
Strip outer.
Definition: Parser.php:6310
OutputPage\getAllowedModules
getAllowedModules( $type)
Show what level of JavaScript / CSS untrustworthiness is allowed on this page.
Definition: OutputPage.php:1592
ResourceLoader
ResourceLoader is a loading system for JavaScript and CSS resources.
Definition: ResourceLoader.php:58
OutputPage\addVaryHeader
addVaryHeader( $header, array $option=null)
Add an HTTP header that will influence on the cache.
Definition: OutputPage.php:2274
ContentHandler\getContentText
static getContentText(Content $content=null)
Convenience function for getting flat text from a Content object.
Definition: ContentHandler.php:93
OutputPage\setProperty
setProperty( $name, $value)
Set an additional output property.
Definition: OutputPage.php:732
OutputPage\isPrintable
isPrintable()
Return whether the page is "printable".
Definition: OutputPage.php:1146
OutputPage\setSyndicated
setSyndicated( $show=true)
Add or remove feed links in the page header This is mainly kept for backward compatibility,...
Definition: OutputPage.php:1192
OutputPage\wrapWikiTextAsInterface
wrapWikiTextAsInterface( $wrapperClass, $text)
Convert wikitext in the user interface language to HTML and add it to the buffer with a <div class="$...
Definition: OutputPage.php:1821
OutputPage\$mTarget
string null $mTarget
ResourceLoader target for load.php links.
Definition: OutputPage.php:308
OutputPage\addInlineStyle
addInlineStyle( $style_css, $flip='noflip')
Adds inline CSS styles Internal use only.
Definition: OutputPage.php:3830
ResourceLoaderClientHtml\setModules
setModules(array $modules)
Ensure one or more modules are loaded.
Definition: ResourceLoaderClientHtml.php:88
OutputPage\userCanPreview
userCanPreview()
To make it harder for someone to slip a user a fake JavaScript or CSS preview, a random token is asso...
Definition: OutputPage.php:3475
Html\linkedStyle
static linkedStyle( $url, $media='all')
Output a "<link rel=stylesheet>" linking to the given URL for the given media type (if any).
Definition: Html.php:651
OutputPage\$mPageTitle
string $mPageTitle
The contents of.
Definition: OutputPage.php:65
ResourceLoader\inDebugMode
static inDebugMode()
Determine whether debug mode is on.
Definition: ResourceLoader.php:1756
ResourceLoaderClientHtml\setModuleStyles
setModuleStyles(array $modules)
Ensure the styles of one or more modules are loaded.
Definition: ResourceLoaderClientHtml.php:97
OutputPage\filterModules
filterModules(array $modules, $position=null, $type=ResourceLoaderModule::TYPE_COMBINED)
Filter an array of modules to remove insufficiently trustworthy members, and modules which are no lon...
Definition: OutputPage.php:504
WebRequest\getRequestId
static getRequestId()
Get the current request ID.
Definition: WebRequest.php:330
OutputPage\redirect
redirect( $url, $responsecode='302')
Redirect to $url rather than displaying the normal page.
Definition: OutputPage.php:365
OutputPage\getUnprefixedDisplayTitle
getUnprefixedDisplayTitle()
Returns page display title without namespace prefix if possible.
Definition: OutputPage.php:1040
IContextSource\getConfig
getConfig()
Get the site configuration.
OutputPage\$mJsConfigVars
array $mJsConfigVars
Definition: OutputPage.php:187
$path
$path
Definition: NoLocalSettings.php:25
ParserOutput\getCategories
& getCategories()
Definition: ParserOutput.php:582
OutputPage\setPrintable
setPrintable()
Set the page as printable, i.e.
Definition: OutputPage.php:1137
OutputPage\getHeadLinksArray
getHeadLinksArray()
Definition: OutputPage.php:3505
OutputPage\adaptCdnTTL
adaptCdnTTL( $mtime, $minTTL=0, $maxTTL=0)
Get TTL in [$minTTL,$maxTTL] and pass it to lowerCdnMaxage()
Definition: OutputPage.php:2168
OutputPage\getCdnCacheEpoch
getCdnCacheEpoch( $reqTime, $maxAge)
Definition: OutputPage.php:846
OutputPage\allowClickjacking
allowClickjacking()
Turn off frame-breaking.
Definition: OutputPage.php:2364
LanguageCode\bcp47
static bcp47( $code)
Get the normalised IETF language tag See unit test for examples.
Definition: LanguageCode.php:175
OutputPage\loadSkinModules
loadSkinModules( $sk)
Transfer styles and JavaScript modules from skin.
Definition: OutputPage.php:2518
OutputPage\showFatalError
showFatalError( $message)
Output an error page.
Definition: OutputPage.php:2901
Html\openElement
static openElement( $element, $attribs=[])
Identical to rawElement(), but has no third parameter and omits the end tag (and the self-closing '/'...
Definition: Html.php:254
Html\rawElement
static rawElement( $element, $attribs=[], $contents='')
Returns an HTML element in a string.
Definition: Html.php:212
OutputPage\getHTML
getHTML()
Get the body HTML.
Definition: OutputPage.php:1656
Message
The Message class deals with fetching and processing of interface message into a variety of formats.
Definition: Message.php:138
OutputPage\$mRevisionId
int null $mRevisionId
To include the variable {{REVISIONID}}.
Definition: OutputPage.php:262
OutputPage\parseInlineAsInterface
parseInlineAsInterface( $text, $linestart=true)
Parse wikitext in the user interface language, strip paragraph wrapper, and return the HTML.
Definition: OutputPage.php:2096
OutputPage\$mLinkHeader
$mLinkHeader
Link: header contents.
Definition: OutputPage.php:332
NS_CATEGORY
const NS_CATEGORY
Definition: Defines.php:78
$keys
$keys
Definition: testCompression.php:72
OutputPage\$styles
array $styles
An array of stylesheet filenames (relative from skins path), with options for CSS media,...
Definition: OutputPage.php:278
OutputPage\isRevisionCurrent
isRevisionCurrent()
Whether the revision displayed is the latest revision of the page.
Definition: OutputPage.php:1712
Sanitizer\normalizeCharReferences
static normalizeCharReferences( $text)
Ensure that any entities and character references are legal for XML and XHTML specifically.
Definition: Sanitizer.php:1123
MWDebug\addModules
static addModules(OutputPage $out)
Add ResourceLoader modules to the OutputPage object if debugging is enabled.
Definition: MWDebug.php:125
CacheTime\isCacheable
isCacheable()
Definition: CacheTime.php:168
IContextSource\getRequest
getRequest()
OutputPage\showNewSectionLink
showNewSectionLink()
Show an "add new section" link?
Definition: OutputPage.php:1171
Title\castFromPageReference
static castFromPageReference(?PageReference $pageReference)
Return a Title for a given Reference.
Definition: Title.php:377
OutputPage\$mPageLinkTitle
string $mPageLinkTitle
Used by skin template.
Definition: OutputPage.php:154
ParserOutput\getText
getText( $options=[])
Get the output HTML.
Definition: ParserOutput.php:350
OutputPage\$mCanonicalUrl
string bool $mCanonicalUrl
Definition: OutputPage.php:60
OutputPage\makeResourceLoaderLink
makeResourceLoaderLink( $modules, $only, array $extraQuery=[])
Explicily load or embed modules on a page.
Definition: OutputPage.php:3204
OutputPage\getIndicators
getIndicators()
Get the indicators associated with this page.
Definition: OutputPage.php:1523
$t
$t
Definition: testCompression.php:74
$wgRequest
if(! $wgDBerrorLogTZ) $wgRequest
Definition: Setup.php:682
Html\element
static element( $element, $attribs=[], $contents='')
Identical to rawElement(), but HTML-escapes $contents (like Xml::element()).
Definition: Html.php:234
OutputPage\addWikiTextTitleInternal
addWikiTextTitleInternal( $text, PageReference $title, $linestart, $interface, $wrapperClass=null)
Add wikitext with a custom Title object.
Definition: OutputPage.php:1870
Skin\getSkinName
getSkinName()
Definition: Skin.php:204
MediaWiki\Linker\LinkTarget
Definition: LinkTarget.php:26
OutputPage\addJsConfigVars
addJsConfigVars( $keys, $value=null)
Add one or more variables to be set in mw.config in JavaScript.
Definition: OutputPage.php:3270
OutputPage\$mPreventClickjacking
bool $mPreventClickjacking
Controls if anti-clickjacking / frame-breaking headers will be sent.
Definition: OutputPage.php:259
Skin
The main skin class which provides methods and properties for all other skins.
Definition: Skin.php:44
OutputPage\getFollowPolicy
getFollowPolicy()
Get the current follow policy for the page as a string.
Definition: OutputPage.php:932
OutputPage\getCategories
getCategories( $type='all')
Get the list of category names this page belongs to.
Definition: OutputPage.php:1486
OutputPage\getJsConfigVars
getJsConfigVars()
Get the javascript config vars to include on this page.
Definition: OutputPage.php:3260
OutputPage\setCopyright
setCopyright( $hasCopyright)
Set whether the standard copyright should be shown for the current page.
Definition: OutputPage.php:1323
OutputPage\getTemplateIds
getTemplateIds()
Get the templates used on this page.
Definition: OutputPage.php:1766
$IP
$IP
Definition: WebStart.php:49
OutputPage\$mIsArticleRelated
bool $mIsArticleRelated
Stores "article flag" toggle.
Definition: OutputPage.php:95
Skin\isResponsive
isResponsive()
Indicates if this skin is responsive.
Definition: Skin.php:217
OutputPage\isSyndicated
isSyndicated()
Should we output feed links for this page?
Definition: OutputPage.php:1251
OutputPage\$mFeedLinksAppendQuery
$mFeedLinksAppendQuery
Definition: OutputPage.php:198
OutputPage\getFileSearchOptions
getFileSearchOptions()
Get the files used on this page.
Definition: OutputPage.php:1776
OutputPage\$mFeedLinks
$mFeedLinks
Handles the Atom / RSS links.
Definition: OutputPage.php:228
OutputPage\$mDoNothing
bool $mDoNothing
Whether output is disabled.
Definition: OutputPage.php:210
OutputPage\$mArticleBodyOnly
bool $mArticleBodyOnly
Flag if output should only contain the body of the article.
Definition: OutputPage.php:234
OutputPage\$mRedirectedFrom
PageReference $mRedirectedFrom
If the current page was reached through a redirect, $mRedirectedFrom contains the title of the redire...
Definition: OutputPage.php:298
OutputPage\$mHasCopyright
bool $mHasCopyright
Is the content subject to copyright.
Definition: OutputPage.php:98
OutputPage\addParserOutput
addParserOutput(ParserOutput $parserOutput, $poOptions=[])
Add everything from a ParserOutput object.
Definition: OutputPage.php:2027
OutputPage\$mAdditionalBodyClasses
array $mAdditionalBodyClasses
Additional <body> classes; there are also <body> classes from other sources.
Definition: OutputPage.php:166
ContentSecurityPolicy
Definition: ContentSecurityPolicy.php:32
OutputPage\prepareErrorPage
prepareErrorPage( $pageTitle, $htmlTitle=false)
Prepare this object to display an error page; disable caching and indexing, clear the current text an...
Definition: OutputPage.php:2679
OutputPage\addTemplate
addTemplate(&$template)
Add the output of a QuickTemplate to the output buffer.
Definition: OutputPage.php:2037
OutputPage\$mIndicators
string[] $mIndicators
Definition: OutputPage.php:134
OutputPage\getFeedAppendQuery
getFeedAppendQuery()
Will currently always return null.
Definition: OutputPage.php:1268
OutputPage\lowerCdnMaxage
lowerCdnMaxage( $maxage)
Set the value of the "s-maxage" part of the "Cache-control" HTTP header to $maxage if that is lower t...
Definition: OutputPage.php:2151
OutputPage\$mHTMLtitle
string $mHTMLtitle
Stores contents of "<title>" tag.
Definition: OutputPage.php:86
ParserOutput\getExtraCSPStyleSrcs
getExtraCSPStyleSrcs()
Get extra Content-Security-Policy 'style-src' directives.
Definition: ParserOutput.php:720
wfExpandUrl
wfExpandUrl( $url, $defaultProto=PROTO_CURRENT)
Expand a potentially local URL to a fully-qualified URL.
Definition: GlobalFunctions.php:474
OutputPage\addFeedLink
addFeedLink( $format, $href)
Add a feed link to the page header.
Definition: OutputPage.php:1241
ParserOutput\preventClickjacking
preventClickjacking( $flag=null)
Get or set the prevent-clickjacking flag.
Definition: ParserOutput.php:1368
OutputPage\transformResourcePath
static transformResourcePath(Config $config, $path)
Transform path to web-accessible static resource.
Definition: OutputPage.php:3974
OutputPage\parseAsContent
parseAsContent( $text, $linestart=true)
Parse wikitext in the page content language and return the HTML.
Definition: OutputPage.php:2052
OutputPage\getAdvertisedFeedTypes
getAdvertisedFeedTypes()
Return effective list of advertised feed types.
Definition: OutputPage.php:1206
OutputPage\setRobotPolicy
setRobotPolicy( $policy)
Set the robot policy for the page: http://www.robotstxt.org/meta.html
Definition: OutputPage.php:871
wfArrayToCgi
wfArrayToCgi( $array1, $array2=null, $prefix='')
This function takes one or two arrays as input, and returns a CGI-style string, e....
Definition: GlobalFunctions.php:330
OutputPage\transformFilePath
static transformFilePath( $remotePathPrefix, $localPath, $file)
Utility method for transformResourceFilePath().
Definition: OutputPage.php:4016
OutputPage\headElement
headElement(Skin $sk, $includeStyle=true)
Definition: OutputPage.php:3090
$type
$type
Definition: testCompression.php:52
OutputPage\$mStatusCode
int $mStatusCode
Definition: OutputPage.php:116
OutputPage\formatPermissionStatus
formatPermissionStatus(PermissionStatus $status, string $action=null)
Format permission $status obtained from Authority for display.
Definition: OutputPage.php:2828