e662614f95
Implicitly marking parameter $... as nullable is deprecated in php8.4, the explicit nullable type must be used instead Created with autofix from Ide15839e98a6229c22584d1c1c88c690982e1d7a Break one long line in SpecialPage.php Bug: T376276 Change-Id: I807257b2ba1ab2744ab74d9572c9c3d3ac2a968e
785 lines
27 KiB
PHP
785 lines
27 KiB
PHP
<?php
|
|
/**
|
|
* This program is free software; you can redistribute it and/or modify
|
|
* it under the terms of the GNU General Public License as published by
|
|
* the Free Software Foundation; either version 2 of the License, or
|
|
* (at your option) any later version.
|
|
*
|
|
* This program is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
* GNU General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU General Public License along
|
|
* with this program; if not, write to the Free Software Foundation, Inc.,
|
|
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
|
* http://www.gnu.org/copyleft/gpl.html
|
|
*
|
|
* @file
|
|
*/
|
|
namespace MediaWiki\ResourceLoader;
|
|
|
|
use InvalidArgumentException;
|
|
use MediaWiki\Config\Config;
|
|
use MediaWiki\MainConfigNames;
|
|
use MediaWiki\Output\OutputPage;
|
|
use Wikimedia\Minify\CSSMin;
|
|
|
|
/**
|
|
* Module for skin stylesheets.
|
|
*
|
|
* @ingroup ResourceLoader
|
|
* @internal
|
|
*/
|
|
class SkinModule extends LessVarFileModule {
|
|
|
|
/**
|
|
* Every skin should define which features it would like to reuse for core inside a
|
|
* ResourceLoader module that has set the class to SkinModule.
|
|
* For a feature to be valid it must be listed here along with the associated resources
|
|
*
|
|
* The following features are available:
|
|
*
|
|
* "accessibility":
|
|
* Adds universal accessibility rules.
|
|
*
|
|
* "logo":
|
|
* Adds CSS to style an element with class `mw-wiki-logo` using the value of wgLogos['1x'].
|
|
* This is enabled by default if no features are added.
|
|
*
|
|
* "normalize":
|
|
* Styles needed to normalize rendering across different browser rendering engines.
|
|
* All to address bugs and common browser inconsistencies for skins and extensions.
|
|
* Inspired by necolas' normalize.css. This is meant to be kept lean,
|
|
* basic styling beyond normalization should live in one of the following modules.
|
|
*
|
|
* "elements":
|
|
* The base level that only contains the most basic of common skin styles.
|
|
* Only styles for single elements are included, no styling for complex structures like the
|
|
* TOC is present. This level is for skins that want to implement the entire style of even
|
|
* content area structures like the TOC themselves.
|
|
*
|
|
* "content-media":
|
|
* Styles for thumbnails and floated elements.
|
|
* Will add styles for the new media structure on wikis where $wgParserEnableLegacyMediaDOM is disabled,
|
|
* or $wgUseContentMediaStyles is enabled.
|
|
* See https://www.mediawiki.org/wiki/Parsing/Media_structure
|
|
*
|
|
* Compatibility aliases: "content", "content-thumbnails".
|
|
*
|
|
* "content-links":
|
|
* The skin will apply optional styling rules for links that should be styled differently
|
|
* to the rules in `elements` and `normalize`. It provides support for .mw-selflink,
|
|
* a.new (red links), a.stub (stub links) and some basic styles for external links.
|
|
* It also provides rules supporting the underline user preference.
|
|
*
|
|
* "content-links-external":
|
|
* The skin will apply optional styling rules to links to provide icons for different file types.
|
|
*
|
|
* "content-body":
|
|
* Styles for the mw-parser-output class.
|
|
*
|
|
* "content-tables":
|
|
* Styles .wikitable style tables.
|
|
*
|
|
* "interface":
|
|
* Shorthand for a set of styles that are common
|
|
* to skins like MonoBook, Vector, etc... Essentially this level is for styles that are
|
|
* common to MonoBook clones.
|
|
* This enables interface-core, interface-indicators, interface-subtitle,
|
|
* interface-user-message, interface-site-notice and interface-edit-section-links.
|
|
*
|
|
* "interface-category":
|
|
* Styles used for styling the categories in a horizontal bar at the bottom of the content.
|
|
*
|
|
* "interface-core":
|
|
* Required interface core styles. Disabling these is not recommended.
|
|
*
|
|
* "interface-edit-section-links":
|
|
* Default interface styling for edit section links.
|
|
*
|
|
* "interface-indicators":
|
|
* Default interface styling for indicators.
|
|
*
|
|
* "interface-message-box":
|
|
* Styles for message boxes. Can be used by skins that do not load Codex styles on page load.
|
|
* Deprecated since MediaWiki 1.43. Skins should now use CodexModule::class to style messages.
|
|
*
|
|
* "interface-site-notice":
|
|
* Default interface styling for site notices.
|
|
*
|
|
* "interface-subtitle":
|
|
* Default interface styling for subtitle area.
|
|
*
|
|
* "interface-user-message":
|
|
* Default interface styling for html-user-message (you have new talk page messages box)
|
|
*
|
|
* "i18n-ordered-lists":
|
|
* Styles for ordered lists elements that support mixed language content.
|
|
*
|
|
* "i18n-all-lists-margins":
|
|
* Deprecated since MediaWiki 1.43. It's merged into the `elements` module.
|
|
*
|
|
* "i18n-headings":
|
|
* Styles for line-heights of headings across different languages.
|
|
*
|
|
* "toc"
|
|
* Styling rules for the table of contents.
|
|
*
|
|
* NOTE: The order of the keys defines the order in which the styles are output.
|
|
*/
|
|
private const FEATURE_FILES = [
|
|
'accessibility' => [
|
|
'all' => [ 'resources/src/mediawiki.skinning/accessibility.less' ],
|
|
],
|
|
'normalize' => [
|
|
'all' => [ 'resources/src/mediawiki.skinning/normalize.less' ],
|
|
],
|
|
'logo' => [
|
|
// Applies the logo and ensures it downloads prior to printing.
|
|
'all' => [ 'resources/src/mediawiki.skinning/logo.less' ],
|
|
// Reserves whitespace for the logo in a pseudo element.
|
|
'print' => [ 'resources/src/mediawiki.skinning/logo-print.less' ],
|
|
],
|
|
// Placeholder for dynamic definition in getFeatureFilePaths()
|
|
'content-media' => [],
|
|
'content-links' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/content.links.less' ]
|
|
],
|
|
'content-links-external' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/content.externallinks.less' ]
|
|
],
|
|
'content-body' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/content.body.less' ],
|
|
'print' => [ 'resources/src/mediawiki.skinning/content.body-print.less' ],
|
|
],
|
|
'content-tables' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/content.tables.less' ],
|
|
'print' => [ 'resources/src/mediawiki.skinning/content.tables-print.less' ]
|
|
],
|
|
'interface-category' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/interface.category.less' ],
|
|
'print' => [ 'resources/src/mediawiki.skinning/interface.category-print.less' ],
|
|
],
|
|
'interface-core' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/interface.less' ],
|
|
'print' => [ 'resources/src/mediawiki.skinning/interface-print.less' ],
|
|
],
|
|
'interface-edit-section-links' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/interface-edit-section-links.less' ],
|
|
],
|
|
'interface-indicators' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/interface-indicators.less' ],
|
|
],
|
|
'interface-site-notice' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/interface-site-notice.less' ],
|
|
],
|
|
'interface-subtitle' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/interface-subtitle.less' ],
|
|
],
|
|
'interface-message-box' => [
|
|
'all' => [ 'resources/src/mediawiki.skinning/messageBoxes.less' ],
|
|
],
|
|
'interface-user-message' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/interface-user-message.less' ],
|
|
],
|
|
'elements' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/elements.less' ],
|
|
'print' => [ 'resources/src/mediawiki.skinning/elements-print.less' ],
|
|
],
|
|
'i18n-ordered-lists' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/i18n-ordered-lists.less' ],
|
|
],
|
|
'i18n-all-lists-margins' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/i18n-all-lists-margins.less' ],
|
|
],
|
|
'i18n-headings' => [
|
|
'screen' => [ 'resources/src/mediawiki.skinning/i18n-headings.less' ],
|
|
],
|
|
'toc' => [
|
|
'all' => [ 'resources/src/mediawiki.skinning/toc/common.less' ],
|
|
'screen' => [ 'resources/src/mediawiki.skinning/toc/screen.less' ],
|
|
'print' => [ 'resources/src/mediawiki.skinning/toc/print.less' ],
|
|
],
|
|
];
|
|
|
|
private const COMPAT_ALIASES = [
|
|
// MediaWiki 1.36
|
|
'content-parser-output' => 'content-body',
|
|
// MediaWiki 1.37
|
|
'content' => 'content-media',
|
|
'content-thumbnails' => 'content-media',
|
|
// MediaWiki 1.39
|
|
// The 'legacy' feature has been folded into other features that relevant skins
|
|
// are expected to have already enabled separately. It is now a no-op that can
|
|
// be safely removed from any skin.json files (T89981, T304325).
|
|
'legacy' => null,
|
|
];
|
|
|
|
/** @var string[] */
|
|
private $features;
|
|
|
|
/**
|
|
* Defaults for when a 'features' parameter is specified.
|
|
*
|
|
* When these apply, they are the merged into the specified options.
|
|
*/
|
|
private const DEFAULT_FEATURES_SPECIFIED = [
|
|
'accessibility' => true,
|
|
'content-body' => true,
|
|
'interface-core' => true,
|
|
'toc' => true
|
|
];
|
|
|
|
/**
|
|
* Default for when the 'features' parameter is absent.
|
|
*
|
|
* For backward-compatibility, when the parameter is not declared
|
|
* only 'logo' styles are loaded.
|
|
*/
|
|
private const DEFAULT_FEATURES_ABSENT = [
|
|
'logo',
|
|
];
|
|
|
|
private const LESS_MESSAGES = [
|
|
// `toc` feature, used in screen.less
|
|
'hidetoc',
|
|
'showtoc',
|
|
];
|
|
|
|
/**
|
|
* @param array $options
|
|
* - features: Map from feature keys to boolean indicating whether to load
|
|
* or not include the associated styles.
|
|
* Keys not specified get their default from self::DEFAULT_FEATURES_SPECIFIED.
|
|
*
|
|
* If this is set to a list of strings, then the defaults do not apply.
|
|
* Use this at your own risk as it means you opt-out from backwards compatibility
|
|
* provided through these defaults. For example, when features are migrated
|
|
* to the SkinModule system from other parts of MediaWiki, those new feature keys
|
|
* may be enabled by default, and opting out means you may be missing some styles
|
|
* after an upgrade until you enable them or implement them by other means.
|
|
*
|
|
* - lessMessages: Interface message keys to export as LESS variables.
|
|
* See also LessVarFileModule.
|
|
*
|
|
* @param string|null $localBasePath
|
|
* @param string|null $remoteBasePath
|
|
* @see Additonal options at $wgResourceModules
|
|
*/
|
|
public function __construct(
|
|
array $options = [],
|
|
$localBasePath = null,
|
|
$remoteBasePath = null
|
|
) {
|
|
$features = $options['features'] ?? self::DEFAULT_FEATURES_ABSENT;
|
|
$listMode = array_keys( $features ) === range( 0, count( $features ) - 1 );
|
|
|
|
$messages = '';
|
|
// NOTE: Compatibility is only applied when features are provided
|
|
// in map-form. The list-form takes full control instead.
|
|
$features = $listMode ?
|
|
self::applyFeaturesCompatibility(
|
|
array_fill_keys( $features, true ),
|
|
false,
|
|
$messages
|
|
)
|
|
: self::applyFeaturesCompatibility( $features, true, $messages );
|
|
|
|
foreach ( $features as $key => $enabled ) {
|
|
if ( !isset( self::FEATURE_FILES[$key] ) ) {
|
|
throw new InvalidArgumentException( "Feature '$key' is not recognised" );
|
|
}
|
|
}
|
|
|
|
$this->features = $listMode
|
|
? array_keys( array_filter( $features ) )
|
|
: array_keys( array_filter( $features + self::DEFAULT_FEATURES_SPECIFIED ) );
|
|
|
|
// Only the `toc` feature makes use of interface messages.
|
|
// For skins not using the `toc` feature, make sure LocalisationCache
|
|
// remains untouched (T270027).
|
|
if ( in_array( 'toc', $this->features ) ) {
|
|
$options['lessMessages'] = array_merge(
|
|
$options['lessMessages'] ?? [],
|
|
self::LESS_MESSAGES
|
|
);
|
|
}
|
|
|
|
if ( $messages !== '' ) {
|
|
$messages .= 'More information can be found at [[mw:Manual:ResourceLoaderSkinModule]]. ';
|
|
$options['deprecated'] = $messages;
|
|
}
|
|
parent::__construct( $options, $localBasePath, $remoteBasePath );
|
|
}
|
|
|
|
/**
|
|
* @internal
|
|
* @param array $features
|
|
* @param bool $addUnspecifiedFeatures Whether to add new features if missing
|
|
* @param string &$messages Messages to report deprecations
|
|
* @return array
|
|
*/
|
|
protected static function applyFeaturesCompatibility(
|
|
array $features, bool $addUnspecifiedFeatures = true, &$messages = ''
|
|
): array {
|
|
if ( isset( $features[ 'i18n-all-lists-margins' ] ) ) {
|
|
// Emit warning only. Key is supported as-is.
|
|
// Replacement requires maintainer intervention as it has non-trivial side-effects.
|
|
$messages .= '[1.43] The use of the `i18n-all-lists-margins` feature with SkinModule'
|
|
. ' is deprecated as it is now provided by `elements`. Please remove and '
|
|
. ' add `elements`, drop support for RTL languages, or incorporate the '
|
|
. ' styles provided by this module into your skin.';
|
|
}
|
|
if ( isset( $features[ 'interface-message-box' ] ) && $features[ 'interface-message-box' ] ) {
|
|
// Emit warning only. Key is supported as-is (For now)
|
|
// Replacement requires maintainer loading a suitable Codex module instead.
|
|
// Note: When removing this deprecation notice and associated code, please
|
|
// make sure mediawiki.legacy.messageBox is not broken.
|
|
$messages .= '[1.43] The use of the `interface-message-box` feature with SkinModule'
|
|
. ' is deprecated in favor of CodexModule. Please remove this feature.';
|
|
}
|
|
|
|
foreach ( self::COMPAT_ALIASES as $from => $to ) {
|
|
if ( isset( $features[ $from ] ) && $to !== null ) {
|
|
if ( isset( $features[ $to ] ) ) {
|
|
$messages .= "SkinModule feature `$from` conflicts with `$to` and was ignored. ";
|
|
} else {
|
|
$features[ $to ] = $features[ $from ];
|
|
}
|
|
}
|
|
unset( $features[ $from ] );
|
|
}
|
|
|
|
// If `content-links` feature is set but no preference for `content-links-external` is set
|
|
if ( $addUnspecifiedFeatures
|
|
&& isset( $features[ 'content-links' ] )
|
|
&& !isset( $features[ 'content-links-external' ] )
|
|
) {
|
|
// Assume the same true/false preference for both.
|
|
$features[ 'content-links-external' ] = $features[ 'content-links' ];
|
|
}
|
|
|
|
// The `content-links` feature was split out from `elements`.
|
|
// Make sure skins asking for `elements` also get these by default.
|
|
if ( $addUnspecifiedFeatures && isset( $features[ 'elements' ] ) && !isset( $features[ 'content-links' ] ) ) {
|
|
$features[ 'content-links' ] = $features[ 'elements' ];
|
|
}
|
|
|
|
// The interface module is a short hand for several modules. Enable them now.
|
|
if ( isset( $features[ 'interface' ] ) && $features[ 'interface' ] ) {
|
|
$features[ 'interface-core' ] = true;
|
|
$features[ 'interface-indicators' ] = true;
|
|
$features[ 'interface-subtitle' ] = true;
|
|
$features[ 'interface-user-message' ] = true;
|
|
$features[ 'interface-site-notice' ] = true;
|
|
$features[ 'interface-edit-section-links' ] = true;
|
|
}
|
|
unset( $features[ 'interface' ] );
|
|
|
|
return $features;
|
|
}
|
|
|
|
/**
|
|
* Get styles defined in the module definition.
|
|
*
|
|
* @return array
|
|
*/
|
|
public function getFeatureFilePaths() {
|
|
// Bypass the current module paths so that these files are served from core,
|
|
// instead of the individual skin's module directory.
|
|
[ $defaultLocalBasePath, $defaultRemoteBasePath ] =
|
|
FileModule::extractBasePaths(
|
|
[],
|
|
null,
|
|
$this->getConfig()->get( MainConfigNames::ResourceBasePath )
|
|
);
|
|
|
|
$featureFilePaths = [];
|
|
|
|
foreach ( self::FEATURE_FILES as $feature => $featureFiles ) {
|
|
if ( in_array( $feature, $this->features ) ) {
|
|
foreach ( $featureFiles as $mediaType => $files ) {
|
|
foreach ( $files as $filepath ) {
|
|
$featureFilePaths[$mediaType][] = new FilePath(
|
|
$filepath,
|
|
$defaultLocalBasePath,
|
|
$defaultRemoteBasePath
|
|
);
|
|
}
|
|
}
|
|
|
|
if ( $feature === 'content-media' ) {
|
|
if ( $this->getConfig()->get( MainConfigNames::UseLegacyMediaStyles ) ) {
|
|
$featureFilePaths['all'][] = new FilePath(
|
|
'resources/src/mediawiki.skinning/content.thumbnails-common.less',
|
|
$defaultLocalBasePath,
|
|
$defaultRemoteBasePath
|
|
);
|
|
$featureFilePaths['screen'][] = new FilePath(
|
|
'resources/src/mediawiki.skinning/content.thumbnails-screen.less',
|
|
$defaultLocalBasePath,
|
|
$defaultRemoteBasePath
|
|
);
|
|
$featureFilePaths['print'][] = new FilePath(
|
|
'resources/src/mediawiki.skinning/content.thumbnails-print.less',
|
|
$defaultLocalBasePath,
|
|
$defaultRemoteBasePath
|
|
);
|
|
}
|
|
if (
|
|
!$this->getConfig()->get( MainConfigNames::ParserEnableLegacyMediaDOM ) ||
|
|
$this->getConfig()->get( MainConfigNames::UseContentMediaStyles )
|
|
) {
|
|
$featureFilePaths['all'][] = new FilePath(
|
|
'resources/src/mediawiki.skinning/content.media-common.less',
|
|
$defaultLocalBasePath,
|
|
$defaultRemoteBasePath
|
|
);
|
|
$featureFilePaths['screen'][] = new FilePath(
|
|
'resources/src/mediawiki.skinning/content.media-screen.less',
|
|
$defaultLocalBasePath,
|
|
$defaultRemoteBasePath
|
|
);
|
|
$featureFilePaths['print'][] = new FilePath(
|
|
'resources/src/mediawiki.skinning/content.media-print.less',
|
|
$defaultLocalBasePath,
|
|
$defaultRemoteBasePath
|
|
);
|
|
}
|
|
}
|
|
}
|
|
}
|
|
return $featureFilePaths;
|
|
}
|
|
|
|
/**
|
|
* Combines feature styles and parent skin styles, ensuring that all
|
|
* feature styles are output *first*, followed by skin related styles.
|
|
*
|
|
* @param array $featureStyles
|
|
* @param array $parentStyles
|
|
*
|
|
* @return array
|
|
*/
|
|
private function combineFeatureAndParentStyles( $featureStyles, $parentStyles ) {
|
|
$combinedFeatureStyles = ResourceLoader::makeCombinedStyles( $featureStyles );
|
|
$combinedParentStyles = ResourceLoader::makeCombinedStyles( $parentStyles );
|
|
$combinedStyles = array_merge( $combinedFeatureStyles, $combinedParentStyles );
|
|
return [ '' => $combinedStyles ];
|
|
}
|
|
|
|
/**
|
|
* Generates CSS for .mw-logo-logo styles and appends them
|
|
* to the skin feature styles array.
|
|
* @param array $featureStyles
|
|
* @param Context $context
|
|
* @return array
|
|
*/
|
|
public function generateAndAppendLogoStyles( $featureStyles, $context ) {
|
|
$logo = $this->getLogoData( $this->getConfig(), $context->getLanguage() );
|
|
$default = !is_array( $logo ) ? $logo : ( $logo['svg'] ?? $logo['1x'] ?? null );
|
|
|
|
// Can't add logo CSS if no logo defined.
|
|
if ( !$default ) {
|
|
return $featureStyles;
|
|
}
|
|
|
|
$featureStyles['all'][] = '.mw-wiki-logo { background-image: ' .
|
|
CSSMin::buildUrlValue( $default ) .
|
|
'; }';
|
|
|
|
if ( is_array( $logo ) ) {
|
|
if ( isset( $logo['svg'] ) ) {
|
|
$featureStyles['all'][] = '.mw-wiki-logo { ' .
|
|
'background-size: 135px auto; }';
|
|
} else {
|
|
if ( isset( $logo['1.5x'] ) ) {
|
|
$featureStyles[
|
|
'(-webkit-min-device-pixel-ratio: 1.5), ' .
|
|
'(min-resolution: 1.5dppx), ' .
|
|
'(min-resolution: 144dpi)'
|
|
][] = '.mw-wiki-logo { background-image: ' .
|
|
CSSMin::buildUrlValue( $logo['1.5x'] ) . ';' .
|
|
'background-size: 135px auto; }';
|
|
}
|
|
if ( isset( $logo['2x'] ) ) {
|
|
$featureStyles[
|
|
'(-webkit-min-device-pixel-ratio: 2), ' .
|
|
'(min-resolution: 2dppx), ' .
|
|
'(min-resolution: 192dpi)'
|
|
][] = '.mw-wiki-logo { background-image: ' .
|
|
CSSMin::buildUrlValue( $logo['2x'] ) . ';' .
|
|
'background-size: 135px auto; }';
|
|
}
|
|
}
|
|
}
|
|
return $featureStyles;
|
|
}
|
|
|
|
/**
|
|
* @param Context $context
|
|
* @return array
|
|
*/
|
|
public function getStyles( Context $context ) {
|
|
$parentStyles = parent::getStyles( $context );
|
|
$featureFilePaths = $this->getFeatureFilePaths();
|
|
$featureStyles = $this->readStyleFiles( $featureFilePaths, $context );
|
|
|
|
$this->normalizeStyles( $featureStyles );
|
|
$this->normalizeStyles( $parentStyles );
|
|
|
|
$isLogoFeatureEnabled = in_array( 'logo', $this->features );
|
|
if ( $isLogoFeatureEnabled ) {
|
|
$featureStyles = $this->generateAndAppendLogoStyles( $featureStyles, $context );
|
|
}
|
|
|
|
return $this->combineFeatureAndParentStyles( $featureStyles, $parentStyles );
|
|
}
|
|
|
|
/**
|
|
* @param Context $context
|
|
* @return array
|
|
*/
|
|
public function getPreloadLinks( Context $context ): array {
|
|
if ( !in_array( 'logo', $this->features ) ) {
|
|
return [];
|
|
}
|
|
|
|
$logo = $this->getLogoData( $this->getConfig(), $context->getLanguage() );
|
|
|
|
if ( !is_array( $logo ) ) {
|
|
// No media queries required if we only have one variant
|
|
return [ $logo => [ 'as' => 'image' ] ];
|
|
}
|
|
|
|
if ( isset( $logo['svg'] ) ) {
|
|
// No media queries required if we only have a 1x and svg variant
|
|
// because all preload-capable browsers support SVGs
|
|
return [ $logo['svg'] => [ 'as' => 'image' ] ];
|
|
}
|
|
|
|
$logosPerDppx = [];
|
|
foreach ( $logo as $dppx => $src ) {
|
|
// Keys are in this format: "1.5x"
|
|
$dppx = substr( $dppx, 0, -1 );
|
|
$logosPerDppx[$dppx] = $src;
|
|
}
|
|
|
|
// Because PHP can't have floats as array keys
|
|
uksort( $logosPerDppx, static function ( $a, $b ) {
|
|
$a = floatval( $a );
|
|
$b = floatval( $b );
|
|
// Sort from smallest to largest (e.g. 1x, 1.5x, 2x)
|
|
return $a <=> $b;
|
|
} );
|
|
|
|
$logos = [];
|
|
foreach ( $logosPerDppx as $dppx => $src ) {
|
|
$logos[] = [
|
|
'dppx' => $dppx,
|
|
'src' => $src
|
|
];
|
|
}
|
|
|
|
$logosCount = count( $logos );
|
|
$preloadLinks = [];
|
|
// Logic must match SkinModule:
|
|
// - 1x applies to resolution < 1.5dppx
|
|
// - 1.5x applies to resolution >= 1.5dppx && < 2dppx
|
|
// - 2x applies to resolution >= 2dppx
|
|
// Note that min-resolution and max-resolution are both inclusive.
|
|
for ( $i = 0; $i < $logosCount; $i++ ) {
|
|
if ( $i === 0 ) {
|
|
// Smallest dppx
|
|
// min-resolution is ">=" (larger than or equal to)
|
|
// "not min-resolution" is essentially "<"
|
|
$media_query = 'not all and (min-resolution: ' . $logos[1]['dppx'] . 'dppx)';
|
|
} elseif ( $i !== $logosCount - 1 ) {
|
|
// In between
|
|
// Media query expressions can only apply "not" to the entire expression
|
|
// (e.g. can't express ">= 1.5 and not >= 2).
|
|
// Workaround: Use <= 1.9999 in place of < 2.
|
|
$upper_bound = floatval( $logos[$i + 1]['dppx'] ) - 0.000001;
|
|
$media_query = '(min-resolution: ' . $logos[$i]['dppx'] .
|
|
'dppx) and (max-resolution: ' . $upper_bound . 'dppx)';
|
|
} else {
|
|
// Largest dppx
|
|
$media_query = '(min-resolution: ' . $logos[$i]['dppx'] . 'dppx)';
|
|
}
|
|
|
|
$preloadLinks[$logos[$i]['src']] = [
|
|
'as' => 'image',
|
|
'media' => $media_query
|
|
];
|
|
}
|
|
|
|
return $preloadLinks;
|
|
}
|
|
|
|
/**
|
|
* Ensure all media keys use array values.
|
|
*
|
|
* Normalises arrays returned by the FileModule::getStyles() method.
|
|
*
|
|
* @param array &$styles Associative array, keys are strings (media queries),
|
|
* values are strings or arrays
|
|
*/
|
|
private function normalizeStyles( array &$styles ): void {
|
|
foreach ( $styles as $key => $val ) {
|
|
if ( !is_array( $val ) ) {
|
|
$styles[$key] = [ $val ];
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Modifies configured logo width/height to ensure they are present and scalable
|
|
* with different font-sizes.
|
|
* @param array $logoElement with width, height and src keys.
|
|
* @return array modified version of $logoElement
|
|
*/
|
|
private static function getRelativeSizedLogo( array $logoElement ) {
|
|
$width = $logoElement['width'];
|
|
$height = $logoElement['height'];
|
|
$widthRelative = $width / 16;
|
|
$heightRelative = $height / 16;
|
|
// Allow skins to scale the wordmark with browser font size (T207789)
|
|
$logoElement['style'] = 'width: ' . $widthRelative . 'em; height: ' . $heightRelative . 'em;';
|
|
return $logoElement;
|
|
}
|
|
|
|
/**
|
|
* Return an array of all available logos that a skin may use.
|
|
* @since 1.35
|
|
* @param Config $conf
|
|
* @param string|null $lang Language code for logo variant, since 1.39
|
|
* @return array with the following keys:
|
|
* - 1x(string): a square logo composing the `icon` and `wordmark` (required)
|
|
* - 2x (string): a square logo for HD displays (optional)
|
|
* - wordmark (object): a rectangle logo (wordmark) for print media and skins which desire
|
|
* horizontal logo (optional). Must declare width and height fields, defined in pixels
|
|
* which will be converted to ems based on 16px font-size.
|
|
* - tagline (object): replaces `tagline` message in certain skins. Must declare width and
|
|
* height fields defined in pixels, which are converted to ems based on 16px font-size.
|
|
* - icon (string): a square logo similar to 1x, but without the wordmark. SVG recommended.
|
|
*/
|
|
public static function getAvailableLogos( Config $conf, ?string $lang = null ): array {
|
|
$logos = $conf->get( MainConfigNames::Logos );
|
|
if ( $logos === false ) {
|
|
// no logos were defined... this will either
|
|
// 1. Load from wgLogo
|
|
// 2. Trigger runtime exception if those are not defined.
|
|
$logos = [];
|
|
}
|
|
if ( $lang && isset( $logos['variants'][$lang] ) ) {
|
|
foreach ( $logos['variants'][$lang] as $type => $value ) {
|
|
$logos[$type] = $value;
|
|
}
|
|
}
|
|
|
|
// If logos['1x'] is not defined, see if we can use wgLogo
|
|
if ( !isset( $logos[ '1x' ] ) ) {
|
|
$logo = $conf->get( MainConfigNames::Logo );
|
|
if ( $logo ) {
|
|
$logos['1x'] = $logo;
|
|
}
|
|
}
|
|
|
|
if ( isset( $logos['wordmark'] ) ) {
|
|
// Allow skins to scale the wordmark with browser font size (T207789)
|
|
$logos['wordmark'] = self::getRelativeSizedLogo( $logos['wordmark'] );
|
|
}
|
|
if ( isset( $logos['tagline'] ) ) {
|
|
$logos['tagline'] = self::getRelativeSizedLogo( $logos['tagline'] );
|
|
}
|
|
|
|
return $logos;
|
|
}
|
|
|
|
/**
|
|
* @since 1.31
|
|
* @param Config $conf
|
|
* @param string|null $lang Language code for logo variant, since 1.39
|
|
* @return string|array Single url if no variants are defined,
|
|
* or an array of logo urls keyed by dppx in form "<float>x".
|
|
* Key "1x" is always defined. Key "svg" may also be defined,
|
|
* in which case variants other than "1x" are omitted.
|
|
*/
|
|
protected function getLogoData( Config $conf, ?string $lang = null ) {
|
|
$logoHD = self::getAvailableLogos( $conf, $lang );
|
|
$logo = $logoHD['1x'];
|
|
|
|
$logo1Url = OutputPage::transformResourcePath( $conf, $logo );
|
|
|
|
$logoUrls = [
|
|
'1x' => $logo1Url,
|
|
];
|
|
|
|
if ( isset( $logoHD['svg'] ) ) {
|
|
$logoUrls['svg'] = OutputPage::transformResourcePath(
|
|
$conf,
|
|
$logoHD['svg']
|
|
);
|
|
} elseif ( isset( $logoHD['1.5x'] ) || isset( $logoHD['2x'] ) ) {
|
|
// Only 1.5x and 2x are supported
|
|
if ( isset( $logoHD['1.5x'] ) ) {
|
|
$logoUrls['1.5x'] = OutputPage::transformResourcePath(
|
|
$conf,
|
|
$logoHD['1.5x']
|
|
);
|
|
}
|
|
if ( isset( $logoHD['2x'] ) ) {
|
|
$logoUrls['2x'] = OutputPage::transformResourcePath(
|
|
$conf,
|
|
$logoHD['2x']
|
|
);
|
|
}
|
|
} else {
|
|
// Return a string rather than a one-element array, getLogoPreloadlinks depends on this
|
|
return $logo1Url;
|
|
}
|
|
|
|
return $logoUrls;
|
|
}
|
|
|
|
/**
|
|
* @param Context $context
|
|
* @return bool
|
|
*/
|
|
public function isKnownEmpty( Context $context ) {
|
|
// Regardless of whether the files are specified, we always
|
|
// provide mw-wiki-logo styles.
|
|
return false;
|
|
}
|
|
|
|
/**
|
|
* Get language-specific LESS variables for this module.
|
|
*
|
|
* @param Context $context
|
|
* @return array
|
|
*/
|
|
protected function getLessVars( Context $context ) {
|
|
$lessVars = parent::getLessVars( $context );
|
|
$logos = self::getAvailableLogos( $this->getConfig(), $context->getLanguage() );
|
|
|
|
if ( isset( $logos['wordmark'] ) ) {
|
|
$logo = $logos['wordmark'];
|
|
$lessVars[ 'logo-enabled' ] = true;
|
|
$lessVars[ 'logo-wordmark-url' ] = CSSMin::buildUrlValue( $logo['src'] );
|
|
$lessVars[ 'logo-wordmark-width' ] = intval( $logo['width'] );
|
|
$lessVars[ 'logo-wordmark-height' ] = intval( $logo['height'] );
|
|
} else {
|
|
$lessVars[ 'logo-enabled' ] = false;
|
|
}
|
|
return $lessVars;
|
|
}
|
|
|
|
public function getDefinitionSummary( Context $context ) {
|
|
$summary = parent::getDefinitionSummary( $context );
|
|
$summary[] = [
|
|
'logos' => self::getAvailableLogos( $this->getConfig(), $context->getLanguage() ),
|
|
];
|
|
return $summary;
|
|
}
|
|
}
|