weDocs integration added

backend/Actions/WeDocs/RecordApiHelper.php

@@ -0,0 +1,119 @@
+<?php
+
+namespace BitApps\Integrations\Actions\WeDocs;
+
+use BitApps\Integrations\Config;
+use BitApps\Integrations\Core\Util\Common;
+use BitApps\Integrations\Core\Util\Hooks;
+use BitApps\Integrations\Log\LogHandler;
+
+/**
+ * Provide functionality for weDocs record operations.
+ */
+class RecordApiHelper
+{
+    private $_integrationID;
+
+    private $_integrationDetails;
+
+    public function __construct($integrationDetails, $integId)
+    {
+        $this->_integrationDetails = $integrationDetails;
+        $this->_integrationID = $integId;
+    }
+
+    public function execute($fieldValues, $fieldMap)
+    {
+        if (!class_exists('WeDocs')) {
+            $response = [
+                'success' => false,
+                'message' => __('weDocs is not installed or activated', 'bit-integrations'),
+            ];
+
+            LogHandler::save($this->_integrationID, ['type' => 'weDocs', 'type_name' => 'check'], 'error', $response);
+
+            return $response;
+        }
+
+        $mainAction = $this->_integrationDetails->mainAction ?? '';
+        $fieldData = $this->generateReqDataFromFieldMap($fieldMap, $fieldValues);
+        $payload = $this->buildPayload($fieldData);
+
+        $defaultResponse = [
+            'success' => false,
+            // translators: %s is the plugin name.
+            'message' => wp_sprintf(__('%s plugin is not installed or activated', 'bit-integrations'), 'Bit Integrations Pro'),
+        ];
+
+        switch ($mainAction) {
+            case 'create_documentation':
+                $response = Hooks::apply(Config::withPrefix('wedocs_create_documentation'), $defaultResponse, $payload);
+                $actionType = 'create_documentation';
+
+                break;
+
+            case 'create_section':
+                $response = Hooks::apply(Config::withPrefix('wedocs_create_section'), $defaultResponse, $payload);
+                $actionType = 'create_section';
+
+                break;
+
+            case 'create_article':
+                $response = Hooks::apply(Config::withPrefix('wedocs_create_article'), $defaultResponse, $payload);
+                $actionType = 'create_article';
+
+                break;
+
+            default:
+                $response = [
+                    'success' => false,
+                    'message' => __('Invalid action', 'bit-integrations'),
+                ];
+                $actionType = 'unknown';
+
+                break;
+        }
+
+        $responseType = !empty($response['success']) ? 'success' : 'error';
+        LogHandler::save($this->_integrationID, ['type' => 'weDocs', 'type_name' => $actionType], $responseType, $response);
+
+        return $response;
+    }
+
+    private function buildPayload($payload)
+    {
+        if (!isset($payload['documentation_id']) && isset($this->_integrationDetails->selectedDocumentationId)) {
+            $payload['documentation_id'] = $this->_integrationDetails->selectedDocumentationId;
+        }
+
+        if (!isset($payload['section_id']) && isset($this->_integrationDetails->selectedSectionId)) {
+            $payload['section_id'] = $this->_integrationDetails->selectedSectionId;
+        }
+
+        return $payload;
+    }
+
+    private function generateReqDataFromFieldMap($fieldMap, $fieldValues)
+    {
+        $dataFinal = [];
+
+        if (!\is_array($fieldMap)) {
+            return $dataFinal;
+        }
+
+        foreach ($fieldMap as $item) {
+            $triggerValue = $item->formField ?? '';
+            $actionValue = $item->weDocsField ?? '';
+
+            if (empty($actionValue)) {
+                continue;
+            }
+
+            $dataFinal[$actionValue] = $triggerValue === 'custom' && isset($item->customValue)
+                ? Common::replaceFieldWithValue($item->customValue, $fieldValues)
+                : ($fieldValues[$triggerValue] ?? '');
+        }
+
+        return $dataFinal;
+    }
+}

backend/Actions/WeDocs/Routes.php

@@ -0,0 +1,12 @@
+<?php
+
+if (!defined('ABSPATH')) {
+    exit;
+}
+
+use BitApps\Integrations\Actions\WeDocs\WeDocsController;
+use BitApps\Integrations\Core\Util\Route;
+
+Route::post('wedocs_authorize', [WeDocsController::class, 'weDocsAuthorize']);
+Route::post('wedocs_get_documentations', [WeDocsController::class, 'getDocumentations']);
+Route::post('wedocs_get_sections', [WeDocsController::class, 'getSections']);

backend/Actions/WeDocs/WeDocsController.php

