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)
	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	safeFilemtime ($filename)
	Safe version of filemtime(), which doesn't throw a PHP warning if the file doesn't exist but returns 1 instead.
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.

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:

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

Below is a description for the $options array:

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' => [modile 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 186 of file ResourceLoaderFileModule.php.

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

Member Function Documentation

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

Collates file paths by option (where provided).

Parameters:

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

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

Definition at line 478 of file ResourceLoaderFileModule.php.

References $value.

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 373 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 670 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 357 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 290 of file ResourceLoaderFileModule.php.

References readScriptFiles().

ResourceLoaderFileModule::getLocalPath ( $ path ) [protected]

Parameters:

$path string

Returns:: string

Definition at line 457 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 348 of file ResourceLoaderFileModule.php.

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 398 of file ResourceLoaderFileModule.php.

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

ResourceLoaderFileModule::getPosition ( )

Returns:: string

Reimplemented from ResourceLoaderModule.

Definition at line 364 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::getRemotePath ( $ path ) [protected]

Parameters:

$path string

Returns:: string

Definition at line 465 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 261 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 526 of file ResourceLoaderFileModule.php.

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

Referenced by getScript(), and getScriptURLsForDebug().

ResourceLoaderFileModule::getScriptURLsForDebug ( ResourceLoaderContext $ context )

Parameters:

$context ResourceLoaderContext

Returns:: array

Reimplemented from ResourceLoaderModule.

Definition at line 270 of file ResourceLoaderFileModule.php.

References $file, $urls, 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 544 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 303 of file ResourceLoaderFileModule.php.

References $styles, 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 332 of file ResourceLoaderFileModule.php.

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

ResourceLoaderFileModule::isRaw ( )

Returns:: bool

Reimplemented from ResourceLoaderModule.

Definition at line 380 of file ResourceLoaderFileModule.php.

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

Gets the contents of a list of JavaScript files.

Parameters:

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

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

Definition at line 559 of file ResourceLoaderFileModule.php.

References getLocalPath(), 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:

$path	String: 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 622 of file ResourceLoaderFileModule.php.

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

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

Gets the contents of a list of CSS files.

Parameters:

$styles	Array: 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 593 of file ResourceLoaderFileModule.php.

References $files, and $styles.

Referenced by getStyles().

static ResourceLoaderFileModule::safeFilemtime ( $ filename ) [static, protected]

Safe version of filemtime(), which doesn't throw a PHP warning if the file doesn't exist but returns 1 instead.

Parameters:

$filename string File name

Returns:: int UNIX timestamp, or 1 if the file doesn't exist

Definition at line 654 of file ResourceLoaderFileModule.php.

ResourceLoaderFileModule::supportsURLLoading ( )

Returns:: bool

Reimplemented from ResourceLoaderModule.

Definition at line 281 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:

$list	Array: List of lists to select from
$key	String: Key to look for in $map
$fallback	String: 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 508 of file ResourceLoaderFileModule.php.

References $fallback.

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 131 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 123 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().

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