https://limb.nohau.ru/ 2026-11-10T17:05:27+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_2007_4:en:packages:macro:compiler&rev=1289372570&do=diff {{macro}} compiler This page is essential for developers who want to create their own 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_2007_4:en:packages:macro:data_sources&rev=1289372570&do=diff How {{macro}} template gets data for displaying? considers that it works with literal variables or regular arrays. If you pass an object to template, make sure that your object is supports ArrayAccess or Iterator interfaces depending on situation. There are two common ways to get data inside template: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_4:en:packages:macro:dictionaries&rev=1289372570&do=diff Where {{macro}} searches for tags and filters?({{macro}} dictionaries) 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 text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_4:en:packages:macro:errors_and_debug&rev=1289372570&do=diff {{macro}} error messages and templates debugging Template compilation errors compiler can detect the most of errors in templates. Here is the list of errors that are considered to be fatal for a 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_2007_4: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. The 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_2007_4: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 rule to variables in expressions. Filters are separated from other part of expression by vertical line. Several filters are separated by vertical lines too: text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_4:en:packages:macro:form_tags&rev=1289372570&do=diff Forms and form elements has aids to auto populate form fields with previously sent data in case of validation errors. There are also tags for generating <select> tags with options and for rendering validation errors (of the server side validation). text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_4: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_2007_4: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, 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_2007_4: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 on 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_2007_4:en:packages:macro:intro&rev=1289372570&do=diff Introduction to {{macro}}. {{macro}} templates syntax and entities. This page demonstrates a simple example of template and covers briefly syntax and template entities like tags, output expressions and filters. {{macro}} template example {{wrap with="page.phtml" in="content_zone"}} <img src={$#photo.largeFileUrl} /> <dl> <dt>Author:</dt><dd>{$#photo.member.name}</dd> <dt>Category:</dt><dd>{$#photo.category.title}</dd> <dt>Title:</dt><dd>{$#photo.title}</dd> <dt>Tags:</dt> <dd> {{list using… text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_4:en:packages:macro:list_tags&rev=1289372570&do=diff Rendering lists or tables {{macro}} tags for rendering lists 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_2007_4: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 splited into many small pages. We call this pagination. Pager - is a bunch of links that allow visitors to jump to other pages of displayed list. Pager can 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_2007_4:en:packages:macro:php_code_in_templates&rev=1289372570&do=diff php-code in {{macro}} templates As you may know compiles initial templates into regular php-class. That's why you can insert any php-blocks in 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_2007_4: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_2007_4:en:packages:macro:tags_info&rev=1289372570&do=diff {{macro}} tags Tags - are control elements of templates. Tags are commonly have a closing tag (like list or wrap), but there also tags that don't have a closing tag like 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 head 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_2007_4:en:packages:macro:tags_intro&rev=1289372570&do=diff Tags Tags - are elements of template that generates PHP code (in most cases). Tags can have a short form like and a full form with opening and closing tags ..tag content.. MACRO requires that tags must have both opening and closing tags in the same template file. You can't, for example, open a tag in one template and close it in another. text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_4:en:packages:macro:template_composition&rev=1289372570&do=diff Templates composition (including, wrapping and reusing) has a rich set of tools for template composition: * Including - inserting the content of other template into the current template * Wrapping - wrapping a part or the whole content of the current template into some particular point (so called text/html 2010-11-10T07:02:50+00:00 Anonymous (anonymous@undisclosed.example.com) https://limb.nohau.ru/doku.php?id=limb3_2007_4: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