kappa/assets-publisher

Basic macros for better works with src and href attribute

dev-master 2015-03-01 15:09 UTC

Requires

• latte/latte: ~2.2@dev
• nette/di: ~2.2@dev
• nette/utils: ~2.2@dev

Requires (Dev)

• mockery/mockery: ~0.9@dev
• nette/nette: ~2.2@dev
• nette/tester: ~1.0@dev
• tracy/tracy: ~2.2@dev

BSD-3-Clause

• Ondřej Záruba

• assets
• nette
• publisher
• macros

README

Basic macros for better works with src and href attribute

Requirements

• PHP 5.4 or higher
• nette/latte
• nette/di
• nette/utils

Installation:

The best way to install Kappa\AssetsPublisher is using Composer

$ composer require kappa/assets-publisher:@dev

And register macro Kappa\AssetsPublisher\Macros\SourceMacro. For example

nette:
	latte:
		macros:
			- Kappa\AssetsPublisher\Macros\SourceMacro

Configuration

documentRoot: %wwwDir%
assetsDir: assets

• documentRoot - You can set document root for all assets. Default value is %wwwDir% form parameters
• assetsDir - you can set name of assets dir. Default value is assets.

For example

documentRoo: /super/web/www
assetsDir: public/assets

Real path to assets will be /super/web/www/public/assets and all assets in template will have path /public/assets because /super/web/www/ is document root and will be ignored.

Usages

Now in template you can link files placed outside of public directory

<img n:source="/not/public/directory/image.png"> {* this create <img src="/assets/fa465asd12sadad.png"> *}
<link n:source="/not/public/directory/style.css"> {* this create <link href="/assets/fa465asd12sadad.css"> *}

Note: Macro automatically decide when to use src or href attribute. For more information please see attributes section or this implementation