description improvements

extension/shortcodes/index.rst

@@ -118,16 +118,24 @@ It contains an array that must be stored in a ``$cfg`` variable and is typically
 
             /*
             // Icon examples
+            // Note: By default is loaded {your-shortcode}/static/img/page_builder.png
+            'icon' => 'http://.../image-16x16.png', // background color should be #8c8c8c
             'icon' => 'dashicons dashicons-admin-site',
             'icon' => 'unycon unycon-crown',
             'icon' => 'fa fa-btc',
             */
 
             /*
             // Title Template examples
+            //
+            // Syntax:
             // * {{- variable }} - Output with html escape
             // * {{= variable }} - Output raw (without html escape)
             // * {{ if (execute.any(javascript, code)) { console.log('Hi'); } }}
+            //
+            // Available variables:
+            // * title - shortcode title (from config)
+            // * o - an object with all shortcode options values
             'title_template' => '{{- title }} Lorem {{- o.option_id }} ipsum {{= o["option-id"] }}',
             'title_template' => '{{- title }}: {{- o.label }}{{ if (o.target == "_blank") { }} <span class="dashicons dashicons-external"></span>{{ } }}',
             */