ResourceLoader module based on local JavaScript/CSS files. More...

Inheritance diagram for ResourceLoaderFileModule:

Collaboration diagram for ResourceLoaderFileModule:

Public Member Functions
	__construct ($options=array(), $localBasePath=null, $remoteBasePath=null)
	Constructs a new module from an options array.
	getDependencies ()
	Gets list of names of modules this module depends on.
	getFlip ($context)
	Get whether CSS for this module should be flipped.
	getGroup ()
	Gets the name of the group this module should be loaded in.
	getLoaderScript ()
	Gets loader script.
	getMessages ()
	Gets list of message keys used by this module.
	getModifiedTime (ResourceLoaderContext $context)
	Get the last modified timestamp of this module.
	getPosition ()
	getScript (ResourceLoaderContext $context)
	Gets all scripts for a given context concatenated together.
	getScriptURLsForDebug (ResourceLoaderContext $context)
	getStyles (ResourceLoaderContext $context)
	Gets all styles for a given context concatenated together.
	getStyleURLsForDebug (ResourceLoaderContext $context)
	getTargets ()
	Get target(s) for the module, eg ['desktop'] or ['desktop', 'mobile'].
	isRaw ()
	supportsURLLoading ()
Protected Member Functions
	getLocalPath ($path)
	getRemotePath ($path)
	getScriptFiles (ResourceLoaderContext $context)
	Gets a list of file paths for all scripts in this module, in order of propper execution.
	getStyleFiles (ResourceLoaderContext $context)
	Gets a list of file paths for all styles in this module, in order of propper inclusion.
	readScriptFiles (array $scripts)
	Gets the contents of a list of JavaScript files.
	readStyleFile ($path, $flip)
	Reads a style file.
	readStyleFiles (array $styles, $flip)
	Gets the contents of a list of CSS files.
Static Protected Member Functions
static	collateFilePathListByOption (array $list, $option, $default)
	Collates file paths by option (where provided).
static	tryForKey (array $list, $key, $fallback=null)
	Gets a list of element that match a key, optionally using a fallback key.
Protected Attributes
	$debugRaw = true
	Boolean: Link to raw files in debug mode.
	$debugScripts = array()
	Array: List of paths to JavaScript files to include in debug mode.
	$dependencies = array()
	Array: List of modules this module depends on.
	$group
	String: Name of group to load this module in.
	$languageScripts = array()
	Array: List of JavaScript files to include when using a specific language.
	$loaderScripts = array()
	Array: List of paths to JavaScript files to include in the startup module.
	$localBasePath = ''
	String: Local base path, see __construct()
	$localFileRefs = array()
	Array: Place where readStyleFile() tracks file dependencies.
	$messages = array()
	Array: List of message keys used by this module.
	$modifiedTime = array()
	Array: Cache for mtime.
	$position = 'bottom'
	String: Position on the page to load this module at.
	$raw = false
	Boolean: Whether mw.loader.state() call should be omitted.
	$remoteBasePath = ''
	String: Remote base path, see __construct()
	$scripts = array()
	Array: List of paths to JavaScript files to always include.
	$skinScripts = array()
	Array: List of JavaScript files to include when using a specific skin.
	$skinStyles = array()
	Array: List of paths to CSS files to include when using specific skins.
	$styles = array()
	Array: List of paths to CSS files to always include.
	$targets = array( 'desktop' )

Detailed Description

ResourceLoader module based on local JavaScript/CSS files.

Definition at line 28 of file ResourceLoaderFileModule.php.

Constructor & Destructor Documentation

ResourceLoaderFileModule::__construct	(	$	options = `array()`,
		$	localBasePath = `null`,
		$	remoteBasePath = `null`
	)

Constructs a new module from an options array.

Parameters:

array	$options	List of options; if not given or empty, an empty module will be constructed
string	$localBasePath	Base path to prepend to all local paths in $options. Defaults to $IP
string	$remoteBasePath	Base path to prepend to all remote paths in $options. Defaults to $wgScriptPath

Below is a description for the $options array:

Exceptions:

MWException

