Обзоры расширений Joomla

 

 

В предыдущей статье «RSForm Joomla. Инструкция» мы начали рассмотрение свойств полей, которые предоставляет данный Joomla модуль формы. В этой части мы продолжим обзор тех свойств, которые не были рассмотрены ранее.

При написании статьи использованы материалы с официального сайта разработчика компонента.

Создание форм Joomla

Компоненты

Загрузка файла

Считаю, что RSForm Pro инструкция была бы не полной без рассмотрения всех полей. В частности, одним из наиболее интересных является Загрузка файла. Данное поле позволяет Вашим пользователям прикреплять файлы к отправляемым данным. Содержимое вкладок Основное и Проверка детальнее были рассмотрены в статье «RSForm Joomla. Инструкция». На вкладке Атрибуты (рисунок ниже) Вы сможете настроить специфические параметры поля Загрузка файла.

RSForm

  • Размер файла (Кб). Максимальный размер файла (в килобайтах), который пользователь может отправить пользователю. Он должен быть меньше или равняться максимально допустимому размеру загружаемого файла, указанного в настройках сервера. Если Вы не знаете это значение, то нажмите кнопку Диагностика настроек загрузки на сервер. Вы увидите нижеперечисленные параметры. Вас интересует значение Максимальный размер загружаемого файла. Оно указано в мегабайтах.

 

Загрузка файлов включена: Да

Временная директория задана: Да

Максимальный размер загружаемого файла: 20

Лимит памяти: 2M

 

  • Принимаемые файлы. RSForm Joomla 3.0 позволяет Вам указать расширения тех файлов, которые Вы хотите разрешить отправлять пользователям. Укажите каждое расширение с новой строки.
  • Назначение. Путь к папке на сервере, в которую будут загружаться файлы. Она должна быть доступна для записи.
  • Префикс файла (оставьте пустым для применения значения по умолчанию). Для того, чтобы избежать подмены файла RSForm Pro добавляет случайный префикс к имени файла. Вы можете указать своё значение префикса. Также Вы можете задать специальный PHP код для генерации случайных префиксов. Этот код необходимо вставить между тегами «//<code>» и «//</code>» (без кавычек). Например, «//<code> return $_POST['form']['name_field']; //</code>» (без кавычек).
  • Прикрепить файл к. Вы можете указать, к каким письмам будет прикреплён данный файл, помимо того, что он будет сохранён на сервере.

Заполнители поля Загрузка файла. «nazvanie_vashego_polya» – данные, которые Вы задали на вкладке Основное в поле Название.

  • {nazvanie_vashego_polya:value} – возвращает прямую ссылку на загрузку файла.
  • {nazvanie_vashego_polya:caption} – возвращает значение поля Подпись.
  • {nazvanie_vashego_polya:path} – возвращает URL прямого доступа к файлу. Может пригодиться для отображения загруженного изображения, например, «http://www.vash-sajt.com/put/k/papke-zagruzki/izobrazhenie.png» (без кавычек).
  • {nazvanie_vashego_polya:localpath} – возвращает локальный путь к файлу на сервере. Например, «/home/public_html/put/k/papke-zagruzki/izobrazhenie.png» (без кавычек). RSForm Pro позволяет использовать данный заполнитель совместно с PDF плагином добавляя загруженные файлы в качестве вложения в PDF.
  • {nazvanie_vashego_polya:filename} – возвращает имя загруженного файла точно так, как оно сохранено в базе данных.

Свободный текст

Свойства поля Свободный текст аналогичны полю Текстовое поле, которое было рассмотрено в статье «RSForm Joomla. Инструкция».

Календарь

Joomla модуль формы позволяет Вам размещать календарь для упрощения ввода дат на Вашем сайте. На вкладке Основное (рисунок ниже) в поле Значение по умолчанию можно добавить не только текст, но и свой собственный PHP код, который необходимо вставить между тегами «//<code>» и «//</code>» (без кавычек).

RSForm Pro

