https://github.com/tappleby/laravel-asset-manifest

Simple Laravel 4 package for re-mapping assets paths, useful for asset revving using tools such as grunt and/or loading assets from a CDN
https://github.com/tappleby/laravel-asset-manifest

Last synced: about 2 months ago
JSON representation

Simple Laravel 4 package for re-mapping assets paths, useful for asset revving using tools such as grunt and/or loading assets from a CDN

• Host: GitHub
• URL: https://github.com/tappleby/laravel-asset-manifest
• Owner: tappleby
• License: mit
• Created: 2014-04-21T01:55:43.000Z (about 11 years ago)
• Default Branch: master
• Last Pushed: 2014-09-08T18:52:30.000Z (over 10 years ago)
• Last Synced: 2024-12-30T12:45:42.020Z (5 months ago)
• Language: PHP
• Homepage:
• Size: 208 KB
• Stars: 4
• Watchers: 3
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Laravel Asset Manifest

Simple Laravel 4 package for re-mapping assets paths, useful for asset revving using tools such as grunt and/or loading assets from a CDN. Extends Laravel's url generator which means existing `asset()` or `URL::asset` calls will work without changes.

[![Build Status](https://travis-ci.org/tappleby/laravel-asset-manifest.svg?branch=master)](https://travis-ci.org/tappleby/laravel-asset-manifest)

## Installation

Require the `tappleby/laravel-asset-manfiest`in your composer.json

	$ composer require tappleby/laravel-asset-manifest:1.*

	

Add the AssetManifestServiceProvider to your `app/config/app.php`:

	'Tappleby\AssetManifest\AssetManifestServiceProvider',

**Optional**

If you wish to access the asset manifest manually, the facade can be registered:

	'AssetManifest'   => 'Tappleby\AssetManifest\Facades\AssetManifest',

The default config path can be changed by publishing the config:

	$ php artisan config:publish tappleby/laravel-asset-manifest

## Usage

The only requirement of this package is a manifest JSON file located at `app/storage/meta/assets.json`. If a key is found in the JSON file, its value will be used as the new asset path:

	{

		"src": "target",

		"foo.png": "bar.png",

		"baz.png": "//cdn.awesomehost.com/baz.png"

	}

Calling `asset("foo.png")` in your view will return "bar.png". If the target url starts with `http` or `//` this value will be returned without passing through laravels default url generator: `asset("baz.png")` returns `//cdn.awesomehost.com/baz.png`

This package integrates well with grunt + grunt-filerev, using the [grunt-filerev-assets](https://github.com/richardbolt/grunt-filerev-assets) package the asset manfiest can automatically be generated.

## License 

licensed under the MIT License - see the LICENSE file for details