Construction options:

     array(
         // Base path to prepend to all local paths in $options. Defaults to $IP
         'localBasePath' => [base path],
         // Base path to prepend to all remote paths in $options. Defaults to $wgScriptPath
         'remoteBasePath' => [base path],
         // Equivalent of remoteBasePath, but relative to $wgExtensionAssetsPath
         'remoteExtPath' => [base path],
         // Scripts to always include
         'scripts' => [file path string or array of file path strings],
         // Scripts to include in specific language contexts
         'languageScripts' => array(
             [language code] => [file path string or array of file path strings],
         ),
         // Scripts to include in specific skin contexts
         'skinScripts' => array(
             [skin name] => [file path string or array of file path strings],
         ),
         // Scripts to include in debug contexts
         'debugScripts' => [file path string or array of file path strings],
         // Scripts to include in the startup module
         'loaderScripts' => [file path string or array of file path strings],
         // Modules which must be loaded before this module
         'dependencies' => [module name string or array of module name strings],
         // Styles to always load
         'styles' => [file path string or array of file path strings],
         // Styles to include in specific skin contexts
         'skinStyles' => array(
             [skin name] => [file path string or array of file path strings],
         ),
         // Messages to always load
         'messages' => [array of message key strings],
         // Group which this module should be loaded together with
         'group' => [group name string],
         // Position on the page to load this module at
         'position' => ['bottom' (default) or 'top']
     )

Definition at line 189 of file ResourceLoaderFileModule.php.

References $IP, $localBasePath, $options, $remoteBasePath, $value, array(), as, global, and wfExpandUrl().

Member Function Documentation

static ResourceLoaderFileModule::collateFilePathListByOption	(	array $	list,
		$	option,
		$	default
	)		`[static, protected]`

Collates file paths by option (where provided).

Parameters:

array	$list	List of file paths in any combination of index/path or path/options pairs
string	$option	option name
	$default	Mixed: default value if the option isn't set

Returns:: Array: List of file paths, collated by $option

Definition at line 482 of file ResourceLoaderFileModule.php.

References $value, array(), and as.

Referenced by getModifiedTime().

ResourceLoaderFileModule::getDependencies ( )

Gets list of names of modules this module depends on.

Returns:: Array: List of module names

Reimplemented from ResourceLoaderModule.

Definition at line 377 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::getFlip ( $ context )

Get whether CSS for this module should be flipped.

Parameters:

$context ResourceLoaderContext

Returns:: bool

Reimplemented from ResourceLoaderModule.

Definition at line 661 of file ResourceLoaderFileModule.php.

Referenced by getStyles().

ResourceLoaderFileModule::getGroup ( )

Gets the name of the group this module should be loaded in.

Returns:: String: Group name

Reimplemented from ResourceLoaderModule.

Definition at line 361 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::getLoaderScript ( )

Gets loader script.

Returns:: String: JavaScript code to be added to startup module

Reimplemented from ResourceLoaderModule.

Definition at line 294 of file ResourceLoaderFileModule.php.

References readScriptFiles().

ResourceLoaderFileModule::getLocalPath ( $ path ) [protected]

Parameters:

$path string

Returns:: string

Definition at line 461 of file ResourceLoaderFileModule.php.

Referenced by readScriptFiles(), and readStyleFile().

ResourceLoaderFileModule::getMessages ( )

Gets list of message keys used by this module.

Returns:: Array: List of message keys

Reimplemented from ResourceLoaderModule.

Definition at line 352 of file ResourceLoaderFileModule.php.

References messages.

ResourceLoaderFileModule::getModifiedTime ( ResourceLoaderContext $ context )

Get the last modified timestamp of this module.

Last modified timestamps are calculated from the highest last modified timestamp of this module's constituent files as well as the files it depends on. This function is context-sensitive, only performing calculations on files relevant to the given language, skin and debug mode.

Parameters:

$context ResourceLoaderContext: Context in which to calculate the modified time

Returns:: Integer: UNIX timestamp

See also:: ResourceLoaderModule::getFileDependencies

Reimplemented from ResourceLoaderModule.

Definition at line 402 of file ResourceLoaderFileModule.php.

References $files, $styles, array(), as, collateFilePathListByOption(), ResourceLoaderContext\getDebug(), ResourceLoaderModule\getFileDependencies(), ResourceLoaderContext\getHash(), ResourceLoaderContext\getLanguage(), ResourceLoaderModule\getMsgBlobMtime(), ResourceLoaderContext\getSkin(), scripts, tryForKey(), wfProfileIn(), and wfProfileOut().

ResourceLoaderFileModule::getPosition ( )

Returns:: string

Reimplemented from ResourceLoaderModule.

Definition at line 368 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::getRemotePath ( $ path ) [protected]

Parameters:

$path string

Returns:: string

