fenom/README.md

Fenom - Template Engine for PHP
===============================

> Composer package: `{"fenom/fenom": "2.*"}`. See on [Packagist.org](https://packagist.org/packages/fenom/fenom)

[![Latest Stable Version](https://poser.pugx.org/fenom/fenom/v/stable.png)](https://packagist.org/packages/fenom/fenom)
[![Build Status](https://travis-ci.org/bzick/fenom.png?branch=master)](https://travis-ci.org/bzick/fenom)
[![Coverage Status](https://coveralls.io/repos/bzick/fenom/badge.png?branch=master)](https://coveralls.io/r/bzick/fenom?branch=master)
[![Total Downloads](https://poser.pugx.org/fenom/fenom/downloads.png)](https://packagist.org/packages/fenom/fenom)
## [Usage](./docs/usage.md) :: [Documentation](./docs/readme.md) :: [Benchmark](./docs/benchmark.md) :: [Articles](./docs/articles.md)

* Simple [syntax](./docs/syntax.md)
* [Fast](./docs/benchmark.md)
* [Secure](./docs/settings.md)
* [Flexible](./docs/ext/extensions.md)
* [Lightweight](./docs/benchmark.md#stats)
* [Powerful](./docs/readme.md)
* Easy to use:

Simple template

```smarty
<html>
    <head>
        <title>Fenom</title>
    </head>
    <body>
    {if $templaters.fenom?}
        {var $tpl = $templaters.fenom}
        <div>Name: {$tpl.name}</div>
        <div>Description: {$tpl.name|truncate:80}</div>
        <ul>
        {foreach $tpl.features as $feature}
            <li>{$feature.name} (from {$feature.timestamp|gmdate:"Y-m-d H:i:s"})</li>
        {/foreach}
        </ul>
    {/if}
    </body>
</html>
```

Display template

```php
<?php
$fenom = Fenom::factory('./templates', './compiled', Fenom::AUTO_RELOAD);
$fenom->display("pages/about.tpl", $data);
```

Get content

```php
<?php
$fenom = Fenom::factory('./templates', './compiled', Fenom::AUTO_RELOAD);
$content = $fenom->fetch("pages/about.tpl", $data);
```

Runtime compilation

```php
<?php
$fenom = new Fenom();
$template = $fenom->compileCode('Hello {$user.name}! {if $user.email?} Your email: {$user.email} {/if}');
$template->display($data);
// or
$content = $template->fetch($data);
```
Add checking nested level for {use} and {extends} Add more docs 2013-07-02 11:07:33 +04:00			`Fenom - Template Engine for PHP`
			`===============================`
Port docs 2013-01-28 12:04:07 +04:00
Dev flags 2014-04-09 18:03:49 +04:00			> Composer package: `{"fenom/fenom": "2.*"}`. See on [Packagist.org](https://packagist.org/packages/fenom/fenom)
Add docs. Create compile dir for tests 2013-02-07 20:04:00 +04:00
Update README.md 2013-09-12 18:59:54 +04:00			`[![Latest Stable Version](https://poser.pugx.org/fenom/fenom/v/stable.png)](https://packagist.org/packages/fenom/fenom)`
Update README.md 2013-09-12 20:13:34 +04:00			`[![Build Status](https://travis-ci.org/bzick/fenom.png?branch=master)](https://travis-ci.org/bzick/fenom)`
			`[![Coverage Status](https://coveralls.io/repos/bzick/fenom/badge.png?branch=master)](https://coveralls.io/r/bzick/fenom?branch=master)`
Update README.md 2013-09-20 10:07:30 +04:00			`[![Total Downloads](https://poser.pugx.org/fenom/fenom/downloads.png)](https://packagist.org/packages/fenom/fenom)`
Update docs 2013-07-07 01:34:37 +04:00			`## [Usage](./docs/usage.md) :: [Documentation](./docs/readme.md) :: [Benchmark](./docs/benchmark.md) :: [Articles](./docs/articles.md)`
Dev, dev and dev. Also, docs, docs and docs. 2013-02-07 17:37:16 +04:00
Add checking nested level for {use} and {extends} Add more docs 2013-07-02 11:07:33 +04:00			`* Simple [syntax](./docs/syntax.md)`
Improve compile method 2013-02-26 23:56:06 +04:00			`* [Fast](./docs/benchmark.md)`
			`* [Secure](./docs/settings.md)`
Add recursive macros support (#28) 2013-07-29 14:53:21 +04:00			`* [Flexible](./docs/ext/extensions.md)`
Optimize extends 2013-06-08 00:08:00 +04:00			`* [Lightweight](./docs/benchmark.md#stats)`
Fix link 2013-08-05 19:26:06 +04:00			`* [Powerful](./docs/readme.md)`
Update main 2013-02-27 20:55:47 +04:00			`* Easy to use:`
Update main 2013-02-24 14:09:28 +04:00
Update readme 2013-02-28 22:29:51 +04:00			`Simple template`
Port docs 2013-01-28 12:04:07 +04:00
Upd docs 2013-02-01 19:13:07 +04:00			```smarty
			`<html>`
			`<head>`
Rename Cytro to Fenom 2013-06-28 11:53:53 +04:00			`<title>Fenom</title>`
Upd docs 2013-02-01 19:13:07 +04:00			`</head>`
			`<body>`
Rename Cytro to Fenom 2013-06-28 11:53:53 +04:00			`{if $templaters.fenom?}`
			`{var $tpl = $templaters.fenom}`
Dev, dev and dev. Also, docs, docs and docs. 2013-02-07 17:37:16 +04:00			`<div>Name: {$tpl.name}</div>`
			`<div>Description: {$tpl.name\|truncate:80}</div>`
Upd docs 2013-02-01 19:13:07 +04:00			`<ul>`
Dev, dev and dev. Also, docs, docs and docs. 2013-02-07 17:37:16 +04:00			`{foreach $tpl.features as $feature}`
			`<li>{$feature.name} (from {$feature.timestamp\|gmdate:"Y-m-d H:i:s"})</li>`
Upd docs 2013-02-01 19:13:07 +04:00			`{/foreach}`
			`</ul>`
			`{/if}`
			`</body>`
			`</html>`
			```
Port docs 2013-01-28 12:04:07 +04:00
Upd docs 2013-02-01 19:13:07 +04:00			`Display template`
Port docs 2013-01-28 12:04:07 +04:00
			```php
Upd docs 2013-02-01 19:14:15 +04:00			`<?php`
Rename Cytro to Fenom 2013-06-28 11:53:53 +04:00			`$fenom = Fenom::factory('./templates', './compiled', Fenom::AUTO_RELOAD);`
			`$fenom->display("pages/about.tpl", $data);`
Port docs 2013-01-28 12:04:07 +04:00			```

Dev, dev and dev. Also, docs, docs and docs. 2013-02-07 17:37:16 +04:00			`Get content`
Port docs 2013-01-28 12:04:07 +04:00
			```php
Upd docs 2013-02-01 19:14:15 +04:00			`<?php`
Rename Cytro to Fenom 2013-06-28 11:53:53 +04:00			`$fenom = Fenom::factory('./templates', './compiled', Fenom::AUTO_RELOAD);`
			`$content = $fenom->fetch("pages/about.tpl", $data);`
Port docs 2013-01-28 12:04:07 +04:00			```

Upd docs 2013-02-01 19:13:07 +04:00			`Runtime compilation`
Port docs 2013-01-28 12:04:07 +04:00
			```php
Upd docs 2013-02-01 19:14:15 +04:00			`<?php`
Rename Cytro to Fenom 2013-06-28 11:53:53 +04:00			`$fenom = new Fenom();`
			`$template = $fenom->compileCode('Hello {$user.name}! {if $user.email?} Your email: {$user.email} {/if}');`
			`$template->display($data);`
Dev, dev and dev. Also, docs, docs and docs. 2013-02-07 17:37:16 +04:00			`// or`
Rename Cytro to Fenom 2013-06-28 11:53:53 +04:00			`$content = $template->fetch($data);`
Port docs 2013-01-28 12:04:07 +04:00			```