A real Readme

2018-03-21 07:44:08 +01:00 · 2018-03-21 07:44:08 +01:00 · b1f7b7aeba
commit b1f7b7aeba
parent a121d1974d
1 changed files with 84 additions and 5 deletions
--- a/README.md
+++ b/README.md
@ -1,13 +1,92 @@
 # tplBlock

+A very simple PHP template class
+
 [![Build Status](https://travis-ci.org/gnieark/tplBlock.svg?branch=master)](https://travis-ci.org/gnieark/tplBlock)

-It's a work in progress repo. Class is not usable for now.
+# Sample

-I don't want to use templating class containing deprecated functions.
+This simple template file:

-I don't want to use one which is a gaz factory.
+```html
+<html>
+<body>
+    <h1>{{pageTilte}}</h1>
+    <ul>
+    <!-- BEGIN templatesystem -->
+        <li><a href="{{templatesystem.url}}"> {{templatesystem.name}}</a>
+         by {{templatesystem.author}} is {{templatesystem.quality}}</li> 
+    <!-- END templatesystem -->
+    </ul>

-So, I invent the wheel again, and i make mine.
+</body>
+</html>
+```

-Se the path test-TplBlock to have a sample.
+Parsed with this code
+
+```php
+<?php
+require_once ("path/class.TplBlock.php");
+
+//init object
+$tpl = new TplBlock();
+//add a var
+$tpl->add_vars(array("pageTilte" => "Poke @zigazou ;)"));
+
+
+$data = array(
+    array(
+        "url"       => "https://github.com/gnieark/tplBlock",
+        "name"      => "tplBlock",
+        "author"    => "Gnieark",
+        "quality"   => "simple and perfect"
+    ),
+    array(
+        "url"       => "https://github.com/Zigazou/TemplateEngine",
+        "name"      =>  "TemplateEngine",
+        "author"    => "Zigazou",
+        "quality"   => "more complex than tplBlock"
+
+    )
+);
+
+//add blocks
+foreach ($data as $block){
+    $tplTemplateSystem = new TplBlock("templatesystem");
+    $tplTemplateSystem -> add_vars($block);
+    $tpl->add_sub_block($tplTemplateSystem);
+}
+
+//parsing:
+echo $tpl->apply_tpl_file("template.html");
+```
+will return:
+
+```html
+<html>
+<body>
+    <h1>Poke @zigazou ;)</h1>
+    <ul>
+            <li><a href="https://github.com/gnieark/tplBlock"> tplBlock</a>
+         by Gnieark is simple and perfect</li> 
+            <li><a href="https://github.com/Zigazou/TemplateEngine"> TemplateEngine</a>
+         by Zigazou is more complex than tplBlock</li> 
+    
+    </ul>
+
+</body>
+</html>
+```
+
+# Conception choices
+
+I wrote this class for use it on others personnals projects. It's really simple. I think logicals functions "OR" "IF", filtering, caching, are not the templating system matter.
+
+If a block ( <--BEGIN .... )is in the template, but is not called, it will be deleted.
+
+Methods apply_tpl_file and apply_tpl_str have for second (optional) parameters a bolean. (true if not given).
+If true, the potentials carriage returns just after the BEGIN and just before the END are deleted.
+
+
+For now, class is permissive. I'll improve it to manage templating errors.