WP Manifestindependent plugin directory
manifest / integrations / strix_prodamus_cf7_api

CF7 Prodamus XL Integration

Integrates Contact Form 7 with Prodamus XL API to automatically create leads and deals from form submissions.

by Your Name · github.com/n1kitadev/strix_prodamus_cf7_api · website

★ 0stars
0forks

Install

No release zip yet. The repository archive installs, but the folder name will carry the branch suffix and updates will not flow:

wp plugin install https://github.com/n1kitadev/strix_prodamus_cf7_api/archive/refs/heads/master.zip
Readme github.com/n1kitadev/strix_prodamus_cf7_api ↗

Плагин для интеграции Contact Form 7 с API Prodamus XL. Автоматически создает лиды и сделки в Prodamus XL при отправке форм Contact Form 7.

🚀 Возможности

  • ✅ Автоматическая интеграция с Contact Form 7
  • ✅ Создание лидов и сделок в Prodamus XL
  • ✅ Настраиваемые параметры API
  • ✅ Поддержка нескольких форм
  • ✅ Детальное логирование всех операций
  • ✅ Безопасная обработка данных
  • ✅ Современный интерфейс настроек

📦 Установка

Вариант 1: Через GitHub (рекомендуется для разработчиков)

cd wp-content/plugins/
git clone https://github.com/N1kitaDev/Strix_Prodamus_CF7_API.git cf7-prodamus-xl-integration

Вариант 2: Ручная установка

  1. Скачайте ZIP архив с GitHub
  2. Распакуйте в wp-content/plugins/
  3. Переименуйте папку в cf7-prodamus-xl-integration

Активация

  1. Зайдите в админку WordPress
  2. Перейдите Plugins → Installed Plugins
  3. Найдите CF7 Prodamus XL Integration и активируйте

⚙️ Настройка

Предварительные требования

  • ✅ WordPress 5.0+
  • ✅ Contact Form 7 5.0+
  • ✅ PHP 7.0+
  • ✅ Аккаунт Prodamus XL с API токеном

Шаг 1: Настройка плагина

  1. Перейдите CF7 Prodamus XL в меню админки
  2. Введите ваш API Token из Prodamus XL
  3. Настройте Stage ID (этап воронки продаж)
  4. Укажите Responsible User ID (ответственный пользователь)
  5. Укажите ID форм для интеграции (опционально)

Шаг 2: Настройка формы Contact Form 7

Убедитесь, что ваша форма содержит следующие поля:

[text* your-name placeholder "Ваше имя"]
[email* your-email placeholder "Email"]
[tel your-phone placeholder "Телефон"]
[text your-contactway placeholder "Способ связи"]

🔧 Настройки

API Token

Ваш токен авторизации из Prodamus XL. Где найти: Prodamus XL → Настройки → API

Stage ID

ID этапа воронки продаж для создания сделок. По умолчанию: 1gKg6-JsY0aftO_lcO6vwQ ("Новая регистрация")

Responsible User ID

ID пользователя, ответственного за сделки. По умолчанию: GEqhVZNU5kG2dgZf48RkEQ

Form IDs

Список ID форм CF7 через запятую. Пример: 10619, 10620, 10621 Пустое поле: интеграция для всех форм

📋 Маппинг полей

Плагин автоматически сопоставляет поля формы:

Поле CF7 Назначение Обязательно
your-name Имя контакта ✅
your-email Email контакта ✅
your-phone Телефон ❌
your-contactway Способ связи ❌

🔍 Логирование

Все операции логируются в wp-content/debug.log:

// Успешное создание лида
CF7 Prodamus XL: Lead created successfully, contact ID: abc123

// Успешное создание сделки
CF7 Prodamus XL: Deal created successfully, ID: def456

// Ошибки
CF7 Prodamus XL: API token not configured
CF7 Prodamus XL: Lead creation failed. Response: {...}

🧪 Тестирование

Шаг 1: Тестовая форма

Создайте тестовую форму CF7 с необходимыми полями.

Шаг 2: Отправка формы

  1. Заполните и отправьте форму
  2. Проверьте логи WordPress на ошибки
  3. Проверьте создание лида в Prodamus XL

Шаг 3: Проверка результатов

  • Новый контакт в Prodamus XL
  • Новая сделка в указанной стадии воронки
  • Корректные данные контакта

🛠️ Разработка

Структура плагина

cf7-prodamus-xl-integration/
├── cf7-prodamus-xl-integration.php    # Основной файл
├── includes/
│   ├── class-cf7-prodamus-xl-admin.php     # Админка
│   └── class-cf7-prodamus-xl-integration.php # Интеграция
├── README.md                            # Документация
├── readme.txt                          # WP readme
├── uninstall.php                       # Деинсталляция
└── .gitignore                         # Игнорируемые файлы

Хуки WordPress

// Основной хук интеграции
add_action('wpcf7_before_send_mail', 'process_form_submission', 10, 1);

// Хуки админки
add_action('admin_menu', 'add_admin_menu');
add_action('admin_init', 'register_settings');

API Endpoints Prodamus XL

  • Создание лида: POST /api/v1/crm/lead
  • Создание сделки: POST /api/v1/pipeline/stage/item

🐛 Устранение неполадок

Распространенные проблемы

1. Формы не интегрируются

Решение:

  • Проверьте, что Contact Form 7 активирован
  • Убедитесь, что указаны правильные ID форм
  • Проверьте логи на наличие ошибок

2. Ошибка "API token not configured"

Решение:

  • Введите корректный API токен в настройках плагина
  • Убедитесь, что токен активен в Prodamus XL

3. Ошибка "Lead creation failed"

Решение:

  • Проверьте корректность API токена
  • Убедитесь, что форма содержит обязательные поля
  • Проверьте логи на детальное описание ошибки

Debug режим

Добавьте в wp-config.php:

define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);

📞 Поддержка

📄 Лицензия

Этот проект распространяется под лицензией GPL v2 или выше.

🤝 Вклад в развитие

  1. Fork репозиторий
  2. Создайте feature branch (git checkout -b feature/AmazingFeature)
  3. Commit изменений (git commit -m 'Add some AmazingFeature')
  4. Push в branch (git push origin feature/AmazingFeature)
  5. Создайте Pull Request

📈 Changelog

v1.0.0 (2026-01-16)

  • 🎉 Первый релиз
  • ✅ Базовая интеграция с Prodamus XL API
  • ✅ Админ панель настроек
  • ✅ Поддержка маппинга полей CF7
  • ✅ Детальное логирование операций
  • ✅ Безопасная обработка данных

Совместимость

  • WordPress 5.0+
  • Contact Form 7 5.0+
  • PHP 7.0+