Download the PHP package vis/apply_form_l5 without Composer
On this page you can find all versions of the php package vis/apply_form_l5. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download vis/apply_form_l5
More information about vis/apply_form_l5
Files in vis/apply_form_l5
Package apply_form_l5
Short Description Apply Forms handler package for L5
License proprietary
Informations about the package apply_form_l5
Apply Form
Пакет Laravel 5 предназначенный для работы с формами. Требует и автоматически устанавливает пакет https://github.com/arturishe21/mail_templates_l5 для работы с отправкой писем. Поддерживает интеграцию с Google Invisible reCaptcha.
Разделы
- Установка
- VIS-CMS
- Настройка
- Пример использования
- Описание классов
Установка
Выполняем
Добавляем ApplyFormServiceProvider в массив ServiceProviders в config/app.php
Выполняем миграцию таблиц
Публикуем js, nodes
Добавляем в layouts.default(или на конкретную вьюху, если заявка только на одной странице) перед закрывающим тегом body
VIS-CMS
В \config\builder\admin.php дописываем массив
Добавляем права доступа в config/builder/tb-definitions/groups.php и добавляем их к группам.
Настройка
В файле config/apply_form/apply_form.php
Включаем капчу и добавляем публичный и скрытый ключи
В файле public/js/apply_form_rules.js переопределяем методы и указываем в них свои действия(например, вызов попапа с кастомным сообщением) по выполнению ajax запроса
В этом же файле можно дописать дополнительные правила проверки полей, например добавить маску для телефонов. Для этого в класс ApplyFormRules нужно добавить свой метод, например:
И зарегистрировать его инициализацую в методе ApplyFormRules.init()
Пример использования
-
Определяем класс, который рассширяет класс Vis\ApplyForm\Models\AbstractApplyForm
-
Добавляем его в массив форм apply_forms в config/apply_form/apply_form.php
-
Создаем форму в шаблонах с названием 'название_формы_form', например такую:
- Дописываем в файл public/js/apply_form_rules.js правила jquery validation Правила определяются как 'название_формы_rules' и 'название_формы_messages'
Описание классов
- Класс расширяемый классом Vis\ApplyForm\Models\AbstractApplyForm
Описание обязательных свойств:
Имя используемой таблицы Значение: строка'
Описание дополнительных свойств:
Правила валидации Значение: массив
Название поля с файлом Используется, если форма передает файл Значение: строка
Путь к папке, в которой будет хранится файл относительно публичной директории Используется, если форма передает файл Значение: строка
Путь к папке, в которой будет хранится файл относительно публичной директории Используется, если форма передает файл Значение: строка
Название шаблона письма Используется, если после сохранения нужно отправить письмо на почту Значение: строка с slug шаблона класса Vis\MailTemplates\MailT
Список имейлов для отправки письма Используется, если после сохранения нужно отправить письмо на почту Значение: строка с slug записи класса Vis\ApplyForm\Models\ApplyFormSettingEmail
Возвращаемое сообщение после удачного сохранения заявки Используется, если после сохранения нужно отправить письмо на почту Значение: строка с slug записи класса Vis\ApplyForm\Models\ApplyFormSettingMessage
Возвращаемое сообщение после неудачного сохранения заявки Используется, если после сохранения нужно отправить письмо на почту Значение: строка с slug записи класса Vis\ApplyForm\Models\ApplyFormSettingMessage
Описание обязательных методов:
Метод подготовки исходных данных Рекомендуется использовать класс-помошник Vis\ApplyForm\Helpers\InputCleaner для очистки данных Значение: массив Возвращаемое значение: массив
Описание дополнительных свойств:
Метод преобразования подготовленных данных в данные для отправки на почту Значение: массив Возвращаемое значение: массив
Метод вызова дополнительного функционала вызываемый после сохранения заявки, например передача данных в API Значение: массив
- Класс Vis\ApplyForm\Helpers\InputCleaner
Описание методов:
Метод установки массива исходных данных Значение: массив
Метод получения массива данных Значение: массив
Метод получения значения по названию поля из массива данных Значение: строка Возвращаемое значение: значение из массива или null
Метод получения целочисленного значения по названию поля из массива данных Значение: строка Возвращаемое значение: целое число
Метод получения дробногочисленного значения по названию поля из массива данных Значение: строка Возвращаемое значение: дробное число
Метод получения строчного значения по названию поля из массива данных Значение: строка Возвращаемое значение: дробное число
Метод получения очищенного строчного значения по названию поля из массива данных Значение: строка Возвращаемое значение: дробное число
Метод получения json строки по названию поля из массива данных Значение: строка Возвращаемое значение: строка json
- Класс Vis\ApplyForm\Helpers\TableHandler Класс хендлер для tb-definitions.
Метод превращения строки с ссылкой на файл в ссылку на файл
Метод превращения строки типа foreign в ссылку на foreign объект Примечание: в дефинишен поля foreign надо дописать параметр 'foreign_model', а в указанной модели определить метод getAdminUrl