На вкладке Проверка в спадающем списке Модификатор даты (рисунок ниже) можно указать второе «связанное» поле Календарь. Например, Вы можете создать два поля Календарь на одной форме. Первое поле – дата начала события, второе – дата окончания события. Если для первого поля в спадающем списке Модификатор даты указать значение Выбранная дата 'kalendar 2' будет минимальной датой, а для второго поля Выбранная дата 'kalendar' будет максимальной датой, то пользователь сможет указать даты. «kalendar» и «kalendar 2» названия первого и второго календаря соответственно. Если в первом (дата начала) выбрать значение 02 апреля 2014, то во втором можно будет выбрать только даты после 02 апреля 2014.

Joomla модуль формы

На вкладке Атрибуты (рисунок ниже) Вы сможете настроить дополнительные параметры поля.

  • Формат даты. Формат даты в поле календаря. Например, если пользователь выбирает сегодняшнюю дату 02 апреля 2014, то «dd.mm.yyyy» (без кавычек) – 02.04.2014, «ddd.mmm.yyyy» (без кавычек) – Ср.Апр.2014, «dddd.mmmm.yyyy» – Среда.Апрель.2014. Вы можете менять местами день, месяц и год. Также можно заменить разделитель (точку).
  • Макет календаря. Доступно два варианта Плоский и Всплывающий. На рисунке ниже в верхней части показан плоский вариант, он виден на странице сразу, а в нижней – всплывающий вариант, он отображается тогда, когда пользователь нажмёт на кнопку рядом с полем ввода даты.

RSForm Joomla 3.0

  • Минимальная дата (мм/дд/гггг). Дата начала календаря. До этой даты пользователь не сможет ничего выбрать в календаре. Если Вы хотите, чтобы пользователь не смог указать дату ранее, чем текущий день, то введите в поле следующий код: «//<code> return date('m/d/Y'); //</code>» (без кавычек ёлочек).
  • Максимальная дата (мм/дд/гггг). Дата окончания календаря. После этой даты пользователь не сможет ничего выбрать в календаре.

RSForm Pro инструкция

  • Всплывающая метка. Если для опции Макет календаря Вы выбрали Всплывающий, то данная опция позволит указать, что именно должно быть на кнопке по нажатию на которую будет открываться календарь.

Также стоит отметить, что создание полей доступно и в других расширениях разработчика. Например, в RSMembership.

Кнопка

Данное поле похоже на поле Кнопка отправки, которое было рассмотрено в статье «RSForm Joomla. Инструкция».

Кнопка изображения

Компонент создания форм Joomla 2.5 - 3 позволяет задать в качестве кнопки растровое изображение. На вкладке Атрибуты (рисунок ниже) Вы сможете задать путь к изображению для кнопки. Данный элемент напоминает поле Кнопка отправки, которое было рассмотрено в статье «RSForm Joomla. Инструкция».

  • Кнопка изображения. Относительный путь к изображению для кнопки в формате «images/headers/blue-flower.jpg» (без кавычек).
  • Изображение кнопки сброс. Относительный путь к изображению для кнопки сброса данных формы. Например, «images/headers/blue-flower.jpg» (без кавычек).

Компонент создания форм Joomla 2.5

Антиспам КАПЧА

Отмечу, что на официальном сайте разработчика RSForm Pro инструкция доступна на английском языке. В ней Вы сможете найти описание каждого из полей.

Антиспам КАПЧА служит для размещения поля защиты от спама (капча). На вкладке Атрибуты Вы сможете найти ряд настроек, которые помогут сконфигурировать это поле. Хочу напомнить, что Joomla модуль формы разработан не только как функциональный, но и как безопасное, с точки зрения защиты от злоумышленников, расширение.

  • Длина. Количество символов на защитном изображении.
  • Генерация изображения. Тип капчи. Доступно три типа: Использовать свободный тип (на изображении будут размещены буквы и\или цифры разными шрифтами), Не использовать свободный тип (на изображении будут размещены буквы и\или цифры одинаковым шрифтом), Невидимый (не будет никакого изображения, а защита от роботов (ботов) будет происходить на основании данных о сессии).

