From afeb8789b57c6486ecafc4aa4709185d8d9b787a Mon Sep 17 00:00:00 2001
From: Dave Mc Nicoll <info@mcnd.ca>
Date: Wed, 1 Feb 2023 18:20:42 +0000
Subject: [PATCH] - Added a new doc section about both new tokens
'section.prepend/append'
---
docs/02-control-structure-extends-section.md | 50 +++++++++++++++++++-
1 file changed, 49 insertions(+), 1 deletion(-)
diff --git a/docs/02-control-structure-extends-section.md b/docs/02-control-structure-extends-section.md
index ef1b1ad..72d6fa2 100644
--- a/docs/02-control-structure-extends-section.md
+++ b/docs/02-control-structure-extends-section.md
@@ -119,4 +119,52 @@ We could use the previous file `path/home` and generate, let's say, the same pag
</html>
```
-Notice that the `<header>` tag is now empty, since we've redeclared it in our navless view.
\ No newline at end of file
+Notice that the `<header>` tag is now empty, since we've redeclared it in our navless view.
+
+## Overview of `section` (string $name, array $options)
+
+In your `$name` variable, accepted characters are alpha-numeric and those specific caracters : `.-_:`, so
+names suches as :
+
+ `body.content`
+ `my-cool-section:heading`
+ `MyOtherSection`
+ `_another_accepted_name`
+
+Allowed options are :
+
+ string `action` : allowed are `prepend`, `default`, `append`
+ int `order` : if you must
+
+### Actions can also be passed using specials tokens :
+
+`section.prepend` and `section.append` can also be used without passing an `action` option.
+
+*path/home-nav.phtml*
+```html
+{% extends "path/home" %}
+
+{% section "header" %}
+ <a href="#mylink">First link here !</a>
+{% endsection %}
+```
+
+*path/home-admin-nav.phtml*
+```html
+{% extends "path/home-nav" %}
+
+{% section.prepend "header" %}
+ <h4>My new NAV header</h4>
+{% endsection %}
+
+{% section.append "header" %}
+ <a href="#mylink">Second link here !</a>
+{% endsection %}
+```
+
+**[HTML]** Would render as such :
+```html
+<h4>My new NAV header</h4>
+<a href="#mylink">First link here !</a>
+<a href="#mylink">Second link here !</a>
+```