3 * Module for resource loader initialization.
5 * This program is free software; you can redistribute it and/or modify
6 * it under the terms of the GNU General Public License as published by
7 * the Free Software Foundation; either version 2 of the License, or
8 * (at your option) any later version.
10 * This program is distributed in the hope that it will be useful,
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 * GNU General Public License for more details.
15 * You should have received a copy of the GNU General Public License along
16 * with this program; if not, write to the Free Software Foundation, Inc.,
17 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
18 * http://www.gnu.org/copyleft/gpl.html
21 * @author Trevor Parscal
22 * @author Roan Kattouw
25 class ResourceLoaderStartUpModule
extends ResourceLoaderModule
{
27 /* Protected Members */
29 protected $modifiedTime = array();
30 protected $configVars = array();
31 protected $targets = array( 'desktop', 'mobile' );
33 /* Protected Methods */
36 * @param ResourceLoaderContext $context
39 protected function getConfig( $context ) {
41 $hash = $context->getHash();
42 if ( isset( $this->configVars
[$hash] ) ) {
43 return $this->configVars
[$hash];
46 global $wgLoadScript, $wgScript, $wgStylePath, $wgScriptExtension,
47 $wgArticlePath, $wgScriptPath, $wgServer, $wgContLang,
48 $wgVariantArticlePath, $wgActionPaths, $wgVersion,
49 $wgEnableAPI, $wgEnableWriteAPI, $wgDBname,
50 $wgSitename, $wgFileExtensions, $wgExtensionAssetsPath,
51 $wgCookiePrefix, $wgResourceLoaderMaxQueryLength,
52 $wgResourceLoaderStorageEnabled, $wgResourceLoaderStorageVersion,
55 $mainPage = Title
::newMainPage();
58 * Namespace related preparation
59 * - wgNamespaceIds: Key-value pairs of all localized, canonical and aliases for namespaces.
60 * - wgCaseSensitiveNamespaces: Array of namespaces that are case-sensitive.
62 $namespaceIds = $wgContLang->getNamespaceIds();
63 $caseSensitiveNamespaces = array();
64 foreach ( MWNamespace
::getCanonicalNamespaces() as $index => $name ) {
65 $namespaceIds[$wgContLang->lc( $name )] = $index;
66 if ( !MWNamespace
::isCapitalized( $index ) ) {
67 $caseSensitiveNamespaces[] = $index;
71 // Build list of variables
73 'wgLoadScript' => $wgLoadScript,
74 'debug' => $context->getDebug(),
75 'skin' => $context->getSkin(),
76 'stylepath' => $wgStylePath,
77 'wgUrlProtocols' => wfUrlProtocols(),
78 'wgArticlePath' => $wgArticlePath,
79 'wgScriptPath' => $wgScriptPath,
80 'wgScriptExtension' => $wgScriptExtension,
81 'wgScript' => $wgScript,
82 'wgSearchType' => $wgSearchType,
83 'wgVariantArticlePath' => $wgVariantArticlePath,
84 // Force object to avoid "empty" associative array from
85 // becoming [] instead of {} in JS (bug 34604)
86 'wgActionPaths' => (object)$wgActionPaths,
87 'wgServer' => $wgServer,
88 'wgUserLanguage' => $context->getLanguage(),
89 'wgContentLanguage' => $wgContLang->getCode(),
90 'wgVersion' => $wgVersion,
91 'wgEnableAPI' => $wgEnableAPI,
92 'wgEnableWriteAPI' => $wgEnableWriteAPI,
93 'wgMainPageTitle' => $mainPage->getPrefixedText(),
94 'wgFormattedNamespaces' => $wgContLang->getFormattedNamespaces(),
95 'wgNamespaceIds' => $namespaceIds,
96 'wgContentNamespaces' => MWNamespace
::getContentNamespaces(),
97 'wgSiteName' => $wgSitename,
98 'wgFileExtensions' => array_values( array_unique( $wgFileExtensions ) ),
99 'wgDBname' => $wgDBname,
100 // This sucks, it is only needed on Special:Upload, but I could
101 // not find a way to add vars only for a certain module
102 'wgFileCanRotate' => BitmapHandler
::canRotate(),
103 'wgAvailableSkins' => Skin
::getSkinNames(),
104 'wgExtensionAssetsPath' => $wgExtensionAssetsPath,
105 // MediaWiki sets cookies to have this prefix by default
106 'wgCookiePrefix' => $wgCookiePrefix,
107 'wgResourceLoaderMaxQueryLength' => $wgResourceLoaderMaxQueryLength,
108 'wgCaseSensitiveNamespaces' => $caseSensitiveNamespaces,
109 'wgLegalTitleChars' => Title
::convertByteClassToUnicodeClass( Title
::legalChars() ),
110 'wgResourceLoaderStorageVersion' => $wgResourceLoaderStorageVersion,
111 'wgResourceLoaderStorageEnabled' => $wgResourceLoaderStorageEnabled,
114 wfRunHooks( 'ResourceLoaderGetConfigVars', array( &$vars ) );
116 $this->configVars
[$hash] = $vars;
117 return $this->configVars
[$hash];
121 * Get registration code for all modules.
123 * @param ResourceLoaderContext $context object
124 * @return string JavaScript code for registering all modules with the client loader
126 public static function getModuleRegistrations( ResourceLoaderContext
$context ) {
127 global $wgCacheEpoch;
128 wfProfileIn( __METHOD__
);
130 $resourceLoader = $context->getResourceLoader();
131 $target = $context->getRequest()->getVal( 'target', 'desktop' );
134 $registryData = array();
137 foreach ( $resourceLoader->getModuleNames() as $name ) {
138 $module = $resourceLoader->getModule( $name );
139 $moduleTargets = $module->getTargets();
140 if ( !in_array( $target, $moduleTargets ) ) {
144 // getModifiedTime() is supposed to return a UNIX timestamp, but it doesn't always
145 // seem to do that, and custom implementations might forget. Coerce it to TS_UNIX
146 $moduleMtime = wfTimestamp( TS_UNIX
, $module->getModifiedTime( $context ) );
147 $mtime = max( $moduleMtime, wfTimestamp( TS_UNIX
, $wgCacheEpoch ) );
149 // FIXME: Convert to numbers, wfTimestamp always gives us stings, even for TS_UNIX
151 $registryData[ $name ] = array(
153 'dependencies' => $module->getDependencies(),
154 'group' => $module->getGroup(),
155 'source' => $module->getSource(),
156 'loader' => $module->getLoaderScript(),
161 $out .= ResourceLoader
::makeLoaderSourcesScript( $resourceLoader->getSources() );
163 // Concatenate module loader scripts and figure out the different call
164 // signatures for mw.loader.register
165 $registrations = array();
166 foreach ( $registryData as $name => $data ) {
167 if ( $data['loader'] !== false ) {
168 $out .= ResourceLoader
::makeCustomLoaderScript(
170 wfTimestamp( TS_ISO_8601_BASIC
, $data['version'] ),
171 $data['dependencies'],
180 !count( $data['dependencies'] ) &&
181 $data['group'] === null &&
182 $data['source'] === 'local'
184 // Modules without dependencies, a group or a foreign source;
185 // call mw.loader.register(name, timestamp)
186 $registrations[] = array( $name, $data['version'] );
187 } elseif ( $data['group'] === null && $data['source'] === 'local' ) {
188 // Modules with dependencies but no group or foreign source;
189 // call mw.loader.register(name, timestamp, dependencies)
190 $registrations[] = array( $name, $data['version'], $data['dependencies'] );
191 } elseif ( $data['source'] === 'local' ) {
192 // Modules with a group but no foreign source;
193 // call mw.loader.register(name, timestamp, dependencies, group)
194 $registrations[] = array(
197 $data['dependencies'],
201 // Modules with a foreign source;
202 // call mw.loader.register(name, timestamp, dependencies, group, source)
203 $registrations[] = array(
206 $data['dependencies'],
214 $out .= ResourceLoader
::makeLoaderRegisterScript( $registrations );
216 wfProfileOut( __METHOD__
);
225 public function isRaw() {
230 * Get the load URL of the startup modules.
232 * This is a helper for getScript(), but can also be called standalone, such
233 * as when generating an AppCache manifest.
235 * @param ResourceLoaderContext $context
238 public static function getStartupModulesUrl( ResourceLoaderContext
$context ) {
240 $moduleNames = array( 'jquery', 'mediawiki' );
241 wfRunHooks( 'ResourceLoaderGetStartupModules', array( &$moduleNames ), '1.23' );
243 // Get the latest version
244 $loader = $context->getResourceLoader();
246 foreach ( $moduleNames as $moduleName ) {
247 $version = max( $version,
248 $loader->getModule( $moduleName )->getModifiedTime( $context )
253 'modules' => ResourceLoader
::makePackedModulesString( $moduleNames ),
255 'lang' => $context->getLanguage(),
256 'skin' => $context->getSkin(),
257 'debug' => $context->getDebug() ?
'true' : 'false',
258 'version' => wfTimestamp( TS_ISO_8601_BASIC
, $version )
260 // Ensure uniform query order
262 return wfAppendQuery( wfScript( 'load' ), $query );
266 * @param ResourceLoaderContext $context
269 public function getScript( ResourceLoaderContext
$context ) {
270 global $IP, $wgLegacyJavaScriptGlobals;
272 $out = file_get_contents( "$IP/resources/src/startup.js" );
273 if ( $context->getOnly() === 'scripts' ) {
276 $configuration = $this->getConfig( $context );
277 $registrations = self
::getModuleRegistrations( $context );
279 $registrations = str_replace( "\n", "\n\t", trim( $registrations ) );
280 $out .= "var startUp = function () {\n" .
281 "\tmw.config = new " .
282 Xml
::encodeJsCall( 'mw.Map', array( $wgLegacyJavaScriptGlobals ) ) . "\n" .
283 "\t$registrations\n" .
284 "\t" . Xml
::encodeJsCall( 'mw.config.set', array( $configuration ) ) .
287 // Conditional script injection
288 $scriptTag = Html
::linkedScript( self
::getStartupModulesUrl( $context ) );
289 $out .= "if ( isCompatible() ) {\n" .
290 "\t" . Xml
::encodeJsCall( 'document.write', array( $scriptTag ) ) .
300 public function supportsURLLoading() {
305 * @param ResourceLoaderContext $context
306 * @return array|mixed
308 public function getModifiedTime( ResourceLoaderContext
$context ) {
309 global $IP, $wgCacheEpoch;
311 $hash = $context->getHash();
312 if ( isset( $this->modifiedTime
[$hash] ) ) {
313 return $this->modifiedTime
[$hash];
316 // Call preloadModuleInfo() on ALL modules as we're about
317 // to call getModifiedTime() on all of them
318 $loader = $context->getResourceLoader();
319 $loader->preloadModuleInfo( $loader->getModuleNames(), $context );
322 wfTimestamp( TS_UNIX
, $wgCacheEpoch ),
323 filemtime( "$IP/resources/src/startup.js" ),
324 $this->getHashMtime( $context )
327 // ATTENTION!: Because of the line below, this is not going to cause
328 // infinite recursion - think carefully before making changes to this
330 // Pre-populate modifiedTime with something because the the loop over
331 // all modules below includes the the startup module (this module).
332 $this->modifiedTime
[$hash] = 1;
334 foreach ( $loader->getModuleNames() as $name ) {
335 $module = $loader->getModule( $name );
336 $time = max( $time, $module->getModifiedTime( $context ) );
339 $this->modifiedTime
[$hash] = $time;
340 return $this->modifiedTime
[$hash];
344 * Hash of all dynamic data embedded in getScript().
346 * Detect changes to mw.config settings embedded in #getScript (bug 28899).
348 * @param $context ResourceLoaderContext
349 * @return string: Hash
351 public function getModifiedHash( ResourceLoaderContext
$context ) {
352 global $wgLegacyJavaScriptGlobals;
355 'vars' => $this->getConfig( $context ),
356 'wgLegacyJavaScriptGlobals' => $wgLegacyJavaScriptGlobals,
359 return md5( serialize( $data ) );
365 public function getGroup() {