ATMF-PHP

PHP support for ATMF (Advanced-Template-Markup-Format)

More about ATMF

Full specificaiton of the format is available here

Setup

Copy the atmf folder in your project and then simply include the engine.php file.

<?php
require_once(__DIR__.'/atmf/engine.php');
$atmf = new \ATMF\Engine();
// ...
$atmf->Rend();

Usage Back-End

Global selector __()

<?php

// Assign some templates
__('#template master', file_get_contents('./templates/master.html'));
__('#template page', file_get_contents('./templates/template.html'));

// Assign variables
__('$fullname', 'Advanced-Template-Markup-Format');
__('$shortname', 'ATMF');
__('$pagetitle', '{$fullname " (" $shortname ")"}');
__('$slogan', 'Cultural made easy!');
__('$userData', __escape('{$crossScripting}'));

Native

<?php

$atmf->vars['slogan'] = 'Cultural made easy!';
$atmf->SetTemplate('header', file_get_contents('./templates/header.html'));

Read variables and translations

__('$fullname'); //Output: Advanced Template Markup Format
__('$pagetitle'); //Output: $fullname ($shortname)
__('@page.theFox 12 red'); //Output: The red fox made 12 steps

Configuration Options

$atmf->SetCultureFolder(__DIR__.'/culture'); //Default: culture
$atmf->SetCulture('bg-BG'); // Default: en-US
$atmf->SetTemplateDiscoveryPath(__DIR__.'/templates'); // Default: No auto discovery
$atmf->allowGlobals = true; // Default: FALSE. Be careful with that if set it to TRUE!

Usage Front-End (templates)

Variables

<h1>{$pageTitle}</h1>

Language resources

<h1>{@page.title}</h1>
<h1>{@page.theFox 10 red}</h1>

Functions - #each #if #else #end

<table style="min-width:500px" cellspacing="10">
    <tr style="font-weight:bold">
        <td>Author Name</td>
        <td>Books</td>
        <td>Sold Out</td>
    </tr>
    {#each $authors as $author}
        <tr>
            <td>
                {$author.firstName " " $author.lastName}
            </td>
            <td>
                <ul>
                {#each $author.books as $book}
                    <li>{$book}</li>
                {#end}
                </ul>
            </td>
            <td>
                {#if $author.soldOut}
                    <span style="color:red">Sold out</span>
                {#else}
                    <span style="color:green">In stock</span>
                {#end}
            </td>
        </tr>
    {#end}
</table>

Extensions

<h1>Today date is {/date "M d, Y"}</h1>

Escaping with backslash

<h1>\{@page.title}</h1>

Full demo available at index.php and the templates folder

Custom Extensions

You can make your own custom extensions by exending the \ATMF\Extension interface.

<?php
class MyCustomExtension implements \ATMF\Extension
{
    public $str = "My custom extension";
    public function __construct() {}
    
    public function Get($args) 
    {
        return $this->str;
    }
    
    public function Set($args, $value) 
    {
        $this->str = $value;
    }
}
\ATMF\Extensions::Register('mycustom', new MyCustomExtension());

The template:

<div>
    <span>{/mycustom}</span> <!-- OUTPUT: My custom extension -->
</div>

The backend:

<?php
__('/mycustom') // Returns "My custom extension"
__('/mycustom', 'Another custom value') // Change the value
__('/mycustom') // Returns "Another custom value"

For more advanced example with arguments check the date core extension inside atmf/core/ext/date