Definition at line 469 of file ResourceLoaderFileModule.php.

Referenced by getScriptURLsForDebug(), getStyleURLsForDebug(), and readStyleFile().

ResourceLoaderFileModule::getScript ( ResourceLoaderContext $ context )

Gets all scripts for a given context concatenated together.

Parameters:

$context ResourceLoaderContext: Context in which to generate script

Returns:: String: JavaScript code for $context

Reimplemented from ResourceLoaderModule.

Definition at line 265 of file ResourceLoaderFileModule.php.

References $files, getScriptFiles(), and readScriptFiles().

ResourceLoaderFileModule::getScriptFiles ( ResourceLoaderContext $ context ) [protected]

Gets a list of file paths for all scripts in this module, in order of propper execution.

Parameters:

$context ResourceLoaderContext: Context

Returns:: Array: List of file paths

Definition at line 530 of file ResourceLoaderFileModule.php.

References $files, ResourceLoaderContext\getDebug(), ResourceLoaderContext\getLanguage(), ResourceLoaderContext\getSkin(), and scripts.

Referenced by getScript(), and getScriptURLsForDebug().

ResourceLoaderFileModule::getScriptURLsForDebug ( ResourceLoaderContext $ context )

Parameters:

$context ResourceLoaderContext

Returns:: array

Reimplemented from ResourceLoaderModule.

Definition at line 274 of file ResourceLoaderFileModule.php.

References $file, $urls, array(), as, getRemotePath(), and getScriptFiles().

ResourceLoaderFileModule::getStyleFiles ( ResourceLoaderContext $ context ) [protected]

Gets a list of file paths for all styles in this module, in order of propper inclusion.

Parameters:

$context ResourceLoaderContext: Context

Returns:: Array: List of file paths

Definition at line 549 of file ResourceLoaderFileModule.php.

References ResourceLoaderContext\getSkin().

Referenced by getStyles(), and getStyleURLsForDebug().

ResourceLoaderFileModule::getStyles ( ResourceLoaderContext $ context )

Gets all styles for a given context concatenated together.

Parameters:

$context ResourceLoaderContext: Context in which to generate styles

Returns:: String: CSS code for $context

Reimplemented from ResourceLoaderModule.

Definition at line 307 of file ResourceLoaderFileModule.php.

References $styles, array(), FormatJson\encode(), ResourceLoaderModule\getFileDependencies(), getFlip(), ResourceLoaderModule\getName(), ResourceLoaderContext\getSkin(), getStyleFiles(), readStyleFiles(), wfDebug(), and wfGetDB().

ResourceLoaderFileModule::getStyleURLsForDebug ( ResourceLoaderContext $ context )

Parameters:

$context ResourceLoaderContext

Returns:: array

Reimplemented from ResourceLoaderModule.

Definition at line 336 of file ResourceLoaderFileModule.php.

References $file, $urls, array(), as, getRemotePath(), and getStyleFiles().

ResourceLoaderFileModule::getTargets ( )

Get target(s) for the module, eg ['desktop'] or ['desktop', 'mobile'].

Returns:: array of strings

Reimplemented from ResourceLoaderModule.

Definition at line 670 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::isRaw ( )

Returns:: bool

Reimplemented from ResourceLoaderModule.

Definition at line 384 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::readScriptFiles ( array $ scripts ) [protected]

Gets the contents of a list of JavaScript files.

Parameters:

array $scripts List of file paths to scripts to read, remap and concetenate

Exceptions:

MWException

Returns:: String: Concatenated and remapped JavaScript data from $scripts

Definition at line 565 of file ResourceLoaderFileModule.php.

References as, empty, getLocalPath(), global, and ResourceLoaderModule\validateScriptFile().

Referenced by getLoaderScript(), and getScript().

ResourceLoaderFileModule::readStyleFile	(	$	path,
		$	flip
	)		`[protected]`

Reads a style file.

This method can be used as a callback for array_map()

Parameters:

string	$path	File path of style file to read
	$flip	bool

Returns:: String: CSS data in script file

Exceptions:

MWException if the file doesn't exist

Definition at line 628 of file ResourceLoaderFileModule.php.

References $dir, $path, CSSMin\getLocalFileReferences(), getLocalPath(), getRemotePath(), CSSMin\remap(), CSSJanus\transform(), and wfDebugLog().

ResourceLoaderFileModule::readStyleFiles	(	array $	styles,
		$	flip
	)		`[protected]`

