https://github.com/botble/laravel-assets
Assets management for Laravel application
https://github.com/botble/laravel-assets
assets-management botble botblecms laravel laravel-5-package
Last synced: about 1 year ago
JSON representation
Assets management for Laravel application
- Host: GitHub
- URL: https://github.com/botble/laravel-assets
- Owner: botble
- License: mit
- Created: 2018-10-23T02:36:23.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2025-02-26T03:22:23.000Z (over 1 year ago)
- Last Synced: 2025-03-30T05:03:29.623Z (over 1 year ago)
- Topics: assets-management, botble, botblecms, laravel, laravel-5-package
- Language: PHP
- Homepage: https://botble.com
- Size: 76.2 KB
- Stars: 46
- Watchers: 3
- Forks: 22
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Laravel Assets management
[](https://github.com/botble/laravel-assets/releases)
[](LICENSE.md)
[](https://scrutinizer-ci.com/g/botble/laravel-assets)
[](https://styleci.io/repos/154250020)
[](https://packagist.org/packages/botble/assets)
[](https://codeclimate.com/github/botble/laravel-assets/maintainability)
## Installation
```bash
composer require botble/assets
```
For version <= 5.4:
Add to section `providers` of `config/app.php`:
```php
// config/app.php
'providers' => [
...
Botble\Assets\Providers\AssetsServiceProvider::class,
];
```
And add to `aliases` section:
```php
// config/app.php
'aliases' => [
...
'Assets' => Botble\Assets\Facades\AssetsFacade::class,
];
```
All assets resource will be manage in config file so we need to publish config to use.
```bash
php artisan vendor:publish --provider="Botble\Assets\Providers\AssetsServiceProvider" --tag=config
```
Add to your master layout view, in `head` tag:
```php
{!! \Assets::renderHeader() !!}
```
and before `body` tag close:
```php
{!! \Assets::renderFooter() !!}
```
## Methods
### Add scripts
```php
\Assets::addScripts(['key-of-assets-in-config-file']);
```
Example:
```php
\Assets::addScripts(['app', 'bootstrap', 'jquery']);
```
### Add styles
```php
\Assets::addStyles(['key-of-assets-in-config-file']);
```
Example:
```php
\Assets::addStyles(['bootstrap', 'font-awesome']);
```
### Remove scripts
```php
\Assets::removeScripts(['key-of-assets-in-config-file']);
```
Example:
```php
\Assets::removeScripts(['bootstrap']);
```
### Remove styles
```php
\Assets::removeStyles(['key-of-assets-in-config-file']);
```
Example:
```php
\Assets::removeStyles(['font-awesome']);
```
### Others
- Set version for assets. Add to `.env`
```bash
ASSETS_VERSION=1.0
```
Then all assets will be added `?v=1.0`
- Change to online mode
```bash
ASSETS_OFFLINE=false
```
Then assets will be loaded from CDN if it's defined in config file.
- To disable versioning:
```bash
ASSETS_ENABLE_VERSION=false
```
## Contributors
- [Sang Nguyen](https://github.com/sangnguyenplus)
- [Dinh Quoc Han](https://github.com/dinhquochan)
## License
[MIT](LICENSE) © Sang Nguyen