Installation

Require the plugin

Install the plugin via Composer:

composer require dereuromark/cakephp-templating

Load the plugin

Load the plugin using the CakePHP plugin shell:

bin/cake plugin load Templating

Or add it manually to your application's src/Application.php:

public function bootstrap(): void
{
    parent::bootstrap();

    $this->addPlugin('Templating');
}

Load the helpers

Add the helpers you want to use in your src/View/AppView.php:

public function initialize(): void
{
    parent::initialize();

    $this->addHelper('Templating.Icon', [
        'sets' => [
            'bs' => \Templating\View\Icon\BootstrapIcon::class,
        ],
    ]);
    $this->addHelper('Templating.IconSnippet');
    $this->addHelper('Templating.Templating');
    $this->addHelper('Templating.Html');
    $this->addHelper('Templating.Form');
}

TIP

You only need to load the helpers you actually use. The Icon helper is the main entry point; the Html and Form helpers add automatic HtmlStringable support to the core helpers.

Install icon libraries

This plugin does not handle asset management or shipping of icon files. Install your preferred icon libraries using any method you like (npm, Composer, CDN, or manual download) and point the configuration at the files. See the Icon helper and Icon configuration pages for the details.

Next steps

• HtmlStringable — make your template code HTML aware.
• Icon helper — render icons from any configured set.