2017 © Pedro Peláez
 

library twig-asset-rev-extension

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use with gulp-rev or grunt-rev

image

m1/twig-asset-rev-extension

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use with gulp-rev or grunt-rev

  • Monday, January 9, 2017
  • by m1
  • Repository
  • 1 Watchers
  • 3 Stars
  • 7,945 Installations
  • PHP
  • 0 Dependents
  • 0 Suggesters
  • 1 Forks
  • 0 Open issues
  • 5 Versions
  • 3 % Grown

The README.md

TwigAssetRevExtension

Author Latest Version on Packagist ![Software License][ico-license] Build Status ![Coverage Status][ico-scrutinizer] Quality Score ![Total Downloads][ico-downloads], (*1)

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use and tested with gulp-rev/gulp-rev-all or grunt-rev, (*2)

Requirements

TwigAssetRevExtension requires PHP version 5.3+., (*3)

Install

Via Composer, (*4)

``` bash $ composer require m1/twig-asset-rev-extension, (*5)


## Usage

`TwigAssetRevExtension` works like other twig extensions, just add the extension using `$twig->addExtension()`. 

``` php
Use \M1\TwigAssetRevExtension\TwigAssetRevExtension;

$assets = json_decode(file_get_contents('rev-manifest.json'), true);
$asset_rev = new TwigAssetRevExtension($assets);
$twig->addExtension($asset_rev);

example.twig:, (*6)

<link href='{{"css/app.css"|asset_rev}}' rel='stylesheet'>

rev-manifest.json:, (*7)

{
  "css/app.css": "css/app.bd6efcb01bc3.css",
  "css/app.min.css": "css/app.min.9f8d3d255c1f.css",
}

Symfony usage

You can register the extension automatically in Symfony via app/config/services.yml., (*8)

``` yml twig.extension.asset_rev: class: M1\TwigAssetRevExtension\TwigAssetRevExtension arguments: [ "%kernel.root_dir%/../web/js/manifest.json", false ] tags: - { name: twig.extension }, (*9)


## Setup

```php
new TwigAssetRevExtension(mixed $assets [, bool $minified = true ] )

Parameters

assets

The path to the JSON file, or the array of assets and rev'd assets, an example:, (*10)

array(
  "css/app.css" => "css/app.bd6efcb01bc3.css",
  "css/app.min.css" => "css/app.min.9f8d3d255c1f.css",
  "js/app.admin.js" => "js/app.admin.96b3cc15df52.js",
  "js/app.admin.min.js" => "js/app.admin.min.dbdc6d8e2114.js",
  "js/app.admin.plugins.js" => "js/app.admin.plugins.927a9b50dd18.js",
  "js/app.admin.plugins.min.js" => "js/app.admin.plugins.min.283a1a903f4a.js",
  "img/image-jpg.jpg" => "img/image-jpg.219a48cfe072.jpg",
  "img/image-png.png" => "img/image-png.1691620d298a.png",
  "img/image-gif.gif" => "img/image-gif.bcd9f17c5cf8.png"
)

If using gulp-rev or gulp-rev-all this is just the contents of rev-manifest.json - parsing the json file with json_decode(file_get_contents('rev-manifest.json'), true);. You should probably cache this result though so you don't have to read the file every request., (*11)

minified

When true this means that TwigAssetRevExtension will pass back minified assets if they're available. Twig debug mode or Silex debug mode override this and it won't pass back minified assets in development., (*12)

Change log

Please see CHANGELOG for more information what has changed recently., (*13)

Testing

bash $ composer test, (*14)

Contributing

Please see CONTRIBUTING and CONDUCT for details., (*15)

Security

If you discover any security related issues, please email hello@milescroxford.com instead of using the issue tracker., (*16)

Credits

License

The MIT License (MIT). Please see License File for more information., (*17)

The Versions

09/01 2017

dev-master

9999999-dev https://github.com/M1/:package_name

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use with gulp-rev or grunt-rev

  Sources   Download

MIT

The Requires

 

The Development Requires

by Miles Croxford

twig css extension filter javascript silex symfony asset js gulp-rev m1 twig-asset-rev-extension twigassetrevextension rev grunt-rev asset_rev

09/01 2017

1.1.1

1.1.1.0 https://github.com/M1/:package_name

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use with gulp-rev or grunt-rev

  Sources   Download

MIT

The Requires

 

The Development Requires

by Miles Croxford

twig css extension filter javascript silex symfony asset js gulp-rev m1 twig-asset-rev-extension twigassetrevextension rev grunt-rev asset_rev

09/01 2017

1.1.0

1.1.0.0 https://github.com/M1/:package_name

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use with gulp-rev or grunt-rev

  Sources   Download

MIT

The Requires

 

The Development Requires

by Miles Croxford

twig css extension filter javascript silex symfony asset js gulp-rev m1 twig-asset-rev-extension twigassetrevextension rev grunt-rev asset_rev

02/08 2016

1.0.0

1.0.0.0 https://github.com/M1/:package_name

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use with gulp-rev or grunt-rev

  Sources   Download

MIT

The Requires

 

The Development Requires

by Miles Croxford

twig css extension filter javascript silex symfony asset js gulp-rev m1 twig-asset-rev-extension twigassetrevextension rev grunt-rev asset_rev

22/01 2016

0.1.0

0.1.0.0 https://github.com/M1/:package_name

Twig Asset Rev Extension adds a asset_rev twig filter so you can use asset revisioning from files, perfect for use with gulp-rev or grunt-rev

  Sources   Download

MIT

The Requires

 

The Development Requires

by Miles Croxford

twig css extension filter javascript silex symfony asset js gulp-rev m1 twig-asset-rev-extension twigassetrevextension rev grunt-rev asset_rev