https://github.com/gregmolnar/yii-less
https://github.com/gregmolnar/yii-less
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/gregmolnar/yii-less
- Owner: gregmolnar
- Created: 2012-10-30T13:11:41.000Z (over 13 years ago)
- Default Branch: master
- Last Pushed: 2017-02-12T09:07:46.000Z (over 9 years ago)
- Last Synced: 2025-03-31T09:11:13.349Z (about 1 year ago)
- Language: PHP
- Size: 149 KB
- Stars: 11
- Watchers: 4
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
Yii-less
========
This extension allows you to register your less files and they will be compiled to CSS with the option to cache.
Installation
------------
Copy the yii-less folder into the extensions folder of you app.
Usage
----
In your config file register the extension:
```php
'behaviors'=>array(
'ext.yii-less.components.LessCompilationBehavior',
),
```
In your config file register your less files to precompile:
```php
'components'=>array(
'lessCompiler'=>array(
'class'=>'ext.yii-less.components.LessCompiler',
'paths'=>array(
// you can access to the compiled file on this path
'css/bootstrap.css' => array(
'precompile' => true, // whether you want to cache the generation
'compressed' => true, // Will pass the compressed option to the less compiler - Compresses all the unrequired whitespace - Defaults to false
'paths' => array('less/bootstrap.less') //paths of less files. you can specify multiple files.
),
),
),
),
```
Register your asset in your layout:
```php
Yii::app()->clientScript->registerCssFile('css/bootstrap.css')
```
If you are using the precompile option, it will set the expires header to 1 week. To bust the cache automatically, add a version number to the end of the file path when modifying the LESS file.
```php
Yii::app()->clientScript->registerCssFile('css/bootstrap.css?v=1.0.1')
```
Additional Information
----------------------
This extension is heavily based on Crisu83's extension: http://www.yiiframework.com/extension/less/.
I changed how the configuration works so they are not compatible and that's the reason for the fork. I hope he doesn't mind.
Contributing
------------
1. Fork it
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create new Pull Request