inteve/latte

Extensions for Latte templates

v1.0.0 2023-12-08 07:20 UTC

Requires

• php: 7.4 - 8.2
• latte/latte: ^2.9
• nette/di: ^2.4.16
• nette/utils: ^2.5.5 || ^3.0 || ^4.0
• phig/phig: ^1.2

Requires (Dev)

• nette/tester: ^2.4

Conflicts

• nette/php-generator: <3.0

BSD-3-Clause

• Jan Pecha

README

Extensions for Latte templates

Installation

Download a latest package or use Composer:

composer require inteve/latte

Inteve\Latte requires PHP 7.4.0 or later and Latte 2.

Usage

Installation of extensions

\Inteve\Latte\ExtensionInstaller::install($latte, [
	new FooExtension,
	new BarExtension,
]);

or via Nette DI extension:

extensions:
	inteve.latte: Inteve\Latte\DIExtension

services:
	- FooExtension
	- BarExtension

IconExtension

Creates new Latte tag {icon foo}. Saves icon code directly to compiled template. Requires implementation PHIG's HtmlIcons interface.

\Inteve\Latte\ExtensionInstaller::install($latte, [
	new \Inteve\Latte\IconExtension($phigIcons),
]);

{icon myIcon}

TypographyExtension

Creates new Latte filter |typography.

\Inteve\Latte\ExtensionInstaller::install($latte, [
	new \Inteve\Latte\TypographyExtension,
]);

{='My a text'|typography} {* prints 'My a text' *}

Custom extension

Just extends Inteve\Latte\Extension:

class MyExtension extends \Inteve\Latte\Extension
{
	/**
	 * @return array<callable(\Latte\Compiler):void>
	 */
	public function getTags(): array
	{
		return [
			function (\Latte\Compiler $compiler) {
				$me = new Latte\Macros\MacroSet($compiler);
				$me->addMacro('myTag', ['MyLatteMacros', 'macroMyTag']);
			},
		];
	}


	/**
	 * @return array<string, callable>
	 */
	public function getFilters(): array
	{
		return [
			'myFilter' => function ($value) {
				return $value,
			},
		];
	}


	/**
	 * @return array<string, mixed>
	 */
	public function getProviders(): array
	{
		return [
			'myProvider' => 'foo bar',
		];
	}
}

License: New BSD License
Author: Jan Pecha, https://www.janpecha.cz/