trikoder/assets-manifest-bundle

Symfony bundle for generating asset urls for our new frontend static asset builing tool

Manifest Asset Bundle

This bundle provides Twig helper for generating urls for static public assets., _(*1)

It reads information from simple JSON config file. There is an example file in manifest.json, _(*2)

Usage

Bundle provides two Twig functions - manifestAsset and manifestAssetInline., _(*3)

mainfestAsset takes 2 parameters:, _(*4)

• asset url in format @BundleName:path/to/asset or namespaced path @BundleName/path/to/asset
• optional array with options
  • for now only option is: "absolute" => if true function returns absolute URIs

Example usage:, _(*5)

<link href="{{ manifestAsset('@AppBundle:css/bundles/home.css') }}" rel="stylesheet" type="text/css">

manifestAssetInline takes 1 parameter:, _(*6)

• asset url in format @BundleName:path/to/asset or namespaced path @BundleName/path/to/asset

It returns the file content of the asset., _(*7)

Example usage:, _(*8)

<style>{{ manifestAssetInline('@AppBundle:css/bundles/home.css') }}</style>

Using custom Twig namespaces

First, you need to register your Twig namespace:, _(*9)

twig:
    paths:
        '%kernel.project_dir%/src/App/Resources': SomeTwigNamepace

Then, you can use :, _(*10)

<style>{{ manifestAsset('@SomeTwigNamepace/css/home.css') }}</style>
<style>{{ manifestAssetInline('@SomeTwigNamepace/js/home.js') }}</style>

Note: Twig namespace references does not contain separator : like bundles. See this link for more details., _(*11)

Running tests and linter

For running tests and linter, there is a complete docker enviroment with php and all required tools. To setup environment use:, _(*12)

bin/dev/docker-compose build
bin/dev/composer install

To run tests (after environment is built):, _(*13)

bin/dev/composer test

To run linter:, _(*14)

bin/dev/phpcsfixer fix --dry-run .

To automaticaly fix coding standards, just ommit --dry-run parameter., _(*15)

Credits

Copyright (C) 2017 Trikoder, _(*16)

Authors: Alen Pokos, Damir Brekalo, Krešo Kunjas., _(*17)

Contributors: Branimir Đurek, _(*18)

License

Package is licensed under MIT License, _(*19)