Initial commit

This commit is contained in:
gustavooth
2026-07-23 22:56:30 -03:00
commit 22a1006598
1816 changed files with 410742 additions and 0 deletions
@@ -0,0 +1,659 @@
<?php
namespace FluentCrm\App\Services\ExternalIntegrations\FluentForm;
use FluentCrm\App\Models\CustomContactField;
use FluentCrm\App\Models\Lists;
use FluentCrm\App\Models\Subscriber;
use FluentCrm\App\Models\Tag;
use FluentCrm\App\Services\Funnel\FunnelHelper;
use FluentCrm\Framework\Support\Arr;
use FluentForm\App\Http\Controllers\IntegrationManagerController;
use FluentForm\App\Modules\Form\FormFieldsParser;
use FluentForm\App\Services\FormBuilder\ShortCodeParser;
use FluentForm\App\Services\Integrations\GlobalNotificationService;
use FluentForm\Framework\Helpers\ArrayHelper;
class Bootstrap extends IntegrationManagerController
{
public $hasGlobalMenu = false;
public $disableGlobalSettings = 'yes';
public function __construct()
{
parent::__construct(
null,
__('FluentCRM', 'fluent-crm'),
'fluentcrm',
'_fluentform_fluentcrm_settings',
'fluentcrm_feeds',
10
);
$this->logo = FLUENTCRM_PLUGIN_URL . 'assets/images/fluentcrm-logo.svg';
$this->description = __('Connect FluentCRM with WP Fluent Forms and subscribe a contact when a form is submitted.', 'fluent-crm');
$this->registerAdminHooks();
add_filter('fluentform/notifying_async_fluentcrm', '__return_false');
$this->registerPaymentEvents();
}
public function pushIntegration($integrations, $formId)
{
$integrations[$this->integrationKey] = [
'title' => $this->title . ' Integration',
'logo' => $this->logo,
'is_active' => $this->isConfigured(),
'configure_title' => __('Configuration required!', 'fluent-crm'),
'global_configure_url' => '#',
'configure_message' => __('FluentCRM is not configured yet! Please configure your FluentCRM API first', 'fluent-crm'),
'configure_button_text' => __('Set FluentCRM', 'fluent-crm')
];
return $integrations;
}
public function getIntegrationDefaults($settings, $formId)
{
return [
'name' => '',
'first_name' => '',
'last_name' => '',
'full_name' => '',
'email' => '',
'other_fields' => [
[
'item_value' => '',
'label' => ''
]
],
'list_id' => '',
'tag_ids' => [],
'tag_ids_selection_type' => 'simple',
'tag_routers' => [],
'skip_if_exists' => false,
'double_opt_in' => false,
'force_subscribe' => false,
'skip_primary_data' => false,
'conditionals' => [
'conditions' => [],
'status' => false,
'type' => 'all'
],
'run_events_only' => [],
'remove_tags' => [],
'enabled' => true
];
}
public function getSettingsFields($settings, $formId)
{
$form = fluentFormApi('forms')->find($formId);
$paymentFields = FormFieldsParser::getPaymentFields($form, ['element']);
$fieldOptions = [];
foreach (Subscriber::mappables() as $key => $column) {
$fieldOptions[$key] = $column;
}
foreach ((new CustomContactField)->getGlobalFields()['fields'] as $field) {
$fieldOptions[$field['slug']] = $field['label'];
}
$fieldOptions['avatar'] = 'Profile Photo';
unset($fieldOptions['email']);
unset($fieldOptions['first_name']);
unset($fieldOptions['last_name']);
$fields = [
[
'key' => 'name',
'label' => __('Feed Name', 'fluent-crm'),
'required' => true,
'placeholder' => __('Your Feed Name', 'fluent-crm'),
'component' => 'text'
],
[
'key' => 'list_id',
'label' => __('FluentCRM List', 'fluent-crm'),
'placeholder' => __('Select FluentCRM List', 'fluent-crm'),
'tips' => __('Select the FluentCRM List you would like to add your contacts to.', 'fluent-crm'),
'component' => 'select',
'required' => false,
'options' => $this->getLists(),
],
[
'key' => 'CustomFields',
'require_list' => false,
'label' => __('Primary Fields', 'fluent-crm'),
'tips' => __('Associate your FluentCRM merge tags to the appropriate Fluent Form fields by selecting the appropriate form field from the list.', 'fluent-crm'),
'component' => 'map_fields',
'field_label_remote' => __('FluentCRM Field', 'fluent-crm'),
'field_label_local' => __('Form Field', 'fluent-crm'),
'primary_fileds' => [
[
'key' => 'email',
'label' => __('Email Address', 'fluent-crm'),
'required' => true,
'input_options' => 'emails'
],
[
'key' => 'first_name',
'label' => __('First Name', 'fluent-crm')
],
[
'key' => 'last_name',
'label' => __('Last Name', 'fluent-crm')
],
[
'key' => 'full_name',
'label' => __('Full Name', 'fluent-crm'),
'help_text' => __('If First Name & Last Name is not available full name will be used to get first name and last name', 'fluent-crm')
]
]
],
[
'key' => 'other_fields',
'require_list' => false,
'label' => __('Other Fields', 'fluent-crm'),
'tips' => __('Select which Fluent Form fields pair with their<br /> respective FluentCRM fields.', 'fluent-crm'),
'component' => 'dropdown_many_fields',
'field_label_remote' => __('FluentCRM Field', 'fluent-crm'),
'field_label_local' => __('Form Field', 'fluent-crm'),
'options' => $fieldOptions
],
[
'key' => 'tag_ids',
'require_list' => false,
'label' => __('Contact Tags', 'fluent-crm'),
'placeholder' => __('Select Tags', 'fluent-crm'),
'component' => 'selection_routing',
'simple_component' => 'select',
'routing_input_type' => 'select',
'routing_key' => 'tag_ids_selection_type',
'settings_key' => 'tag_routers',
'is_multiple' => true,
'labels' => [
'choice_label' => __('Enable Dynamic Tag Selection', 'fluent-crm'),
'input_label' => '',
'input_placeholder' => __('Set Tag', 'fluent-crm')
],
'options' => $this->getTags()
],
[
'key' => 'skip_if_exists',
'require_list' => false,
'checkbox_label' => __('Skip if contact already exists in FluentCRM', 'fluent-crm'),
'component' => 'checkbox-single'
],
[
'key' => 'skip_primary_data',
'require_list' => false,
'checkbox_label' => __('Skip name update if an existing contact has old data (per primary field)', 'fluent-crm'),
'component' => 'checkbox-single'
],
[
'key' => 'double_opt_in',
'require_list' => false,
'checkbox_label' => __('Enable Double opt-in for new contacts', 'fluent-crm'),
'component' => 'checkbox-single'
],
[
'key' => 'force_subscribe',
'require_list' => false,
'checkbox_label' => __('Enable Force Subscribe if contact is not in subscribed status (Existing contact only)', 'fluent-crm'),
'component' => 'checkbox-single',
'inline_tip' => __('If you enable this, the contact will be forcefully subscribed regardless of the contact\'s current status', 'fluent-crm')
],
[
'require_list' => false,
'key' => 'conditionals',
'label' => __('Conditional Logics', 'fluent-crm'),
'tips' => __('Allow FluentCRM integration conditionally based on your submission values', 'fluent-crm'),
'component' => 'conditional_block'
]
];
if ($paymentFields) {
$hasSubscriptionFields = !!FormFieldsParser::getInputsByElementTypes($form, ['subscription_payment_component']);
$options = [
'fluentform/payment_refunded' => __('On Payment Refund', 'fluent-crm')
];
if ($hasSubscriptionFields) {
$options = [
'fluentform/subscription_payment_active' => __('On Subscription Active', 'fluent-crm'),
'fluentform/subscription_payment_canceled' => __('On Subscription Cancel', 'fluent-crm'),
'fluentform/payment_refunded' => __('On Payment Refund', 'fluent-crm')
];
}
$fields[] = [
'require_list' => false,
'key' => 'run_events_only',
'label' => __('Run only on events', 'fluent-crm'),
'component' => 'checkbox-multiple-text',
'options' => $options,
'tips' => __('If you check any of the events, then this feed will only run for the selected events', 'fluent-crm')
];
}
$fields[] = [
'require_list' => false,
'key' => 'remove_tags',
'label' => __('Remove Contact Tags', 'fluent-crm'),
'placeholder' => __('Select Tags (remove from contact)', 'fluent-crm'),
'tips' => __('(Optional) The selected tags will be removed from the contact (if it exists)', 'fluent-crm'),
'component' => 'select',
'is_multiple' => true,
'required' => false,
'options' => $this->getTags(),
];
$fields[] = [
'require_list' => false,
'key' => 'enabled',
'label' => __('Status', 'fluent-crm'),
'component' => 'checkbox-single',
'checkbox_label' => __('Enable This feed', 'fluent-crm')
];
return [
'fields' => $fields,
'button_require_list' => false,
'integration_title' => $this->title
];
}
public function getMergeFields($list, $listId, $formId)
{
return [];
}
protected function getLists()
{
$lists = Lists::orderBy('title', 'ASC')->get();
$formattedLists = [];
foreach ($lists as $list) {
$formattedLists[$list->id] = $list->title;
}
return $formattedLists;
}
protected function getTags()
{
$tags = Tag::orderBy('title', 'ASC')->get();
$formattedTags = [];
foreach ($tags as $tag) {
$formattedTags[strval($tag->id)] = $tag->title;
}
return $formattedTags;
}
/*
* Form Submission Hooks Here
*/
public function notify($feed, $formData, $entry, $form)
{
// check if only on payment event
if (Arr::get($feed, 'settings.run_events_only')) {
// We have running events selected. So we may not run this feed.
$paymentFields = FormFieldsParser::getPaymentFields($form, ['element']);
if ($paymentFields) {
return false;
}
}
return $this->runFeed($feed, $formData, $entry, $form);
}
private function runFeed($feed, $formData, $entry, $form)
{
$data = $feed['processedValues'];
$contact = Arr::only($data, ['first_name', 'last_name', 'email']);
if (!is_email($contact['email'])) {
$contact['email'] = ArrayHelper::get($formData, $contact['email']);
}
if (!$contact['first_name'] && !$contact['last_name']) {
$fullName = Arr::get($data, 'full_name');
if ($fullName) {
$nameArray = explode(' ', $fullName);
if (count($nameArray) > 1) {
$contact['last_name'] = array_pop($nameArray);
$contact['first_name'] = implode(' ', $nameArray);
} else {
$contact['first_name'] = $fullName;
}
}
}
foreach (Arr::get($data, 'other_fields') as $field) {
if ($field['item_value']) {
$contact[$field['label']] = str_replace('<br />', ' ', $field['item_value']);
}
}
if ($entry->ip) {
$contact['ip'] = $entry->ip;
}
if (!is_email($contact['email'])) {
$this->addLog(
$feed['settings']['name'],
'failed',
__('FluentCRM API called skipped because no valid email available', 'fluent-crm'),
$form->id,
$entry->id
);
return false;
}
if (isset($contact['country'])) {
$country = FunnelHelper::getCountryShortName($contact['country']);
if ($country) {
$contact['country'] = $country;
} else {
unset($contact['country']);
}
}
$subscriber = Subscriber::where('email', $contact['email'])->first();
if ($subscriber && Arr::isTrue($data, 'skip_if_exists')) {
$this->addLog(
$feed['settings']['name'],
'info',
__('Contact creation has been skipped because the contact already exists in the database', 'fluent-crm'),
$form->id,
$entry->id
);
return false;
}
if (!empty($contact['avatar'])) {
// validate the avatar photo
$validUrl = '';
if (filter_var($contact['avatar'], FILTER_VALIDATE_URL) !== FALSE) {
$url = $contact['avatar'];
$dots = explode('.', $url);
$ext = strtolower(end($dots));
if (in_array($ext, ['png', 'jpg', 'jpeg', 'webp', 'gif'])) {
$validUrl = $contact['avatar'];
}
}
if (!$validUrl) {
unset($contact['avatar']);
}
}
if ($subscriber) {
if ($subscriber->ip && isset($contact['ip'])) {
unset($contact['ip']);
}
if (Arr::isTrue($data, 'skip_primary_data')) {
if ($subscriber->first_name) {
unset($contact['first_name']);
unset($contact['last_name']);
}
}
}
$user = get_user_by('email', $contact['email']);
if ($user) {
$contact['user_id'] = $user->ID;
}
$tags = $this->getSelectedTagIds($data, $formData, 'tag_ids');
if ($tags) {
$contact['tags'] = $tags;
}
if (!$subscriber) {
if (empty($contact['source'])) {
$contact['source'] = 'FluentForms';
}
if (Arr::isTrue($data, 'double_opt_in')) {
$contact['status'] = 'pending';
} else {
$contact['status'] = 'subscribed';
}
if ($listId = Arr::get($data, 'list_id')) {
$contact['lists'] = [$listId];
}
$subscriber = FluentCrmApi('contacts')->createOrUpdate($contact, false, false);
if (!$subscriber) {
return false;
}
if ($entry->status == 'confirmed' && $subscriber->status != 'subscribed') {
$subscriber = $subscriber->updateStatus('subscribed');
}
if ($subscriber->status == 'pending') {
$subscriber->sendDoubleOptinEmail();
}
$this->addLog(
$feed['settings']['name'],
'success',
__('Contact has been created in FluentCRM. Contact ID: ', 'fluent-crm') . $subscriber->id,
$form->id,
$entry->id
);
do_action('fluent_crm/contact_added_by_fluentform', $subscriber, $entry, $form, $feed);
} else {
if ($listId = Arr::get($data, 'list_id')) {
$contact['lists'] = [$listId];
}
$hasDouBleOptIn = Arr::isTrue($data, 'double_opt_in');
$forceSubscribed = !$hasDouBleOptIn && ($subscriber->status != 'subscribed');
if (!$forceSubscribed) {
$forceSubscribed = Arr::isTrue($data, 'force_subscribe');
}
if ($forceSubscribed) {
$contact['status'] = 'subscribed';
}
$originalFields = FluentCrmApi('contacts')->getContact($contact['email'])->getOriginal();
$currentCustomValues = $subscriber->custom_fields();
$subscriber = FluentCrmApi('contacts')->createOrUpdate($contact, $forceSubscribed, false);
if (!$subscriber) {
return false;
}
if ($entry->status == 'confirmed' && $subscriber->status != 'subscribed') {
$subscriber = $subscriber->updateStatus('subscribed');
}
if ($hasDouBleOptIn && ($subscriber->status == 'pending' || $subscriber->status == 'unsubscribed')) {
$subscriber->sendDoubleOptinEmail();
}
do_action('fluent_crm/contact_updated_by_fluentform', $subscriber, $entry, $form, $feed);
if ($removeTags = Arr::get($feed, 'settings.remove_tags', [])) {
$subscriber->detachTags($removeTags);
}
$dirtyFields = array_merge($feed['processedValues'], ['dirty_custom_fields' => $currentCustomValues]);
do_action('fluent_crm/contact_updated_with_changes', $subscriber, $dirtyFields, $originalFields, ['source' => 'fluentform', 'formId' => $form->id]);
$this->addLog(
$feed['settings']['name'],
'success',
__('Contact has been updated in FluentCRM. Contact ID: ', 'fluent-crm') . $subscriber->id,
$form->id,
$entry->id
);
}
}
public function isConfigured()
{
return true;
}
public function isEnabled()
{
return true;
}
protected function addLog($title, $status, $description, $formId, $entryId)
{
do_action('ff_log_data', [
'title' => $title,
'status' => $status,
'description' => $description,
'parent_source_id' => $formId,
'source_id' => $entryId,
'component' => $this->integrationKey,
'source_type' => 'submission_item'
]);
}
/*
* We will remove this in future
*/
protected function getSelectedTagIds($data, $inputData, $simpleKey = 'tag_ids', $routingId = 'tag_ids_selection_type', $routersKey = 'tag_routers')
{
$routing = ArrayHelper::get($data, $routingId, 'simple');
if (!$routing || $routing == 'simple') {
return ArrayHelper::get($data, $simpleKey, []);
}
$routers = ArrayHelper::get($data, $routersKey);
if (empty($routers)) {
return [];
}
return $this->evaluateRoutings($routers, $inputData);
}
/*
* We will remove this in future
*/
protected function evaluateRoutings($routings, $inputData)
{
$validInputs = [];
foreach ($routings as $routing) {
$inputValue = ArrayHelper::get($routing, 'input_value');
if (!$inputValue) {
continue;
}
$condition = [
'conditionals' => [
'status' => true,
'is_test' => true,
'type' => 'any',
'conditions' => [
$routing
]
]
];
if (\FluentForm\App\Services\ConditionAssesor::evaluate($condition, $inputData)) {
$validInputs[] = $inputValue;
}
}
return $validInputs;
}
private function registerPaymentEvents()
{
add_action('fluentform/subscription_payment_active', function ($subscription, $submission) {
$this->handlePaymentEvent($submission, 'fluentform/subscription_payment_active');
}, 10, 2);
add_action('fluentform/subscription_payment_canceled', function ($subscription, $submission) {
$this->handlePaymentEvent($submission, 'fluentform/subscription_payment_canceled');
}, 10, 2);
add_action('fluentform/payment_refunded', function ($refund, $transaction, $submission) {
$this->handlePaymentEvent($submission, 'fluentform/payment_refunded');
}, 10, 3);
}
private function handlePaymentEvent($submission, $event)
{
// Get Fluent Forms Feeds
$feeds = fluentCrmDb()->table('fluentform_form_meta')
->where('form_id', $submission->form_id)
->where('meta_key', 'fluentcrm_feeds')
->orderBy('id', 'ASC')
->get();
if ($feeds->isEmpty()) {
return false;
}
if (!is_array($submission->response)) {
$formData = json_decode($submission->response, true);
} else {
$formData = $submission->response;
}
$form = fluentFormApi('forms')->find($submission->form_id);
$notificationService = new GlobalNotificationService();
foreach ($feeds as $feed) {
$parsedValue = json_decode($feed->value, true);
if ($parsedValue && ArrayHelper::isTrue($parsedValue, 'enabled')) {
$runEvents = ArrayHelper::get($parsedValue, 'run_events_only', []);
// check if this is our event or not
if (!$runEvents || !in_array($event, $runEvents)) {
continue;
}
// Now check if conditions matched or not
$isConditionMatched = $notificationService->checkCondition($parsedValue, $formData, $submission->id);
if ($isConditionMatched) {
$item = [
'id' => $feed->id,
'meta_key' => $feed->meta_key,
'settings' => $parsedValue
];
$processedValues = $item['settings'];
unset($processedValues['conditionals']);
$item['processedValues'] = ShortCodeParser::parse($processedValues, $submission->id, $formData, $form, false, $feed->meta_key);
$this->runFeed($item, $formData, $submission, $form);
}
}
}
}
}