Модуль веб-формы Drupal 8 - краткое руководство

Опубликовано: 2020-04-07

Модуль Drupal 8 Webform является дополнительным модулем и является одним из самых мощных и гибких модулей в Drupal 8. Это модуль с открытым исходным кодом, используемый для создания форм и управления отправкой. Drupal Webform также попал в наш список лучших модулей Drupal, которые вам абсолютно необходимы для вашего следующего проекта Drupal! Узнайте больше об универсальном модуле в этом руководстве по веб-форме Drupal 8.

Drupal Webform - это универсальный модуль, который используется для создания форм и извлечения информации от пользователей на веб-сайтах Drupal. Например, мы можем использовать модуль веб-форм Drupal для создания опросов, контактных форм, форм обратной связи и многого другого. После отправки этот модуль позволит отправлять электронные письма пользователю и может отправлять уведомления администратору относительно отправки. Есть варианты для просмотра отправки, публикации ее как узла, страницы или блока и экспорта результатов в файл CSV.

Логотип веб-формы, полученный из Drupal.org/Webform

Логотип веб-формы, полученный из Drupal.org/Webform

Начало работы с модулем Drupal 8 Webform

Сообщество Drupal предоставило нам несколько феноменальных модулей, и Drupal Webform, безусловно, является одним из них. Джейкоб Роковиц, создатель и сопровождающий модуля Webform, однажды обсуждал с нами Webform и свой вклад в сообщество Drupal. «У каждого есть свой стиль разработки программного обеспечения. После 20 лет написания программного обеспечения я пришел к выводу, что мне нравится работать над одной целью / проектом, которым является модуль Webform для Drupal 8. В то же время я также узнал, что создание программного обеспечения с открытым исходным кодом - это больше, чем просто код вкладчика; речь идет о поддержке и создании сообщества вокруг кода. » Узнайте больше о Джейкобе и многих других участниках нашего сообщества Drupal здесь.
Теперь приступим к установке модуля веб-форм Drupal 8 и созданию веб-форм.

Установите и включите модуль Drupal Webform

Загрузите модуль Drupal 8 Webform с https://www.drupal.org/project/webform и включите его.

Установите и включите drupal 8

Чтобы включить веб-форму, перейдите в раздел « Расширить» и в категории веб-форм вы увидите веб-форму вместе с флажком. Для работы с Drupal 8 веб-формы включают полевой API, системный модуль, пользовательский модуль. Без включения этих трех модулей веб-форму нельзя включить.
В веб-форме есть много опций, которые предоставляют определенные функции. Включите их согласно требованию.

Создайте новую веб-форму Drupal

Чтобы создать новую веб-форму Drupal 8, включите Webform UI и Webform Access. Пользовательский интерфейс Webform обеспечивает удобный пользовательский интерфейс для создания / обслуживания веб-форм, а Webform Access управляет узлами веб-форм. Включите узел Webform перед включением доступа к Webform. Затем перейдите в Структура> Веб-формы .

Создать новую веб-форму

Вот несколько вариантов веб-форм.

  • На первой вкладке Forms находится список созданных веб-форм. По умолчанию есть контактная форма. Это шаблон, предоставляемый модулем Webform.
  • Во второй вкладке Templates есть больше шаблонов.
  • На вкладке «Представления» мы можем просматривать формы, отправленные пользователями.
  • Параметры имеют предопределенный многоразовый набор значений, доступных для переключателей, флажков и меню.
  • На вкладке «Надстройки» есть еще несколько значений, которые можно использовать повторно.
  • В конфигурациях представлены общие настройки веб-форм.

Чтобы создать новую веб-форму -

  1. Щелкните Добавить веб-форму.
  2. При нажатии кнопки «Добавить веб-форму» открывается вкладка с заголовком, описанием, категорией и статусом.
  3. Добавьте заголовок к веб-форме и краткое описание веб-формы.
  4. В конце, в разделе « Статус» есть два варианта: открытые и закрытые. Это означает, что если статус « открыт », форма доступна пользователю, в противном случае она закрыта. После редактирования всех параметров нажмите Сохранить . Например, здесь заголовок « Регистрация ».
веб-форма добавление полей

Добавление полей в веб-форму Drupal 8

При нажатии кнопки « Сохранить» открывается страница с заголовком веб-формы (здесь - «Регистрация»).

веб-форма Регистрация


● Чтобы добавить поля в веб-форму, нажмите + Добавить элемент .
● При нажатии + Добавить элемент появляется всплывающее окно со списком полей, которые можно использовать в веб-форме.

добавлять элементы в веб-форму


Чтобы предварительно просмотреть элементы, нажмите « Показать предварительный просмотр» справа вверху. Чтобы добавить элемент, нажмите кнопку « Добавить» соответствующего элемента. При нажатии на правой стороне страницы открывается всплывающее окно.

элементы веб-формы


Здесь есть возможности для редактирования названия заголовка и множество дополнительных настроек поля. После внесения всех изменений в настройки нажмите в конце кнопку « Сохранить» . Установите флажок под обязательным для всех обязательных полей веб-формы.

● Вы можете просмотреть созданную веб-форму, щелкнув вкладку « Просмотр » вверху. Кнопка «Отправить» создается автоматически при добавлении элемента в веб-форму.
● Вкладка « Тест » обеспечивает тестирование созданной веб-формы. Значения полей формы автоматически заполняются случайными значениями.
● На вкладке « Результат » можно просмотреть значения отправленной формы. На вкладке результатов есть три варианта.

  1. Список всех представленных форм на вкладке представления.
  2. Отправленные результаты могут быть загружены в четырех форматах: разделенный текст, таблицы HTML, документ JSON или документ Yaml на вкладке « Загрузить ».
  3. Можете очистить отправленные формы в прозрачной вкладке результатов.

