1
0
Fork 0
mirror of https://github.com/Oreolek/kohana-less.git synced 2024-06-29 05:04:57 +03:00
kohana-less/README.md

2 KiB

KO3 LESS Module

LESS Module is a port of Leaf Corcoran's LESSPHP for Kohana 3 It adopts some of Alex Sancho's Kohana 2.3 Assets Module codes for CSS compression, credits goes to them Thanks to cheeaun for helping out

To Use

  1. Put the less module folder in your Modules directory
  2. Include less module in your application's bootstrap: 'less' => MODPATH.'less'
  3. Copy the less config file from /modules/less/config/less.php to your application's config directory
  4. From your less.php config file, put the path to where you want the CSS files compiled / compressed, the folder must be writable
  5. You can set compression to TRUE on your less.php config file if you want your CSS files to be combined in to one file and compressed

Sample Code

** /media/css/style.less **

	@bodyBkgColor: #EEE;

	body {
		background: @bodyBkgColor;

		h1 { font-size: 3em; }
	}

** APPPATH/config/less.php **

	return array(
		'compress' => TRUE,

		// relative PATH to a writable folder to store compiled / compressed css
		// path below will be treated as: DOCROOT . 'media/css/'
		'path'     => 'media/css/',
	);

** APPPATH/classes/controller/sample.php **

	Controller_Home extends Controller_Template {

		public $template = 'template';

		// no need to add .less extension
		public $stylesheets = array('reset', 'style');

		public function action_index()
		{
			$stylesheets = $this->stylesheets;

			foreach (stylesheets as $key => $value)
			{
				// I keep my less files inside APPPATH . 'media/less/' but can be anywhere
				$stylesheets[$key] = APPPATH . 'media/less/' . $value;
			}

			$this->template->stylesheets = Less::set($this->stylesheets);
		}
	}

** APPPATH/views/template.php **

	<html>
	<head>
		<title>LESS for Kohana</title>
		<?= $stylesheets ?>
	</head>
	<body>
		<h1>LESS for Kohana or Kohana for LESS?</h1>
	</body>
	</html>

Issues

Please report it to the issues tracker.