PHPackages grape-fluid/asset-loader - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. grape-fluid/asset-loader ActiveLibrary[Utility & Helpers](/categories/utility) grape-fluid/asset-loader ======================== v0.7.1(2mo ago)19181BSD-3-ClausePHPPHP >= 8.2 Since Mar 6Pushed 2mo ago2 watchersCompare [ Source](https://github.com/grape-fluid/asset-loader)[ Packagist](https://packagist.org/packages/grape-fluid/asset-loader)[ Docs](https://github.com/grape-fluid/asset-loader)[ RSS](/packages/grape-fluid-asset-loader/feed)WikiDiscussions master Synced 1mo ago READMEChangelog (5)Dependencies (8)Versions (8)Used By (1) GrapeFluid/AssetLoader [![](https://camo.githubusercontent.com/a647a231e2b4d42009bdd9c73de6511f8aaf89534b548eb9689f7afef31eb684/68747470733a2f2f646576656c6f706572732e677261706573632e637a2f6c6f676f5f696e6c696e652e706e67)](https://camo.githubusercontent.com/a647a231e2b4d42009bdd9c73de6511f8aaf89534b548eb9689f7afef31eb684/68747470733a2f2f646576656c6f706572732e677261706573632e637a2f6c6f676f5f696e6c696e652e706e67) ============================================================================================================================================================================================================================================================================================================================================================================================================================ [](#grapefluidassetloader-) [![PHP from Packagist](https://camo.githubusercontent.com/13e68be8e3de2857a75c54259bc13fc7923fda93c835a9a48e25631ba92bb592/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f67726170652d666c7569642f61737365742d6c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/grape-fluid/asset-loader)[![Build Status](https://camo.githubusercontent.com/489dc49efc2d0cee19719fca7d5ad3f5f0ff0f593078d17078108981dbf5a0f3/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f67726170652d666c7569642f61737365742d6c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://travis-ci.org/grape-fluid/asset-loader)[![Code coverage](https://camo.githubusercontent.com/e8cac38c76656d6e30bdf0a6ad717dc75ff45897b33269ddc2643f9cc8c52b51/68747470733a2f2f696d672e736869656c64732e696f2f636f766572616c6c732f67726170652d666c7569642f61737365742d6c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://coveralls.io/r/grape-fluid/asset-loader)[![Licence](https://camo.githubusercontent.com/88f28b0696aa01b76a3ff22b2d14167a12394f3505bf7c9bc5da3305b9dd1844/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f67726170652d666c7569642f61737365742d6c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/grape-fluid/asset-loader)[![Downloads this Month](https://camo.githubusercontent.com/dbe502e1d46fce75d62799766d276d215c3be28744f58dc8dee3c86938081c92/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f67726170652d666c7569642f61737365742d6c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/grape-fluid/asset-loader)[![Downloads total](https://camo.githubusercontent.com/f5b1ad877ded47e53b4a7ce1d5bcddd26c6bbaa488d585eff3db8f0acd12eda2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f67726170652d666c7569642f61737365742d6c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/grape-fluid/asset-loader)[![Latest stable](https://camo.githubusercontent.com/465cfda191c94f379de60157b720f638402d41ec142aa4f9844c655a2ccc24a9/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f67726170652d666c7569642f61737365742d6c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/grape-fluid/asset-loader) Asset Loader for your Nette projects Dependencies ------------ [](#dependencies) RequireVersionPHP`>= 5.6`nette/application`^2.4`nette/di`^2.4`Require-devVersionnette/tester`^2.0`tracy/tracy`^2.4`Quickstart ---------- [](#quickstart) 1. Install **Asset Loader** with composer ``` composer require grape-fluid/asset-loader ``` 2. Register **extension** (in neon) ``` extensions: assets: Grapesc\GrapeFluid\AssetLoaderExtension ``` 3. Set your **public directory** (mostly www) (in neon) ``` assets: config: wwwDir: %appDir%/../www ``` 4. Set-up your first package (see all options / features below) ``` assets: yourPackage: js: # will create file in wwwDir/assets/yourPackage/js/main.js - %appDir%/modules/WebsiteModule/assets/js/main.js css: # will create file in wwwDir/assets/yourPackage/css/styles.css - %appDir%/modules/StyleModule/assets/css/style.css # you can also use external / remote assets - 'https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.1.1/css/bootstrap.min.css' copy: # will copy all images from folder into wwwDir/assets/yourPackage/copy/ - %appDir%/modules/StyleModule/assets/images/* ``` 5. Inject *AssetsControl* and create component in your **BasePresenter** ``` /** @var \Grapesc\GrapeFluid\AssetsControl\AssetsControl @inject */ public $assets; protected function createComponentAssets() { return $this->assets; } ``` 6. Render your assets in **template** ``` {control assets:css} {control assets:js} ``` Multiple files -------------- [](#multiple-files) If you have too many files (for ex. scripts) that you want to include in your templates, or just want to copy whole directory (for ex. with images), you can use asterisk `*` character. ``` assets: yourPackage: js: - %appDir%/modules/WebsiteModule/assets/js/scripts/* ``` Custom destination ------------------ [](#custom-destination) If you need, for any reason, copy file into public directory with custom name or custom directory, just specify asset as array. You can use `&` character that will be replaced with public assets directory folder. ``` assets: yourPackage: js: # [ source, destination ] - [ %appDir%/modules/WebsiteModule/assets/js/main.js, &/my/folder/test.js ] ``` You can also do the same with whole **directories**: ``` assets: yourPackage: js: # [ source, destination ] - [ %appDir%/modules/StyleModule/assets/images/*, &/images/ ] ``` Options ------- [](#options) Of course, quickstart doesn't do anything special but copy files and use them in your template files. But it's getting more interesting with these options. ### Limits [](#limits) You can limit **assets** by Nette-like links. By default all defined assets are enabled everywhere. **You can combine multiple limits.** By using limits Asset Loader will load only assets that matches your limit. You can easily create assets for backend / frontend, but also for sub-frontend modules, etc. #### How to limit asset for **module**? [](#how-to-limit-asset-for-module) ``` assets: yourPackage: limit: - ":Module:.*" ``` #### How to limit asset for multiple **presenters**? [](#how-to-limit-asset-for-multiple-presenters) ``` assets: yourPackage: limit: - ":Module:Presenter:.*" - ":Module:AnotherPresenter:.*" ``` #### Limiting by access rights ($user->isAllowed()) [](#limiting-by-access-rights-user-isallowed) ``` assets: yourPackage: # Will call $user->isAllowed('homepage') - ['link' = ':Module:Presenter.*', 'auth' = 'homepage'] ``` #### Limiting by custom options [](#limiting-by-custom-options) Create and define custom service that implements `\Grapesc\GrapeFluid\Options\IAssetOptions` interface as written below. **We are automatically registering these as services** sou you don't have to. **Inject through constructor** in these services also works. Now you are able to handle limits in any way you want. For example enable / disable assets from your back-office. ``` assets: config: options: # Must implement \Grapesc\GrapeFluid\Options\IAssetOptions - \Your\Class\That\Handles\SomeOptions - \Your\Class\That\Handles\AnotherOptions yourPackage: # Will call $class->getOption('inline.enabled') on every service - ['link' = ':Module:Presenter.*', 'option' = 'inline.enabled'] ``` #### Using negation limit [](#using-negation-limit) Use `!` in front of limit ``` assets: yourPackage: limit: - "!:Module:Presenter:.*" ``` ### Ordering [](#ordering) Sometimes, especially when using modules, it comes handy to sort / order your packages. #### Start / End [](#start--end) ``` assets: yourPackage: order: [start|end] ``` #### Before / After [](#before--after) ``` assets: yourPackage: order: [before|after]: anotherPackageName ``` or ``` assets: yourPackage: order: type: [before|after] position: anotherPackageName ``` ### Disabling [](#disabling) ``` assets: yourPackage: [disable|disabled]: true ``` Debug ----- [](#debug) By default Asset Loader operates in production mode, you can override this with following: ``` assets: config: debug: true ``` When debug mode is one, Asset Loader watch files for changes and deploy them automatically. It also works if you add new files into your packages. Other ----- [](#other) ### Custom asset folder [](#custom-asset-folder) ``` assets: config: assetsDir: customDirectoryName ``` ### Directory permissions [](#directory-permissions) ``` assets: config: dirPerm: 0511 ``` ### Health Score 50 — FairBetter than 96% of packages Maintenance86 Actively maintained with recent releases Popularity18 Limited adoption so far Community14 Small or concentrated contributor base Maturity70 Established project with proven stability Bus Factor1 Top contributor holds 55% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~731 days Total 5 Last Release 70d ago PHP version history (2 changes)v0.5.0PHP >= 5.6 v0.7.0PHP >= 8.2 ### Community Maintainers ![](https://www.gravatar.com/avatar/07e65576bd5b3c50b761ed2e78b8ffec8daeadb908a43a56470b07dbf9685837?d=identicon)[sparkcz](/maintainers/sparkcz) --- Top Contributors [![GEp1c](https://avatars.githubusercontent.com/u/16386245?v=4)](https://github.com/GEp1c "GEp1c (11 commits)")[![sparkcz](https://avatars.githubusercontent.com/u/4996607?v=4)](https://github.com/sparkcz "sparkcz (9 commits)") --- Tags assetsfluid-cmsnetteassetsgrape-fluidfluid-cms ### Embed Badge ![Health badge](/badges/grape-fluid-asset-loader/health.svg) ``` [![Health](https://phpackages.com/badges/grape-fluid-asset-loader/health.svg)](https://phpackages.com/packages/grape-fluid-asset-loader) ``` ### Alternatives [kriswallsmith/assetic Asset Management for PHP 3.7k48.9M161](/packages/kriswallsmith-assetic)[markstory/asset_compress An asset compression plugin for CakePHP. Provides file concatenation and a flexible filter system for preprocessing and minification. 3761.0M11](/packages/markstory-asset-compress)[stolz/assets An ultra-simple-to-use assets management library 296519.2k8](/packages/stolz-assets)[backpack/basset Dead-simple way to load CSS or JS assets only once per page, when using Laravel 10+. 202832.4k6](/packages/backpack-basset)[assetic/framework Asset Management for PHP 1001.4M20](/packages/assetic-framework)[markstory/mini-asset An asset compression library. Provides file concatenation and a flexible filter system for preprocessing and minification. 66741.1k3](/packages/markstory-mini-asset) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)