3 * Abstraction for resource loader modules which pull from wiki pages.
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
26 * Abstraction for resource loader modules which pull from wiki pages
28 * This can only be used for wiki pages in the MediaWiki and User namespaces,
29 * because of its dependence on the functionality of
30 * Title::isCssJsSubpage.
32 abstract class ResourceLoaderWikiModule
extends ResourceLoaderModule
{
34 /* Protected Members */
36 # Origin is user-supplied code
37 protected $origin = self
::ORIGIN_USER_SITEWIDE
;
39 // In-object cache for title mtimes
40 protected $titleMtimes = array();
42 /* Abstract Protected Methods */
45 * @param $context ResourceLoaderContext
47 abstract protected function getPages( ResourceLoaderContext
$context );
49 /* Protected Methods */
52 * Get the Database object used in getTitleMTimes(). Defaults to the local slave DB
53 * but subclasses may want to override this to return a remote DB object, or to return
54 * null if getTitleMTimes() shouldn't access the DB at all.
56 * NOTE: This ONLY works for getTitleMTimes() and getModifiedTime(), NOT FOR ANYTHING ELSE.
57 * In particular, it doesn't work for getting the content of JS and CSS pages. That functionality
58 * will use the local DB irrespective of the return value of this method.
60 * @return DatabaseBase|null
62 protected function getDB() {
63 return wfGetDB( DB_SLAVE
);
70 protected function getContent( $title ) {
71 if ( $title->getNamespace() === NS_MEDIAWIKI
) {
72 // The first "true" is to use the database, the second is to use the content langue
73 // and the last one is to specify the message key already contains the language in it ("/de", etc.)
74 $text = MessageCache
::singleton()->get( $title->getDBkey(), true, true, true );
75 return $text === false ?
'' : $text;
77 if ( !$title->isCssJsSubpage() && !$title->isCssOrJsPage() ) {
80 $revision = Revision
::newFromTitle( $title, false, Revision
::READ_NORMAL
);
85 $content = $revision->getContent( Revision
::RAW
);
86 $model = $content->getModel();
88 if ( $model !== CONTENT_MODEL_CSS
&& $model !== CONTENT_MODEL_JAVASCRIPT
) {
89 wfDebug( __METHOD__
. "bad content model #$model for JS/CSS page!\n" );
93 return $content->getNativeData(); //NOTE: this is safe, we know it's JS or CSS
99 * @param $context ResourceLoaderContext
102 public function getScript( ResourceLoaderContext
$context ) {
104 foreach ( $this->getPages( $context ) as $titleText => $options ) {
105 if ( $options['type'] !== 'script' ) {
108 $title = Title
::newFromText( $titleText );
109 if ( !$title ||
$title->isRedirect() ) {
112 $script = $this->getContent( $title );
113 if ( strval( $script ) !== '' ) {
114 $script = $this->validateScriptFile( $titleText, $script );
115 if ( strpos( $titleText, '*/' ) === false ) {
116 $scripts .= "/* $titleText */\n";
118 $scripts .= $script . "\n";
125 * @param $context ResourceLoaderContext
128 public function getStyles( ResourceLoaderContext
$context ) {
129 global $wgScriptPath;
132 foreach ( $this->getPages( $context ) as $titleText => $options ) {
133 if ( $options['type'] !== 'style' ) {
136 $title = Title
::newFromText( $titleText );
137 if ( !$title ||
$title->isRedirect() ) {
140 $media = isset( $options['media'] ) ?
$options['media'] : 'all';
141 $style = $this->getContent( $title );
142 if ( strval( $style ) === '' ) {
145 if ( $this->getFlip( $context ) ) {
146 $style = CSSJanus
::transform( $style, true, false );
148 $style = CSSMin
::remap( $style, false, $wgScriptPath, true );
149 if ( !isset( $styles[$media] ) ) {
150 $styles[$media] = '';
152 if ( strpos( $titleText, '*/' ) === false ) {
153 $styles[$media] .= "/* $titleText */\n";
155 $styles[$media] .= $style . "\n";
161 * @param $context ResourceLoaderContext
164 public function getModifiedTime( ResourceLoaderContext
$context ) {
165 $modifiedTime = 1; // wfTimestamp() interprets 0 as "now"
166 $mtimes = $this->getTitleMtimes( $context );
167 if ( count( $mtimes ) ) {
168 $modifiedTime = max( $modifiedTime, max( $mtimes ) );
170 $modifiedTime = max( $modifiedTime, $this->getMsgBlobMtime( $context->getLanguage() ) );
171 return $modifiedTime;
175 * @param $context ResourceLoaderContext
178 public function isKnownEmpty( ResourceLoaderContext
$context ) {
179 return count( $this->getTitleMtimes( $context ) ) == 0;
183 * Get the modification times of all titles that would be loaded for
185 * @param $context ResourceLoaderContext: Context object
186 * @return array( prefixed DB key => UNIX timestamp ), nonexistent titles are dropped
188 protected function getTitleMtimes( ResourceLoaderContext
$context ) {
189 $dbr = $this->getDB();
191 // We're dealing with a subclass that doesn't have a DB
195 $hash = $context->getHash();
196 if ( isset( $this->titleMtimes
[$hash] ) ) {
197 return $this->titleMtimes
[$hash];
200 $this->titleMtimes
[$hash] = array();
201 $batch = new LinkBatch
;
202 foreach ( $this->getPages( $context ) as $titleText => $options ) {
203 $batch->addObj( Title
::newFromText( $titleText ) );
206 if ( !$batch->isEmpty() ) {
207 $res = $dbr->select( 'page',
208 array( 'page_namespace', 'page_title', 'page_touched' ),
209 $batch->constructSet( 'page', $dbr ),
212 foreach ( $res as $row ) {
213 $title = Title
::makeTitle( $row->page_namespace
, $row->page_title
);
214 $this->titleMtimes
[$hash][$title->getPrefixedDBkey()] =
215 wfTimestamp( TS_UNIX
, $row->page_touched
);
218 return $this->titleMtimes
[$hash];