среда, 12 октября 2011 г.

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

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

List (Список)
  Параметр типа list выводит выпадающий список, определенный пользователем
Поля:
  • type (обязательное) - значение “type”
  • name (обязательное) - имя параметра
  • label (обязательное) - имя поля
  • default - значение по умолчанию
  • description - выпадающая подсказка при наведении мышкой
  • class - имя CSS класса для поля
  • value (обязательное) - значение
Пример:
<param name="mylistvalue" type="list" default="" label="Select an option" description="">
 <option value="0">Option 1</option>
 <option value="1">Option 2</option>
</param>


Menu (Меню)
 Данный параметр показывает список всех меню с сайта.
Поля:
  • type (обязательное) - значение “menu”
  • name (обязательное) - имя параметра
  • label (обязательное) - имя поля
  • description - всплывающая подсказка
  • default - значение по умолчанию
Пример: <param name="mymenu" type="menu" default="mainmenu" label="Select a menu" description="Select a menu" />

Menuitem (пункты меню)
  Данный параметр показывает пункты меню.
Поля:
  • type (обязательный) - значение “menuitem”
  • name (обязательный) - имя параметра
  • label (обязательный) - имя поля
  • default - значение по умолчанию
  • description - выпадающая подсказка
  • state - будут показаны все меню (значение 0) или только опубликованные (значение 1)
Пример: <param name="mymenuitem" type="menuitem" default="45" label="Select a menu item" description="Select a menu item" />

Password (Пароль)
  Данный тип password служит для ввода пароля.
Поля:
  • type (обязательное) - значение “type”
  • name (обязательное) - имя параметра
  • label (обязательное) - название поля
  • size - указывает ширину текстового поля в символах
  • default - значение пароля по умолчанию
  • description - всплывающая подсказка
  • class - имя CSS класса для поля
Пример: <param name="mypassword" type="password" default="secret" label="Enter a password" description="" size="5" />

Radio
 Параметр типа переключатель для выбора различных параметров.
Поля:
  • type (обязательное) - значение “radio”
  • name (обязательное) - имя параметра
  • label (обязательное) - название поля
  • default - значение по умолчанию
  • description - всплывающая подсказка
  • value (обязательное) - это значение будет сохранено, если этот элемент выбран
Пример:
<param name="myradiovalue" type="radio" default="0" label="Select an option" description="">
   <option value="0">1</option>
 <option value="1">2</option>
</param>


Spacer (разделитель)
  Это визуальный разделитель.
Поля:
  • type (обязательное) - значение “spacer”
  • default - представляет собой строку, которая будет использоваться вместо <hr />, который вставляется по умолчанию.
Пример:
<param type="spacer" />
<param type="spacer" default="Advanced parameters" />
<param type="spacer" default="&lt;b&gt;Advanced parameters&lt;/b&gt;" />

SQL
  Данный тип параметра выводит выпадающий список, который получается путем выполнения SQL-запроса к базе данных Joomla.
Поля:
  • type (обязательное) - значение “sql”
  • name (обязательное) - имя параметра
  • label (обязательное) - имя поля
  • query (обязательное) - sql-запрос при выполнении котрого будет создаваться выпадающий список
  • default - значение по умолчанию
  • description - выпадающая подсказка
  • key_field - это имя столбца, который будет содержать значение параметра.
  • value_field - это имя столбца, значения которого будут показаны в выпадающем списке
Пример:
<param name="title" type="sql" default="10" label="Select an article" query="SELECT id AS value, title FROM #__content" />
 <param name="title" type="sql" default="10" label="Select an article" query="SELECT id, title FROM #__content" key_field="id" />
<param name="myfield" type="sql" default="10" label="Select an article" query="SELECT id AS value, title AS myfield FROM #__content" />
<param name="myfield" type="sql" default="10" label="Select an article" query="SELECT id, title FROM #__content" key_field="id" value_field="title" />

Text
  Текстовое поле для ввода данных.
Поля:
  • type (обязательное) - значение “text”
  • name (обязательное) - имя параметра
  • label (обязательное) - название поля
  • size - длина текстового поля в символах
  • default - значение по умолчанию
  • description - всплывающая подсказка
  • class - имя CSS класса для поля
Пример:
<param name="mytextvalue" type="text" default="Some text" label="Enter some text" description="" size="10" />

Textarea
 Текстовая область для ввода данных
Поля:
  • type (обязательное) - значение “textarea”
  • name (обязательное) - имя параметра
  • label (обязательное) - название поля
  • rows (обязательное) - это высота видимой области текста в строках
  • cols (обязательное) - это ширина видимой области текста в символах
  • default - значение по умолчанию
  • description - всплывающая подсказка
  • class -  имя CSS класса для поля
Пример:
<param name="mytextarea" type="textarea" default="default" label="Enter some text" description="" rows="10" cols="5" />

Timezones
  Выпадающий список часовых поясов
Поля:
  • type (обязательное) - значение “timezones”
  • name (обязательное) - имя параметра
  • label (обязательное) - название поля
  • default - значение по умолчанию
  • description -всплывающая подсказка
Пример:
<param name="mytimezone" type="timezones" default="-10" label="Select a timezone" description="" />

Usergroup
 Выпадающий список групп пользователей
Поля:
  • type (обязательное) - значение “usergroup”
  • name (обязательное) - имя параметра
  • label (обязательное) - название поля
  • default - группа пользователей по умолчанию
  • size - количество строк списка, которые отображаются
  • multiple - указывает, допускается или не допускается выбор нескольких элементов
  • description - выпадающая подсказка
  • class - имя CSS класса для поля
Пример:
<param name="myusergroups" type="usergroup" default="" label="Select a user group" description="" />
 На этом цикл статей посвященных стандартным параметрам для шаблонов CMS Joomla закончен. Надеюсь, Вам это пригодилось. Если есть дополнения или замечания пишите в комментариях. И не забываем благодарить :)

Полный список параметров Вы можете скачать в PDF-формате.

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



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

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



1 комментарий:

  1. Очень всё подобно! Спасибо! Ещё не пробовал, но материал подробный. думаю проблем не будет. Жаль только перекопируют для своих ГС

    ОтветитьУдалить