https://limb.nohau.ru/ 2026-11-10T16:18:31+00:00 https://limb.nohau.ru/ https://limb.nohau.ru/lib/exe/fetch.php?media=wiki:dokuwiki.svg text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:compiler&rev=1289372570&do=diff {{macro}} compiler This page is essential for developers who want to create their own {{macro}} tags or filters. After reading this page you will have a better understanding of the {{macro}} templates compilation process. It is considered that you have already read the text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:data_sources&rev=1289372570&do=diff How {{macro}} template gets data for displaying? {{macro}} usually works with plain PHP scalar values or arrays. However, if you want your objects to be fully supported in {{macro}} as well, make sure that your object supports ArrayAccess(in case of accessing attributes using dotted syntax) or text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:dictionaries&rev=1289372570&do=diff Where {{macro}} looks for tags and filters Dictionaries supports only tags and filters that are registered in special dictionaries: * tags dictionary, * filters dictionary searches tags in: * limb/macro/src/tags - by default * limb/*/src/macro and src/macro of your Limb3-based application in case of using VIEW package. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:errors_and_debug&rev=1289372570&do=diff {{macro}} error messages and templates debugging Template compilation errors {{macro}} compiler can detect the most of errors in templates. Here is the list of errors that are considered to be fatal for a {{macro}} template: * Unbalanced template, that has an opening tag in one template and does not have a corresponding closing tag in the same template file(in case if this tag requires a closing tag). text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:expressions&rev=1289372570&do=diff Expressions. How to render variable values in templates Expressions syntax Expressions - are special entities of template that have two main functions: * to render variables (in such cases expressions are called output expressions): * {$percentage} - renders a variable from local data scope. Same as <?php echo $percentage; ?> text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:filters_intro&rev=1289372570&do=diff Filters. How to modify or format data on rendering. Filters are used to modify or to apply some special formatting rules to variables in expressions. Filters are separated from other parts of an expression by vertical line. Several filters can be combined into a text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:form_tags&rev=1289372570&do=diff Forms and form elements {{macro}} has basic aids to auto populate form fields with previously sent data. There are also tags for generating <select> tags with options and for rendering validation errors. Here is the list of the most commonly used {{macro}} text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:how_to_create_new_filter&rev=1289372570&do=diff How to create your own {{macro}} filters filters are stored in files with .filter.php suffix in file name. Filters files can be found in limb/macro/src/filters/ folder and also in src/macro folders of Limb3 packages and Limb-based applications. Filters core classes text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:how_to_create_new_tag&rev=1289372570&do=diff How to create your own {{macro}} tags It is considered that you have already read this two pages: * "{{macro}} compilation and rendering. How to run {{macro}} template.", * {{macro}} compiler, {{macro}} tags are stored in files with .tag.php suffix in file name. Tags files can be found in limb/macro/src/tags/ folder and also in src/macro folders of Limb3 packages and Limb-based applications. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:important_details&rev=1289372570&do=diff {{macro}} compilation and rendering. How to run {{macro}} template. Compile time vs run time is a PHP compiling template engine, which basically means that creates PHP code while parsing the template markup. Generated PHP code is cached onto the disk, then it is included and executed. Since generated PHP code is cached, this provides text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:intro&rev=1289372570&do=diff Introduction to {{macro}}. {{macro}} templates syntax and entities. This page demonstrates a simple example of {{macro}} template and covers briefly {{macro}} syntax and template entities like tags, output expressions and filters. {{macro}} template example text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:list_tags&rev=1289372570&do=diff Rendering lists or tables {{macro}} tags for lists rendering Let's consider the following example: <table border="1"> <tr> <th>№</th> <th>Title</th> <th>Volume, liters</th> <th>Weight, kg</th> </tr> {{list using="$#tanks" as="$tank" counter="$number"}} {{list:item}} <tr> <td>{$number}</td> <td>{$tank.name}</td> <td>{$tank.volume}</td> <td>{$tank.weight}</td> </tr> {{/list:item}} {{list:empty}} <tr><td colspan='4'>List is empty!</td></tr… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:pagination&rev=1289372570&do=diff Rendering lists with pagers. Pagination In most cases lists are too long to be displayed on a single page. In such cases lists are usually spllited(paginated) into many small pages. Pager - is a bunch of links that allow visitors to jump to other pages of displayed list. Pager may come in different forms: it can be just two links text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:php_code_in_templates&rev=1289372570&do=diff Using PHP code in {{macro}} templates As you may know {{macro}} compiles initial templates into a regular PHP class. That's why you can insert any PHP blocks into {{macro}} templates, e.g.: <select name='my_selector'> <?php foreach($this->items as $item) { echo '<option value="'. $item['value'] . '" '; if(some_condition()) echo 'selected'; echo '>'. $item['title'] .'</option>'; } ?> </select> text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:pros_and_cons&rev=1289372570&do=diff Pros and cons of MACRO template engine Pros * MACRO has powerful tools for templates composition such as wrapping, including, reusing, multiple wrapping. We really don't know any other template engine that offers the same capabilities. * MACRO is a text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:tags_info&rev=1289372570&do=diff {{macro}} tags Tags - are the main control elements of {{macro}} templates. Tags commonly have a closing tag (e.g list or wrap), but there also tags that don't have a closing tag(e.g slot). Tags annotations Tags can be found in *.tag.php files in limb/macro/src/tags and in /src/macro folders of your packages. In the header of each tag file there are text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:tags_intro&rev=1289372570&do=diff Tags Tags - are elements of {{macro}} template that generates PHP code (in most cases). Tags can have a short form like {{tag_name attrr1='value1'...att2='valueM'/}} and a full form with opening and closing tags {{tag_name attr1='value1'...attr2='valueM'}} text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:template_composition&rev=1289372570&do=diff Templates composition (including, wrapping and reusing) {{macro}} has a rich set of tools for template composition, these are: * Including - inserting the content of some other template into the current template * Wrapping - wrapping a part or the whole content of the current template into some particular place(so called text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3:en:packages:macro:template_file_name_resolving&rev=1289372570&do=diff How {{macro}} searches template files by aliases? can work both with absolute template file paths and aliases(relative ones): * /var/dev/project/template/news.phtml - absolute path * news.phtml - an alias resolves aliases using template locator