dalpras/smart-template

Smart template engine for key-value substitutions

Maintainers

Details

github.com/dalpras/smart-template

Source

Issues

Installs: 2

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 1

Forks: 0

Open Issues: 0

v1.4.1 2024-04-18 09:03 UTC

Requires

  • php: >=8.2

Requires (Dev)

proprietary ac0fc6bc6994e4c2db770e89fa42c9e328702238

  • Stefano Dal Prà

This package is auto-updated.

Last update: 2024-09-11 13:20:20 UTC

README

Introduction

Stop using template engines with new languages and new tricks to learn!
This is the right place: smart-template have the potential for building an engine based on callbacks that is lightning fast.

This is a full rendering system in a few lines of code.
smart-template library is designed for fast and efficient rendering without the mess of complicated libraries.

There are no dependencies!!

You will only use what you really need.

Features

  • key->value substitutions.
  • Nested templates files in a structered folders to access anything you need.
  • Deep nested rendering.
  • Customized attributes rendering for HTML elements.
  • Callbacks for customized rendering.
  • ...

Installation

As usual, composer make the job for you:

composer require dalpras/smart-template

Examples

Let's take a look to an example ...
Just some lines of code in different files.

/** ./mywebpage.php */
$templateEngine = new TemplateEngine(__DIR__ . '/templates');

echo $templateEngine->render('table.php', function ($render) {
        return $render['table']([
            '{class}' => 'text-right',
            '{cols}' => $render['row'](['{text}' => 'hello datum!'])
        ]);
    });

// or you can begin to nest everything you need

echo $templateEngine->render('table.php', function ($render) {
        return $render['table']([
            '{class}' => 'text-right',
            '{rows}' => function($render) {
                return $render['row'](['{text}' => 'hello nested!']);
            },
        ]);
    });


// or just use another file for rendering

echo $templateEngine->render('toolbar.php', function ($render) {
        return $render['header']([
            '{text}' => 'hello toolbar!'
        ]);
    });

// also you can use many files as you want

echo $templateEngine->render('table.php', function ($render) {
        return $render['table']([
            '{class}' => 'text-right',
            '{rows}' => function($render, TemplateEngine $template) {
                return $template->render('toolbar.php', fn($render) => $render['header']([
                    '{text}' => 'hello different template toolbar'
                ]));
            },
        ]);
    });

// or custom specific functions for rendering

echo $templateEngine->render('table.php', function ($render) {
        return $render['table']([
            '{class}' => 'text-right',
            '{rows}' => $render['myfunc']('hello func!'),
        ]);
    });


// GREAT POWER INVOLVES GREAT RESPONSIBILITY!
/** ./templates/table.php */
return [
    'table' => <<<html
        <div class="table-responsive">
            <table class="table table-sm {class}">
                <tbody>
                    {rows}
                </tbody>
            </table>
        </div>
        html,

    'row' => <<<html
        <tr><td>{text}</tr></td>
        html,
];
/** ./templates/nesteddir/toolbar.php */
return [
    'header' => <<<html
        <div class="toolbar">{text}</div>
        html,
        
    'myfunc' => fn($text) => 'This is your ' . $text
];