В этой статье хотелось бы более подробно остановиться на параметрах шаблонов.

Все параметры шаблона находятся в специальном файле с расширением .xml и именем, одинаковым с именем самого шаблона.

Для примера рассмотрим шаблон полного вида статьи default.

Файлы шаблонов полного вида статьи находятся в папке views/record.Полное имя файла состоит из префикса и названия шаблона. Для полного вида статьи префикс названия файла должен быть default_record_, а полное имя файла, соответственно будет default_record_default.php. Более подробную информацию по этому вопросу Вы можете найти в уроке о работе с шаблонами Cobalt. Я даже порекомендовал бы его для обязательного предварительного изучения.

Параметры этого шаблона находятся в одноименном XML файле default_record_default.xml.

Структура файла параметров шаблона

Рассмотрим пример файла настроек.

<?xml version="1.0" encoding="utf-8"?>
<form>
	<name>Default</name>
	<author>MintJoomla</author>
	<creationDate>Febrary 2012</creationDate>
	<copyright>Copyright (C) 2005 - 2012 MintJoomla. All rights reserved.</copyright>
	<license>Commercial (http://www.mintjoomla.com/commercial-license)</license>
	<authorEmail>support@mintjoomla.com</authorEmail>
	<authorUrl>www.mintjoomla.com</authorUrl>
	<version>8.36</version>
	<description>Default article full view template</description>

	<fields name="tmpl_params">
		<fieldset name="name" label="Fieldset Nmae">
			<field>
				<option value="1">Value 1</option>
			</field>
		</fieldset>
	</fields>
	
	<fields name="tmpl_core">
		<fieldset name="name2" label="Fieldset Name 2">
			<field />
		</fieldset>
	</fields>
</form>

Несколько важных моментов, которые надо понимать:

• Вся структура XML должна быть обязательно заключена в коневой тег <form>.

• Верхняя группа параметров вида <name>, <author>, <version> и других нужна для заполнения информации об авторе этого шаблона и его контактных данных, чтобы пользователь легко мог найти автора и обратиться к нему при наличии вопросов.

• В файл параметров шаблона может быть добавлено только 2 раздела <fields> с фиксированными именами- tmpl_params и tmpl_core. Вы можете добавлять свои параметры в раздел tmpl_params. Раздел tmpl_core следует изменять с осторожностью, т.к. его может использовать ядро Cobalt. Иными словами, настройки раздела tmpl_core должны присутствовать обязательно.

• Каждый раздел <fields> может содержать сколько угодно элементов <fieldset>. Элемент <fieldset> позволяет объединять параметры в группы, что сильно упрощает их зрительное восприятие, особенно если параметров много. Объединив параметры в группы, Вы упростите их чтение.

Группа параметров fieldset

<fieldset name="name" label="Group Name" description="Group description"></fieldset>

допустимые атрибуты группы параметров fieldset

Параметр field

<field name type label [class default description]>
	[<option value="1">Value 1</option>]
</field>

Элемент <field> может содержать основные и дополнительные атрибуты.

Все атрибуты записываются в формате имя="значение", атрибуты отделяются друг от друга пробелом. Состав дополнительных атрибутов зависит, в основном, от значения атрибута type.

Вот описание основных атрибутов элемента <field>

Опция type

Рассмотрим несколько значений атрибута type. На самом деле их существует гораздо больше, но этот основной набор покроет 99%-100% ваших нужд.

Text

type="text"

Текстовое поле ввода. Превратится в <input type="text"> в HTML.

Textarea

type="textarea"

Область ввода произвольного текста.

List

type="list"

Выпадающий список значений для выбора. В HTML превратится в <select>

Так же как список значений, этот XML элемент может включать в себя элементы <option>. Например:

<field name="search_mode" type="list" default="3" label="Режим поиска">
	<option value="1">Искать везде</option>
	<option value="2">Искать в категории</option>
	<option value="3">Искать в ветке</option>
</field>

Radio

type="radio"

Блок radio-кнопок.

Особых атрибутов нет, может включать в себя элементы <option>.

Например:

<field name="search_title" type="radio" class="btn-group" default="1" label="Искать в заголовке">
	<option value="0">CNO</option>
	<option value="1">CYES</option>
</field>

Meresourcesfields

type="meresourcesfields"

Список полей из типов контента Cobalt. Это один из самых полезных и практичных параметров в контексте шаблонов кобальта. Предположим, Вам необходимо разместить значение какого-то поля в определенной позиции шаблона с отдельными стилями. Это легко можно сделать, просто вызвав это поле в шаблоне по его ID. Примерно так.

<?php echo $item->fields_by_id[11]->result ?>

Где 11- это ID поля. Читайте эту статью для более подробной информации.

Но если вы не знаете, какой будет ID или хотите предоставить пользователю возможность самому выбрать, где и какое поле разместить, вот тогда этот параметр и придет на помощь.

Внимание: шаблон основной опции name должен быть name=”field_имя_поля”

accesslevel

type="accesslevel"

Список уровней доступа типа public, registered, special, Дополнительные атрибуты отсутствуют, но при необходимости можно добавить в список дополнительный элемент <option>. Например:

<field name="add" type="accesslevel" default="3" label="Кто добавит?">
	<option value="0">Ни кто</option>
</field>

Folderlist

type="folderlist"

Выпадающей список папок из указанной директории.

Пожалуйста, подпишитесь или установите наблюдение за этой статьей, нажав на кнопке с иконкой . Мы будем дополнять ее новой информацией, и Вы сможете получать уведомления при изменениях или дополнениях этой статьи.