ПафНутиЙ-Блог » Модули » UniForm — модуль универсальных ajax-форм для DataLife Engine

UniForm — модуль универсальных ajax-форм для DataLife Engine

10.05
551
20979
UniForm — модуль универсальных ajax-форм для DataLife Engine

Не подходит стандартная форма обратной связи? Нужна возможность использовать свои поля? Нужна защита от ботов и лёгкая настройка без использования БД? Тогда этот модуль для Вас!

Преимущества


  • Не использует БД. Для работы модуля не требуется дополнительное соединение с БД и он не хранит данные из форм.
  • Скорость работы. За счёт простоты реализации удалось достичь приемлемой скорости работы.
  • Лёгкость настройки и стилизации. Все настройки модуля, оформление email-сообщения и самой формы вынесены в файлы шаблона, а это значит, что вы можете кастомизировать внешний вид не только формы, но и email-сообщения так, как этого требует дизайн.
  • AJAX вызов и отправка форм. Это даёт максимальную защиту от автоматических заполнений и не обременяет пользователя разгадкой каптчи.


Требования к установке


  • Версия DLE: 10.2 и выше.
  • PHP 5.4 и выше.
  • Прямые руки.


Установка


  • Скачать актуальную версию модуля
  • Распаковать содержимое папки DLE-UniForm-X.X.X (X.X.X - номер актуальной версии модуля) в корень сайта.
  • В браузере запустить установку модуля по адресу: ваш_сайт/dle_module_install.php?module=uniform
  • Следовать инструкциям


Скриншоты форм, поставляемых в комплекте с модулем



Форма обратной связи
UniForm — модуль универсальных ajax-форм для DataLife Engine


Форма обратной связи, с ошибками
UniForm — модуль универсальных ajax-форм для DataLife Engine


Сообщение об успешной отправке сообщения из формы обратной связи
UniForm — модуль универсальных ajax-форм для DataLife Engine


Форма заказа звонка
UniForm — модуль универсальных ajax-форм для DataLife Engine


Форма заказа звонка, в процессе отправки
UniForm — модуль универсальных ajax-форм для DataLife Engine


Email, с заказом звонка
UniForm — модуль универсальных ajax-форм для DataLife Engine


Тестовая форма с примером обработки результатов отправки формы
UniForm — модуль универсальных ajax-форм для DataLife Engine


Настройка


  • Описание и примеры конфигурации вызова модуля можно найти в файлах, с именем config.tpl.
  • Описание и примеры параметров формы можно найти в файле {THEME}/uniform/test/form.tpl.
  • Описание и примеры параметров email-сообщения можно найти в файле {THEME}/uniform/callback/email.tpl.


Параметры, доступные в файле конфигурации (config.tpl):


  • templateFolder — Папка с шаблонами формы формы. Указывается подпапка, в папке uniform текущего шаблона сайта, в которой должны лежать файлы config.tpl, form.tpl и email.tpl. Например шаблон формы обратной связи (feedback) выглядит так:
    {THEME}/uniform/
    └── feedback/ 
        ├── config.tpl - файл конфига
        ├── email.tpl - файл email-сообщения
        └── form.tpl - файл вывода формы

  • nocache — Отключение кеширования модуля.
  • debug — Дебаг. Выводится распечатка конфига, массива данных, переданных через $_POST и массива данных, отправляемых на email.
  • required — Обязательные поля. Указываются имена полей, обязательных для заполнения.
  • hidden — Разрешенные скрытые поля. Такие поля передаются из атрибута data-uf-settings кнопки открытия формы. Например, если к кнопке открытия формы прописать
    data-uf-settings='{"formConfig": "feedback", "fields":{"field1": "value1", "field2": "value2", "field3": "value3"}}'
    и при этом в конфиге будет вот такая запись:
    hidden = field1,field3
    то поле field2 не будет выведено в форму. Это сделано для безопасности работы модуля.
  • sendmail — Отправлять email при заполнения формы?
  • emails — Адреса почты, на которые необходимо отправлять уведомление. Необходимо прописать один или несколько email-адресов, через запятую.
  • selectFields — Поля типа select. Необходимо перечислить через запятую имена всех полей, являющихся селектами.
  • checkboxFields — Поля типа checkbox. Необходимо перечислить через запятую имена всех полей, являющихся чекбоксами.
  • radioFields — Поля типа radio. Необходимо перечислить через запятую имена всех полей, являющихся радиокнопками.
  • sendAsPlain — Отправлять сообщение как простой текст.
  • sendToAuthor — Отправить письмо автору новости, если есть newsId (есть поле с name="newsId") и если автор разрешил получение писем с сайта.
  • sendToSender — Отправлять письмо так же на email, указанный в поле email.
  • allowAttachments — Разрешить прикрепление файлов.
  • maxFileSize — Максимальный размер загружаемого файла (в килобайтах).
  • allowedFileTypes — Разрешенные типы файлов, перечисляем расширения через запятую, без точек и пробелов.


