a241d83e0a
This reverts commit e08ea8ccb9.
Reason for revert: Breaks Phan in extensions, and as far as I’m aware,
this change isn’t urgently needed for anything, so the simplest fix is
to revert it again for now. After PHP 7.4 it should be safer to try this
again (we hopefully won’t need the two “hack” classes by then).
Bug: T308443
Change-Id: Iff3318cbf97a67f821f78e60da62a583f63e389e
114 lines
4 KiB
PHP
114 lines
4 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
|
|
*/
|
|
|
|
/**
|
|
* Module which magically loads the right skinScripts and skinStyles for every
|
|
* skin, using the specified OOUI theme for each.
|
|
*
|
|
* @ingroup ResourceLoader
|
|
* @internal
|
|
*/
|
|
class ResourceLoaderOOUIFileModule extends ResourceLoaderFileModule {
|
|
use ResourceLoaderOOUIModule;
|
|
|
|
/** @var array<string,string|ResourceLoaderFilePath> */
|
|
private $themeStyles = [];
|
|
|
|
public function __construct( array $options = [] ) {
|
|
if ( isset( $options['themeScripts'] ) ) {
|
|
$skinScripts = $this->getSkinSpecific( $options['themeScripts'], 'scripts' );
|
|
$options['skinScripts'] = $this->extendSkinSpecific( $options['skinScripts'] ?? [], $skinScripts );
|
|
}
|
|
if ( isset( $options['themeStyles'] ) ) {
|
|
$this->themeStyles = $this->getSkinSpecific( $options['themeStyles'], 'styles' );
|
|
}
|
|
|
|
parent::__construct( $options );
|
|
}
|
|
|
|
public function setSkinStylesOverride( array $moduleSkinStyles ): void {
|
|
parent::setSkinStylesOverride( $moduleSkinStyles );
|
|
|
|
$this->skinStyles = $this->extendSkinSpecific( $this->skinStyles, $this->themeStyles );
|
|
}
|
|
|
|
/**
|
|
* Helper function to generate values for 'skinStyles' and 'skinScripts'.
|
|
*
|
|
* @param string $module Module to generate skinStyles/skinScripts for:
|
|
* 'core', 'widgets', 'toolbars', 'windows'
|
|
* @param string $which 'scripts' or 'styles'
|
|
* @return array<string,string|ResourceLoaderFilePath>
|
|
*/
|
|
private function getSkinSpecific( $module, $which ): array {
|
|
$themes = self::getSkinThemeMap();
|
|
|
|
return array_combine(
|
|
array_keys( $themes ),
|
|
array_map( function ( $theme ) use ( $module, $which ) {
|
|
if ( $which === 'scripts' ) {
|
|
return $this->getThemeScriptsPath( $theme, $module );
|
|
} else {
|
|
return $this->getThemeStylesPath( $theme, $module );
|
|
}
|
|
}, array_values( $themes ) )
|
|
);
|
|
}
|
|
|
|
/**
|
|
* Prepend theme-specific resources on behalf of the skin.
|
|
*
|
|
* The expected order of styles and scripts in the output is:
|
|
*
|
|
* 1. Theme-specific resources for a given skin.
|
|
*
|
|
* 2. Module-defined resources for a specific skin,
|
|
* falling back to module-defined "default" skin resources.
|
|
*
|
|
* 3. Skin-defined resources for a specific module, which can either
|
|
* append to or replace the "default" (via ResourceModuleSkinStyles in skin.json)
|
|
* Note that skins can only define resources for a module if that
|
|
* module does not already explicitly provide resources for that skin.
|
|
*
|
|
* @param array $skinSpecific Module-defined 'skinScripts' or 'skinStyles'.
|
|
* @param array $themeSpecific
|
|
* @return array Modified $skinSpecific
|
|
*/
|
|
private function extendSkinSpecific( array $skinSpecific, array $themeSpecific ): array {
|
|
// If the module or skin already set skinStyles/skinScripts, prepend ours
|
|
foreach ( $skinSpecific as $skin => $files ) {
|
|
if ( !is_array( $files ) ) {
|
|
$files = [ $files ];
|
|
}
|
|
if ( isset( $themeSpecific[$skin] ) ) {
|
|
$skinSpecific[$skin] = array_merge( [ $themeSpecific[$skin] ], $files );
|
|
} elseif ( isset( $themeSpecific['default'] ) ) {
|
|
$skinSpecific[$skin] = array_merge( [ $themeSpecific['default'] ], $files );
|
|
}
|
|
}
|
|
// If the module has no skinStyles/skinScripts for a skin, then set ours
|
|
foreach ( $themeSpecific as $skin => $file ) {
|
|
if ( !isset( $skinSpecific[$skin] ) ) {
|
|
$skinSpecific[$skin] = [ $file ];
|
|
}
|
|
}
|
|
return $skinSpecific;
|
|
}
|
|
}
|