WP Compiler

Description

Harness the power of pre-processed CSS and minified JS in your theme or plugin, without any complicated installs or build tools. Simply tell WP Compiler where to find your source files and where to put the compiled results, then throw your install into Dev Mode. WP Compiler watches your source folders for you, and recompiles your CSS and JS on any file change. WP Compiler supports both SCSS and LESS precompilers for CSS, to suit anyone’s preference.

When you’re ready to launch a new site, just turn off Dev Mode, and your styles and javascript will be compiled & minimized and comments & source maps will be removed. With Dev mode disabled, Compiler will stop watching source directories, so there is no effect on site performance, but you can still apply a quick change at any time, by clicking the compile button in the admin toolbar.

WP Compiler relies on scssphp, lessphp, and minify.
Specific issues with the underlying compilation libraries should be submitted to their respective developers.

Screenshots

  • The admin bar interface of WP Compiler
  • The admin bar interface of WP Compiler, in dev mode
  • The settings page

Installation

  1. Download the plugin file to your system and unzip it
  2. Using an FTP program, or your hosting control panel, upload the unzipped plugin folder to your WordPress installationís wp-content/plugins/ directory
  3. Activate the plugin from the Plugins menu within the WordPress admin
  4. Go to Settings -> Compiler Settings
  5. Set the paths to your source CSS and JS files and the targets they compile to
  6. Turn on Dev Mode and get coding!

FAQ

How can I combine multiple JavaScript files?

The easiest way to compile your JS is to store it all in a single directory. If you set your compilation source to be the directory path, all JS files in the directory will be combined and minified.

How can I make sure JavaScript files are minified in a specific order?

WP Compiler supports .manifest files for JavaScript. This is a custom file format in which each line consists of a relative file path to a JS file, a relative path to a directory containing JS, or a relative path to another .manifest file. for clarity, lines beginning with a hash symbol (#) are treated as comments.

Here is an example of a manifest file:

# <js.manifest>
# This is a sample JavaScript manifest file for WP Compiler
# all paths are relative to the current manifest file
# First we are going to load specific files that have to come first
test-script.js
test-script2.js
# Now let’s load a sub-manifest
partials/js.manifest
# Finally, let’s load a folder whose contents
# don’t need to be in a specific order
external-scripts/

What about AutoPrefixing, JS Transpiling, NPM includes, Require.js, Custom Task Runners or ?

Unfortunately, there is a limit to how many of the immense number of node.js build processes available can be replicated in native PHP. Please let us know about which features you’d most like to see tackled next.

Contributors & Developers

“WP Compiler” is open source software. The following people have contributed to this plugin.

Translate “WP Compiler” into your language.

Interested in development?

Browse the code, check out the SVN repository, or subscribe to the development log by RSS.

Changelog

1.0

  • Initial Release