3 * This program is free software; you can redistribute it and/or modify
4 * it under the terms of the GNU General Public License as published by
5 * the Free Software Foundation; either version 2 of the License, or
6 * (at your option) any later version.
8 * This program is distributed in the hope that it will be useful,
9 * but WITHOUT ANY WARRANTY; without even the implied warranty of
10 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
11 * GNU General Public License for more details.
13 * You should have received a copy of the GNU General Public License along
14 * with this program; if not, write to the Free Software Foundation, Inc.,
15 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
16 * http://www.gnu.org/copyleft/gpl.html
19 * @author Trevor Parscal
20 * @author Roan Kattouw
24 * Object passed around to modules which contains information about the state
25 * of a specific loader request
27 class ResourceLoaderContext
{
29 /* Protected Members */
31 protected $resourceLoader;
45 public function __construct( $resourceLoader, WebRequest
$request ) {
46 global $wgDefaultSkin, $wgResourceLoaderDebug;
48 $this->resourceLoader
= $resourceLoader;
49 $this->request
= $request;
53 $modules = $request->getVal( 'modules' );
54 $this->modules
= $modules ? self
::expandModuleNames( $modules ) : array();
56 $this->skin
= $request->getVal( 'skin' );
57 $this->user
= $request->getVal( 'user' );
58 $this->debug
= $request->getFuzzyBool( 'debug', $wgResourceLoaderDebug );
59 $this->only
= $request->getVal( 'only' );
60 $this->version
= $request->getVal( 'version' );
63 $this->skin
= $wgDefaultSkin;
68 * Expand a string of the form jquery.foo,bar|jquery.ui.baz,quux to
69 * an array of module names like array( 'jquery.foo', 'jquery.bar',
70 * 'jquery.ui.baz', 'jquery.ui.quux' )
71 * @param $modules String Packed module name list
72 * @return array of module names
74 public static function expandModuleNames( $modules ) {
76 // For backwards compatibility with an earlier hack, replace ! with .
77 $modules = str_replace( '!', '.', $modules );
78 $exploded = explode( '|', $modules );
79 foreach ( $exploded as $group ) {
80 if ( strpos( $group, ',' ) === false ) {
81 // This is not a set of modules in foo.bar,baz notation
82 // but a single module
85 // This is a set of modules in foo.bar,baz notation
86 $pos = strrpos( $group, '.' );
87 if ( $pos === false ) {
88 // Prefixless modules, i.e. without dots
89 $retval = explode( ',', $group );
91 // We have a prefix and a bunch of suffixes
92 $prefix = substr( $group, 0, $pos ); // 'foo'
93 $suffixes = explode( ',', substr( $group, $pos +
1 ) ); // array( 'bar', 'baz' )
94 foreach ( $suffixes as $suffix ) {
95 $retval[] = "$prefix.$suffix";
104 * Return a dummy ResourceLoaderContext object suitable for passing into things that don't "really" need a context
106 public static function newDummyContext() {
107 return new self( null, new FauxRequest( array() ) );
111 * @return ResourceLoader
113 public function getResourceLoader() {
114 return $this->resourceLoader
;
120 public function getRequest() {
121 return $this->request
;
127 public function getModules() {
128 return $this->modules
;
134 public function getLanguage() {
135 if ( $this->language
=== null ) {
137 $this->language
= $this->request
->getVal( 'lang' );
138 if ( !$this->language
) {
139 $this->language
= $wgLang->getCode();
142 return $this->language
;
148 public function getDirection() {
149 if ( $this->direction
=== null ) {
150 $this->direction
= $this->request
->getVal( 'dir' );
151 if ( !$this->direction
) {
152 # directionality based on user language (see bug 6100)
153 $this->direction
= Language
::factory( $this->language
)->getDir();
156 return $this->direction
;
160 * @return string|null
162 public function getSkin() {
167 * @return string|null
169 public function getUser() {
176 public function getDebug() {
181 * @return String|null
183 public function getOnly() {
188 * @return String|null
190 public function getVersion() {
191 return $this->version
;
197 public function shouldIncludeScripts() {
198 return is_null( $this->only
) ||
$this->only
=== 'scripts';
204 public function shouldIncludeStyles() {
205 return is_null( $this->only
) ||
$this->only
=== 'styles';
211 public function shouldIncludeMessages() {
212 return is_null( $this->only
) ||
$this->only
=== 'messages';
218 public function getHash() {
219 if ( !isset( $this->hash
) ) {
220 $this->hash
= implode( '|', array(
221 $this->getLanguage(), $this->getDirection(), $this->skin
, $this->user
,
222 $this->debug
, $this->only
, $this->version