version up and docs

Aleksandr-ru · Apr 5, 2017 · 1ec71e8 · 1ec71e8
1 parent 3376548
commit 1ec71e8
Show file tree

Hide file tree

Showing 2 changed files with 32 additions and 2 deletions.
diff --git a/README.md b/README.md
@@ -5,6 +5,7 @@ Another simple template parser
 
 * Blocks of markup as object
 * Block repeat (setBlock appends new block and returns handle to it)
+* Recursive blocks (see example below)
 * Empty block placeholders
 * Independent variables in blocks and main template
 * Variable data escaping (filtering) in template, see markup below
@@ -159,6 +160,35 @@ for($i=1; $i<=3; $i++) {
 $to->showOutput();
 ```
 
+## Recursive blocks
+Since 2.4 there is an abilty to make your blocks recursive. For example:
+
+*recursive.html*
+
+```
+<body>
+	<!-- BEGIN blockname -->
+	[a recursive block]
+	<!-- RECURSION blockname -->
+	<!-- END blockname -->
+</body>
+```
+
+The code:
+
+```
+$to = TemplateObject::loadTemplate('recursive.html');
+$to->setBlock('blockname')->setBlock('blockname')->setBlock('blockname');
+$to->showOutput();
+```
+
+Output:
+
+```
+[a recursive block] [a recursive block] [a recursive block]
+```
+
+
 ## Function quick reference
 
 ### *static* loadTemplate(string  $file) : TemplateObject

diff --git a/TemplateObject.php b/TemplateObject.php
@@ -4,12 +4,12 @@
  * Based on features of HTML_Template_IT by Ulf Wendel, Pierre-Alain Joye.
  *
  * @author Rebel
- * @copyright (c) 2016 Aleksandr.ru 
+ * @copyright (c) 2017 Aleksandr.ru
  * @link https://github.com/Aleksandr-ru/TemplateObject Project page
  * @link https://pear.php.net/package/HTML_Template_IT Original HTML_Template_IT
  * @link http://aleksandr.ru Author's website
  *
- * @version 2.3
+ * @version 2.4
  */
 class TemplateObject
 {