Download the PHP package frankfoerster/cakephp-asset without Composer
On this page you can find all versions of the php package frankfoerster/cakephp-asset. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download frankfoerster/cakephp-asset
More information about frankfoerster/cakephp-asset
Files in frankfoerster/cakephp-asset
Package cakephp-asset
Short Description Provides a CakePHP 3.x AssetHelper to selectively add last modified timestamps to css and js assets.
License MIT
Homepage https://github.com/frankfoerster/cakephp-asset
Informations about the package cakephp-asset
cakephp-asset
-
Provides a CakePHP 3.x AssetHelper to selectively add last modified timestamps to css and js assets. CakePHP's implementation of Asset timestamps does not allow you to apply the behavior selectively to single files. Therefore I created this little Helper.
- Provides a CakePHP 3.x AssetFilter to request asset files from
/src/Assets/*
. For example if you delevop an app using requirejs, then you can enable the AssetFilter to request modules from/src/Assets/js/*
. This enables you to hide your source files from the webroot of your application or plugin.
Installation
You can install this plugin into your CakePHP application using composer.
Run the following command
Configuration
You can load the plugin using the shell command:
Or you can manually add the loading statement in the config/boostrap.php file of your application:
Load the Helper
Load the AssetHelper in the src/View/AppView.php file of your application.
Use the AssetHelper in your Layout.
The last modified time of the asset files is automatically appended.
The methods provided are AssetHelper::css()
and AssetHelper::js()
. Both take up to three arguments:
$path
- The path to the asset relative to the webroot of your app or plugin.$plugin
- Either false to link to an app asset, or the name of a plugin. (default false)$appendTimestamp
- Whether to append a last modified timestamp to the url. (default true)
CSS
Linking the CSS file your_app/webroot/css/app.css
produces the following output:
JS
Linking the JS file your_app/webroot/js/app.js
produces the following output:
Linking Plugin Assets
Linking the JS file MyPlugin/webroot/js/plugin.js
produces the following output:
Linking Source Assets
To request assets from /src/Assets/*
you have to enable the AssetFilter in config/bootstrap.php
:
Then you can use the AssetHelper to request a source asset.
App
Linking the JS file your_app/src/Assets/js/app.js
produces the following output:
and the AssetFilter will then return the content of your_app/src/Assets/js/app.js.
Plugin
Linking the JS file MyPlugin/src/Assets/js/plugin.js
will procude the following output:
and the AssetFilter will then return the content of MyPlugin/src/Assets/js/plugin.js.
Important!
Linking of source assets is only enabled for Configure 'debug' => true
.