====== WACT tag dictionary (including Limb3 specific tags) ======

//Most of the pages have usage examples. In some cases the whole group of tag has the only example, in such cases the page with usage example is marked with "See example here!""//

You can also browse examples in SVN at : https://svn.limb-project.com/3.x/examples/wact/examples/. 

Or you can also download examples from http://projects.limb-project.com/ (see. WACT section)

===== WACT Core Tags =====

^Tag^Description^
|Location: **limb/wact/src/tags/core/**||
|[[.Tags:CoreTags:coreBlockTag|<core:block>]]|Allows to join a group of tags into single block and to show or to hide this block|
|[[.Tags:CoreTags:coreCommentTag|<core:comment>]]|Allows to insert a comment into template that will not be rendered.|
|[[.Tags:CoreTags:CoreDatasourceTag|<core:datasource>]]|Provides a scope for template variables. In other words inserts a new data context (datasource) into template|
|[[.Tags:CoreTags:CoreOptionalTag|<core:optional>]]|Outputs a portion of the template if named variable exists at runtime.|
|[[.Tags:CoreTags:CoreDefaultTag|<core:default>]]|Outputs a portion of the template if a given variable is not defined at runtime (partner of <core:optional> tag|
|[[.Tags:CoreTags:CoreIfTag|<core:if>]]|Outputs a portion of the template if a given variable expression is true.|
|[[.Tags:CoreTags:CoreIncludeTag|<core:include>]]|Outputs a portion of the template if a given variable.|
|[[.Tags:CoreTags:CoreLiteralTag|<core:literal>]]|Prevent contents of tag from being parsed.|
|[[.Tags:CoreTags:CorePlaceholderTag|core:placeholder>]]|Present a named location where content can be inserted. Partner of <core:wrap> tag.|
|[[.Tags:CoreTags:coreRepeatTag|<core:repeat>]]|Allows to output a portion of the template several times.|
|[[.Tags:CoreTags:coreRuntimeContentTag|<core:runtimecontent>]]|Provides a placeholder in the template at runtime where any text can be rendered. |
|[[.Tags:CoreTags:CoreWrapTag|<core:wrap>]]|Wraps a portion of the current template into some placeholder of the base (parent) template and thus compiles two (or more) templates into a single one.|
|[[.Tags:CoreTags:CoreSetTag|<core:set>]]|Sets the value of a variable (or several variables) in the current scope|

===== WACT List Tags (WACT tags to output lists and tables) =====

^Tag^Description^
|Location: **limb/wact/src/tags/list/**|||
|[[.tags:ListTags:ListListTag|<list:list>]]|Defines a list boundaries. Holds iterator. **See example here!**|
|[[.tags:ListTags:ListItemTag|<list:item>]]|Used to contain the content for rendering list items (rows). Repeated for every item in iterator. **See example here!**|
|{$:ListRowNumber}|Outputs number of the current row.|
|{$:ListRowOdd}|Has true value if current row is odd. Used inside <list:item> tag contents|
|{$:ListRowEven}|Has true value if current row is even. Used inside <list:item> tag contents|
|{$:Parity}|Emits odd or even depending on row. Used inside <list:item> tag contents|
|[[.tags:ListTags:ListDefaultTag|<list:default>]]|Define alternative output to be shown when enclosing list is empty|
|[[.tags:ListTags:ListSeparatorTag|<list:separator>]]|Define output between list items|
|[[.tags:ListTags:ListFillTag|<list:fill>]]|Used to generate valid markup in multicolumn lists|

===== WACT Form tags =====

^Tag^Description^
|Location: **limb/wact/src/tags/form/**|||
|[[.tags:FormTags:FormTag|<form>]]|Enhanced html <form> tag.|
|[[.tags:FormTags:FormErrorsTag|<form:errors>]]|Used in rendering form validation errors.|
|[[.tags:FormTags:ControlTag|ControlTag]] (has no tag) | A base class for all form elements tags.|
|[[.tags:FormTags:InputTag|<input>]]|Enhanced html <input> tag.|
|[[.tags:FormTags:ButtonTag|<button>]]|Enhanced html <button> tag.|
|[[.tags:FormTags:TextAreaTag|<text_area>]]|Enhanced html <textarea> tag.|
|[[.tags:FormTags:LabelTag|<label>]] |Enhanced html <label> tag.|
|[[.tags:FormTags:JsCheckboxTag|<js_checkbox>]]| Inserts a DHML checkbox with hidden input field, that always returns 0 or 1 (unlike regular <input type='checkbox'> tag).|
|[[.tags:FormTags:SelectTag|<select>]] |Enhanced html <select> tag.|
|[[.tags:FormTags:OptionTag|<option>]] |Enhanced html <option> tag.|
|[[.tags:FormTags:SelectOptionsSourceTag|<select:options_source>]] |Used to generate options lists for <select> tags from iterators or arrays.|
|[[.tags:FormTags:FormMultipleTag|<form_multiple>]] | Enhanced version of WACT <form> tag. Automatically prefixes all form fields names with form name. Allows to have several active form on the same page.|
|[[.tags:FormTags:FormRefererTag|<form:referer>]]|Renders a hidden input with $_SERVER["HTTP_REFERER"] value or with **referer** parameter of the request.|
|[[.tags:FormTags:FormPreserveStateTag|<form:preserve_state>]] | Allows to specify what request parameters should be passed through the form.|


===== Wact Pager tags (WACT tag to perform lists pagination) =====

^Tag^Description^
|Location**limb/wact/src/tags/pager/**|||
|[[.tags:PagerTags:PagerNavigatorTag|<pager:navigator>]] | The root element of a page. **See example here!**|
|[[.tags:PagerTags:PaginateTag|<paginate>]] | Allows to link pager with list and thus paginate iterator right in the template.|
|[[.tags:PagerTags:PagerPrevTag|<pager:prev>]] | The element that steps back one page.|
|[[.tags:PagerTags:PagerFirstTag|<pager:first>]] | The "back to start" element of the pager.|
|[[.tags:PagerTags:PagerNextTag|<pager:next>]] | The element that steps forward one page.|
|[[.tags:PagerTags:PagerLastTag|<pager:last>]] | The "go to end" element of the pager.|
|[[.tags:PagerTags:PagerListTag|<pager:list>]] | Marks the "iterable" section of the pager. |
|[[.tags:PagerTags:PagerNumberTag|<pager:number>]] | Allows to render a link to some page.|
|[[.tags:PagerTags:PagerCurrentTag|<pager:current>]] | Allows to render a link or just a number of the current page|
|[[.tags:PagerTags:PagerSeparatorTag|<pager:separator>]] | The separator between <pager:number> and <pager:current> tags.|
|[[.tags:PagerTags:PagerSectionTag|<pager:section>]] | Allows to render a link to a block of pages. In a pager e.g. 1 2 3 [4-6] [7-9] (the [4-6] is a section)|
|[[.tags:PagerTags:PagerElipsesTag|<pager:elipses>]] | Allows to render a separator between groups of links to pages in the begining, in the middle and in the end of the pager. In a pager e.g. ...6 7 8... (the ... are the elipses)|
|**Tag properties. Can be used inside <pager:navigator>** tag||
|{$:TotalPages}|Total number of pages.|
|{$:TotalItems}|Total items in paginated list.|
|{$:HasMoreThanOnePage}|Has true value if pager has more than one page.|
|{$:BeginItemNumber}|Has number of record that the current page starts with.|
|{$:EndItemNumber}|Has number of record that the current page ends with.|


===== WACT Request tags =====

^Tag^Description^
|Location: **limb/wact/src/tags/request/**||
|[[.Tags:RequestTags:SiteBranchSelectorTag|<site_branch_selector>]]|Defines a group of tags that can render different portions of the template depending on the request URL.|
|[[.Tags:RequestTags:SiteBranchTag|<site_branch>]]| Renders a portion of the template if page URL contains a certain substring.|

===== Wact Fetch tags (used to fetch data right from WACT template also known as PULL-VIEW) =====

^Tag^Description^
|Location: **limb/wact/src/tags/fetch/**||
|[[.tags:FetchTags:FetchTag|<fetch>]]| Performs data fetch operations with classes implementing WactFetcher interface.|
|[[.tags:FetchTags:FetchParameterTag|<fetch:params>]]| Allows to pass parameters to fetchers.|
|[[.tags:FetchTags:FetchDecorateTag|<fetch:decorate>]]| Allows to decorate fetched iterator with some decorator right in the template.|

===== Limb Fetch tags  =====

^Tag^Description^
|Location: **limb/web_app/src/template/tags/fetch/**||
|[[.tags:lmbFetchTags:lmbActiveRecordFetchTag|<active_record:fetch>]]| Advanced version of <fetch> tag that used Limb3 ActiveRecords as a source of data.|
|[[.tags:lmbFetchTags:lmbFindParamsTag|<find:params>]]| A kind of <fetch:param> tag, allows to pass any params to custom find-method. A partner of <active_record:fetch> tag.|

===== Wact Iterator tags (used to pass iterators between tags and to decorate iterators right in WACT template) =====

^Tag^Description^
|Location: **limb/wact/src/tags/iterator/**||
|[[.tags:IteratorTags:IteratorTransferTag|<iterator:transfer>]]| Moves iterator from one scope to other. Useful if transfered iterator should be paginated, sortered or decorated|
|[[.tags:IteratorTags:IteratorDecorateTag|<iterator:decorate>]] | Allows to decorate transtered iterator with some decorator right in the template. A partner of <interator:transfer> tag.|

===== Wact Perform tags (a group of tags to execute method of template helper-objects) =====

^Tag^Description^
|Location: **limb/web_app/src/template/tags/perform/**||
|[[.tags:PerformTags:PerformTag|<perform>]]| Defines a callback of some method of so called template command that is a class implementing WactTemplateCommand interface. With <perform> tag you can insert a callback into template that will be affect template somehow. For example you can change a number of rendered items per page in pager, load some data, insert variables into template etc.|
|[[.tags:PerformTags:PerformParamsTag|<perform:params>]] | Allows to pass parameters to executed template command method. Used inside <perfor> tag.|
===== Limb Request tags =====

^Tag^Description^
|Location: **limb/web_app/src/template/tags/request/**||
|[[.tags:lmbRequestTags:lmbRouteUrlTag|<route_url>]] | Renders <a> tag, with "href" attribute value created by [[limb3:ru:packages:web_app:lmb_routes|lmbRoutes]] class.|
|[[.tags:lmbRequestTags:lmbRouteUrlSetTag|<route_url_set>]] | Inserts into the current scope a variable with value created by [[limb3:ru:packages:web_app:lmb_routes|lmbRoutes]] class.|

===== WACT Dev tags (WACT tags used during template development) =====

^Tag^Description^
|Location: **limb/wact/src/tags/dev/**||
|[[.tags:DevTags:DevDataSpaceTag|<dev:dataspace>]] | View the contents of a runtime datasource.|
|[[.tags:DevTags:DevSourceTag|<dev:source>]] | View the PHP source code generated into the compiled template.|