stefanobalocco / neartal
PHP HTML5 template engine losely based on TAL specification
Requires
- php: >=5.2.0
This package is auto-updated.
Last update: 2024-05-11 02:15:35 UTC
README
A php template engine based on TAL, an attribute-based template engine. This version is a fork from my previous project "SmallTAL", and utilize data- attributes to allow the templates to be html5 complaint.
There is at least two other php tal implementation (PHPTAL, for example), but this implementation was written thinking about size and speed; tal templates are converted into php code (without the inner data), allowing to reuse them without the need of future conversion. Each time a template is requested, if the template/metal file/neartal source was modified after the template compilation, the library recompile the template into php code. The template engine uses a personal fork of the ganon html5 parser (http://code.google.com/p/ganon/ http://github.com/StefanoBalocco/ganon).
It's licensed under a BSD-like license.
Using
To use NearTAL you need to do:
-
Create a temp directory, a cache directory and a template directory
-
Template directory should have this structure: | Templates +-- TemplateName.metal.html < macros for the template +--| TemplateName +-- PageName.html
-
Use the library in your project, for example:
include( 'NearTAL.php' ); $data_required_by_the_template = array ( 'variabile' => 'a value', 'arrayVariable' => array ( 'some data', 'some other data' ) ); $nearTALpaths = array ( 'temp' => '/path/to/temp/directory', 'template' => '/path/to/the/template/directory', 'cache' => '/path/where/cache/file/will/be/stored' );
$returnValue = NearTAL( "TemplateName", "PageName", $data_required_by_the_template, $nearTALpaths );
If you want to obtain the template in a variable, you should use ob_start()/ob_get_clean().
You can look the NearTAL.Tests.php (it's a PHPUnit test case) file and/or the tests folder.
Unsupported TAL/TALES features
This is a minimal TAL template engine, optional features isn't supported. Also on-error isn't supported.
Usefull links
TAL specification: http://wiki.zope.org/ZPT/TALSpecification14 TALES specification: http://wiki.zope.org/ZPT/TALESSpecification13 METAL specification: http://wiki.zope.org/ZPT/METALSpecification10 Owlfish TAL, TALES and METAL reference: http://www.owlfish.com/software/simpleTAL/tal-guide.html