Теги шаблонов


Список тегов, поддерживаемых в шаблоне form.tpl.
Вместо X следует прописывать имя инпута, селекта, чекбокса или радиокнопки. Имена не должны дублироваться.
  • {* текст *} — Служебный комментарий. Текст, заключенный в такие теги, не будет выведен в браузер.
  • [error]текст[/error] — выводит текст, если форма содержит ошибки заполнения.
  • [success]текст[/success] — выводит текст, если форма удачно отправлена.
  • [form]текст[/form] — выводит текст, если форма только что открыта, или отправлена с ошибками.
  • [debug]{debug}[/debug] — выводит дебаг.
  • [uf_token_error]текст[/uf_token_error] — выводит текст, если происходит попытка межсайтовой подделки запроса (CSRF Attack) или если конфиг формы изменился во время заполнения формы.
  • [uf_email_error]текст[/uf_email_error] — выводит текст, если поле имеет имя email, является обязательным и не проходит валидацию (наличие символа @ и точки).
  • [uf_default_value]текст[/uf_default_value] — выводит текст, если форма открыта впервые.
  • {uf_filed_X} — выводит данные, переданные в форму из текстовых полей в случаи ошибочного заполнения.
  • [uf_field_X="Y"]текст[/uf_field_X] — Выводит текст, если в текстовое поле X передано значение Y.
  • [uf_error_X]текст[/uf_error_X] — выводит текст, если текстовое поле содержит ошибку.
  • [uf_select_X="Y"]текст[/uf_select_X] — Выводит текст, если в селекте X отмечен пункт со значением Y.
  • [uf_select_X_Y]selected[/uf_select_X_Y] — Выводит текст, если в селекте X отмечен пункт со значением Y. Является вариацией предыдущего тега.
  • [uf_checkbox_X="Y"]текст[/uf_checkbox_X] — Выводит текст, если отмечен чекбокс с именем X, содержащий значение Y.
  • [uf_checkbox_X_Y]checked[/uf_checkbox_X_Y] — Выводит текст, если отмечен чекбокс с именем X, содержащий значение Y. Является вариацией предыдущего тега.
  • [uf_radio_X="Y"]текст[/uf_radio_X] — Выводит текст, если отмечена радиокнопка с именем X, содержащая значение Y.
  • [uf_radio_X_Y]checked[/uf_radio_X_Y] — Выводит текст, если отмечена радиокнопка с именем X, содержащая значение Y. Является вариацией предыдущего тега.


