Модуль simpleForm2

Модуль simpleForm2 - это не вторая версия модуля simpleForm, а иной модуль. Названия у них схожи потому, что у них практически идентичное ядро. Модуль simpleForm2 отличается от модуля simpleForm тем, что тут код написания формы превратился в мета-язык + в сам код формы можно вписывать HTML код, JavaScript, CSS... Элементы этого метаязыка выглядят также как и в XML за искоючением того, что в XML тэг обрамляется знаками больше, меньше, а тут вместо этих знаков нужно использовать фигурные скобки. Т.е. элемент в XML коде формы выглядит так:

<element label="Ваше имя" type="text" required="required" error="Введите ваше имя" />

А в мета-языке simpleForm2 так:

{element label="Ваше имя" type="text" required="required" error="Введите ваше имя" /}

То же самое относится и к элементам "option".

Плюс к этому, в следствии того, что появилась возможность внедрять HTML код в код формы отпала необходимость в элементе "group". В коде формы simpleForm2 можно использовать следующие элементы:

• form - тэг формы. (добавлен в версии 1.0.5)
• element - тэг элемента формы (input, select, textarea...).
• option - тэг одного из нескольких вариантов значения тэга element (его можно сравнить с option в HTML).

Элемент "form" может быть как открывающий {form} так и закрывающий {/form}. Этот элемент необязательный. Его следует использовать только в тех случаях, когда вы хотите вынести часть кода за пределы формы, например, для отображения формы во всплывающем окне с использованием какой-либо JavaScript библиотеки.

У каждого из этих элементов, кроме "form" есть определенный набор атрибутов. Атрибуты могут быть как обязательные так и не обязательные.

Атрибуты тэга "element"

• type * - Определяет тип элемента. Возможные значения: text, textarea, select, radio, button, submit, reset, checkbox, captcha, file (елемент "file" добавлен в версии 1.0.1).
• label * - Определяет поясняющую надпись возле элемента.
• required - Если значение этого атрибута равно "required", то заполнение данного элемента будет обязательным для пользователя.
• regex - Значением этого атрибута может быть регулярное выражение для проверки правильности заполнения элемента, у которого назначен этот атрибут.
• error - Значением этого атрибута может быть текст сообщения об ошибки вызванной незаплнением элемента, у которого определен этот атрибут и атрибут required имеет значение "required", либо введенные данные не прошли проверку регулярного выражения.
• value - Значение этого атрибута является значением элемента по-умолчанию.
• class - Если этот атрибут не пустой, то элементу будет задан CSS класс из значения этого атрибута.
• multiple - Данный атрибут может использоваться только в элементе с типом: select. Определяет можно ли выбрать несколько вариантов значений. Возможные значения: multiple.
• width - Используется только в элементах типа: captcha. Определяет ширину изображения в пикселах. Возможные значения: целое число не менее 100.
• height - Используется только в элементах типа: captcha. Определяет высоту изображения в пикселах. Возможные значения: целое число не менее 50.
• onclick - Используется только в элементах типа: button, reset, checkbox. Определяет HTML атрибут onclick.
• onchange - Используется только в элементах типа: text, textarea, select. Определяет HTML атрибут onchange.
• extensions - Используется только в элементах типа: file. Определяет расширения файлов доступных для загрузки перечисленных через запятую. Например: gif, jpg, zip
• maxsize - Используется только в элементах типа: file. Определяет мексимальный размер загржаемого файла. Принимает значения в килобайтах и магабайтах. Например, чтобы задать максимальный размер загружаемого файла в 200 килобайт нужно написать: 200Kb. Для размера в 1 мегабайт: 1Mb.
• color - Используется только в элементах типа: captcha. Определяет цвет надписи в формате HEX. Если отсутствует - цвет генерируется случайным образом. (добавлен в версии 1.0.5)
• background - Используется только в элементах типа: captcha. Определяет цвет фона в формате HEX. Если отсутствует - цвет генерируется случайным образом. (добавлен в версии 1.0.5)

Атрибуты тэга "option"

• label * - Определяет поясняющую надпись возле элемента.
• value * - Определяет вариант значения элемента.
• selected - Если значение этого атрибута равно "selected", то данный вариант значения элемента будет отмечен по-умолчанию.
• onclick - Определяет HTML атрибут onclick.

Элемент "option" используется только как содержимое элемента "element" типа: select, radio, checkbox.

Внимание! Атрибуты, отмеченные знаком * являются обязательными атрибутами.

Обработка формы происходит в соответствии с требованиями указанными в параметрах элементов. Данные собираются по шаблону прописанному в языковом файле и отправляются на e-mail, указанный в настройках модуля формы.

Пример кода формы simpleForm2:

{form}
<p>{element label="Ваше имя" type="text" required="required" error="Введите ваше имя" /}</p>
<p>{element label="Ваше сообщение" type="textarea" required="required" error="Введите ваше сообщение" /}</p>
<p>
   {element label="simpleForm2 - это:" type="select"}
      {option label="Модуль" value="Модуль" /}
      {option label="Компонент" value="Компонент" /}
      {option label="Плагин" value="Плагин" /}
      {option label="Не знаю" value="Не знаю" /}
   {/element}
</p>
<p>{element type="submit" value="Отправить" /}</p>
{/form}

История изменений

• Исправлена ошибка связанная с обработкой нескольких елементов "file" с одинаковыми названиями.

• Добавлен элемент "form".
• Добавлен параметр "color" у элемента типа: "captcha".
• Добавлен параметр "background" у элемента типа: "captcha".

• Исправлена ошибка связанная с обработкой атрибута "onchange".

• Шаблон письма вынесен в файл шаблона.

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

• Можно вводить несколько e-mail адресов получателей писем
• Письма отправляются в формате HTML
• Письмо формируется из 2-х шаблонов. 1- общий шаблон письма. 2- шаблон каждой записи значения элемента формы.
• Добавлен новый элемент "file" - элемент позволяющий загружать файлы, которые прикрепляются к письму.

• Скачать модуль Joomla! simpleForm2 v.1.0.10. Для Joomla! 1.5.x
• Скачать модуль Joomla! simpleForm2 v.1.0.5. Для Joomla! 1.0.x