README.md

JustLess

ZF2 module that allows automation of compiling your LESS with the extra of minifying the files. A view helper is available which expects a .less file as a parameter and will compile and possibly minify it returning the filename of the compiled file.

Why JustLess?

First of all I like automating my workflow, if I can skip the step of compiling and minifying through automation then I will! Second of all, the existing modules that I found were entire Asset Managers, but all I wanted was LESS compilation and minification. That's why I made JustLess.

Features

• Compile LESS to CSS on the fly
• Automatically minify the result
• Compilated files are cached using file modified time.

Installation

1. Add the module to your composer.json (or use composer cli)

   "require": {
       "rickkuipers/justless": "~1.0.0"
   }

2. Run composer update: php composer.phar update

3. Enable the module in application.config.php

   return array(
     'modules' => array(
       /*...*/
       'JustLess',
       /*...*/
     ),
   );

4. Copy the file from /vendor/rickkuipers/justless/config/justless.global.php.dist to /config/autoload/justless.global.php

5. Edit the config to match your preferred configuration

6. Make sure the destination_dir is writable (chmod -R 0777 css/).

Usage

$this->less($file, $minify) first parameter is the .less file, second parameter is optional if you want to override the default configuration of minifying the css.

<link href="<?php echo $this->basePath($this->less('less/style.less')) ?>" media="screen" rel="stylesheet" type="text/css">