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

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

16.03
722
211 344
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
  • Следовать инструкциям


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



Форма обратной связи


Форма обратной связи, с ошибками


Сообщение об успешной отправке сообщения из формы обратной связи


Форма заказа звонка


Форма заказа звонка, в процессе отправки


Email, с заказом звонка


Тестовая форма с примером обработки результатов отправки формы


Настройка


  • Описание и примеры конфигурации вызова модуля можно найти в файлах, с именем 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.



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


  • Обновлён установщик
  • Добавлен новый параметр parseSendMail, добавляющий возможность производить манипуляции над данными перед отправкой email. В параметр передаётся путь к php файлу, без расширения, отностительно папки engine/modules. Например можно добавить в шаблон email-сообщения новые теги [footer]{footer}[/footer]. Для этого в конфиге прописываем parseSendMail = addFooter, создаём файл engine/modules/addFooter.php со следующим содержимым:
    <?php
    if ($arSendMail['select1'] === 'val1') {
    	$mailTpl->set('[footer]', '');
    	$mailTpl->set('[/footer]', '');
    	$mailTpl->set('{footer}', $arSendMail['select1']);
    } else {
    	$mailTpl->set_block("'[footer](.*?)[/footer]'si", '');
    }





Для вывода формы непосредственно на странице достаточно прописать в нужном месте шаблона (начиная с версии 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

Ответы на частые вопросы



[Q]: Почему ничего не работает?
[A]: C вероятностью в 80% у вас дважды подключена бибилиотека jQuery (20% - проверьте шаги по инструкции).

[Q]: Сделано всё по инструкции, но модальное окно не открывается.
[A]: У вас дважды подключена библиотека jQuery. Имейте ввиду, что в DLE уже есть jquery и подключать её отдельно не нужно.

[Q]: Библиотека jQyery подключена 1 раз (я проверил все скринты на странице в браузере, а не в файле шаблона), но окно всё равно не открывается.
[A]: Вполне вероятно, что вы перенесли js в конец страницы, а скрипты модуля подключаете в начало. Перенесите скрипты модуля в конец страницы.

[Q]: Не приходит письмо.
[A]: Проверьте конфиг модуля (поле emails должно быть раскомментировано). Если всё ок — проверьте папку спам (недопочты типа mail.ru, rambler и прочие noname почтовые службы очень часто при неправильной настройке сервера отправляют письма в спам, особенно, если у вас shared-хостинг). Если в папке спам ничего нет — проверьте логи почтового сервера (узнать о расположении логов можно у хостера). Самый простой способ избежать конфузов при отправке почты - подключить почту для домена.




Жду ваших отзывов!

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

Комментарии

anatohi
anatohi 27 января 2016 16:45
Добрый Вечер Павел! У меня при отправке пишет Error, с чем это может быть связано, версия DLe 10.6
Ошибку нашел, в связке с dle asset, происходит такая ошибка, как решить эту задачу?
Решил проблему!
sitennov
sitennov 31 января 2016 12:32
Спасибо огромное за модуль.

Скажи, можно ли сделать в модуле маску на ввод номера телефона?
sitennov
sitennov 31 января 2016 12:37
Хотел также спросить. Если кнопка вызова формы стоит в краткой новости, возможно ли идентифицировать адрес новости на странице раздела?
ПафНутиЙ
ПафНутиЙ 31 января 2016 12:54
Цитата: sitennov
Скажи, можно ли сделать в модуле маску на ввод номера телефона?

https://github.com/dle-modules/DLE-UniForm/issues/25

Цитата: sitennov
Если кнопка вызова формы стоит в краткой новости, возможно ли идентифицировать адрес новости на странице раздела?

https://github.com/dle-modules/DLE-UniForm/tree/master/templates/Default/uniform/newsauthor
sitennov
sitennov 31 января 2016 12:55
Спасибо.
maulo
maulo 2 февраля 2016 19:47
нужно добавить прикрепление файла как ето сделать где копать?
ПафНутиЙ
ПафНутиЙ 2 февраля 2016 20:13
Клонируйте репозиторий, вносите необходимые правки, используйте. Начните с этого файла.
maulo
maulo 3 февраля 2016 14:28
ПафНутиЙ,
Цитата: ПафНутиЙ
Клонируйте репозиторий, вносите необходимые правки, используйте. Начните с этого файла.


а можно немного подробней, питалса с етого слепить

<?php
if($_FILES['fileFF']['size'] > 0) {

  $output = '<h1>Спасибо! Ваш файл получен.</h1>';

  $to = "name@yandex.ru"; // адрес почты получателя
  $from = "name@mail.ru"; // адрес почты отправителя
  $subject = "Заголовок письма";
  $message = "Содержимое письма";

  $attachment = chunk_split(base64_encode(file_get_contents($_FILES['fileFF']['tmp_name'])));
  $filename = $_FILES['fileFF']['name'];
  $filetype = $_FILES['fileFF']['type'];

  $boundary = md5(date('r', time())); // рандомное число

  $headers = "From: " . $from . "rn"; // см. наиболее часто используемые заголовки
  $headers .= "Reply-To: " . $from . "rn";
  $headers .= "MIME-Version: 1.0rn";
  $headers .= "Content-Type: multipart/mixed; boundary="_1_$boundary"";

  $message="
--_1_$boundary
Content-Type: multipart/alternative; boundary="_2_$boundary"

--_2_$boundary
Content-Type: text/plain; charset="utf-8"
Content-Transfer-Encoding: 7bit

$message

--_2_$boundary--
--_1_$boundary
Content-Type: "$filetype"; name="$filename"
Content-Transfer-Encoding: base64
Content-Disposition: attachment // содержимое является вложенным

$attachment
--_1_$boundary--";

  mail($to, $subject, $message, $headers);

}
?>

<!DOCTYPE HTML>

<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<title>Прикрепить файл к email | PHP</title>

<?php echo $output; ?>
<form enctype="multipart/form-data" method="post">
<input type="file" name="fileFF"><input type="submit" value="Отправить">
</form>


но чето неполучяетса я в ПХП ище ненастолько разбераюсь, немогу понять как работает етот модуль и што ему надо править буду длягодарен за болие подробную инфу
ПафНутиЙ
ПафНутиЙ 4 февраля 2016 09:38
Для начала стоит начать изучать php.
Книжки почитайте, php.net, гугл, яндекс на худой конец.
Я могу вам реализовать загрузуку файлов, но это будет платно и дорого.
uragun
uragun 3 марта 2016 17:46
Подскажите как решили, очень нужно! заранее спасибо - кодировку движка и сайта уже не поменять! А автор не ответит(
uragun
uragun 3 марта 2016 17:47


Помогите ребята кто нашел как решить проблему!
ПафНутиЙ
ПафНутиЙ 3 марта 2016 17:50
Проверьте заголовки, которые отдаёт сервер, скорее всего кодировка, в которой работает сервер не совпадает с кодировкой сайта.
uragun
uragun 3 марта 2016 22:39
Поменял движок на 10.6 и везде поставил UTF-8 спасибо помогло, но перестали сообщения на e-mail приходить. Может на 10.6 не работает модуль? Заранее Спасибо за ответ!
uragun
uragun 4 марта 2016 14:17
Всю ночь разбирался делал, и пришёл к выводу! Что на кодировке UTF-8 все без кракозябр но сообщения не приходяь, на кодировке windows-1251 все приходит но с крякобрязами) Что за мистика?
Roow
Roow 4 марта 2016 21:58
В режиме афиша происходит рассинхрон title и shortstory / fullstory (то есть заголовки не совпадают с содержанием новости)
ПафНутиЙ
ПафНутиЙ 4 марта 2016 23:17
Проверяйте кодировку сервера, проверяйте логи.
Где то ошибка.
Roow
Roow 5 марта 2016 16:17
кодировки в порядке, проблема в шаблоне. В оригинале blockpro.tpl в режиме афиша все хорошо, а в оригинале group.tpl уже идет путаница
ПафНутиЙ
ПафНутиЙ 5 марта 2016 18:44
Ответ предназначался пользователю uragun, я промахнулся.

Все вопросы по работе модуля BlockPro следует задавать в техподдержку, ссылка на которую есть в админке модуля.
lhtattoo
lhtattoo 9 марта 2016 21:34
Доброго времени суток, уважаемый разработчик. Ваша форма - то, что я так долго искал. Но по какой-то причине она не хочет работать на моем лендинге.
- Проверил на предмет конфликтов с другими модулями
- Перезалил файлы
- До миллиметра прошел всю инструкцию по установке еще раз.

Help) lhtattoo.ru
ПафНутиЙ
ПафНутиЙ 9 марта 2016 21:49
Для начала не стоит коллекционировать библиотеки jquery http://joxi.ru/Vm6deMYux77eqA
lhtattoo
lhtattoo 9 марта 2016 22:16
ПафНутиЙ, лишнюю библиотеку удалил, но не помогло.(
yurta
yurta 9 марта 2016 23:45
Приветсвую, спасибо за модуль, но он упорно не хочет работать с другим модулем от razer Xpay textHide

консоль ругается на парсинг тегов

$content = preg_replace( "#\[PaymentsTagHide:{$tag}\](.*?)\[/PaymentsTagHide:{$tag}\]#ies", "$this->ParseTag( '{$tag}', '\1' )", $content );
yurta
yurta 9 марта 2016 23:46
это строка из модуля xpay hidetext
ПафНутиЙ
ПафНутиЙ 9 марта 2016 23:58
Не уверен, что смогу вам помочь т.к. модуле от rezer как правило закодированы.
yurta
yurta 10 марта 2016 00:20
ПафНутиЙ,

Вот этот модуль, он с открытым кодом, и бесплатный
_rezer_net/content/57-skritii-tekst.html

а проблемный код
engineincpaymentsextensionplagintag_hideapi.php

45 строка


ну это я так понял из-за парсинга тегов, происходит, так что думаю это не в вашем модуле дело.
yurta
yurta 10 марта 2016 16:05
Решил проблему, выводом формы в своем модальном окне, может кому поможет
yurta
yurta 10 марта 2016 16:07
Автору конечно спасибо, отлично сделано :)
souz21
souz21 11 марта 2016 17:56
Версия 1.2 на DLE 10.3 работает вообще?
У меня письма не приходят. В config.tpl раскомментирована строка с адресом почты.

В спаме нет. Почта правильно прописана. Шаблон: callback.

Цитата: souz21
У меня письма не приходят. В config.tpl раскомментирована строка с адресом почты.

Разобрался. Оказывается в админке dle надо было переключить на PHP mail()

Гости не могут писать автору новости? Только авторизованные?
В админке не могу разрешить гостям разрешить писать в ПМ
petroloa
petroloa 22 марта 2016 12:05
Здравствуйте! Все поставил, но при вызове окна появляется полоса прокрутки, как ее убрать??? Заранее спасибо.
petroloa
petroloa 22 марта 2016 12:06
вот сайт http://lenovo-service.center/petroloa,
вот сайт http://lenovo-service.center/

Добавить комментарий

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

Информация

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