Список тегов, поддерживаемых в шаблоне email.tpl.
Вместо X следует прописывать имя инпута, селекта, чекбокса или радиокнопки. Имена не должны дублироваться.
  • {* текст *} — Служебный комментарий. Текст, заключенный в такие теги, не будет выведен в сообщении.
  • [header]текст[/header] — Тема письма.
  • {all_mail_fields} — выводит все поля, переданные из формы в удобном, для последующей вставке в шаблон, виде.
  • [uf_field_X]текст[/uf_field_X] — выводит текст, если текстовое пол X заполнено.
  • {X} — выводит данные, переданные в форму из текстового поля X.
  • [not_X]текст[/not_X] — Выводит текст, если в текстовое поле X пустое.
  • [uf_field_X="Y"]текст[/uf_field_X] — Выводит текст, если в текстовое поле X передано значение Y.
  • [uf_select_X="Y"]текст[/uf_select_X] — Выводит текст, если в селекте X отмечен пункт со значением Y.
  • [uf_checkbox_X="Y"]текст[/uf_checkbox_X] — Выводит текст, если отмечен чекбокс с именем X, содержащий значение Y.
  • [uf_radio_X="Y"]текст[/uf_radio_X] — Выводит текст, если отмечена радиокнопка с именем X, содержащая значение Y.
  • {send_date} — выводит дату отправки сообщения из формы, отформатированную в соответсвии с настройками DLE.
  • {current_page} — выводит URL страницы, с которой было отправлено сообщение.
  • [news_id]{news_id}[/news_id] — ID новости (если есть поле с name="newsId").
  • [news_autor]{news_autor}[/news_autor] — Логин автора новости (если есть поле с name="newsId").
  • [news_title]{news_title}[/news_title] — Заголовок новости (если есть поле с name="newsId").
  • [news_email]{news_email}[/news_email] — Email автора новости (если есть поле с name="newsId").
  • {site_home_title} — Выводит название сайта из настроек DLE.
  • {site_http_home_url} — Выводит адрес сайта из настроек DLE.
  • {site_short_title} — Выводит краткое название сайта из настроек DLE.
  • [user_name]{user_name}[/user_name] — Выводит логин пользователя, отправившего сообщение.
  • [user_fullname]{user_fullname}[/user_fullname] — Выводит полное имя пользователя, отправившего сообщение.
  • [user_email]{user_email}[/user_email] — Выводит email пользователя, отправившего сообщение.
  • [user_foto]{user_foto}[/user_foto] — Выводит ссылку на аватар пользователя, отправившего сообщение.
  • [user_land]{user_land}[/user_land] — Выводит то, что пользователь, отправивший сообщение, написал в поле "Место жительства".
  • [to_sender] текст [/to_sender] — Выводит текст для отправителя, если указан параметр sendToSender
  • [not_to_sender] текст [/not_to_sender] — Выводит текст для получателей псьма, отличных от отправителя, если указан параметр sendToSender


Добавлено в v1.2



Улучшения и исправления

  • Теперь если в форме есть заполненное поле с `name="header"`, такое поле будет автоматически подставлено в тему письма.
  • Исправлена ошибка на DLE 10.5+ с невозможностью указать email отправителя из формы.
  • Исправлена ошибка с экранированием кавычек в письме.
  • Если пользователь авторизован, то тег {uf_field_email} при открытии формы автоматически заменится на его email.
  • Убран тег {send_date=D.m.Y} т.к. он оказался нерабочим.
  • Исправлено некорректное поведение тега {send_date}.
  • Добавлен новый параметр конфигурации sendAsPlain — Отправлять сообщение как простой текст. Теперь можно отправлять письма как простые текстовые сообщения, без обработки html.
  • Добавлен новый параметр конфигурации sendToAuthor — Отправить письмо автору новости, если есть поле с name="newsId" и если автор разрешил получение писем с сайта.
  • Реализована возможность отправлять в письме данные из новости. Для этого необходимо передать в форму поле newsId. Пример шаблона в папке newsauthor.
  • Реализована возможность отправки сообщения на email автора новости. Для этого необходимо передать в форму поле newsId и в конфиге прописать sendToAuthor = y. Пример шаблона в папке newsauthor.


