Создание шаблона для CMS Joomla. Список стандартных параметров и их описание (часть 2)

В предыдущем посте мы начали рассмотрение стандартных параметров, которые можно добавить в шаблон CMS Joomla. Благодаря этим параметрам мы можем изменять шаблон прямо из админки, что делает шаблоны более привлекательными. Давайте продолжим рассмотрение стандартных параметров шаблонов для CMS Joomla.

Filelist (Список файлов).

Параметр типа Filelist предоставляет раскрывающийся список файлов из указанного каталога.
Поля:

• type (обязательное) - значение “filelist”
• name (обязательное) - имя параметра
• label (обязательное) - название поля
• directory - путь к папке, из которой будет показываться список файлов
• filter - является регулярным выражением строки, который используется для фильтрации списка файлов, выбранных для включения в раскрывающемся списке.
• exclude - является регулярным строковым выражением, которое используется для исключения файлов из списка.
• stripext - является логическим выражением. Если истинно, то в именах будет исключаться расширение. Замете, что и при загрузке файла расширение будет удалено.
• hide_none - является логическим аргументом. Если истинно, то не будет отображаться пункт исключения из раскрывающегося списка
• hide_default - логический аргумент. Если истинно, то используется по умолчанию раскрывающийся список исключений.

Пример: <param name="myfile" type="filelist" default="" label="Select a file" description="" directory="administrator" filter="" exclude="" stripext="" />

Folderlist (Список директорий)

Параметр типа Folderlist показывает в виде выпадающего списка директории из определенной директории.
Поля:

• type (обязательное) - значение “folderlist”
• name (обязательное) - имя параметра
• label (обязательное) - название поля
• directory (обязательное) - путь к папке, из которой будут показаны другие директории
• default - название папки по умолчанию
• description - при наведении мышки на поле всплывает окно подсказки
• filter - является регулярным выражением строки, которая используется для фильтрации списка папок
• exclude - является регулярным строковым выражением, которое используется для исключения папки из списка
• hide_none - является логическим аргументом. Если истинно, то не будет отображаться пункт исключения из раскрывающегося списка
• hide_default - логический аргумент. Если истинно, то используется по умолчанию раскрывающийся список исключений.

Пример: <param name="myfolder" type="folderlist" default="" label="Select a folder" directory="administrator" filter="" exclude="" stripext="" />


Helpsites (Сайты помощи)

Параметр типа  helpsites показывает список help-сайтов в виде выпадающего меню. Список help-сайтов: [path-to-Joomla]/administrator/help/helpsites-15.xml
Поля:

• type (обязательное) - значение “helpsites”
• name (обязательное) - название параметра
• label (обязательное) - название поля
• default - сайт помощи по умолчанию, вводим url
• description - при наведении мышки на поле всплывает окно подсказки

Пример:<param name="myhelpsite" type="helpsites" default="" label="Select a help site" description="" />


Hidden (скрытый параметр)
Это тип скрытого параметра, который обеспечивает скрытое поле для сохранения параметров, значение которого не может быть изменено непосредственно пользователем Администратор (оно может быть изменено в коде или путем редактирования файла xml).
Поля:

• type (обязательно)- значение “hidden”
• name (обязательно) - название параметра
• label  (обязательно) - название поля
• default (обязательно) - данные, которые необходимо передать
• class - имя CSS класса для поля

Пример: <param name="mysecretvariable" type="hidden" default="" />


Imagelist (Список картинок)

Параметр типа Imagelist показывает выпадающий список графических файлов из указанной директории. Отображаются только файлы с расширением PNG,. GIF,. JPG,. BMP,. ICO.
Поля:

• type (обязательное) - значение “imagelist”
• name (обязательное) - имя параметра
• label (обязательное) - имя поля
• directory - путь к папке, содержащей графические файлы
• default - имя файла по умолчанию
• description - при наведении мышки на поле всплывает окно подсказки
• filter - является регулярным выражением строки, которая используется для фильтрации списка изображений
• exclude - является регулярным строковым выражением, которое используется для исключения папки из списка
• stripext - является логическим выражением. Если истинно, то в именах будет исключаться расширение. Замете, что и при загрузке файла расширение будет удалено.
• hide_none - является логическим аргументом. Если истинно, то не будет отображаться пункт исключения из раскрывающегося списка
• hide_default - логический аргумент. Если истинно, то используется по умолчанию раскрывающийся список исключений.

Пример:
<param name="myimage" type="imagelist" default="" label="Select an image" description="" directory="" exclude="" stripext="" />


Languages (Язык)

Параметр типа Languages показывает выпадающий список установленных языков для сайта или фдминпанели.
Поля:

• type (обязательное) - значение “languages”
• name (обязательное) - имя параметра
• label (обязательное) - имя поля
• client (обязательное) - на какую область будет распространяться параметр: сайт или админка
• default - язык по умолчанию
• description - при наведении мышки на поле всплывает окно подсказки

Пример: <param name="mylanguage" type="languages" client="site" default="en-GB" label="Select a language" description="" />

Думаю на этом пора заканчивать, а то пост получается слишком длинным. В следующем посте мы продолжим рассматривать параметры для шаблонов CMS Joomla.
Не пропустите обновления моего блога, подписавшись на RSS  рассылку или следите за мной в twitter.

Как правильно составлять xml-файл читайте в статье "Файлы объявления в CMS Joomla. Правила составления xml файла в Joomla."

Понравилась статья? Поблагодарить автора:

Введите e-mail адрес: