Как расширить глобальные параметры шаблона
Этот урок о том, как расширить глобальные параметры шаблона в компоненте ZOO.
Начнем
Все глобальные параметры шаблона расположены в папке /media/zoo/applications/APPLICATION/templates/TEMPLATE/template.xml. В целом Вы можете включать любые типы параметров Joomla, такие как text, radio, list, и др.Разбирая по деталям
Типичный файл шаблона template.xml должен включать в себя следующие параметры.<params group="category">
<param name="show_alpha_index" type="list" default="1" label="Alpha Index" description="Show/Hide alpha index">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_title" type="radio" default="1" label="Title" description="Show/Hide title">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_description" type="radio" default="1" label="Description" description="Show/Hide description">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_image" type="radio" default="1" label="Image" description="Show/Hide image">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="alignment" type="list" default="left" label="Alignment" description="You can choose how the image and the content should be aligned.">
<option value="left">Image Left</option>
<option value="right">Image Right</option>
<option value="center">All Centered</option>
</param>
<param name="@spacer" type="spacer" />
<param name="categories_cols" type="radio" default="4" label="Categories Columns" description="Set how many columns to use per row.">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
</param>
<param name="show_categories_titles" type="radio" default="1" label="Categories Titles" description="Show/Hide categories titles">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_categories_item_count" type="radio" default="1" label="Categories Item Count" description="Show item count of categories">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_categories_descriptions" type="radio" default="1" label="Categories Descriptions" description="Show/Hide categories descriptions">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_categories_images" type="radio" default="1" label="Categories Images" description="Show/Hide categories images">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_sub_categories" type="radio" default="1" label="Sub Categories" description="Show/Hide sub categories">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="show_sub_categories_item_count" type="radio" default="1" label="Sub Categories Item Count" description="Show/Hide item count of sub categories">
<option value="0">Hide</option>
<option value="1">Show</option>
</param>
<param name="@spacer" type="spacer" />
<param name="items_cols" type="radio" default="2" label="Item Columns" description="Set how many columns to use per row">
<option value="1">1</option>
<option value="2">2</option>
<option value="3">3</option>
<option value="4">4</option>
</param>
<param name="items_media_alignment" type="list" default="left" label="Items Media Alignment" description="You can choose how the media element should be aligned.">
<option value="left">Left</option>
<option value="right">Right</option>
<option value="center">Center</option>
</param>
</params>
<params group="item">
<param name="item_media_alignment" type="list" default="right" label="Item Media Alignment" description="You can choose how the media element should be aligned.">
<option value="left">Left</option>
<option value="right">Right</option>
<option value="center">Center</option>
<option value="top">Top</option>
</param>
</params>
Вы можете добавлять любые параметры, какие Вам нужно. Они автоматически будут конвертированы в глобальные. В зависимости от группы параметров, они будут показаны в параметрах шаблона категории и материала.
Чтобы получить значения параметров в вашем шаблоне, используйте
$this->params->get('template.PARAM_NAME'). Совет: template. перед PARAM_NAME, указывает на то, где будет находится объект параметра.