Gets the contents of a list of CSS files.

Parameters:

array	$styles	List of media type/list of file paths pairs, to read, remap and concetenate
	$flip	bool

Returns:: Array: List of concatenated and remapped CSS data from $styles, keyed by media type

Definition at line 599 of file ResourceLoaderFileModule.php.

References $files, $styles, array(), as, and empty.

Referenced by getStyles().

ResourceLoaderFileModule::supportsURLLoading ( )

Returns:: bool

Reimplemented from ResourceLoaderModule.

Definition at line 285 of file ResourceLoaderFileModule.php.

static ResourceLoaderFileModule::tryForKey	(	array $	list,
		$	key,
		$	fallback = `null`
	)		`[static, protected]`

Gets a list of element that match a key, optionally using a fallback key.

Parameters:

array	$list	List of lists to select from
string	$key	Key to look for in $map
string	$fallback	Key to look for in $list if $key doesn't exist

Returns:: Array: List of elements from $map which matched $key or $fallback, or an empty list in case of no match

Definition at line 512 of file ResourceLoaderFileModule.php.

References $fallback, and array().

Referenced by getModifiedTime().

Member Data Documentation

ResourceLoaderFileModule::$debugRaw = true [protected]

Boolean: Link to raw files in debug mode.

Definition at line 113 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$debugScripts = array() [protected]

Array: List of paths to JavaScript files to include in debug mode.

Usage:

 array( [skin-name] => array( [file-path], [file-path], ... ), ... )

Definition at line 67 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$dependencies = array() [protected]

Array: List of modules this module depends on.

Usage:

 array( [file-path], [file-path], ... )

Definition at line 99 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$group [protected]

String: Name of group to load this module in.

Definition at line 109 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$languageScripts = array() [protected]

Array: List of JavaScript files to include when using a specific language.

Usage:

 array( [language-code] => array( [file-path], [file-path], ... ), ... )

Definition at line 51 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$loaderScripts = array() [protected]

Array: List of paths to JavaScript files to include in the startup module.

Usage:

 array( [file-path], [file-path], ... )

Definition at line 75 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$localBasePath = '' [protected]

String: Local base path, see __construct()

Definition at line 33 of file ResourceLoaderFileModule.php.

Referenced by __construct().

ResourceLoaderFileModule::$localFileRefs = array() [protected]

Array: Place where readStyleFile() tracks file dependencies.

Usage:

 array( [file-path], [file-path], ... )

Definition at line 133 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$messages = array() [protected]

Array: List of message keys used by this module.

Usage:

 array( [message-key], [message-key], ... )

Definition at line 107 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$modifiedTime = array() [protected]

Array: Cache for mtime.

Usage:

 array( [hash] => [mtime], [hash] => [mtime], ... )

Definition at line 125 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$position = 'bottom' [protected]

String: Position on the page to load this module at.

Definition at line 111 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$raw = false [protected]

Boolean: Whether mw.loader.state() call should be omitted.

Definition at line 115 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$remoteBasePath = '' [protected]

String: Remote base path, see __construct()

Definition at line 35 of file ResourceLoaderFileModule.php.

Referenced by __construct().

ResourceLoaderFileModule::$scripts = array() [protected]

Array: List of paths to JavaScript files to always include.

Usage:

 array( [file-path], [file-path], ... )

Definition at line 43 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$skinScripts = array() [protected]

Array: List of JavaScript files to include when using a specific skin.

Usage:

 array( [skin-name] => array( [file-path], [file-path], ... ), ... )

Definition at line 59 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$skinStyles = array() [protected]

Array: List of paths to CSS files to include when using specific skins.

Usage:

 array( [file-path], [file-path], ... )

Definition at line 91 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::$styles = array() [protected]

Array: List of paths to CSS files to always include.

Usage:

 array( [file-path], [file-path], ... )

Definition at line 83 of file ResourceLoaderFileModule.php.

Referenced by getModifiedTime(), getStyles(), and readStyleFiles().

ResourceLoaderFileModule::$targets = array( 'desktop' ) [protected]

Reimplemented from ResourceLoaderModule.

Definition at line 116 of file ResourceLoaderFileModule.php.

The documentation for this class was generated from the following file:

includes/resourceloader/ResourceLoaderFileModule.php

Public Member Functions

Protected Member Functions

Static Protected Member Functions

Protected Attributes

Detailed Description

Constructor & Destructor Documentation

Member Function Documentation

Member Data Documentation