Новые теги для email-сообщений

  • [news_id]{news_id}[/news_id] — ID новости (если есть поле с name="newsId").
  • [news_autor]{news_autor}[/news_autor] — Логин автора новости (если есть поле с name="newsId").
  • [news_title]{news_title}[/news_title] — Заголовок новости (если есть поле с name="newsId").
  • [news_email]{news_email}[/news_email] — Email автора новости (если есть поле с name="newsId").
  • {site_home_title} — Выводит название сайта из настроек DLE.
  • {site_http_home_url} — Выводит адрес сайта из настроек DLE.
  • {site_short_title} — Выводит краткое название сайта из настроек DLE.
  • [user_name]{user_name}[/user_name] — Выводит логин пользователя, отправившего сообщение.
  • [user_fullname]{user_fullname}[/user_fullname] — Выводит полное имя пользователя, отправившего сообщение.
  • [user_email]{user_email}[/user_email] — Выводит email пользователя, отправившего сообщение.
  • [user_foto]{user_foto}[/user_foto] — Выводит ссылку на аватар пользователя, отправившего сообщение.
  • [user_land]{user_land}[/user_land] — Выводит то, что пользователь, отправивший сообщение, написал в поле "Место жительства".



Добавлено в v1.3


  • Новый, удобный установщик модуля.
  • Добавлена возможность пикреплять файлы к сообщению в форме. Для этого необходимо в конфиге указать параметр allowAttachments, а так же параметры maxFileSize (максимальный размер прикрепляемого файла) и allowedFileTypes (доступные типы файлов) при необходимости. Готовый шаблон для прикрепления файлов к сообщению — attachments.
  • Добавлен новый параметр конфигурации sendToSender. Если этот параметр задан, то письмо будет отправлено на email-адрес, указанный в поле email. Так же проверяется валидность этого адреса.
  • В шаблон email-сообщения добавлены новые теги, обрабатываемые в сообщении и в поле заголовке письма, когда активирован параметр sendToSender.
    [to_sender] текст для отправителя [/to_sender]
    [not_to_sender] текст для других получателей [/not_to_sender]
  • Добавлены почти все поля из профиля пользователя в шаблон email.
  • Добавлен вывод допполей из профиля пользователя в шаблон email.
  • Ко всем тегам в шаблонах email-сообщения добавлены противоположные теги [not_X], выводящие текст между ними, когда соответствующий тег {X} пуст.
  • Исправлена ошибка, когда пользователю разрешено менять шаблон сайта, а шаблон формы берётся из шаблона, установленного по умолчанию в системе.
  • Улучшения и оптимизация кода.
  • Теперь минимально-допустимая версия php - 5.4.



Для вывода формы непосредственно на странице достаточно прописать в нужном месте шаблона (начиная с версии 1.1):
<div data-uf-inline="/engine/ajax/uniform/uniform.php" data-uf-settings='{"formConfig": "inline"}'>
	<div class="uf-inline-loading"></div>
</div>


Для Отправки сообщения автору новости необходимо прописать в шаблон краткой или полной новости (начиная с версии 1.2):
<span class="uf-btn" data-uf-open="/engine/ajax/uniform/uniform.php" data-uf-settings='{"formConfig": "newsauthor", "fields": {"newsId": "{news-id}"}}'>Связь с автором новости</span>



Скачать модуль UniForm


Жду ваших отзывов!
Обновлено: 27 ноября 2016
(Модуль обновлён до версии 1.3)

Похожие материалы

  • EditRating — модуль для лёгкого редактирования рейтинга в DataLife Engine
  • Easy Like - модуль организации системы лайков новостей для DLE 9.x - 10.x (обновлено до 1.4)
  • Block.Pro.2.5
  • Yandex Maps - модуль Яндекс карт для DLE (только UTF-8 версия, обновлено до 1.4.1)
Закрыть

Комментировать могут только зарегистрированные пользователи

+

Комментарии

Asiuslik
Asiuslik 8 ноября 2016 22:04
Ответов: 1 #5735
С отправкой файлов помогите пожалуйста. Писал вам раньше но ничего не вышло, SMTP как и Localhost, отправляет только текстовую инфу. Ставил обычные PHP формы то они делают отправку файлов на этом же хостинге.
ПафНутиЙ
ПафНутиЙ 8 ноября 2016 23:13
Ответов: 0 #5736
Напишите тиккет https://github.com/dle-modules/DLE-UniForm/issues/new попробуем разобраться.
Asiuslik
Asiuslik 11 ноября 2016 19:07
Ответов: 0 #5744
Цитата: ПафНутиЙ
https://github.com/dle-modules/DLE-UniForm/issues/new попробуем разобраться.