● Вкладка «Настройки» содержит общие настройки веб-форм, которые могут быть изменены в соответствии с требованиями пользователя.

● Конфигурацию веб-формы Drupal можно загрузить на вкладке « Экспорт ». Отображается конфигурация, которую можно загрузить, нажав кнопку « Загрузить» в конце страницы. Конфигурация загружается в формате Yaml , поскольку файл конфигурации Yaml можно легко импортировать в другой экземпляр Drupal.

Добавление содержимого в веб-форму Drupal

Как только модуль Drupal 8 Webform включен, создается тип контента с именем « webform ». У него есть такие поля, как заголовок, тело и веб-форма. В веб-форме есть раскрывающийся список со всеми созданными веб-формами.

Чтобы добавить контент в веб-форму, выберите «Контент»> «Добавить контент»> «Веб-форма» . Как уже упоминалось, будет заголовок и тело. Существует раскрывающийся список с надписью Webform, в котором указаны названия всех созданных веб-форм.

веб-форма

Рядом с этим есть еще одна опция, которая называется « Настройки веб - формы ».

настройки веб-формы

В разделе « Статус» есть три варианта: « Открыть» (чтобы оставаться открытой для пользователей), « Закрыто» (чтобы закрыть форму для пользователей) и « Запланировано» ( будет отображаться поле даты и времени, а в соответствии с указанными датой и временем форма будут оставаться открытыми для заполнения пользователями).

Вы также можете предоставить данные по умолчанию, заполнив поле данных отправки по умолчанию доступным токеном. Маркер можно просмотреть, нажав Обзор доступных маркеров . Примеры для записи токена можно просмотреть, щелкнув ссылку «Пример» . И можете просмотреть все отправленные формы на вкладке « Результат ».

Добавление веб-формы Drupal 8 в качестве поля в типах контента

Чтобы добавить веб-форму Drupal в тип контента, перейдите в раздел Структура> Типы контента> Управление полями того типа контента, для которого форма требуется.

Щелкните поле Добавить . В разделе «Добавить новое поле» выберите « Веб - форма » в разделе « Ссылки », дайте название этому полю и нажмите «Сохранить и продолжить».

В настройках поля можно указать количество значений, разрешенных для поля, и нажать «Сохранить настройки поля».

Вы можете выбрать форму по умолчанию из значения по умолчанию или нажать « Сохранить настройки ».

Теперь перейдите в « Содержание»> «Добавить контент» и выберите тип контента, в котором есть поле, относящееся к веб-формам.

веб-форма

В раскрывающемся списке выберите форму, которая требуется для этого содержимого. Отправленную форму можно просмотреть на вкладке « Результат » этого содержимого.

Добавление капчи в веб-формы Drupal

Вы, должно быть, видели, что Captcha широко используется на многих веб-сайтах. Перед отправкой формы она задает вопрос и запрашивает ответ у пользователя. Это предотвращает перегрузку серверов ботами, отправляя множество форм и сообщений электронной почты.

Drupal Webform позволяет добавлять элемент Captcha при создании веб-формы. Captcha веб-формы Drupal требует, чтобы вы включили модуль Captcha.

Шаги по добавлению капчи веб-формы Drupal в формы:

Загрузите и включите модуль captcha с www.drupal.org/project/captcha .

Перейдите в Структура> Веб-формы .

Нажмите на сборку формы, для которой требуется капча.

Щелкните Добавить элемент и разверните Дополнительные элементы . Расширяя список, можно просмотреть дополнительные элементы. Нажмите на Добавить элемент капчи, чтобы добавить капчу.

капча веб-форм

При нажатии на Добавить элемент справа откроется окно настроек. Установите флажок Режим администратора, чтобы администратор мог отлаживать и просматривать капчу.

А в типе Challenge у нас есть 2 варианта - математика и изображение. Вы можете выбрать любой из ваших вариантов. Затем нажмите « Сохранить» и « Сохранить элементы» .

Добавьте поле в тип контента типа поля Webform и обратитесь к форме, для которой добавляется капча.

Теперь перейдите в Content> Add content> и выберите тип контента, в котором есть поле, относящееся к форме.

Заполните заголовок и сохраните содержимое. Когда вы просматриваете контент, форма вместе с капчей публикуется. Перед проверкой кнопки отправки необходимо заполнить поле captcha, иначе форма не будет отправлена ​​и выдаст предупреждающее сообщение.

веб-форма drupal 8

Преимущества модуля Drupal Webform

Модуль Drupal Webform имеет открытый исходный код, что означает, что он бесплатный, и вам нужно только время, чтобы установить и настроить формы.

Вы также можете выполнять проверку формы с помощью хуков, обработчиков веб-форм или модуля проверки веб-форм Drupal. Модуль проверки веб-форм Drupal добавляет дополнительную вкладку к узлу, где вы можете настроить и создать свои собственные правила проверки.

Эти веб-формы являются гибкими и позволяют настраивать поля, используемые в формах.

В одной установке он предоставляет множество опций, таких как отправка уведомлений и писем пользователю и администратору.

Drupal Webforms упрощает экспорт результатов отправки. Пользователи могут просматривать результат отправленной формы в интерфейсе администратора, а также могут экспортировать результат в формате CSV, нажав одну кнопку.