@@ -0,0 +1,145 @@
+<?php
+
+namespace BitApps\Integrations\Actions\WeDocs;
+
+use WP_Post;
+
+/**
+ * Provide functionality for weDocs integration.
+ */
+class WeDocsController
+{
+    private const DOC_POST_TYPE = 'docs';
+
+    private const ALLOWED_POST_STATUSES = ['publish', 'draft', 'pending', 'private'];
+
+    public static function weDocsAuthorize()
+    {
+        self::checkPluginExists();
+        wp_send_json_success(true);
+    }
+
+    public static function getDocumentations()
+    {
+        self::checkPluginExists();
+
+        $allDocumentations = get_posts(
+            [
+                'post_type'      => self::DOC_POST_TYPE,
+                'post_status'    => self::ALLOWED_POST_STATUSES,
+                'posts_per_page' => -1,
+                'post_parent'    => 0,
+                'orderby'        => 'title',
+                'order'          => 'ASC',
+            ]
+        );
+
+        $documentations = array_map(
+            function ($doc) {
+                return (object) [
+                    'value' => (string) $doc->ID,
+                    'label' => $doc->post_title,
+                ];
+            },
+            $allDocumentations
+        );
+
+        wp_send_json_success(['documentations' => $documentations], 200);
+    }
+
+    public static function getSections($request)
+    {
+        self::checkPluginExists();
+
+        $documentationId = self::sanitizeId($request->documentation_id ?? '');
+
+        if ($documentationId > 0) {
+            $documentation = get_post($documentationId);
+
+            if (!self::isValidDocumentation($documentation)) {
+                wp_send_json_error(__('Selected documentation is invalid.', 'bit-integrations'), 400);
+            }
+        }
+
+        $queryArgs = [
+            'post_type'      => self::DOC_POST_TYPE,
+            'post_status'    => self::ALLOWED_POST_STATUSES,
+            'posts_per_page' => -1,
+            'orderby'        => 'title',
+            'order'          => 'ASC',
+        ];
+
+        if ($documentationId > 0) {
+            $queryArgs['post_parent'] = $documentationId;
+        }
+
+        $sections = get_posts($queryArgs);
+
+        if ($documentationId <= 0) {
+            $sections = array_values(array_filter($sections, [__CLASS__, 'isValidSection']));
+        }
+
+        $options = array_map(
+            function ($section) {
+                return (object) [
+                    'value' => (string) $section->ID,
+                    'label' => $section->post_title,
+                ];
+            },
+            $sections
+        );
+
+        wp_send_json_success(['sections' => $options], 200);
+    }
+
+    public function execute($integrationData, $fieldValues)
+    {
+        $integrationDetails = $integrationData->flow_details;
+        $fieldMap = $integrationDetails->field_map ?? [];
+
+        $recordApiHelper = new RecordApiHelper($integrationDetails, $integrationData->id);
+
+        return $recordApiHelper->execute($fieldValues, $fieldMap);
+    }
+
+    private static function checkPluginExists()
+    {
+        if (!class_exists('WeDocs')) {
+            wp_send_json_error(__('weDocs is not activated or not installed', 'bit-integrations'), 400);
+        }
+    }
+
+    private static function sanitizeId($value)
+    {
+        if (empty($value)) {
+            return 0;
+        }
+
+        return absint($value);
+    }
+
+    private static function isValidDocsPost($post)
+    {
+        return $post instanceof WP_Post && $post->post_type === self::DOC_POST_TYPE;
+    }
+
+    private static function isValidDocumentation($post)
+    {
+        return self::isValidDocsPost($post) && (int) $post->post_parent === 0;
+    }
+
+    private static function isValidSection($post)
+    {
+        if (!self::isValidDocsPost($post)) {
+            return false;
+        }
+
+        $parentId = (int) $post->post_parent;
+
+        if ($parentId <= 0) {
+            return false;
+        }
+
+        return (int) wp_get_post_parent_id($parentId) === 0;
+    }
+}

backend/Core/Util/AllTriggersName.php

@@ -144,6 +144,7 @@ public static function allTriggersName()
             'WCSubscriptions'                => ['name' => 'WooCommerce Subscriptions',  'isPro' => true, 'is_active' => false],
             'Webhook'                        => ['name' => 'Webhook',  'isPro' => true, 'is_active' => false],
             'WeForms'                        => ['name' => 'WeForms',  'isPro' => true, 'is_active' => false],
+            'WeDocs'                         => ['name' => 'weDocs',  'isPro' => true, 'is_active' => false],
             'WPCourseware'                   => ['name' => 'WP Courseware',  'isPro' => true, 'is_active' => false],
             'WPEF'                           => ['name' => 'eForm',  'isPro' => true, 'is_active' => false],
             'WPForo'                         => ['name' => 'wpForo Forum',  'isPro' => true, 'is_active' => false],

frontend/src/Utils/StaticData/webhookIntegrations.js