Третий тип наиболее удобный для пользователей. Первый – наиболее сложный. На рисунке ниже показаны первые два типа сгенерированного изображения (при условии использования букв и цифр).

Генерация изображения

  • Цвет фона. Цвет фона изображения в формате «#FFFFFF» (без кавычек).
  • Цвет текста. Цвет фона изображения в формате «#000000» (без кавычек).
  • Тип. Если в качестве генератора изображения Вы указали Использовать свободный тип или Не использовать свободный тип, то данная опция позволит задать, какие символы выводить на изображении. Доступно три типа: Буквы, Цифры, Буквы и цифры. На рисунке выше показан третий тип.
  • Расположение. Можно задать горизонтальное или вертикальное расположение поля ввода капчи относительно изображения капчи. На рисунке выше показан горизонтальный пример, на рисунке ниже – вертикальный.

Вертикальный тип капчи

  • Отображать Обновить. Позволяет Вам задать кнопку Обновить, которой будет оснащено поле капчи Joomla модуль формы.
  • Текст обновления. Текст, который будет выводиться в качестве ссылки на обновление защитного изображения.
  • Размер. Размер шрифта символов на защитном изображении.

Скрытое поле

Данный тип поля служит для «технических» целей. Например, когда необходимо отправить с формой какие-то промежуточные данные, которые не должен видеть и изменять пользователь. Свойства этого поля аналогичны описанным ранее (для других полей).

Билет поддержки

Это скрытое поле, которое содержит «техническую» информацию, генерируемую случайным образом на основании настроек на вкладке Атрибуты. Настройки этой вкладки похожи на настройки поля Антиспам КАПЧА.

Разделитель страницы

Joomla модуль формы RSForm Pro позволяет Вам создавать многостраничные формы. Специально для этого служит поле Разделитель страницы. Разместите его на форме и при помощи мыши переместите под то поле, после которого Вы хотите, чтобы форма разделялась на страницы. Частично свойства этого поля были рассмотрены в статье «RSForm Joomla. Инструкция».

Разделитель страницы

Опция Проверять при смене страницы?, на вкладке Атрибуты (рисунок выше) указывает на то, что RSForm Pro должен проверять введённые пользователям данные тогда, когда он переходит на другую страницу.

Поле дня рождения

В RSForm Joomla 3.0 Вы можете разместить Поле дня рождения на своей форме. На вкладке Проверка (рисунок ниже) доступна специальная проверка для этого поля.

  • Разрешить неправильные даты (например, 31 Фев 2013). Включив данную опцию, Вы разрешите пользователям указывать несуществующие даты. Например, день месяца, который не существовал в указанный год.
  • Правило проверки. Содержит пять параметров: Без проверки, Начиная с сегодня (включая сегодня), Начиная с завтра, До сегодня (исключая сегодня), До сегодня (включая сегодня). Эти правила могут понадобиться, например, если Вы не хотите разрешать пользователям указывать ложную информацию об их дне рождения с целью получения выгоды. Например, недавно зарегистрировавшийся на сайте кинотеатра пользователь, указывает сегодняшнюю дату своего рождения для получения скидки или бесплатных билетов на сеанс.

Проверка поля дня рождения

