{"id":19509248,"url":"https://github.com/grape-fluid/asset-loader","last_synced_at":"2026-03-01T15:03:29.638Z","repository":{"id":62512312,"uuid":"111812835","full_name":"grape-fluid/asset-loader","owner":"grape-fluid","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-18T12:08:58.000Z","size":34,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-10-10T14:45:17.352Z","etag":null,"topics":["assets","fluid-cms","nette"],"latest_commit_sha":null,"homepage":null,"language":"PHP","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/grape-fluid.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-11-23T13:30:07.000Z","updated_at":"2025-02-18T10:25:38.000Z","dependencies_parsed_at":"2024-11-10T23:11:35.796Z","dependency_job_id":"fd06a25b-4944-4a57-9b5a-9a5579084647","html_url":"https://github.com/grape-fluid/asset-loader","commit_stats":null,"previous_names":[],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/grape-fluid/asset-loader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grape-fluid%2Fasset-loader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grape-fluid%2Fasset-loader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grape-fluid%2Fasset-loader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grape-fluid%2Fasset-loader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/grape-fluid","download_url":"https://codeload.github.com/grape-fluid/asset-loader/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/grape-fluid%2Fasset-loader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29973161,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-01T14:44:57.896Z","status":"ssl_error","status_checked_at":"2026-03-01T14:43:27.662Z","response_time":124,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["assets","fluid-cms","nette"],"created_at":"2024-11-10T23:11:28.607Z","updated_at":"2026-03-01T15:03:29.599Z","avatar_url":"https://github.com/grape-fluid.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GrapeFluid/AssetLoader \u003cimg align=\"right\" height=\"40px\" src=\"https://developers.grapesc.cz/logo_inline.png\"\u003e\n\n[![PHP from Packagist](https://img.shields.io/packagist/php-v/grape-fluid/asset-loader.svg?style=flat-square)](https://packagist.org/packages/grape-fluid/asset-loader)\n[![Build Status](https://img.shields.io/travis/grape-fluid/asset-loader.svg?style=flat-square)](https://travis-ci.org/grape-fluid/asset-loader)\n[![Code coverage](https://img.shields.io/coveralls/grape-fluid/asset-loader.svg?style=flat-square)](https://coveralls.io/r/grape-fluid/asset-loader)\n[![Licence](https://img.shields.io/packagist/l/grape-fluid/asset-loader.svg?style=flat-square)](https://packagist.org/packages/grape-fluid/asset-loader)\n[![Downloads this Month](https://img.shields.io/packagist/dm/grape-fluid/asset-loader.svg?style=flat-square)](https://packagist.org/packages/grape-fluid/asset-loader)\n[![Downloads total](https://img.shields.io/packagist/dt/grape-fluid/asset-loader.svg?style=flat-square)](https://packagist.org/packages/grape-fluid/asset-loader)\n[![Latest stable](https://img.shields.io/packagist/v/grape-fluid/asset-loader.svg?style=flat-square)](https://packagist.org/packages/grape-fluid/asset-loader)\n\nAsset Loader for your Nette projects\n\n## Dependencies\n\n| Require           | Version      |\n|-------------------|--------------|\n| PHP               | `\u003e= 5.6`     |\n| nette/application | `^2.4`       |\n| nette/di          | `^2.4`       |\n\n| Require-dev       | Version      |\n|-------------------|--------------|\n| nette/tester      | `^2.0`       |\n| tracy/tracy       | `^2.4`       |\n\n## Quickstart\n\n1. Install **Asset Loader** with composer\n\n\t```\n\tcomposer require grape-fluid/asset-loader\n\t```\n\n2. Register **extension** (in neon)\n\n\t```\n\textensions:\n\t\tassets: Grapesc\\GrapeFluid\\AssetLoaderExtension\n\t```\n\t\n3. Set your **public directory** (mostly www) (in neon)\n\n\t```\n\tassets:\n\t\tconfig:\n\t\t\twwwDir: %appDir%/../www\n\t```\n\t\n4. Set-up your first package (see all options / features below)\n\n\t```\n\tassets:\n\t\tyourPackage:\n\t\t\tjs:\n\t\t\t\t# will create file in wwwDir/assets/yourPackage/js/main.js\n\t\t\t\t- %appDir%/modules/WebsiteModule/assets/js/main.js\n\t\t\tcss:\n\t\t\t\t# will create file in wwwDir/assets/yourPackage/css/styles.css\n\t\t\t\t- %appDir%/modules/StyleModule/assets/css/style.css\n\t\t\t\t# you can also use external / remote assets\n\t\t\t\t- 'https://cdnjs.cloudflare.com/ajax/libs/twitter-bootstrap/4.1.1/css/bootstrap.min.css'\n\t\t\tcopy:\n\t\t\t\t# will copy all images from folder into wwwDir/assets/yourPackage/copy/\n\t\t\t\t- %appDir%/modules/StyleModule/assets/images/*\n\t```\n\t\n5. Inject *AssetsControl* and create component in your **BasePresenter**\n\n\t``` \n    /** @var \\Grapesc\\GrapeFluid\\AssetsControl\\AssetsControl @inject */\n    public $assets;\n    \n    \n    protected function createComponentAssets()\n    {\n    \treturn $this-\u003eassets;\n    }\n\t```\n\t\n6. Render your assets in **template**\n\n\t``` \n    {control assets:css}\n    {control assets:js}\n\t```\n\t\n## Multiple files\n\nIf you have too many files (for ex. scripts) that you want to include in your templates, \nor just want to copy whole directory (for ex. with images),\nyou can use asterisk `*` character.\n\n```\nassets:\n\tyourPackage:\n\t\tjs:\n\t\t\t- %appDir%/modules/WebsiteModule/assets/js/scripts/*\n```\n\n## Custom destination\n\nIf you need, for any reason, copy file into public directory with custom name or custom directory,\njust specify asset as array. You can use `\u0026` character that will be replaced with public assets directory folder.\n\n```\nassets:\n\tyourPackage:\n\t\tjs:\n\t\t\t# [ source, destination ]\n\t\t\t- [ %appDir%/modules/WebsiteModule/assets/js/main.js, \u0026/my/folder/test.js ]\n```\n\t\nYou can also do the same with whole **directories**:\n\n```\nassets:\n\tyourPackage:\n\t\tjs:\n\t\t\t# [ source, destination ]\n\t\t\t- [ %appDir%/modules/StyleModule/assets/images/*, \u0026/images/ ]\n```\n\t\n## Options\n\nOf course, quickstart doesn't do anything special but copy files and use them in your template files.\nBut it's getting more interesting with these options.\n\n### Limits\n\nYou can limit **assets** by Nette-like links.\nBy default all defined assets are enabled everywhere.\n**You can combine multiple limits.** By using limits Asset Loader will load only assets that matches your limit.\nYou can easily create assets for backend / frontend, but also for sub-frontend modules, etc.\n\n#### How to limit asset for **module**?\n\n```\nassets:\n\tyourPackage:\n\t\tlimit:\n\t\t\t- \":Module:.*\"\n```\n\n#### How to limit asset for multiple **presenters**?\n\n```\nassets:\n\tyourPackage:\n\t\tlimit:\n\t\t\t- \":Module:Presenter:.*\"\n\t\t\t- \":Module:AnotherPresenter:.*\"\n```\n\n#### Limiting by access rights ($user-\u003eisAllowed())\n```\nassets:\n\tyourPackage:\n\t\t# Will call $user-\u003eisAllowed('homepage')\n\t\t- ['link' = ':Module:Presenter.*', 'auth' = 'homepage']\n```\n\n#### Limiting by custom options\n\nCreate and define custom service that implements `\\Grapesc\\GrapeFluid\\Options\\IAssetOptions` interface as written below.\n**We are automatically registering these as services** sou you don't have to.\n**Inject through constructor** in these services also works.\nNow you are able to handle limits in any way you want.\nFor example enable / disable assets from your back-office.\n\n```\nassets:\n\tconfig:\n\t\toptions:\n\t\t\t# Must implement \\Grapesc\\GrapeFluid\\Options\\IAssetOptions\n\t\t\t- \\Your\\Class\\That\\Handles\\SomeOptions\n\t\t\t- \\Your\\Class\\That\\Handles\\AnotherOptions\n\tyourPackage:\n\t\t# Will call $class-\u003egetOption('inline.enabled') on every service\n\t\t- ['link' = ':Module:Presenter.*', 'option' = 'inline.enabled']\n```\n\n#### Using negation limit\n\nUse `!` in front of limit\n\n```\nassets:\n\tyourPackage:\n\t\tlimit:\n\t\t\t- \"!:Module:Presenter:.*\"\n```\n\n### Ordering\n\nSometimes, especially when using modules, it comes handy to sort / order your packages.\n\n#### Start / End\n\n```\nassets:\n\tyourPackage:\n\t\torder: [start|end]\n```\n\n#### Before / After\n\n```\nassets:\n\tyourPackage:\n\t\torder:\n\t\t\t[before|after]: anotherPackageName\n```\n\nor\n\n```\nassets:\n\tyourPackage:\n\t\torder:\n\t\t\ttype: [before|after]\n\t\t\tposition: anotherPackageName\n```\n\n### Disabling\n\n```\nassets:\n\tyourPackage:\n\t\t[disable|disabled]: true\n```\n\n\n## Debug\n\nBy default Asset Loader operates in production mode, you can override this with following:\n\n```\nassets:\n\tconfig:\n\t\tdebug: true\n```\n\nWhen debug mode is one, Asset Loader watch files for changes and deploy them automatically.\nIt also works if you add new files into your packages.\n\n## Other\n\n### Custom asset folder\n\n```\nassets:\n\tconfig:\n\t\tassetsDir: customDirectoryName\n```\n\n### Directory permissions\n\n```\nassets:\n\tconfig:\n\t\tdirPerm: 0511\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrape-fluid%2Fasset-loader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgrape-fluid%2Fasset-loader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgrape-fluid%2Fasset-loader/lists"}