Тиккет написал :)
Alexsks
Alexsks 13 ноября 2016 22:24
Ответов: 2 #5745
Здравствуйте, помогите, все сделал как по инструкции, но не открывается форма: http://kompuhelp.esy.es/
ПафНутиЙ
ПафНутиЙ 13 ноября 2016 23:17
Ответов: 1 #5746
Уберите двойное подключение библиотеки jquery, избавьтесь от js ошибок на сайте.
Alexsks
Alexsks 14 ноября 2016 14:24
Ответов: 0 #5748
спасибо, закоментил {THEME}/js/universal/jquery.js, заработало!
constructor_1
constructor_1 20 ноября 2016 11:41
Ответов: 1 #5751
Здравствуйте! Поискал по коментам не нашел. При запуске установки ошибка
Parse error: syntax error, unexpected '[' in /home/u41417/stokmobile.ru/www/dle_module_install.php on line 18
constructor_1
constructor_1 20 ноября 2016 11:42
Ответов: 0 #5752
Нашел)) спс
Asiuslik
Asiuslik 22 ноября 2016 17:00
Ответов: 1 #5754
Здравствуйте! Отправил тиккет 11 дней назад, Когда примерно сможете глянуть проблемку с прикреплением файлов ?
ПафНутиЙ
ПафНутиЙ 22 ноября 2016 18:40
Ответов: 0 #5756
Примерно в этом или следующем году, как только будет время и желание.
К сожалению некоммерческие продукты в низком приоритете, а платными доработками и заказами я не занимаюсь.
deafmovie
deafmovie 23 ноября 2016 01:02
Ответов: 6 #5760
ПафНутиЙ, просто замечательный модуль! Красивая вещь! У меня такая проблема по инструкции, залил файлы, вписал e-mail в конфиг feedback, в шаблоне подключил стили после <head> / т.к. перед концом </head> стили не работают / кнопочка отображается, при клике на нее выходит меседж - "The content could not be loaded." - при клике на первые два слова - преебрасывает в
/engine/ajax/uniform/uniform.php с ошибкой 500. Не понял также назначение файла dle_module_install.php - открывал - отдает 500.
deafmovie
deafmovie 23 ноября 2016 01:03
Ответов: 0 #5761
помогите, пожалуйста разобраться.
ПафНутиЙ
ПафНутиЙ 23 ноября 2016 10:51
Ответов: 4 #5763
скорее всего вы некоррекно залили файлы модуля. Проверьте права доступа к файлам. Обычно такое бывает если заливать через вебинтерфес хостинга или от пользователя root.
deafmovie
deafmovie 27 ноября 2016 23:18
Ответов: 3 #5767
К сожалению не помогло. удалил все файлы, заново заливал через фтп, либо распаковал через интерфейс, права 644 на файлы, 755 на папки. Пересмотрел свой .htaccess - ничего не изменилось. Запускаю - dle_module_install.php получаю пустую страницу:
Сайт пока не может обработать этот запрос.
HTTP ERROR 500

На сайте сама кнопка "Обратная связь" - AJAX кликабельна, появляется затемнение фона и надпись - The content could not be loaded. я очень расстроился.
chaser3000
chaser3000 28 ноября 2016 02:17
Ответов: 0 #5768
У меня тоже такое было. С помощью FileZilla установил на все залитые папки права 700 с перенаправлением на вложенные каталоги (т.е. все вложенные файлы получают те-же права), и все заработало!
Wstory
Wstory 16 декабря 2016 13:43
Ответов: 1 #5796
У меня то же самое, почти все варианты перепробовал, но так и не получилось... Кто нибудь решил эту проблему? Помогите пожалуйста.
ПафНутиЙ
ПафНутиЙ 16 декабря 2016 16:47
Ответов: 0 #5797
Обратитесь к хостеру
Asiuslik
Asiuslik 23 ноября 2016 16:53
Ответов: 0 #5764
Спасибо за ответ )
leha0918
leha0918 24 ноября 2016 16:31
Ответов: 1 #5765
Здравствуйте. Как добавить в форму заказа такое поле как Ваше имя и ваш телефон ? так же что надо прописать что бы эти данные приходили на мой email.
Заранее большое спасибо!