@@ -91,6 +91,7 @@ export const customFormIntegrations = [
   'SeoPress',
   'ThriveLeads',
   'NotificationX',
+  'WeDocs',
   'UserRegistrationMembership',
   'UltimateAffiliatePro',
 ]

frontend/src/components/AllIntegrations/EditInteg.jsx

@@ -175,8 +175,9 @@ const EditFluentCart = lazy(() => import('./FluentCart/EditFluentCart'))
 const EditWCAffiliate = lazy(() => import('./WCAffiliate/EditWCAffiliate'))
 const EditWPCafe = lazy(() => import('./WPCafe/EditWPCafe'))
 const EditNotificationX = lazy(() => import('./NotificationX/EditNotificationX'))
-const EditTeamsForWooCommerceMemberships = lazy(() =>
-  import('./TeamsForWooCommerceMemberships/EditTeamsForWooCommerceMemberships')
+const EditWeDocs = lazy(() => import('./WeDocs/EditWeDocs'))
+const EditTeamsForWooCommerceMemberships = lazy(
+  () => import('./TeamsForWooCommerceMemberships/EditTeamsForWooCommerceMemberships')
 )
 const EditAsgarosForum = lazy(() => import('./AsgarosForum/EditAsgarosForum'))
 const EditSeoPress = lazy(() => import('./SeoPress/EditSeoPress'))
@@ -597,6 +598,9 @@ const IntegType = memo(({ allIntegURL, flow }) => {
       return <EditWPCafe allIntegURL={allIntegURL} />
     case 'NotificationX':
       return <EditNotificationX allIntegURL={allIntegURL} />
+    case 'weDocs':
+    case 'WeDocs':
+      return <EditWeDocs allIntegURL={allIntegURL} />
     case 'Asgaros Forum':
     case 'AsgarosForum':
       return <EditAsgarosForum allIntegURL={allIntegURL} />

frontend/src/components/AllIntegrations/IntegInfo.jsx

@@ -182,6 +182,7 @@ const TeamsForWooCommerceMembershipsAuthorization = lazy(
 )
 const SeoPressAuthorization = lazy(() => import('./SeoPress/SeoPressAuthorization'))
 const NotificationXAuthorization = lazy(() => import('./NotificationX/NotificationXAuthorization'))
+const WeDocsAuthorization = lazy(() => import('./WeDocs/WeDocsAuthorization'))
 const AsgarosForumAuthorization = lazy(() => import('./AsgarosForum/AsgarosForumAuthorization'))
 const UserRegistrationMembershipAuthorization = lazy(
   () => import('./UserRegistrationMembership/UserRegistrationMembershipAuthorization')
@@ -650,6 +651,9 @@ export default function IntegInfo() {
         return <SeoPressAuthorization seoPressConf={integrationConf} step={1} isInfo />
       case 'NotificationX':
         return <NotificationXAuthorization notificationXConf={integrationConf} step={1} isInfo />
+      case 'weDocs':
+      case 'WeDocs':
+        return <WeDocsAuthorization weDocsConf={integrationConf} step={1} isInfo />
       case 'Asgaros Forum':
       case 'AsgarosForum':
         return <AsgarosForumAuthorization asgarosForumConf={integrationConf} step={1} isInfo />

frontend/src/components/AllIntegrations/NewInteg.jsx

@@ -174,8 +174,9 @@ const FluentCart = lazy(() => import('./FluentCart/FluentCart'))
 const WCAffiliate = lazy(() => import('./WCAffiliate/WCAffiliate'))
 const WPCafe = lazy(() => import('./WPCafe/WPCafe'))
 const NotificationX = lazy(() => import('./NotificationX/NotificationX'))
-const TeamsForWooCommerceMemberships = lazy(() =>
-  import('./TeamsForWooCommerceMemberships/TeamsForWooCommerceMemberships')
+const WeDocs = lazy(() => import('./WeDocs/WeDocs'))
+const TeamsForWooCommerceMemberships = lazy(
+  () => import('./TeamsForWooCommerceMemberships/TeamsForWooCommerceMemberships')
 )
 const AsgarosForum = lazy(() => import('./AsgarosForum/AsgarosForum'))
 const SeoPress = lazy(() => import('./SeoPress/SeoPress'))
@@ -1693,6 +1694,16 @@ export default function NewInteg({ allIntegURL }) {
             setFlow={setFlow}
           />
         )
+      case 'weDocs':
+      case 'WeDocs':
+        return (
+          <WeDocs
+            allIntegURL={allIntegURL}
+            formFields={flow?.triggerData?.fields}
+            flow={flow}
+            setFlow={setFlow}
+          />
+        )
       case 'Asgaros Forum':
       case 'AsgarosForum':
         return (