A module wrapper for Wikimedia’s Less parser that compiles .less files to .css. Also used by the ProcessWire core for AdminThemeUikit customization.

Less parser for ProcessWire

This is a ProcessWire module wrapper for the Wikimedia LESS parser. Originally developed by Bernhard Baumrock with additions by Ryan Cramer. Requires ProcessWire 3.0.164+.

Requirements


  • ProcessWire 3.0.179 or newer (3.0.229+ preferable)
  • PHP 7.4 or newer

Install


  1. Copy all files included in this module into new directory /site/modules/Less/.
  2. In the ProcessWire admin, go to Modules > Refresh.
  3. Click install for the Less module.

API usage


Compile string and two .less files to a css file

$less = $modules->get('Less');
$less->setOption('compress', true);
$less->addStr('@color: #4D926F; h2 { color: @color; }');
$less->addFile('/path/to/file1.less');
$less->addFile('/path/to/file2.less', '/url/to/images/');
$less->saveCss('/path/to/file.min.css');

Access Wikimedia less parser directly

$parser = $less->parser();
$parser->parseFile('/path/to/file.less');
$css = $parser->getCss();

For details about API methods you can access from $parser see: https://github.com/wikimedia/less.php/blob/v4.1.1/API.md

Usage with ProcessWire’s AdminThemeUikit module


Install this module to add the ability to customize the ProcessWire core AdminThemeUikit admin theme module CSS. For this usage, you must have ProcessWire 3.0.179 or newer. See instructions here: https://processwire.com/blog/posts/pw-3.0.179/

License


This module uses the Apache license for consistency with the Wikimedia LESS parser license.

Install and use modules at your own risk. Always have a site and database backup before installing new modules.

Latest news

  • ProcessWire Weekly #532
    In the 532nd issue of ProcessWire Weekly we'll cover the latest core updates, check out a couple of brand-new third party modules, and more. Read on!
    Weekly.pw / 20 July 2024
  • Page List Custom Children module
    This simple module gives you the ability to customize the parent/child relationship as it appears in the admin page list, enabling child pages to appear under more than one parent.
    Blog / 28 June 2024
  • Subscribe to weekly ProcessWire news

“…building with ProcessWire was a breeze, I really love all the flexibility the system provides. I can’t imagine using any other CMS in the future.” —Thomas Aull