Download the PHP package trentrichardson/cakephp-shrink without Composer
On this page you can find all versions of the php package trentrichardson/cakephp-shrink. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download trentrichardson/cakephp-shrink
More information about trentrichardson/cakephp-shrink
Files in trentrichardson/cakephp-shrink
Package cakephp-shrink
Short Description Compiles, combines, and minifies javascript, coffee, less, scss, and css
License MIT
Homepage http://github.com/trentrichardson/cakephp-shrink
Informations about the package cakephp-shrink
Shrink CakePHP Plugin
About
- Author: Trent Richardson
- Twitter: @practicalweb
The Shrink plugin compiles, combines, and minifies javascript and css. It currently has support for native javascript and css, Less (php and node versions), Sass (php and ruby versions), CoffeeScript, and TypeScript.
Shrink is a minimal configuration plugin. For a super powerful, configurable asset minifier look into Mark Story's asset_compress instead.
Installation
This version is for CakePHP 3, for other versions of CakePHP check the branches on Github.
It is recommended to use composer to install: "trentrichardson/cakephp-shrink": "~3.0"
.
Then enable your plugin in bootstrap.php Plugin::load('Shrink');
or Plugin::loadAll();
.
You can also manually download Shrink and place into app/Plugin folder
Enable the plugin in bootstrap.php with Plugin::load('Shrink',['autoload'=>true]);
or
Plugin::loadAll();
. When manually installing you need to set the autoload flag to true.
Add "Shrink.Shrink" to your $helpers
property in your controller. Likely AppController.php.
Usage
You use Shrink in the same way you already use the Html helper for js and css. The slight differences are that you must include the file extension (since you can now process less, sass, coffee), and the parameters following the files.
Lets say you have a layout, and a view in the users controller. The view might have at the top:
Then in the layout you have:
Shrink will see that there are views passing js and css as well as layouts and merge them together appropriately (layouts css and js, then views css and js)
Once fetch is called that type's queue is cleared and you can queue again.
Options
Options are passed just like other helpers.
You may also pass in options using Configure, however any options directly passed to the helper as shown above will override those set with Configure:
The available options to pass are:
Extending
Extending Shrink is extremely simple, and can likely be done with only a few lines of code. There are two abstractions, Compilers and Compressors.
Compilers are for file types like Coffee, Less, etc. These can be found in the app/Plugin/Shrink/src/Lib/ShrinkCompiler folder. The file and class name goes by the file extension. Less files have a .less extension, so will create ShrinkCompilerLess.php. Each compiler must set the $resultType variable to 'js' or 'css' (the end result type), and implement the compile method.
Compressors are for minifying the code after it has been compiled to js or css. These can be found in app/Plugin/Shrink/src/Lib/ShrinkCompressor. The file and class name goes by the option you set in settings (the minifier option for js or css). So if you pass the minifier option for css to be cssmin, the file name will be ShrinkCompressorCssmin.php. Each compressor class must implement the compress method.
The easiest way to extend a compiler or compressor is to simply copy one of the existing versions. You will also notice compilers and compressors extend ShrinkBase. This is a utility class which currently provides a "cmd" method to execute commands.
Testing
If you are making changes it is a good idea to create tests and ensure your new code is in a passing state. Tests are run via phpunit. Since cakephp-shrink provides support for command line utilities and composer packages you must install them before tests can run.
Depending on your setup you may need to use sudo. To run tests simply call phpunit
or vendor/bin/phpunit
.
License
Copyright 2015 Trent Richardson
You may use this project under MIT or GPL licenses.
All versions of cakephp-shrink with dependencies
composer/installers Version *
cakephp/cakephp Version ~3.0
leafo/lessphp Version 0.5.0
leafo/scssphp Version 0.1.1
natxet/cssmin Version 3.0.2
tedivm/jshrink Version ~1.0