{"id":2717,"date":"2020-08-18T11:08:58","date_gmt":"2020-08-18T11:08:58","guid":{"rendered":"https:\/\/fluentforms.com\/?post_type=docs&p=2717"},"modified":"2023-07-25T06:13:33","modified_gmt":"2023-07-25T06:13:33","password":"","slug":"integrationmanager-class","status":"publish","type":"docs","link":"https:\/\/fluentforms.com\/docs\/integrationmanager-class\/","title":{"rendered":"Integration Manager Class"},"content":{"rendered":"\n

Introduction<\/h2>\n\n\n\n

The Fluent Forms Integration Manager Class provides developers with a very easy & simple solution to add new integration in a time-effective way. Follow this documentation to create your own Integration.<\/p>\n\n\n\n

You just need to provide your Integration settings data structure and the fields will be automatically generated for you. Please check this Integration Feed – Fields API<\/a> for the available input component that you can use for your integration settings.<\/p>\n\n\n\n

You can extend this class to create your own Integration. Include the class using the following namespace.<\/p>\n\n\n\n

use \\FluentForm\\App\\Services\\Integrations\\IntegrationManager;<\/code><\/pre>\n\n\n\n
 This class file location: \/plugins\/fluentform\/app\/Services\/Integrations\/IntegrationManager.php.<\/p>\n\n\n\n
Please checkout the github<\/a> file to get more information.<\/p>\n\n\n\n
Methods<\/h2>\n\n\n\n
__construct()<\/h3>\n\n\n\n
This is the construct method of this class. This method needs to override. You have to pass a Application object and a few other required parameters. To pass Application object you can include it using the following namespace<\/p>\n\n\n\n
use \\FluentForm\\Framework\\Foundation\\Application;<\/pre>\n\n\n\n
Here is an example of how you can override. You can use the following filter fluentform_notifying_async_<\/em>{{integrationKey}} when developing the integration it will make debugging easier.<\/p>\n\n\n\n
public function __construct(Application $application)\n{\n    parent::__construct(\n        $application,\n        'MyAwesomeIntegration',                           \/\/ title\n        'myIntegrationKey',                               \/\/ integration key\n        'my_integration_details',                         \/\/ option key\n        'my_integration_feed',                            \/\/ settings key\n        11                                                \/\/ priority \n    );\n\n    $this->description = '';                              \/\/ Integration details\n \n    $this->logo = '\/my-integration-image-file-path.png';  \/\/ Integration Logo\n    $this->registerAdminHooks();                          \/\/ Internal Functions\n    \n\/\/  add_filter('fluentform\/notifying_async_{integrationKey}', '__return_false');\n}<\/code><\/pre>\n\n\n\n
getGlobalFields()<\/h3>\n\n\n\n
This method will need to return the settings data format for the integration API connection. You have to keep the structure as same as the example.  This setting will store the API key & additional required data to connect with your Integration API.<\/p>\n\n\n\n
Here is an example<\/strong> of the data format.<\/p>\n\n\n\n
[\n    'logo'             => $this->logo,                                         \/\/ Logo Path which was set in constructor\n    'menu_title'       => __('Integration Settings', 'fluentform'),            \/\/ Integration Settins Title\n    'menu_description' => __('Description', 'fluentform'),                     \/\/ Integration Settins Details\n    'valid_message'    => __('Your API Key is valid', 'fluentform'),           \/\/ Valid API Message \n    'invalid_message'  => __('Your API Key is not valid', 'fluentform'),       \/\/ Invalid API Message\n    'save_button_text' => __('Save Settings', 'fluentform'),                   \/\/ Settings Save Button tTxt\n    'fields'           => [\n        'apiKey' => [\n            'type'       => 'text',                                            \/\/ API key type\n            'label_tips' => __(\"Enter your Integration API Key\", 'fluentform'),\/\/ Additional help text\n            'label'      => __('Integration API Key', 'fluentform'),           \/\/ Input Label\n        ]\n    ],\n    'hide_on_valid'    => true,                                                \/\/ Settings Input will be hidden on valid \n    'discard_settings' => [\n        'section_description' => 'Your AwesomeIntegration is Activated',       \/\/ Discard Settings Page Description\n        'button_text'         => 'Disconnect AwesomeIntegration',              \/\/ Discard Button Text\n        'data'                => [\n            'apiKey' => ''                                                     \/\/ Set API key to empty on discard\n        ],\n        'show_verify'         => true                                          \/\/ Show verification Option\n    ]\n];<\/code><\/pre>\n\n\n\n
getGlobalSettings()<\/h3>\n\n\n\n
In this method, you will need to get your settings data using your option key and your default settings for the Settings. You will get one parameter here $settings<\/strong>.<\/p>\n\n\n\n
Here is an example<\/strong> of the method:<\/p>\n\n\n\n
 public function getGlobalSettings($settings)\n    {\n        $globalSettings = get_option($this->optionKey);\n        if (!$globalSettings) {\n            $globalSettings = [];\n        }\n        $defaults = [\n            'apiKey' => '',\n            'status' => ''\n        ];\n\n        return wp_parse_args($globalSettings, $defaults);\n    }<\/code><\/pre>\n\n\n\n
saveGlobalSettings()<\/h3>\n\n\n\n
Here you will get the settings data after user submission and you can use the data to connect with your API or do your required task. Then save the data or return the error using your own validation.<\/p>\n\n\n\n
For example<\/strong> :<\/p>\n\n\n\n
public function saveGlobalSettings($settings)\n    {\n        if (!$settings['apiKey']) {\n            $mySettings = [\n                'apiKey' => '',\n                'status' => false\n            ];\n            \n            update_option($this->optionKey, $mySettings, 'no');\n            wp_send_json_success([\n                'message' => __('Your settings has been updated and disconnected', 'fluentform'),\n                'status'  => false\n            ], 200);\n        }\n\n        \/\/ Verify API key\n        try {\n             \n        \/\/ Connect with your api using the apiKey\n        \/\/ Your code\n            \n        } catch (\\Exception $exception) {\n            wp_send_json_error([\n                'message' => $exception->getMessage()\n            ], 400);\n        }\n\n        \/\/ API key is verified now\n        $settings = [\n            'apiKey' => sanitize_text_field($settings['apiKey']),\n            'status' => true\n        ];\n\n        \/\/ Update options with the key\n        update_option($this->optionKey, $settings, 'no`');\n\n        wp_send_json_success([\n            'message' => __('Your MyAwesomeIntegration api key has been verfied and successfully set', 'fluentform'),\n            'status'  => true\n        ], 200);\n    }<\/code><\/pre>\n\n\n\n
After you have successfully completed this step along with the previous methods, your integration will appear int the fluent form modules list.<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
After you enable your new integration, you can go to the integration settings page where settings will be displayed according to your global field settings from getGlobalFields.<\/p>\n\n\n\n
After the integration is up and running the integration needs to be pushed in the form feed, so a user can use this in his form. The following method will achieve this.<\/p>\n\n\n\n
pushIntegration()<\/h3>\n\n\n\n
Adding your integration into the form feeds. Here you will get  two parameters $integrations, $formId<\/strong>, <\/p>\n\n\n\n
Here is the screenshot when the integration is pushed :<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
If the integration is configured it will push the integration into the form feed or else it will show a message to configure the API. The isConfigured() method, to check if the integration is configured is built in, you just need to call it.<\/p>\n\n\n\n
public function pushIntegration($integrations, $formId)\n{\n    $integrations[$this->integrationKey] = [\n        'title'                 => $this->title . ' Integration',\n        'logo'                  => $this->logo,\n        'is_active'             => $this->isConfigured(),\n        'configure_title'       => 'Configuration required!',\n        'global_configure_url'  => admin_url('admin.php?page=fluent_forms_settings#{your settings page url}'),\n        'configure_message'     => 'MyAwesomeIntegration is not configured yet! Please configure your API first',\n        'configure_button_text' => 'Set MyAwesomeIntegration API'\n    ];\n    return $integrations;\n}<\/code><\/pre>\n\n\n\n
getIntegrationDefaults()<\/h3>\n\n\n\n
This method will return your Integration feed setting’s default data format.  You will get two parameters here $settings, $formId<\/strong>. Here is an example of this method. <\/p>\n\n\n\n
[\n    'name'                   => '',\n    'id'                     => '',\n    'fieldEmailAddress'      => '',\n    'custom_field_mappings'  => (object)[],\n    'default_fields'         => (object)[],\n    'conditionals'           => [\n                   'conditions' => [],\n                   'status'     => false,\n                   'type'       => 'all'\n    ],\n    'enabled' => true\n];<\/code><\/pre>\n\n\n\n
getSettingsFields()<\/h3>\n\n\n\n
This method will render input fields for the integration feed settings page, based on the returned input data format. You will get two parameters here $settings, $formId<\/strong>.<\/p>\n\n\n\n
 You can use the prebuilt input component to create your settings page, here is a documentation link<\/a> where you can find the details list of these input components.<\/p>\n\n\n\n
Required properties for the fields:<\/p>\n\n\n\n