mirror of
https://gerrit.wikimedia.org/r/mediawiki/skins/Vector.git
synced 2024-12-23 13:12:44 +00:00
94d1bee402
* Use !== instead of != * Avoid else after return * Use falsey check for object is null * Use consistently spaces inside of brackets Change-Id: I2928664acbab315ab3eae38c74f87b019d46cf29
105 lines
3.4 KiB
PHP
105 lines
3.4 KiB
PHP
<?php
|
|
|
|
namespace MediaWiki\Skins\Vector;
|
|
|
|
use MediaWiki\MediaWikiServices;
|
|
use MediaWiki\Request\WebRequest;
|
|
use MediaWiki\Title\Title;
|
|
|
|
/**
|
|
* @stable for use inside Minerva as a soft dependency temporarily until T360452 is resolved.
|
|
* @see doc/adr/0004-code-sharing-between-vector-and-minerva.md
|
|
*/
|
|
class ConfigHelper {
|
|
|
|
/**
|
|
* Determine whether the configuration should be disabled on the page.
|
|
*
|
|
* @param array $options read from MediaWiki configuration.
|
|
* $params = [
|
|
* 'exclude' => [
|
|
* 'mainpage' => (bool) should it be disabled on the main page?
|
|
* 'namespaces' => int[] namespaces it should be excluded on.
|
|
* 'querystring' => array of strings mapping to regex for patterns
|
|
* the query strings it should be excluded on
|
|
* e.g. [ 'action' => '*' ] disable on all actions
|
|
* 'pagetitles' => string[] of pages it should be excluded on.
|
|
* For special pages, use canonical English name.
|
|
* ]
|
|
* ]
|
|
* @param WebRequest $request
|
|
* @param Title|null $title
|
|
*
|
|
* @return bool
|
|
*/
|
|
public static function shouldDisable( array $options, WebRequest $request, Title $title = null ) {
|
|
$canonicalTitle = $title ? $title->getRootTitle() : null;
|
|
|
|
$exclusions = $options[ 'exclude' ] ?? [];
|
|
$inclusions = $options[ 'include' ] ?? [];
|
|
|
|
$excludeQueryString = $exclusions[ 'querystring' ] ?? [];
|
|
foreach ( $excludeQueryString as $param => $excludedParamPattern ) {
|
|
$paramValue = $request->getRawVal( $param );
|
|
if ( $paramValue !== null ) {
|
|
if ( $excludedParamPattern === '*' ) {
|
|
// Backwards compatibility for the '*' wildcard.
|
|
$excludedParamPattern = '.+';
|
|
}
|
|
return (bool)preg_match( "/$excludedParamPattern/", $paramValue );
|
|
}
|
|
}
|
|
|
|
if ( $title && $title->isMainPage() ) {
|
|
// only one check to make
|
|
return $exclusions[ 'mainpage' ] ?? false;
|
|
}
|
|
if ( $canonicalTitle && $canonicalTitle->isSpecialPage() ) {
|
|
$spFactory = MediaWikiServices::getInstance()->getSpecialPageFactory();
|
|
[ $canonicalName, $par ] = $spFactory->resolveAlias( $canonicalTitle->getDBKey() );
|
|
if ( $canonicalName ) {
|
|
$canonicalTitle = Title::makeTitle( NS_SPECIAL, $canonicalName );
|
|
}
|
|
}
|
|
|
|
//
|
|
// Check the inclusions based on the canonical title
|
|
// The inclusions are checked first as these trump any exclusions.
|
|
//
|
|
// Now we have the canonical title and the inclusions link we look for any matches.
|
|
foreach ( $inclusions as $titleText ) {
|
|
$includedTitle = Title::newFromText( $titleText );
|
|
|
|
if ( $canonicalTitle->equals( $includedTitle ) ) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
//
|
|
// Check the excluded page titles based on the canonical title
|
|
//
|
|
// Now we have the canonical title and the exclusions link we look for any matches.
|
|
$pageTitles = $exclusions[ 'pagetitles' ] ?? [];
|
|
foreach ( $pageTitles as $titleText ) {
|
|
// use strtolower to make sure the config passed for special pages
|
|
// is case insensitive, so it does not generate a wrong special page title
|
|
$excludedTitle = Title::newFromText( $titleText );
|
|
|
|
if ( $canonicalTitle && $canonicalTitle->equals( $excludedTitle ) ) {
|
|
return true;
|
|
}
|
|
}
|
|
|
|
//
|
|
// Check the exclusions
|
|
// If nothing matches the exclusions to determine what should happen
|
|
//
|
|
$excludeNamespaces = $exclusions[ 'namespaces' ] ?? [];
|
|
if ( $title && $title->inNamespaces( $excludeNamespaces ) ) {
|
|
return true;
|
|
}
|
|
|
|
return false;
|
|
}
|
|
}
|