Overview
The Templating plugin for CakePHP makes working with HTML and view helpers more convenient and ships a powerful, unified way to render (font) icons from a range of popular libraries.
It helps you to:
- make working with HTML and helpers more convenient,
- provide (font) icons from various libraries out of the box,
- and, together with the IdeHelper plugin, get auto-complete on those icons.
The current branch targets CakePHP 5. Composer declares the supported PHP and framework ranges.
Supported icon sets
You can use one or many of the following icon sets out of the box:
- Bootstrap
- FontAwesome v4/v5/v6/v7
- Material
- Feather
- Lucide, a modern Feather fork with 1000+ icons
- Heroicons, by the Tailwind CSS team
You can also add your own custom icon set.
The pieces
| Concept | Responsibility |
|---|---|
| Icon helper | Renders icons from any configured set, in font or SVG mode. |
| IconSnippet helper | Convenience wrappers for common icon snippets (yes/no, thumbs, neighbors). |
| Templating helper | Colored status output (ok(), warning(), yesNo()). |
| Html helper | Enhanced HtmlHelper with automatic HtmlStringable support. |
| Form helper | Enhanced FormHelper with automatic HtmlStringable support. |
HtmlStringable | A marker contract for value objects that carry already-safe HTML. |
Next steps
- Installation, install and register the plugin.
- Getting started, render your first SVG.
- HtmlStringable, the core concept behind the helpers.
- Icon helper, render icons from any configured set.
Demo
A live demo of the helpers is available at sandbox.dereuromark.de/sandbox/templating-examples.