extendedclientscript

Yii Framework Extensions

Popular Tags

extendedclientscript Faster page loading by combining and compressing JS / CSS files

Documentation
Change Log

With this extension you can transparently reduce page load times by combining and compressing the used Javascript and CSS files.

All parameters can be set in your main.php config. No need for altering your code, just set and forget.

Needs Yii 1.0.4/1.1.x or greater, and for compression JSMin and CSSTidy.

Resources ¶

Join discussion

Documentation ¶

Requirements ¶

Yii 1.0.4/1.1.x or above

Installation ¶

Since version 0.9

Extract the zip file under 'proctected/extensions'
Add the following to your 'config/main.php':

// application components
	'components'=>array(
                 ....
	    'clientScript'=>array(
			'class'=>'ext.ExtendedClientScript.ExtendedClientScript',
			'combineCss'=>true,
			'compressCss'=>true,
			'combineJs'=>true,
			'compressJs'=>true,
		),

And you're set!

For more options see the comments in the file. To mention a few:

excludeFiles: array with files not to be combined/compressed. Handy for some rarely used JS/CSS files.
autoRefresh: If false, no check on filemtime() to speed up a bit more. Useful in production.

Change Log ¶

August 30, 2011: 0.9.0 ¶

New version, using CssMin and JsMin (included). Several improvements of Sam included.
August 23, 2011: 0.4.1 ¶
Automatic exclusion of remote files (JS as well as CSS), so you can use your CDN of choice. Thanks Kir!
By popular demand: removal of DIRECTORY_SEPARATOR, changed to '/'
March 12, 2009 ¶
Additional test to prevent E_ALL errors.
March 11, 2009 ¶
Initial release.

18 5

29 followers

4 210 downloads

Yii Version: 1.1

License: BSD-2-Clause

Category: Caching

Tags: clientscript, combine, compress, css, jquery

Developed by: Maxximus

Created on: Mar 11, 2009

Last updated: 13 years ago

Downloads

show all

Related Extensions

User Contributed Notes 20

#682

0 0

CSS file handling need to be improved

The option "excludeFiles" does only work for JS files. CSS files getting combined/compressed even if listed in the option "excludeFiles".

Another improvement would be to exclude all files where the path points to a CDN.

p_m at Mar 19, 2010, 4:14:13 PM

#1001

0 0

csstidy too old

seems that csstidy is too old for php 5.3 :(
"Non-static method csstidy::is_important() should not be called statically, assuming $this from incompatible context" .. don't want to start debugging as it ends up with 6 hours and no result :)
Trying to find a good alternative...

mintao at Jan 12, 2010, 2:12:00 PM

#1002

0 0

DIRECTORY_SEPARATOR

DIRECTORY_SEPARATOR is - as the name says a directory separator, not a url separator. So it works well with linux and mac because the folder separator in urls matches the directory separator.

As windows uses the backslash \ creating a url with the constant DIRECTORY_SEPARATOR can't work anymore on windows virtual hosts.

So there definitely has to be a "/" instead of the constant DIRECTORY_SEPARATOR.

mintao at Jan 12, 2010, 1:47:47 PM

#1523

1 0

Update

Updated extension code

samdark at Jul 6, 2009, 7:14:06 PM

#1525

0 0

DIRECTORY_SEPARATOR

Same problem with DIRECTORY_SEPARATOR.

samdark at Jul 6, 2009, 1:44:45 PM

#1555

0 0

Great component

I have the same issue Boris did.

For me in line 221 does not make sense use DIRECTORY_SEPARATOR because this a URL separator and not a file separator.

You said: "It is also used in several other places in this extension".

This is just coincidence.
In my Windows XP DIRECTORY_SEPARATOR is '\' and in your tests maybe is LINUX. And linux maybe is '/' separator, just like URL separator which is '/'.

Ismael at Jun 25, 2009, 3:23:24 AM

#1839

0 0

DIRECTORY_SEPARATOR

Thanks!
DIRECTORY_SEPARATOR is a predefined PHP constant, so that can't (shoudn't) be the real issue. It is also used in several other places in this extension.
BTW: Might be better to use the forum thread for this: [url=http://www.yiiframework.com/forum/index.php/topic,1091.0.html]forum discussion[/url]

Maxximus at Mar 12, 2009, 11:06:53 PM

#1840

0 0

Great job, is this a bug?

Hi,

it works fine for me. Great idea, no need to reinvent the wheel now ;-)

But can you please check the line 221 in the current revision of ExtendedClientScript

I think DIRECTORY_SEPARATOR is wrong, i did not work for me, it worked as i changed it to "/". How come? Idea?

Otherwise i got errors that resource could not be found...

Thanks,
Boris

Boris at Mar 12, 2009, 7:23:51 PM

#2864

0 0

DIRECTORY_SEPARATOR BUG AND RECOMMENDED

In the 221 line, you can not use DIRECTORY_SEPARATOR, DIRECTORY_SEPARATOR used in the URL is not correct, I agree this is a bug. In addition, can you turn the associated documents to be re-released, such as the pictures to use relative paths inside css file? I think this is necessary, css files are mapped to another file, the directory path has changed, the picture of the paths must be properly re-mapping.This is also can be done.

rickywu at Feb 18, 2011, 8:23:30 AM

#3449

0 0

DIRECTORY_SEPARATOR not needed

DIRECTORY_SEPARATOR is not needed. As long as you use forward slashes (/) everywhere everything will work as intended.

All *nix systems use forward slashes (/) while windows use back slashes (). The good news is that Windows converts forward slashes (/) into back slashes () hence why you should only use forward slashes (/). It's been like this for ages and that's how i do it.

sAe at Apr 13, 2011, 9:51:51 PM

#5060

0 0

Facing a problem

Hi first of all thank you for this extension i have been using it for quite sometime now....just one problem...now whenever i use a widget from yii the images do not load when the compression is on...if i take the compression off it works fine...i checked the css which is calling the images and they are fine but once the compression happens the css file gets moved and so the path in the css does not work... how do i make it work..kindly help

Wenceslaus D'silva at Sep 12, 2011, 4:46:49 AM

#5367

1 0

Re: Facing a problem

deadmantfa: i posted patch for it at google code, here it is http://code.google.com/p/extendedclientscript/issues/detail?id=1

Nafania at Oct 7, 2011, 9:34:09 AM

#5371

0 0

thank you Nafania

Thank u Nafania I shall check this out Tom and let u know how it goes. Cheers

Wenceslaus D'silva at Oct 7, 2011, 12:40:58 PM

#5376

0 0

Thank u

Thank you Nafania it worked like a charm....great work...cheers

Wenceslaus D'silva at Oct 8, 2011, 6:54:38 AM

#5511

0 0

Another server host

Could I set another server url for generated files like this: http://www.yiiframework.com/doc/api/1.1/CAssetManager#basePath-detail ?

Stamm at Oct 17, 2011, 8:21:29 PM

#6199

0 0

Enhancements

I propose you to enhance some functionality of excluding css and js files:

public function renderHead(&$output)
{
..........
  foreach ($this->cssFiles as $url => $media) {
     $file_arr = pathinfo($url);
     if (!empty($this->excludeCssFiles) && in_array($file_arr['basename'], $this->excludeCssFiles) || $this->isRemoteFile($url)) {
         // excluding files
     } else {
         $cssFiles[$media][$url] = $url;
     }
  }
.........
}

And renderJs function:

private function renderJs($output, $pos)
{
.......
    foreach ($jsFiles as &$fileName) {
    $file_arr = pathinfo($fileName);
    (!empty($this->excludeJsFiles) && in_array($file_arr['basename'], $this->excludeJsFiles) || $this->isRemoteFile($fileName)) AND $fileName = false;
.......
}

After this enhances I can do this in my config:

'clientScript' => array(
            'class' => 'application.extensions.ExtendedClientScript.ExtendedClientScript',
            'combineCss' => true,
            'compressCss' => true,
            'combineJs' => true,
            'compressJs' => true,
            'excludeJsFiles' => array('jquery.min.js', 'jquery-ui.min.js', 'jquery-ui.css'),
            'excludeCssFiles' => array('jquery-ui.css'),
        ),

andser at Dec 19, 2011, 1:07:04 PM

#8316

0 0

include(JSMin.php) error

Hi,
Thank you for the extension.
Do you have an idea what can cause this error:

include(JSMin.php) [<a href='function.include'>function.include</a>]: failed to open stream: No such file or directory

It appears only if

'autoRefresh' => true,

For a quick fix I added

'import'=>array('ext.ExtendedClientScript.jsmin.JSMin' )

to config file.

Is it expected behavior?

yugene at May 25, 2012, 6:26:57 AM

#10709

0 0

Array to string conversion

Just started, installed and set the config.

I got: Array to string conversion in [...]/ExtendedClientScript.php on line 209

Nathan at Nov 18, 2012, 9:15:11 AM

#13095

0 0

@Nathan - Re: Array to string conversion

In ExtendedClientScript.php, line 209, replace:

serialize($this->cssMinFilters . $this->cssMinPlugins)

With:

serialize($this->cssMinFilters) . serialize($this->cssMinPlugins)

Rodrigo Coelho at May 4, 2013, 8:55:29 AM

#13117

0 0

pull request

@Rodrigo Coelho

I've published it on the github with your fix: https://github.com/kirs/extendedclientscript

iEmpire at May 6, 2013, 10:27:18 AM

Categories

Popular Tags