ikkez/f3-template-directives

Collection of template directives for PHP Fat-Free Framework

Template directives

Collection of different template directives for the PHP Fat-Free Framework., _(*1)

This package gives you a base to write your own template tag handler (directive) easily. Therefore extend the \Template\TagHandler class and implement its build method. You can also have a look at the included, ready-to-use directives:, _(*2)

form

A collection of additional form-related HTML tag handlers for server side data handling to form / input / select / textarea elements., _(*3)

Init:, _(*4)

\Template\Tags\Form::initAll();

This automatically registers the following directives: input, select, option, textarea, form., _(*5)

Any data you set to the global POST variable is filled into the registered form elements accordingly. If you want to use a different hive key, you can do it like this:, _(*6)

// change source key
$f3->copy('POST','form1');
\Template\Tags\Form::instance()->setSrcKey('form1');

You can also fill the form fields dynamically based on the form name attribute:, _(*7)

<form name="contact">

The field target is then set to FORM.contact:, _(*8)

$f3->copy('POST','FORM.contact');
\Template\Tags\Form::instance()->setDynamicSrcKey(true);

For more tests, see: http://f3.ikkez.de/formtest, _(*9)

markdown

Convert inline markdown text or render a file., _(*10)

<markdown>
# Headline

You can write **markdown** here
</markdown>

or, _(*11)

<markdown src="path/to/file.md" />

Init:, _(*12)

\Template\Tags\Markdown::init('markdown');

image

Render image thumbnails automatically., _(*13)

Init:, _(*14)

\Template\Tags\Image::init('image' [, $tmpl [, $options ] ] );

Options:, _(*15)

• temp_dir, public accessable path for generated, temporary thumbnail images
• file_type, default file type for dumped images, png, jpeg, gif or wbmp
• default_quality, image quality, 0-100
• not_found_fallback, fallback path for missing images
• not_found_callback, define a callable function here that is executed when the image path was not found. The function receives the $filePath as first parameter.

Usage:, _(*16)

<image src="path/to/image.jpg" width="200" />

Additional attributes:, _(*17)

• width, target image width
• height, maximum image height
• crop, allow image to be cropped into width/height ratio
• enlarge, size up image when source image is smaller than target size
• quality, overwrite default quality

Licence

GPLv3, _(*18)