Forms: 3rd-Party Integration v1.8

Отправьте контактную форму 7, Gravity Forms или Ninja Forms в стороннюю службу, например CRM. Несколько настраиваемых сервисов, настраиваемое сопоставление полей. Предоставляет перехватчики и фильтры для предварительной и последующей обработки результатов. Позволяет отправлять отдельные электронные письма или прикреплять дополнительные результаты к существующим электронным письмам. Поставляется с парой примеров хуков для распространенных CRM (listrak, mailchimp, salesforce). В разделе часто задаваемых вопросов вы найдете дополнительные плагины, которые расширяют эту функциональность, например отправку сообщений XML/SOAP, настройку заголовков и динамических полей.

По сути, плагин выполняет удаленный запрос (POST) к URL-адресу службы, передавая пересопоставленные значения отправки формы.

На основе идеи Алекса Хагера "Как интегрировать Salesforce в контактную форму 7".

Оригинальный плагин Contact Form 7: интеграция со сторонними организациями, разработанный при содействии AtlanticBT. Текущий плагин спонсируется Stephen P. Kane Consulting. Пожалуйста, отправляйте запросы на поддержку или ошибки в систему отслеживания проблем GitHub в дополнение к форумам поддержки WordPress, поскольку форумы не отправляют электронные письма.

Компоненты

Обратите внимание, что эта документация постоянно меняется и может быть неточной для последней версии 1.4.0.

- add_action("Forms3rdPartyIntegration_service_a", $response, $param_ref);

- крючок для каждого сервиса, обозначенный - это указано в разделе "Хуки" каждого сервиса.

- предоставить функцию, которая принимает $response и $results в качестве аргументов

- позволяет выполнять дальнейшую обработку ответа службы и напрямую изменять результаты обработки, представленные в виде массива("success"=>false, "errors"=>false, "attach"=>"", "message" => "");

- успех = true или false - изменить, считается ли запрос на обслуживание "правильным" или нет.

- error = массив сообщений об ошибках для возврата в форму

- Attach = текст, который нужно прикрепить к концу тела письма.

- message = отображаемое уведомление о сообщении (из ответа ajax CF7) под формой

- обратите внимание, что базовое "условие успеха" здесь может быть дополнено постобработкой

- add_action("Forms3rdPartyIntegration_service", $response, $param_ref, $sid);

- то же, что и предыдущий хук, но не привязан к конкретной услуге

- add_filter("Forms3rdPartyIntegration_service_filter_post_, ...

- крючок для каждого сервиса, обозначенный - это указано в разделе "Хуки" каждого сервиса.

- позволяет программно изменять параметры запроса, отправляемого в сервис

- должен возвращать обновленный массив $post

- add_filter("Forms3rdPartyIntegration_service_filter_post", "YOUR_HOOK", 10, 4);

- в дополнение к специфичному для услуги суффиксу _a; принимает параметры $post, $service, $form, $sid

- add_filter("Forms3rdPartyIntegration_service_filter_args", "YOUR_HOOK", 10, 3);

- изменить массив args, отправленный в wp_remote_post

- позволяет добавлять заголовки или переопределять существующие настройки (таймаут, тело)

- если вы вернете массив, содержащий ключ response_bypass, он пропустит обычный POST и вместо этого будет использовать это значение в качестве стороннего ответа; обратите внимание, что он должен соответствовать формату обычного ответа wp_remote_post.

- Примечание: при использовании response_bypass вам следует рассмотреть возможность включения исходных аргументов в результат обратного вызова в целях отладки.

- add_action("Forms3rdPartyIntegration_remote_failure", "mycf7_fail", 10, 5);

- перехватчик для изменения объекта формы (CF7 или GF) в случае какого-либо сбоя в обслуживании - используйте примерно так:

function mycf7_fail(&$cf7, $debug, $service, $post, $response) {

$cf7->skip_mail = правда; // остановить отправку электронной почты

// перехватить сообщение, чтобы уведомить пользователя

///TODO: как изменить переменную "mail_sent", чтобы сообщение не было зеленым? on_sent_ok взломать?

$cf7->messages["mail_sent_ok"] = "Не удалось выполнить почтовый запрос:** " . $response["safe_message"];

}

- нужен какой-то способ изменить возвращаемую переменную mail_sent в CF7, чтобы лучше указывать на ошибку - в настоящее время нет возможности получить к ней прямой доступ.

- add_action("Forms3rdPartyIntegration_service_settings", "YOUR_HOOK", 10, 3)

- принимает параметры $eid, $P, $entity, соответствующие индексу каждого объекта службы и пространству имен этого плагина, а также массив настроек $entity.

- позволяет добавить раздел в настройки администратора каждого сервиса

- назовите поля формы с пространством имен плагина для автоматического сохранения: $P[$eid][ВАШЕ_ПОЛЬЗОВАТЕЛЬСКОЕ_ПОЛЕ] $rarr; Forms3rdPartyIntegration[0][ВАШЕ_ПОЛЬЗОВАТЕЛЬСКОЕ_ПОЛЕ]

- add_action("Forms3rdPartyIntegration_service_metabox", "ВАШ_КРЮК", 10, 2)

- принимает параметры $P, $entity, соответствующие индексу каждого объекта службы и пространства имен этого плагина, а также массив настроек $options (представляющий полные настройки плагина)

- позволяет добавить метабокс (или что-нибудь еще) на страницу настроек администратора плагина

- назовите поля формы с пространством имен плагина для автоматического сохранения: $P[YOUR_CUSTOM_FIELD] $rarr; Forms3rdPartyIntegration[ВАШ_CUSTOM_ПОЛЕ]

- add_filter("Forms3rdPartyIntegration_debug_message", "YOUR_HOOK", 10, 5);

- обход/альтернативное ведение журнала отладки

- add_filter("Forms3rdPartyIntegration_plugin_hooks", "ВАШ_HOOK", 10, 1);

- Принимает массив хуков плагинов контактной формы для присоединения F3p и возвращает этот массив. Мо