Download the PHP package floor12/yii2-module-feedback without Composer
On this page you can find all versions of the php package floor12/yii2-module-feedback. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package yii2-module-feedback
yii2-module-feedback
Модуль для работы с обращениями пользователей на сайте. Из коробки содержит обычную встраевуемую и форму для модального окна. Возможна конфигурация различных тематик для обращения с отправкой уведомлений о них на разные адреса. Администрирование сохранными заявками происходит через отдельный CRUD.
Установка
Добавление модуля в проект
Для добавления модуля выполняем команду
или добавляем в секцию "required" вашего файла composer.json следую строку:
Выполнение миграций
Для хранения сохраненных обращений спользуется таблица feedback
. Выполняем миграции:
Для автоматического применения миграций из установленных в проект модулей рекомендую использовать дополнительный компонент, например fishvision/yii2-migrate.
Регистрация модуля в приложении и его конфигурирование
Для дальнейшей работы необходимо прописать модуль в конфиге приложения, в секции modules
.
В минимальной конфигурации регистрация модуля выглядит следующим образом:
При этом floor12\feedback\Module
имеет дополнительные параметры для конфигурации:
adminRoles
- массив ролей пользователей, которым доступно управление, по умолчанию содержит['@']
предоставляя доступ всем авторизованным пользователям;adminLayout
- алиас для лейаута админского контроллера, по умолчанию@app/views/layouts/main
;frontendLayout
- алиас для лейаута фронтенд контроллера (исползуется если отображать форму на отдельной странице), по умолчанию@app/views/layouts/main
;viewFormModal
- алиас пути к view формы для модального окна, по умолчанию@vendor/floor12/yii2-module-feedback/src/views /frontend/_form_modal_bs
;viewFormEmbedded
- алиас пути к view формы для встраивания в страницу или показу на отдельной странице, по умолчанию@vendor/floor12/yii2 -module-feedback/src/views/frontend/_form_embedded
;viewSuccessModal
- алиас пути к view, отдаваемому в модальное окно при успешной отправки обращения, по умолчанию@vendor/floor12/yii2-module-feedback/src/views/frontend/_success_modal_bs
;viewSuccessEmbedded
- алиас пути к view, отдаваемому клиенту при успешной отправки обращения, по умолчанию@vendor/floor12/yii2 -module-feedback/src/views/frontend/_success_ebedded
;viewMailUserTemplate
- алиас пути к шаблону письма для благодарности пользователю, по умолчанию@vendor/floor12/yii2-module -feedback/src/views/mail/_user_thanks.php
;viewMailAdminTemplate
- алиас пути к view, отдаваемому клиенру при успешной отправки обращения, по умолчанию@vendor/floor12/yii2-module-feedback/src/views/mail/_admin_info.php
;emailRequired
- является лиemail
обязательным полем, по умолчаниюfalse
;phoneRequired
- является лиphone
обязательным полем, по умолчаниюtrue
;
Темы запросов и адреса для уведомлений
Для работы модуля, необходимо задать хотя бы одну конфигурацию через параметры Yii2 приложения.
Обычно, это можно сделать в файлах app\config\params.php
или common\config\params.php
.
В параметры необходимо прописать no-replyEmail
,no-replyEmail
и массив contactForm
.
Пример конфигурации:
Использование
Для обработки пользовательских запросов и рендеринга форм используется
floor12\feedback\controllers\FrontendController
, который по имеет
action для работы с формой в модальном окне /feedback/admin/form-modal
и
в виде обычной страницы /feedback/admin/form
.
Например, размещение кнопки на открытие модального окна с формой может выглядить так:
С использованием Bootstrap Modal и, соответственно, Jquery:
Для этого подхода, необходимо зарегистрировать в приложении floor12\editmodal\EditModalAsset
.
Для этих же целей можно воспользоваться floor12\feedback\components\OpenContactModalButtonWidget
.
Если вы не хотите и не используете Bootstrap и Jquery, то можно воспользоваться моей ванильной имплементацией модального окна. Она прорисует модалное окно и загрузит туда форму, и jquery, необходимый для работы базовых валидаций форм Yii2 загрузится уже туда, только если пользователь открывал форму.
Для этого случая, необходимо зарегистрировать в приложении другой бандл:floor12\editmodal\EditModal2Asset
.
Администрирование
После регистрации в приложении административный CRUD по-умолчанию
доступен по адресу /feedback/admin/index
, за который
отвечает floor12\feedback\controllers\AdminController
.
All versions of yii2-module-feedback with dependencies
yiisoft/yii2 Version ~2.0.13
floor12/yii2-editmodal Version dev-master
floor12/yii2-phone Version dev-master
floor12/yii2-fprotector Version dev-master
floor12/yii2-module-files Version dev-master
yii2mod/yii2-enum Version *
kartik-v/yii2-widget-datepicker Version dev-master