И так же интересует как с помощью данного модуля создать 2 кнопки.
Заказать товар и Заказать обратный звонок
ПафНутиЙ
ПафНутиЙ 27 ноября 2016 17:42
Ответов: 0 #5766
1. Посмотрите стандартные шаблоны модуля, там как раз реализованы эти поля.

2. Создайте две строки вызова модуля с нужными параметрами.
chaser3000
chaser3000 29 ноября 2016 01:44
Ответов: 0 #5769
Здравствуйте! Можно ли в модуль добавить каптчу? Если да, то как?
dreder
dreder 29 ноября 2016 17:10
Ответов: 3 #5770
Добрый день. У меня странная ситуация , у меня не прикрепляются файлы и стандартный шаблон attachments не присылает на почту файлы,не знаете в чем проблема?
Кроме мэйла ничего не менял , сообщение приходит ,но пустое , файлы маленького размера по 1-5 кбайт
dreder
dreder 29 ноября 2016 17:34
Ответов: 2 #5771
Все сделал, увидел опечатку ,которую вы исправили в коде.Спасибо)
dreder
dreder 30 ноября 2016 15:44
Ответов: 1 #5772
Хотя на почту @mail.ru файлы не приходят ,а на gmail все ок. Не знаете в чем может быть проблема? В серверах майла?)
ПафНутиЙ
ПафНутиЙ 3 декабря 2016 10:50
Ответов: 0 #5774
Возможно mail.ru по какой то причине банит эти вложения.
Yamakasi
Yamakasi 4 декабря 2016 00:28
Ответов: 1 #5776
Цитата: dreder
Хотя на почту @mail.ru файлы не приходят ,а на gmail все ок. Не знаете в чем может быть проблема? В серверах майла?)

с майл ру не всё так просто даже с простыми письмами увы((( очень он капризный)
я делаю так, тупо принимаю всё на яндекс почту например, она без проблем принимает всё, а после по фильтру автоматом переадресация уже на майл. такой механизм уже не первый год использую и всё как часики, а если сразу на майл гнать, увы(( то с опозданием, то ещё чего то ему не нравится там...
dreder
dreder 5 декабря 2016 14:00
Ответов: 0 #5779
Да,у них и сервера валятся в последнее время частенько.Иногда даже не понятно или форма не работает,или сервер упал. Спасибо за информацию.
Yamakasi
Yamakasi 6 декабря 2016 15:57
Ответов: 0 #5787
dreder,
нет у них сервера нормально всё пашут как часики, у них просто защита от спама через чур(( она через чур применяет фильтр даже к нормальным письмам, знакомый хостер например устал уже каждый раз с ними общатся по этому поводу. именно он мне когда то посоветовал сделать так, ну точнее на яндекс гнать. ну или в Вашем случае можно также и на гугли. смысл я думаю Вы поняли как и что, ну уже на яндекс или на гугли (гмайл) посылать, а он уже будет пересылать из под фильтра на майл например.

напрямую на майл ру, на разных хостах косячит увы, то приходит с задержкой нереальной, а то порой всё нормально, смотрю, что то подозрительно, нет писем))) а потом выясняется в спам листе у майл ру)))
Colonizator
Colonizator 9 декабря 2016 15:46
Ответов: 0 #5792
Очень крутой модуль! Спасибо!
souz21
souz21 19 декабря 2016 19:19
Ответов: 1 #5810
Ошибка при попытке запустить файл инсталл
Файл с конфигурацией установки модуля не найден, возмжно установочные файлы модуля не скопированы.
Залил папку в корень: dle_starter_installer
Залил установщик: dle_module_install.php

Информация

Посетители, находящиеся в группе Гости, не могут оставлять комментарии к данной публикации.