Рейтинг: 4.0/5.0 (1903 проголосовавших)Категория: Инструкции
Качество веб-сайта и его юзабилити во многом зависят от того, смогут ли его будущие посетители без труда связаться с администрацией или менеджерами.
Безусловно, можно воспользоваться возможностью отправки письма на электронную почту, указанную в контактах. Но этот способ слишком долгий и неудобный, особенно если речь идет о небольшом вопросе, рекомендации или замечании.
В этой связи представляется логичным использование формы обратной связи.
Сущность и значение формы обратной связи для JoomlaФорма обратной связи представляет собой удобный инструмент для отправки сообщений администрации сайта.
Эта небольшая, но крайне значимая деталь современных сайтов не приводит к созданию излишнего веса страницы и не связана с написанием значительного числа громоздких скриптов.
Система управления контентом (CMS) Joomla 3 позволяет создать форму обратной связи, которая имеет следующие преимущества:
Когда пользователь отправляет администрации письмо через данный компонент оно автоматически приходит на электронный ящик владельцев сайта.
По сути, весь процесс работы формы обратной связи можно представить в виде двух этапов:
Важно отметить, что подобная форма может состоять из произвольного количества полей различного назначения. При этом такие поля, как «E-mail », «Имя », «Тема » и «Сообщение » являются обязательными.
Процесс создания формы обратной связи в Joomla 3. пошаговая инструкцияСтандартный функционал CMS Joomla 3 позволяет создать форму обратной связи, без установки дополнительных расширений. Это значительно упрощает задачу формирования этого важного модуля на любом сайте.
В этой связи, приведенная ниже инструкция может оказаться полезной даже для любителей, которые не в полной мере знакомы с тонкостями программирования.
Целесообразно детально рассмотреть каждый из этапов создания формы обратной связи на Joomla 3 .
Шаг 1.В админ-панели Joomla 3 следует открыть меню «Компоненты » и перейти на вкладку «Контакты »:
В открывшемся окне следует нажать кнопку «Создать », после чего появится форма с пустыми полями. Здесь нужно указать все необходимые данные.
В частности, поля «Имя », «Категория » и «Связанный пользователь » являются обязательными для заполнения. Кроме того, можно указать следующие контактные данные: «Должность », «Почтовый ящик », «Город », «Сайт », «Телефон » и т.д.
На вкладке «Дополнительная информация » можно разместить дополнительные контактные данные, например схему проезда, или график работы, которые могут иметь важное значение для пользователей формы обратной связи:
На вкладке «Параметры публикации » представляется возможным указать дату начала и конца публикации, а также прописать мета-описания и мета-тег «разрешить/запретить » индексацию страницы:
На следующей вкладке – «Настройки отображения » можно выбрать, какие контактные данные необходимо публиковать на странице, поскольку по умолчанию опубликуются все указанные данные.
Здесь же следует установить формат отображения формы обратной связи Joomla 3 .
Следует подчеркнуть, что всего доступно три варианта отображения:
На последней вкладке «Настройки отображения контактов » можно настроить блокируемые темы и почтовые ящики, а также активировать пункт «Отправить копию письма на почту отправителя »:
После того как указаны все необходимые данные, нужно сохранить контакт:
После сохранения необходимо сформировать пункт меню для созданного контакта. Для этого нужно перейти в раздел «Меню » и выбрать в нем «Главное меню », затем вкладку «Создать пункт меню »:
В появившемся окне нужно привязать отдельный пункт меню к главному или вертикальному меню, которое обычно располагается в левом или в правом блоке админ-панели Joomla 3 :
В качестве типа пункта меню необходимо выбрать раздел «Контакты »:
После установки типа пункта меню, появится поле «Выбор контакта ». В нем нужно выбрать созданный на предыдущих этапах контакт (в данном случае – Администратор).
Важно подчеркнуть, что вкладки «Параметры отображения контактов » и «Параметры почты », копируют настройки вкладок «Настройки отображения » и «Настройки отображения контактов » соответственно:
На вкладке «Параметры отображения ссылки » прописывается поле «Заголовок, как ссылка », которое является пользовательским описанием данного пункта меню. Впоследствии данное описание будет отображаться при наведении курсора на пункт меню.
Также можно придать пункту меню свой класс CSS. если требуется его уникальное оформление. Данный пункт не является обязательным:
После завершения описанных выше операций можно настроить параметры отображения страницы, а именно теги title и h1 данной страницы.
Эту вкладку также можно пропустить, в этом случае заголовок будет отображать название страницы, в данном случае – «Обратная связь»:
На вкладке «Метаданные » указываются мета теги Description и Keywords веб-страницы. По сути, эта вкладка повторяет настройки раздела «Параметры публикации », который открывается в окне создания контактов.
После заполнения всех необходимых полей, нужно сохранить созданный пункт меню и обновить страницу сайта.
Таким образом, меню (в данном случае главное меню) пополнится еще одним пунктом – «Обратная связь », как показано на рисунке ниже:
Если все предыдущие шаги были выполнены верно, то на странице обратной связи появятся две или три вкладки (в зависимости от наличия данных заполненных на 3-ем шаге):
Таким образом, форма обратной связи для Joomla 3 создана. Её отображение может иметь вид сворачивающихся списков, что устанавливается по умолчанию, либо вид вкладок.
Кроме того, в образовавшемся компоненте все элементы могут быть открыты или частично скрыты, при выборе формата отображения «Обычный »:
Таким образом, создание формы обратной связи не требует больших усилий, но при этом формирует весьма значимый и полезный модуль системы Joomla 3.
Помните, что свободная связь посетителей сайта с его администрацией – основа положительной репутации любого веб-сайта, а повышение юзабилити – гарантия достижения высоких позиций в поисковых системах.
06 мая 2014 в 16:41
Мне нужно сделать казалось бы банальную задачу, но никак не могу допереть как. Перерыл уже весь интернет и форум, но не смог найти ответ на свой вопрос. Помогите, пожалуйста!
Что имеем: Сайт лендингпейдж на joomla 3
Задача:
На сайте в разных блоках должны находиться кнопки "Заказать", "Обратный звонок", "Консультация" и т.д. При нажатии на них должно появляться модальное окно с простой формой (для каждого случая своей) которая будет просить ввести номер телефона или адрес e-mail. После ввода данных и нажатия кнопки "ОК" должно отправиться письмо на адрес сайта с этими данными. Таких примеров куча, на всех лендингах так реализован заказ.
К сожалению, только пару дней назад познакомился с CMS joomla, но задача стоит именно такая. До этого работал в основном с drupal.
Что я нашел:
ставил разные расширения: Quickform, ChronoForms, но не смог сделать так как нужно. Не до конца понимаю принципы работы джумлы, а разбираться нет времени. Получается вывести форму на отдельную страницу, а так что бы в открывающемся окне - нет
Раньше думал что для джумлы есть очень много готовых расширений и такая задача кажется очень распространенной, но ничего не могу найти.
Помогите, кто знает как
41792 / 34177 / 6122
04.12.2014, 13:36 Форма обратной связи во всплывающем окне
После регистрации реклама в сообщениях будет скрыта и будут доступны все возможности форума.
Записей в блоге: 1
04.12.2014, 13:46 Форма обратной связи во всплывающем окне
1. Берём модуль наподобие PWeb AJAX Popup Contact Form. Именно этот платный, но отдав в своё время 10 евро за него я не пожалел ни разу ещё.
2. Создаём 3 таких модуля (по количеству нужных РАЗНЫХ кнопок), в настройках модулей пишем слова, которые будут отображаться на кнопке во фронтэнде и выводим каждый из них в несуществующей позиции. Обычно позиции называюстся position-1, position-2, footer, header и т.д. А тут пусть будет позиция knopka-zakaz, knopka-consult и т.д. Чтоб были уникальные имена, не встречающиеся в шаблоне.
3. В нужном месте в материале прописываем
4. Если отображается на главной не материал, а компонент, то тогда прописываем позиции в index.php шаблона.
Таких модулей можно вывести хоть 100 на одной странице. А де факто их будет 3 разных. Модуль можно использовать как Call Back кнопку, отправлять сообщения определенному юзеру, на список мыл и т.д.
Могу привести пример, где у меня этот модуль работает в трёх ипостасях.
Joomla forms and extensions, инструкция teka ir 641 wordpress forms pluginиюлв этой статье рассмотрены случаи, когда joomla не инструкция для kyocera fs 1118mfp отправляем.
quickform joomla инструкция quickform id 1 social like. Инструкция на процессор рефустановки mitsubishi образец годового.
Обратной связи quickform. 9 сенкомпонент quickform простой и удобный.
Кроме quickform joomla инструкция того, создание сайта– сложное дело, и техническая сторона только часть уравнения, поэтому, пожалуйста, не присылайте мне жалобы типа: чувак, твоя инструкция отстой если ваш сайт выйдувполесконем точка ком.
For more information, please visit этом посте будет приведен пример, того, почему joomla сейчас является, одной из наиболее качественных cms. частушки для. Генератор форм для сайтов.
Компонент форм для joomla с функцией. электропила парма 2м инструкция.
Быстрый, и удобный. Или используя инструкцию quickform id хх для плагина, где хх.
Quickform форма с функциями калькулятора и зависимыми полями.
QuickForm - компактный и быстрый компонент форм для сайтов на движке Joomla. включает функционал калькулятора и зависимых (связанных) полей. Особенным достоинством QuickForm является удобный интерфейс, позволяющий создавать сложные формы в несколько кликов, а также уникальный функционал клонирования групп полей любой структуры и вложенности. Компонент строит роботозащищенные формы, система защиты от спама позволяет обходиться без капчи. Имеется статистика (история) заказов по каждому отправлению формы джумла.
QuickForm будет удобно использовать как для простой контактной формы или калькулятора джумла, так и для сложных динамичных форм, включающих множество различных наименований и разветвленных групп полей. Интерфейс нативно понятный, но если появятся вопросы, ниже указана ссылка на форум, где можно спросить и посмотреть ответы других пользователей.
Пример: Заказать форму на команду УстановкаУстановочный пакет компонента форм включает сам компонент форм, модуль и плагин группы контент. Для вывода формы джумла в материал просто вставьте инструкцию
Скачать и посмотреть компонент форм джумла QuickForm можно по ссылке.
Совместимость Joomla! 3+, Joomla! 2.5+
Компонент форм джумла сделан простым и компактным, всплывающие подсказки помогут вам быстро разобраться в его интерфейсе. Если все-же возникнут вопросы, их можно задать на форуме http://joomlaforum.ru/index.php/topic,228015.0.html
Обратная ссылка на автора
Компонент QuickForm распространяется свободно по лицензии GNU GPL. В настройках компонента вы сможете выбрать вариант отображения обратной ссылки: видимая. скрытая. без ссылки. В последнем случае вам понадобится ввести код, простое удаление обратной ссылки из файлов приведет к неработоспособности расширения. Здесь вы сможете получить код.
Введите EMAIL на который будет выслан код *
Введите домен который нужно активировать *
В предыдущей статье «RSForm. Формы для Joomla » мы рассмотрели основные возможности RSForm Pro, а также затронули вопрос непосредственного создания форм при помощи мастера. В этой статье поговорим о полях форм и их свойствах. Материал представлен как некая инструкция RSForm Pro.
Отмечу, что все описанные здесь, и в других частях цикла, приёмы относятся к Joomla 2.5 – 3. При написании статьи использованы материалы с официального сайта разработчика компонента.
Создание форм Joomla КомпонентыУ каждого элемента формы есть свойства. Для разных элементов они могут повторяться. Не будем рассматривать одинаковые свойства разных полей несколько раз.
Текстовое полеРассмотрим элемент Текстовое поле . При помощи него пользователь сможет вводить данные в строку ввода. Свойства текстового поля разделены на три вкладки:
Рассмотрим каждую из них более детально. На вкладке Основное (рисунок ниже) расположены следующие поля:
На рисунке ниже показано, где именно во фронтальной части будет отображаться тот или иной текст из свойств объекта.
Под номером 5 расположен элемент «(*)» (без кавычек), который свидетельствует о том, что пользователь обязательно должен заполнить данное поле. Без этого информация не будет отправлена.
RSForm Pro может проверять данные, которые вводит пользователь в формы для Joomla 2.5 – 3. На вкладке Проверка (рисунок ниже) Вы можете настроить соответствующие параметры.
Рассмотрим более детально правила проверки, которые помогут Вам при настройке формы Joomla 3.
Для некоторых правил проверки будет доступно поле Дополнительно принимаемые символы. В него Вы сможете задать символы, которые разрешены для ввода. Это своего рада исключение из правил. Например, выбрав правило Буквы и задав в поле Дополнительно принимаемые символы пробел, можно будет включить проверку на поле «ФИО», и тогда пользователь сможет ввести в одну строку свою фамилию, имя и отчество через пробелы между словами, а RSForm - проверить, чтобы в этих данных были только буквы.
На вкладке Атрибуты (рисунок ниже) Вы сможете настроить дополнительные параметры поля для формы Joomla 3.
Рассмотрим другие поля формы с учётом их уникальных свойств, отличных от поля Текстовое поле. Также стоит отметить, что создание полей доступно и в других расширениях разработчика. Например, в RSMembership .
Текстовая областьПозволяет разместить на форме область для ввода большого количества текста. На вкладке Атрибуты (рисунок ниже) Вы сможете найти параметры Столбцов и Рядов. которые помогут Вам указать размер текстовой области в строках и столбцах.
Опция Включить WYSIWYG редактор позволяет включить или отключить визуальный редактор, при помощи которого, пользователи смогут оформлять свои ответы.
Позволяет создавать выпадающие списки для Вашей формы Joomla 3. В свойствах поля на вкладке Основное Вы сможете задать элементы, которые необходимо выводить в выпадающем списке (рисунок ниже).
Каждый элемент списка нужно вводить с новой строки. Например, если ввести:
RSForm Joomla 2.5
RSForm Joomla 3.0
RSForm Joomla 3.1
RSForm Joomla 3.2
тогда и в спадающем списке пользователь увидит вышеперечисленные элементы в том же порядке, сможет выбрать любой из них, и по умолчанию будет показан элемент «RSForm Joomla 1.5». Также после отправки данных Вы увидите именно то, что указал пользователь. Например, если он указал «RSForm Joomla 2.5», то и в отправленных данных Вы увидите именно «RSForm Joomla 2.5». Рассмотрим вариант списка, указанный на рисунке выше, то есть:
Компонент RSForm Pro|Купить[d]
RSForm Joomla 1.5
RSForm Joomla 2.5
RSForm Joomla 3.0
RSForm Joomla 3.1
RSForm Joomla 3.2
В случае «RSForm|Инструкция RSForm» пользователь, во фронтальной части сайта увидит надпись «Инструкция RSForm», а не «RSForm», но если он выберет «Инструкция RSForm», то в отправленных данных Вы увидите значение «RSForm». Именно оно будет сохранено в базе данных.
В случае «Компонент RSForm Pro|Купить[d]» пользователь не сможет выбрать «Купить», так как для строки задан параметр «[d]» (без кавычек). Он означает, что данная строка будет показана в списке, но её нельзя выбрать.
В случае «RSForm Pro|Формы Joomla 3[c]» строка «Формы Joomla» будет установлена в спадающем списке по умолчанию, так как для строки задан параметр «[c]» (без кавычек). Он означает, что данная строка будет установлена в спадающем списке по умолчанию.
Отмечу, что можно задавать параметры «[c][d]». Это означает, что строка будет установлена в спадающем списке по умолчанию и её нельзя будет выбрать.
В случае с «RSForm Joomla[g]» пользователь увидит надпись «RSForm Joomla» в качестве заголовка (жирный курсив) для списка из элементов (рисунок ниже):
RSForm Joomla 1.5
RSForm Joomla 2.5
RSForm Joomla 3.0
RSForm Joomla 3.1
RSForm Joomla 3.2
Таким образом можно группировать элементы.
Если Вы используете заменители для вставки в письма или сообщения о благодарности, то учитывайте, что вместо заменителя будет вставлено подпись поля, а не фактически выбранное значение выпадающего списка.
На вкладке Атрибуты (рисунок ниже), при помощи опции Множество. Вы можете разрешить пользователям выбирать несколько значений из выпадающего списка формы Joomla 3. Это происходит путём зажатия на клавиатуре клавиши «CTRL» или «SHIFT» и нажатием мышью на тот или иной элемент списка.
RSForm Joomla позволяет Вам размещать на форме группу чекбоксов. Настройка элементов аналогична полю Выпадающий список. рассмотренного выше, за исключением того, что для чекбоксов не предусмотрен параметр «[g]» (группировка). На вкладке Атрибуты (рисунок ниже) Вы можете задать расположение чексбоксов (горизонтально или вертикально).
Данное поле аналогично полю Группа чексбоксов. рассмотренного выше.
Кнопка отправкиЭто обязательный элемент любой формы. Без этой кнопки пользователь не сможет завершить заполнение формы. Вернее, не сможет отправить данные.
На вкладке Атрибуты (рисунок ниже) Вам будут доступны следующие опции.
Все свойства данного поля были описаны выше в статье.
Кстати говоря, аналогичные поля и настройки полей используются в компоненте создания универсальных каталогов товаров и услуг RSDirectory .
В следующей части статьи «RSForm Pro инструкция » мы продолжим рассмотрение свойств различных полей. Например, таких: Загрузка файла, Свободный текст, Календарь и так далее.
0: 2004 3: 8.
Средняя оценка: 5 Всего проголосовало: 1
Feature: unstable: stable: 20160514: 20140826: 20121221: 12 opensourcecms. 1: 12 com is a central resource for all things related to open source cms and gives you the opportunity try out most of best tools in. 0: 11 selection des meilleurs cours, tutoriels, exercices, conseils et bonnes pratiques pour apprendre a programmer sites web dynamiques en langage php. 2: 11 новый детский лагерь национальной гвардии украины под киевом «променистий» или «лучистый. 0: 10 бюро переводов «терра» санкт-петербург, митрофаньевское шоссе, д. 1: 2008 2 к. 0: 2007 1, бц «адмирал»оф. 0: 2006 218 график смен, стоимость продажа путевок в аккорд пуще-озерной, киев на. 1: 2006 строительство домов ключ волгограде, готовым индивидуальным проектам. 0: 2005 11-current: 10-stable: 10. 1: 2005 3: 9. 0: 2004 3: 8. 3: 2004 2: 7. 2: 2004 4: 6. 1: 2004 4: 5. 0 5: 4. N/A Советское Заполярье - Общественно-политическая газета Тазовского района ЯНАО Детский центр «Алые паруса», Семейный Клуб Развития Личности, Уфа, раннее развитие Д оработка и расширение сайта это комплекс работ, направленных на увеличение прибыли от 11: 3. Отправление 5: 2. Прибытие место 2. Выезд обратно 8: feature; release date: 2016-08-11: 2016-04-04: 2014-07-15: 2013-06-09.
Многие ценят простоту в том, что в итоге может оказаться довольно полезным и функциональным приспособлением. Так и компонент QuickForm. сначала очень легок во всех планах, даже в настройке, но потом дает возможность использовать очень непростые формы для заполнения, с анимацией, дополнительными критериями под информацию и еще много чем другим. Основная черта, которая используется тут и на которую делается упор – это всплывающие поля, возможность использования системного калькулятора, изображений и подписей.
Простое начало наряду с грандиозным продолжением!
Изначальный вид формы для регистрации, который появляется перед посетителем, практически ничем не отличить от всех остальных. Но, в результате потихоньку заполняя поля, нужно будет выбирать подпункты из выпадающих мини-меню, после чего на экране красиво нарисуются дополнительные формы. Сюда можно будет вписать что угодно, причем такая система очень даже подойдет для продаж и вот почему. Дело в том, что компонент QuickForm настраивается настолько тонко, что пользователь может уточнять через регистрационную форму любую информацию. Как пример, изначально вводится простая информация с именем и почтой, потом, можно выбирать различные категории, если это касается продаж. К тому же, эти категории товара можно добавлять, сколько нужно, собственно, как и товаров в такое же поле ниже. После этого, перед покупателем появляется ваша подпись с каким-либо текстовым наполнением и картинка выбираемой вещи. Еще немного ниже – размеры, цвет, и даже места, где можно прописать, какую именно надпись вы хотите видеть на одежде. В итоге к товару выводятся подсчеты общей цены, сюда же можно прикрепить файл, если есть такая необходимость, и указывается тип доставки. Что самое интересное, данный пример всего один, а реализовать удастся миллион идей!
Совершенствует элементарные вещи до сложных систем!
С таким подходом, несложно догадаться, что к вам в руки попадает очень серьезный инструмент, потому скачать компонент QuickForm стоит для того, чтоб иметь, в случае потребности, и простую форму регистрации на сайте, и подробную систему вкладок, которые легко могут организовать для посетителя процесс покупки или заказа какой – либо услуги!
Пример формы заказа товара созданный с помощью компонента QuickForm.
Добрый день!
Поставил компонент QuickForm в Joomla! 3, создал форму, настроил отображение, но на страницах где она должна быть - только надпись "not found", не подскажете в какую сторону копать?
Здравствуйте! Компонент установил, проверил все прекрасно работает. В настройках компонента нужно создать, настроить нужную форму и запомнить id. Далее в менеджере модулей создать модуль или использовать существующий mod_quickform. установить id, указать позицию и назначить нужные страницы для отображения. Проверьте активирован ли плагин компонента.
Добрый день!
Поставил компонент QuickForm в Joomla! 3, создал форму, настроил отображение, но на страницах где она должна быть - только надпись "not found", не подскажете в какую сторону копать?
| Статьи о PHP | Формуляры на все случаи жизни
Формуляры на все случаи жизниВ настоящее время редкое веб-приложение обходится без форм. Наверное, каждый разработчик потратил много времени, вставляя повторяющиеся комбинации html-тегов. Написание функций проверки данных также занимает некоторое время. Как вам кажется, наверное, неплохо бы эту работу автоматизировать? Как раз для этого и был задуман HTML_QuickForm. В этой статье мы расскажем о том, как этот пакет поможет вам избавиться от рутинной работы и при это придаст вашим приложениям более профессиональный вид.
Формы — это один из краеугольных каменей любого веб-приложения. Они являются связующим звеном между пользователем и приложением (или базой данных). Часто программист имеет дело с одной и той же последовательностью действий: размещение формы на странице, заполнение формы пользовательскими данными, их проверка, и, наконец, дальнейшая обработка (например, сохранение данных в базе или генерация на их основе нового формуляра). В этой ситуации многие неоправданно усложняют себе жизнь, программируя заново бесконечное количество функций для каждой формы. Однако не стоит каждый раз изобретать колесо. QuickForm предлагает быстрое и удобное решение для выполнения почти всех рутинных операций, с которыми сталкивается программист. Этот класс, а точнее библиотека классов, содержит большое количество функций, пригодных не только для создания формы, но и для проверки и обработки пользовательских данных.
При написании этой статьи мы пользовались версией 3.2 Примеры кода должны функционировать во всех версиях 3.х. Для установки QuickForm можно воспользоваться командой pear install HTML_QuickForm. К тому же вам потребуется установить еще одни пакет - HTML_Common. Существует альтернативный способ установки: необходимо загрузить tgz-архив с адреса pear.php.net/package/HTML_QuickForm и выполнить команду pear install HTML_QuickForm-3.2.tgz. На этой странице вы так же сможете найти подробный справочник по классам и функциям QuickForm.
Первый шагДля того, чтобы продемонстрировать основные функции QuickForm, создадим маленькую форму-пример, с помощью которой пользователь может подписаться на одну или несколько новостных лент. Для этого он должен указать полное имя, дату рождения и e-mail. К тому же мы хотим узнать хобби, которым занимается посетитель на досуге, а так же информацию о новостных лентах, на которые он хотел бы подписаться. Полный вариант кода формы, вы можете найти в листинге 1 .
Рисунок 1. (Первая форма)
Для генерации нового формуляра нам прежде всего необходим объект класса HTML_QuickForm. Вот как мы его создаем:
<?php
require_once( 'HTML/QuickForm.php' );
$form = new HTML_QuickForm ( 'mainForm'. 'post' );
?>
В качестве первого параметра конструктор принимает имя формы, которое помещается в html-тег form. В качестве следующего параметра мы должны указать каким способом (POST или GET) пользовательские данные будут обратно возвращены в скрипт. В качестве третьего параметра можно указать url-адрес, куда будут посылаться данные. Обычно этот параметр оставляют пустым, поскольку данные возвращаются в тот же самый скрипт, где была сгенерирована форма. Все выгоды подобного подхода мы увидим ниже. А теперь добавим пару элементов на нашу форму. Для этого воспользуемся функцией addElement().
<?php
$form -> addElement ( 'header'. 'myHeader'. 'Подписаться' );
$form -> addElement ( 'text'. 'firstName'. 'Имя:' );
$form -> addElement ( 'checkbox'. 'inMailList'. 'Подписаться на рассылку:' );
?>
Она принимает, как минимум, три параметра: тип элемента, его имя (идентификатор), строку символов (метку), которая показывается рядом с элементом. В качестве типа может быть указан любой известный элемент html-формы. В этом примере мы используем элементы text (строка ввода) и checkbox (флажок). Элемент header представляет собой псевдоэлемент QuickForm, предназначенный для создания заголовков, которые улучшают внешний вид формы и помогают группировать элементы.
В нашем примере мы так же хотим узнать дату рождения пользователя. Если бы мы пользовались только чистым html/php при создании соответствующего поля, нам пришлось бы потратить много времени и написать объемный кусок кода. Для решения этой задачи с помощью QuickForm мы можем воспользоваться элементом date, который автоматически преобразовывается в три поля select, предназначенных для выбора дня, месяца и года. В этом случае функции addElement() нужно передать ассоциативный массив в качестве четвертого параметра:
<?php
$form -> addElement ( 'date'. 'birthday'. 'Дата рождения:'. array( 'format' => 'd-F-Y'. 'language' => 'ru'. 'minYear' => 1900. 'maxYear' => 2000 ));
?>
Как видите, наряду с форматом даты и языком, мы указываем временной интервал для года. Язык необходим для поля выбора месяца, где перечисляются названия месяцев в полной или краткой форме. Формат даты QuickForm совместим с форматом php-функции date(). Подробную информацию о ней смотрите в мануале php.
Перед тем, как разместить формуляр на странице, присвоим некоторым элементам стандартные значения. На практике их источником часто является база данных или конфигурационный файл. в QuickForm применяется другой принцип. Для присвоения стандартных значений элементам необходимо создать ассоциативный массив в форме: ElementName => Value. Массив передается функции setDefaults(). Таким же образом можно присвоить элементам константные значения. В этом случае массив должен передаваться функции setConstants(). Константные значения отличаются о стандартных тем, что они не могут изменяться в ходе дальнейшего выполнения скрипта. Обратите внимание на то, что подобное значение является константным только в теле php-скрипта. Поскольку поле формы отображается на странице, пользователь может изменить его значение.
Создаем новые элементыКласс HTML_QuickForm управляет всеми элементами формы. Отдельный же элемент является объектом класса HTML_QuickForm_Element. Если возникает потребность в изменении параметров уже созданного элемента формы, прежде всего необходимо получить ссылку на него с помощью getElement(). В нашем примере мы изменяем внешний вид элемента select.
<?php
$select = & $form -> getElement ( 'newsletter' );
$select -> setSize ( 4 );
$select -> setMultiple ( true );
?>
До этого момента мы исходили из того, что каждый элемент существует сам по себе. Однако часто требуется объединить несколько элементов в логический ряд. Чаще всего в группы объединяются элементы checkbox и radio-кнопки. Для того, чтобы объединить отдельные элементы в группы, прежде всего мы должны создать ассоциативный массив, содержащий элементы, входящие в данную группу. С этой целью мы воспользуемся функцией createElement().
<?php
$checkbox = array();
$checkbox [] = HTML_QuickForm. createElement ( 'checkbox'. 'garden'. null. 'Gartenarbeit' );
.
$form -> addGroup ( $checkbox. 'hobby'. 'Ihre Hobbys:'. '' );
?>
В данном примере, при создании нового элемента checkbox, мы передаем конструктору четвертый параметр. Речь идет о тексте, отображаемом рядом с флажком. Впрочем, не стоит удивляться, что количество и характер параметров конструктора различны для каждого элемента формы. Функции addElement() и createElement() принимают только один основной параметр - тип элемента, в зависимости от него выбирается соответствующий класс (каждый элемент представляет собой отдельный класс, производный от HTML_QuickForm_Element), в конструктор которого и передаются остальные параметры.
Обработка данныхТеперь мы подошли к тому моменту, когда у нас уже есть простой экземпляр готовой формы, куда пользователь может вводить данные. При нажатии на кнопку ОК, данные посылаются обратно в скрипт. Но как же мы получим к ним доступ? Посмотрите на последние строчки кода из листинга 1:
<?php
if ( $form -> validate ()) <
$form -> process ( 'process_data'. false );
> else <
$form -> display ();
>
?>
Форма, созданная с помощью с помощью QuickForm, имеет два состояния: либо она еще не отображена, либо пользовательские данные заполненной формы посылаются в скрипт на обработку. Во втором случае необходимо дополнительно различать: прошли ли данные проверку или нет. Функция validate() позволяет узнать состояние, в котором находится форма. Если она отображается впервые, функция возвращает false, а форма может быть прорисована в браузере при помощи display(). Функция возвратит то же значение (false), если данные формы уже были посланы в скрипт-обработчик, но не прошли проверку. В этом случае пользователь снова должен ввести некоторые данные, поэтому форма, дополненная сообщениями об ошибках, должна отобразиться еще раз. Только в том случае, если проверка пользовательских данных прошла успешно, функция validate() возвратит true. Затем данные могут пройти дальнейшую обработку внутри скрипта. Мы написали особую функцию process_data(), которая выводит последовательно все пользовательские данные в браузер. Теперь вы можете немного попрактиковаться.
Фильтры и правила проверки данныхЧасто веб-приложение сохраняет данные в базе, причем они могут не только не соответствовать действительности, но и создавать угрозу безопасности веб-приложения. Quick-Form снабжает нас мощным инструментом контроля данных. Пакет содержит встроенные фильтры и правила проверки данных. Их функциональность мы можем как угодно изменять. Фильтры представляют собой набор определенных инструкций, предназначенных для коррекции данных, а правила служат для проверки данных на соответствие определенному условию. Самый распространенный пример применения фильтра — удаление лишних пробелов с помощью функции trim(). Вернемся к предыдущему листингу: допустим, мы хотим сохранить в базе данных имя пользователя и при этом удалить ведущие и конечные пробелы. Для этого мы создадим оператор: $form->applyFilter('firstName', 'trim'); Имя конкретного элемента можно заменить на '__ALL__'. В этом случае указанный фильтр будет применен ко всем элементам формы. В качестве фильтра может быть применена любая php-функция, которая принимает строку в качестве единственного параметра и возвращает строковое значение. Приведем пример кода из листинга 2. который дополняет наш первый пример:
<?php
$form -> addRule ( 'firstName'. 'Укажите, пожалуйста, ваше имя:'. 'required' );
$form -> addRule ( 'surname'. 'Фамилия должна состоять как минимум из пяти букв:'. 'minlength'. 5 );
?>
Таким образом, к нашей форме было добавлено два правила. Первое служит для проверки, ввел ли пользователь свое имя при подписке на новости. Второе следит за тем, чтобы фамилия пользователя, если только она указана, содержала не более пяти символов. За каждым элементом может быть закреплено сколько угодно правил проверки данных. Наряду с именем элемента, функция AddRule() требует указать сообщение об ошибке, которое появится рядом с элементом в случае, если данные не прошли проверку. В качестве третьего параметра необходимо указать правило, на соответствие которому будут проверяться данные. Таблица 1 содержит некоторые из них:
Поле состоит только из цифр
QuickFrom не ограничивает ваши возможности только встроенными правилами. Любая php-функция, которая принимает в качестве параметра строку и возвращает булевское значение может быть использована при проверке данных. Правда, такую функцию нужно зарегистрировать при помощи registerRule(). Мы дополнили второй пример функцией checkMailInDatabase(), которая должна проверить существует ли введенный пользователем e-mail в базе данных. Если адрес существует, выдается соответствующее сообщение об ошибке, уведомляя пользователя, что под таким адресом регистрироваться уже нельзя.
До сих пор мы проверяли данные на сервере. Однако иногда бывает полезно провести проверку прямо в браузере при помощи JavaScript. Чтобы правило применялось на клиентской стороне, необходимо передать функции AddRule() строку “client” в качестве четвертого параметра (“server” - значение по умолчанию). В этом случае данные будут проверятся при нажатии на кнопку Submit. Если данные поля формы не соответствуют правилу, появится сообщение об ошибке. Однако не стоит полагаться на то, что JavaScript включен в браузере клиента. Для более надежной проверки данных необходимо либо отказаться от проверки в браузере, либо создавать два однотипных правила: одно будет контролировать данные на стороне сервера, другое — на стороне клиента.
Если вы используете правила и фильтры одновременно, имейте в виду, что сначала QuickForm применяет фильтры и только потом правила.
Создаем индивидуальный дизайнНаша форма выглядит достаточно солидно, на некоторые недочеты, мы, конечно же, можем посмотреть сквозь пальцы. Однако и в этой области QuickForm показывает свою гибкость. Сначала изменим текст, которые напоминает пользователю о наличии обязательных полей (* обязательные поля). С помощью функции setRequiredNote() мы можем добавить любой текст, который заменит английский вариант надписи. Сам по себе QuickForm не отвечает за прорисовку формы, эту задачу он передает рендереру, который представляет собой объект класса HTML_QuickForm_Renderer_Default. Ссылку на него мы можем получить с помощью функции defaultRenderer(). Таким образом можно изменить внешний вид не только всей формы, но и отдельных ее элементов. Для прорисовки формы рендерер нуждается в несложных шаблонах, которые могут быть инициализированы функциями setFormTemplate(), setHeaderTemplate(), setElementTemplate(). Займемся сначала общим видом формы. QuickForm заключает ее содержимое в таблицу, поэтому шаблон формы должен иметь вид:
Обе подстановки
Теперь займемся внешним видом элементов. В этом случае шаблон усложняется:
Три подстановки
Иллюстрация 2. (Старый формуляр с новым дизайном)
Загрузка файлов на серверДавайте перейдем к другой теме и займемся загрузкой файлов на сервер. Для решения этой часто встречающейся проблемы QuickForm содержит очень быстрое и изящное решение - элемент file. О том, как можно без особых трудностей реализовать функцию загрузки файлов на сервер, нам расскажет фрагмент кода, взятый из листинга 4 :
<?php
require_once( 'HTML/QuickForm.php' );
$form = new HTML_QuickForm ( 'mainForm'. 'post' );
$file =& $form -> addElement ( 'file'. 'myFile'. 'Файл:' );
$form -> addElement ( 'submit'. 'submit'. 'OK' );
if ( $form -> validate ())
<
if ( $file -> isUploadedFile ())
<
$file -> moveUploadedFile ( '/tmp' );
$fileInfo = $file -> getValue ();
print_r ( $fileInfo );
>
> else
<
$form -> display ();
>
?>
Элемент file, на объект которого мы получаем ссылку, отвечает прежде всего за отображение поля выбора файла с кнопкой «обзор». При нажатии на кнопку появляется классическое диалоговое окно Windows с предложением выбрать файл. Если пользователь заполнил формуляр, первое условие выполнится. Функция isUploadedFile() следит за тем, чтобы во-первых файл был выбран пользователем, и во-вторых за тем, чтобы файл был успешно загружен на сервер. А теперь мы можем, с помощью moveUploadedFile(), переместить загруженный файл в нужный каталог и переименовать его, указав новое имя в качестве второго параметра. С помощью функции getValue() мы можем узнать некоторые характеристики файла, например, оригинальное имя и размер.
Класс HTML_QuickForm_file содержит все средства для организации загрузки файлов на сервер. К тому же он, наряду с уже упомянутыми правилами, он включает четыре дополнительных:
HTML_QuickForm предлагает несколько классов, которые программист должен иметь под рукой, создавая форму. Так вы сэкономите много времени и нервов. К сожалению, рамки данной статьи не позволяют рассмотреть все возможности этого мощного пакета. Тем, кто собирается интенсивно использовать QuickForm, можно посоветовать обратить внимание на возможность привязки пакета к одной из известных систем обработки шаблонов. Впрочем всем, кто хотел бы углубиться в предмет, мы настоятельно рекомендуем посмотреть неплохую документацию по классам, доступную по адресу pear.php.net/manual/en/package.html.html-quickform.php.
Ссылки
