TemplateDetails.xml файл всегда находится в корневой каталог для шаблонов. Например, для шаблона Beez полный путь будет выглядеть так: [path-to-Joomla]/templates/beez/templateDetails.xml
Обратите внимание, что письмо случае важно на регистр операционных систем, таких как Linux. Вы можете использовать стандартный текстовый редактор (не текстовый процессор) или редактор XML внести изменения в этот файл.
Найдите <params> элемент, как правило, ближе к концу файла.Если нет <params> элемента вам необходимо добавить еще один. Это должно быть непосредственно под <install> элемента в иерархии элементов XML. Не забудьте закрыть элемент с </ Params> тега. Заметим, что для Joomla 1,6 года <install> тег является устаревшим в пользу <Extension>.
Для каждого параметра, который вы хотите определить, добавить <param> элемента. Этот элемент принимает ряд обязательных и необязательных аргументов, которые зависят от типа аргумента. Только по-настоящему обязательным аргумент типа, кроме названия, по умолчанию, описание и этикетки являются общими для большинства типов параметров и название является обязательным, если это происходит. Эти обязательные / общие аргументы:
* Тип определяет тип управления формы HTML используется в экран параметров шаблона в администратора, чтобы позволить пользователю изменять значение параметра.
* Имя уникальное имя параметра. Вы будете ссылаться на это имя при получении значения параметра в код шаблона.
Следующие аргументы не являются обязательными, но являются общими для почти всех типов параметров:
* По умолчанию По умолчанию значение параметра.
* Описание текста, который будет отображаться в качестве подсказки для поля на экране параметров шаблона в администратора. Это переводимые строки, см. Шаблон Переводы для информации о том, как добавить языковые переводы этой строки.
* Метка описательное название поля, которое будет показано пользователю в экран параметров шаблона в администратора. Это переводимые строки, см. Шаблон Переводы для информации о том, как добавить языковые переводы этой строки. Если на этикетке аргумент опущен, по умолчанию будет значение задается имя аргумента.
Необязательных аргументов зависит от типа параметра. Каждый из типов параметров подробно описана в Стандартные типы параметров. Если вы являетесь разработчиком это также возможность создавать свои собственные типы параметров, см. в разделе Создание пользовательских параметров XML-типов для получения дополнительной информации.
Например, следующий отрывок показывает <params> разделе определения двух параметров: один для раскрывающийся список изменения шаблона цвета, другой для переключатель, который позволит пользователю, чтобы показать или скрыть автора сообщения об авторских правах.
<params> <param name="templateColour" type="list" default="blue" label="Template Colour" description="Choose the template colour."> <option value="blue">Blue</option> <option value="red">Red</option> <option value="green">Green</option> <option value="black">Black</option> </param> <param name="authorCopyright" type="radio" default="1" label="Author Copyright" description="Show/Hide author copyright."> <option value="0">hide</option> <option value="1">show</option> </param> </params>
На экране параметров шаблона для этого примера будет выглядеть следующим образом:
Примечание: Параметр группы в настоящее время не поддерживается в параметры шаблона.
Совет: Чтобы включить HTML-теги в XML аргументы вы должны закодировать определенные специальные символы следующим образом:
| Описание | Символ | кодировка |
|---|---|---|
| & | Амперсанд | & |
| “ | Двойная кавычка | " |
| ' | Одиночная кавычка | ' |
| < | Меньше чем | < |
| > | Больше | > |
