Документация MevvForms

Доступные формы, локальные записи и обратимая миграция.

MevvForms отвечает за схему формы, проверку на стороне сервера, доступную отрисовку, локальные записи и устойчивую очередь уведомлений. В этом руководстве описаны рабочий основной выпуск и проверенный путь замены существующей формы WPForms без удаления её исходных данных.

Обзор и требования

MevvForms Free — локальная среда выполнения. Опубликованная форма читается из версионируемой записи формы WordPress, отрисовывается с настоящими подписями и связями с ошибками, заново проверяется на сервере, сохраняется локально и передаётся в устойчивую очередь уведомлений.

WordPress
6.6 или новее; проверено вплоть до WordPress 7.1.
PHP
8.1 или новее; матрица выпусков покрывает PHP 8.1–8.5.
Граница данных
Определения форм, записи и задания в очереди по умолчанию остаются на сайте WordPress.
Файлы перевода
Для турецкого и английского включены редактируемые PO, скомпилированные MO и каталоги POT.

Пока посетитель отрисовывает или отправляет форму, бесплатная редакция не обращается к внешнему сервису ни за лицензией, ни с телеметрией, ни за AI, ни за обновлением.

Установка

  1. Сделайте восстановимую резервную копию базы данных и wp-content.
  2. Загрузите и активируйте ZIP MevvForms Free.
  3. Убедитесь, что таблицы базы данных MevvForms созданы и что администратор может открыть панель управления.
  4. Держите исходный плагин форм активным, пока не завершатся предпросмотр миграции, импорт и проверки работоспособности.
  5. Устанавливайте соответствующий компаньон Pro только тогда, когда сохранённая форма использует выпущенный модуль Pro.

Не удаляйте бесплатный пакет, пока установлен Pro. Среда выполнения сохранённой формы принадлежит бесплатной редакции; Pro её расширяет.

Отрисовка и отправка формы

Вставьте опубликованную форму через [mevvforms id="123"]. Отрисовщик выводит стабильные идентификаторы полей, настоящие подписи, описания, цель для сводки ошибок и подписанную сессию, привязанную к текущей ревизии формы.

  • Обязательность и правила проверки берутся из схемы, которой владеет сервер.
  • Скрытые или неизвестные значения от клиента не могут ослабить правила сервера.
  • Корректная отправка создаёт запись раньше, чем сработает любой побочный эффект уведомления.
  • Ответ содержит настроенное сообщение или безопасное перенаправление, но никогда — сохранённые значения полей.

Если форма изменилась после того, как страница была открыта, обновите страницу перед отправкой, чтобы подписанная сессия совпала с текущей ревизией.

Обратимая миграция с WPForms

Миграция начинается только на чтение. Предпросмотр перечисляет сопоставленные поля, уведомления, подтверждения, вставки на страницах и неподдерживаемые настройки. Применение создаёт или обновляет одну подготовленную форму MevvForms и записывает хеш источника. Оно не удаляет ни данные WPForms, ни ревизии, ни таблицы, ни содержимое страниц.

  1. Требуйте точного предпросмотра до применения.
  2. Импортируйте форму как подготовленную и снова сравните хеши источника.
  3. Прогоните проверочный шлюз перехода: публикация, отрисовка, подписанная тестовая отправка, локальная запись и уведомление в очереди.
  4. Исходный плагин можно отключать только после того, как эти проверки пройдены.
  5. Если какая-либо проверка не проходит, откат восстанавливает прежний список активных плагинов и возвращает импортированную форму в черновики.

Измеренный инвентарь mevvshop.com — одна исходная форма с 4 полями, 1 уведомлением, 1 подтверждением и одной живой вставкой. Эти числа — шлюз выпуска для того сайта, а не обещание про каждую форму WPForms.

Записи и граница приватности

Записи и типизированные проекции полей хранятся в отдельных локальных таблицах. Пароли, данные карт, CVV, nonce WordPress, сессионные токены и поля, помеченные store=false, никогда не пишутся в значения записи.

  • IP-адреса представлены только специфичным для сайта HMAC там, где это нужно для ограничения частоты.
  • Текстовые, числовые и датовые проекции поддерживают последующий поиск, не меняя исходной идентичности поля.
  • Неудачная запись в таблицу записей или в outbox откатывает всю транзакцию отправки.
  • Боевые свидетельства фиксируют только идентификаторы формы, записи и задания; отправленные значения не фиксируются никогда.

Уведомления и подтверждения

Уведомления — устойчивые задания. Сбой почты не может стереть принятую запись: временные неудачи повторяются с ограниченными задержками, а постоянные ошибки конфигурации останавливаются до вмешательства администратора.

Заголовки
Получатели и подстановочные теги в заголовках проверяются; внедрение CR/LF вырезается.
Тело
HTML экранируется или фильтруется под контекст вывода.
Подтверждение
Решение о сообщении, странице того же сайта или перенаправлении из списка разрешённых берётся из сохранённой схемы.
Идемпотентность
Один и тот же ключ задания уведомления не может дважды создать один и тот же побочный эффект.

Граница между бесплатной редакцией и Pro

Бесплатной редакции принадлежит надёжная среда выполнения: схема, базовые поля, доступная отрисовка, проверка на сервере, локальные записи, уведомления через outbox, подтверждения, двуязычная админка и обратимая миграция с WPForms.

Pro — компаньон для продвинутых выпущенных модулей. Условные сценарии, многошаговые инструменты конверсии, документы, коммерция, интеграции, аналитика и поверхности для разработчиков включаются лишь по мере закрытия их шлюзов выпуска. Сохранённая конфигурация Pro должна и дальше отрисовываться и отправляться, пока установленный код Pro остаётся доступным, даже если лицензия позже истечёт.

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

Решение проблем и откат

Старый шорткод пуст
Убедитесь, что у исходного идентификатора есть активное сопоставление миграции и что шорткод wpforms не принадлежит другому плагину.
Отправка сообщает об истёкшей сессии
Перезагрузите страницу и отправьте её против последней опубликованной ревизии.
Уведомление ждёт
Откройте состояние очереди, исправьте постоянную ошибку конфигурации или дождитесь запланированной повторной попытки при временной ошибке транспорта.
Переход не отключил WPForms
Прочитайте результат проверки. Защитный шлюз сохранил или восстановил WPForms, потому что не удалась проверка отрисовки, отправки, записи или задания.

Для поддержки сообщите версии плагина, WordPress и PHP плюс безопасный код ошибки. Перед отправкой журналов уберите значения полей, данные клиентов, сессионные токены, nonce и ключи лицензий.