FForms WP Registry grade D+. High-severity findings · 2 findingsWP RegistryHigh-severity findings · 2 findingsOpen the reportD+

Современный WordPress-плагин для contact/lead-форм с REST-first архитектурой.

Use cases

• contact forms
• lead forms
• public forms, quizzes, surveys and brief forms
• headless cms and email smtp for form submissions from JAMStack sites like AstroJS

Два режима

У плагина ровно две точки входа.

Headless API — один роут POST /wp-json/fforms/v1/main без схемы. Форму создавать не нужно: какие поля передали, такие и записали, а formType классифицирует заявку, чтобы записи можно было фильтровать. Без formType заявка получает тип main.

curl -X POST https://example.com/wp-json/fforms/v1/main \
  -H "Content-Type: application/json" \
  -d '{ "formType": "consultation", "email": "anna@example.com", "company": "Acme" }'

Конструктор — форма собирается блоками в Gutenberg и после публикации доступна сразу всеми способами: блок Form by FForms, шорткод [fform id=123], а если включить «Share via link» в панели «Publication» — ещё и секретная ссылка /forms/<токен>/ (без индексации), iframe- и js-сниппеты. Ссылку можно перевыпустить: старая перестаёт работать сразу.

Быстрый старт

1. Активируйте плагин и откройте FForms → Добавить форму.
2. Соберите поля блоками и опубликуйте форму.
3. Вставьте её блоком или шорткодом; для внешнего сайта включите «Share via link» и скопируйте нужный сниппет.
4. Записи доступны в FForms → Записи, экспорт — в FForms → Экспорт CSV.

Пример submit из формы конструктора:

{
  "form_id": 123,
  "fields": {
    "name": "Анна",
    "email": "anna@example.com",
    "message": "Перезвоните мне"
  },
  "website": "",
  "source": "https://example.com/contact"
}

Встроенный SMTP выключен по умолчанию. Не включайте его одновременно с другим SMTP-плагином.

Локальная разработка (wp-env)

Требуется Docker и Node 20+.

make install
make start        # http://localhost:8890 — admin/password
make status       # проверить, что всё поднялось

Плагин монтируется в контейнер из этой папки ("plugins": ["."] в .wp-env.json), правки в PHP/JS видны сразу без перезапуска. Ядро WordPress качается в контейнер ("core": null — последний стабильный).

Полный список целей — make help. Те же операции есть и как npm-скрипты:

Порт 8890 выбран, чтобы не конфликтовать с окружением монорепо wpcraft на 8888. Тестовое окружение отключено ("testsEnvironment": false) — включите, когда появятся PHPUnit-тесты. Локальные переопределения — в .wp-env.override.json (в git не попадает).

WP_DEBUG и SCRIPT_DEBUG включены, PHP-ошибки пишутся в wp-content/debug.log внутри контейнера:

make tail