SCSS Happy Compiler – Compile SCSS to CSS & Automatic Enqueue

ཞིབ་བརྗོད།

AUTOMATICALLY COMPILE YOUR SCSS FILES TO CSS FILES

Compile easily your SCSS code to CSS automatically, directly on your server and without installing SASS. You choose when and how to compile.

SCSS is a CSS preprocessor language that adds many features like variables, mixins, imports, nesting, color manipulation, functions, and control directives. All theses features are supported in the plugin.

HOW IT WORKS

In the plugin settings pages, you can choose the folder which will contain all of your SCSS files, and the folder which will contain generated CSS files.

The plugin compile your SCSS files recursively, so that SCSS files in subfolders can be compiled too, creating the missing folders to recreate the same path in the CSS folder than the SCSS folder.

As everyone has not the same needs, you will be able to set some useful options.

ENQUEUE CSS FILES AUTOMATICALLY

This option let you ask the plugin to automatically include your generated CSS files in your header, thus you won’t have to enqueue these files manually.

COMPILATION OPTIONS

Choose when you want the plugin to generate the CSS files:

• Always: if you are in development and be sure that all CSS files will be compiled everytime you load a page
• When SCSS has changed: if you just want to compile if you have edited one of your SCSS files ; this option takes into account inclusions and subfolders, so that an included scss file that has been changed will trigger the compilation of the file which includes it
• If logged in: if you want only logged in users to trigger compilation
• If admin logged in: if you want only logged in administrators to trigger compilation

Also, you can choose to generate source map files with your CSS files to better visualize your generated code while debugging.
Exemple: main.css will generate the source map main.css.map.

MINIFICATION OPTIONS

Your generated CSS code can be fully or partially minified according to your needs. Here are the minification modes available:
* Expanded
* Compressed
To let you see the difference between all these options, they are previewed live when you change it.

ERRORS DISPLAYING OPTIONS

Choose how to display compiling errors in front office:
* Always
* If the WP_DEBUG constant of your WordPress installation is true (in wp_options.php)
* If Logged In: if you want only logged in users to see compilation errors
* If Admin Logged In: if you want only logged in administrators to see compilation errors
* Never
And if you don’t want to display errors even in BO, select the last option :
* Never, even in Back Office

COMPILE CSS FROM EVERY FOLDERS IN YOUR WORDPRESS INSTALLATION in the ‘Advanced Paths’ tab

Compile SCSS from any folder of your WordPress installation : themes, plugins, …
In two textareas, you can specify one path per row: SCSS folder path on the left, CSS folder path on the right.
And you can add as many paths as you need!

IMPORT / EXPORT SETTINGS in the ‘Import / Export’ tab

Download immediately your settings in a .json file, either to use them on another site or to save them.
Upload this .json file on every websites with this plugin installed to overwrite settings.