На вкладке Атрибуты (рисунок ниже) Вы сможете найти дополнительные опции по настройке данного поля.

  • Порядок сортировки полей. Можно указать, в каком порядке будут отображаться поля День, Месяц и Год на форме.
  • Разделитель даты. Знак разделителя между днём, месяцем и годом рождения. Отображается в отправленных данных.
  • Отображать выбор дня. Активировав данную опцию, RSForm Pro будет отображать выбор конкретного дня рождения.
  • Поля Отображать 'Пожалуйста выберите' при выборе дня – оставьте пустым для того, чтобы не отображать надпись; Отображать 'Пожалуйста выберите' при выборе месяца – оставьте пустым для того, чтобы не отображать надпись и Отображать 'Пожалуйста выберите' при выборе года – оставьте пустым для того, чтобы не отображать надпись схожи. Если задать в них какое-то значение, то оно будет показано в спадающем списке соответствующего временного указателя (дня, месяца или года). Если ничего не указывать, то в спадающем списке будет показано фактическое начальное значение поля. Например, «01» (без кавычек) для дня и месяца.
  • Отображение дня. Можно отображать число дня рождения в формате «01» (без кавычек) (опция Число с нулём в начале (01)) или в формате «1» (без кавычек) (опция Число без нуля в начале (01)).
  • Отображать выбор месяца. Активировав данную опцию, RSForm Pro будет отображать выбор конкретного месяца рождения.
  • Отображение месяца. Можно отображать месяц дня рождения в формате «01» (без кавычек) (опция Число с нулём в начале (01)) или в формате «1» (без кавычек) (опция Число без нуля в начале (01)), или в формате «Янв» (без кавычек) (опция Коротко (Янв)), или в формате «Январь» (без кавычек) (опция Полностью (Январь)).
  • Отображать выбор года. Активировав данную опцию, RSForm Pro будет отображать выбор конкретного года рождения.
  • Опции Начальный год и Конечный год позволяют задать первый и последний годы соответственно, которые сможет указать пользователь.
  • Хранить ноль вначале Дня/Месяца?. Компонент создания форм Joomla 2.5 – 3 позволяет вам сохранять дни и месяцы в базе данных с или без нуля вначале не зависимо от того, что именно видит и указывает пользователь.

Атрибуты поля дня рождения

Карты Google

Для упрощения указания адреса Вы можете разместить карту Google на своей форме. На вкладке Атрибуты (рисунок ниже) Joomla модуль формы RSForm Pro предоставляет Вам некоторые настройки данного поля.

Атрибуты Карты Google

  • Ширина карты и Высота карты. Позволяет указать ширину и высоту области карты на форме. В пикселях. Например, «700px» (без кавычек).
  • Центр карты. Координаты центра карты по умолчанию. Широта и долгота. Например, «50.005751,36.229118» (без кавычек).
  • Масштаб карты. RSForm Joomla 3.0 позволяет задать начальный масштаб карты.
  • Включить поиск геолокации. Если данная опция включена, то компонент создания форм Joomla 2.5 – 3 попытается самостоятельно определить местоположение пользователя.
  • Выходной результат. В каком формате будут отображаться данные, когда пользователь перемещает маркер на карте. Адреса – «Кооперативная улица, 23, Харьков, Харьковская область, Украина» или Координаты «50.005751,36.229118».
  • Размер. Размер поля ввода в символах.

За один товар

RSForm Joomla 3.0 позволяет Вам организовать внесение денежных средств в качестве пожертвования, оплаты товаров или услуг. Поля За один товар, За несколько товаров, Пожертвование, Всего и Выберите платёж доступны только в том случае, если Вы установили и активировали системный плагин RSForm Pro Payment.

Рассмотрим работу данного поля на небольшом примере. Вы создали форму, на которой разместили некий товар и поле За один товар. На вкладке Атрибуты (рисунок ниже) поля За один товар можно внести стоимость этого товара, опция Цена и указать, нужно или нет отображать это поле во фронтальной части сайта посетителям. Опция Отображать во фронтальной части сайта?. По умолчанию, валюта берётся из настроек RSForm Pro, которые мы рассмотрим в статье «Настройка RSForm Pro».

Атрибуты За один товар

Отмечу, что данное поле не обязательно отображать пользователю. Цену можно указать и при помощи других средств. Это поле служит больше для «технических» целей. По сути, благодаря ему RSForm Pro понимает, что по нажатию на кнопку отправки данных необходимо не только отправить данные в базу данных, но и перенаправить пользователя к оплате покупки с нужной ценой, которая указана в атрибутах поля За один товар.

В следующей статье «RSForm Pro для Joomla 2.5 - 3» мы закончим рассмотрение полей и их свойств, в частности коснёмся платёжных полей и полей для интеграции компонент создания форм с RSEvents Pro. Надеюсь, что данная RSForm Pro инструкция будет Вам полезна.

Отмечу, что данный компонент очень большой. Рассмотреть все его возможности и тем более варианты применения практически не реально.

 

Полезные ссылки: