feat(ai-kit): allow title, URL, and metadata editing for KB section-based documents

Smart Cloud Solutions Inc. · Smart Cloud Solutions Inc. · commit a8a46a79a61b · 2026-04-18T10:19:53.000+02:00
diff --git a/ai-kit-admin/dist/chunks/330.828d35e6.js b/ai-kit-admin/dist/chunks/330.828d35e6.js
diff --git a/ai-kit-admin/dist/chunks/330.9e81af7e.js b/ai-kit-admin/dist/chunks/330.9e81af7e.js
diff --git a/ai-kit-admin/dist/index.asset.php b/ai-kit-admin/dist/index.asset.php
@@ -1 +1 @@
-<?php return array('dependencies' => array('jquery', 'react', 'react-dom', 'react-jsx-runtime', 'wp-components', 'wp-data', 'wp-i18n'), 'version' => 'fb86e5d1fe3b40905744');
+<?php return array('dependencies' => array('jquery', 'react', 'react-dom', 'react-jsx-runtime', 'wp-components', 'wp-data', 'wp-i18n'), 'version' => '62ae99f41fce601125a5');
diff --git a/ai-kit-admin/dist/index.js b/ai-kit-admin/dist/index.js
diff --git a/ai-kit-admin/php/kb/admin.php b/ai-kit-admin/php/kb/admin.php
@@ -1146,6 +1146,9 @@ private function getEffectiveSectionMetadata(object $section, ?object $override)
         if (is_array($extra_meta) && !empty($extra_meta['description']) && is_string($extra_meta['description'])) {
             $metadata['description'] = $extra_meta['description'];
         }
+        if (is_array($extra_meta) && !empty($extra_meta['postUrl']) && is_string($extra_meta['postUrl'])) {
+            $metadata['postUrl'] = $extra_meta['postUrl'];
+        }
         if ($section->category) {
             $metadata['category'] = $section->category;
         }
diff --git a/ai-kit-admin/php/kb/parser.php b/ai-kit-admin/php/kb/parser.php
@@ -315,6 +315,10 @@ private function parseGutenbergWithSections(\WP_Post $post, array $blocks): arra
                 'md' => $this->converter->blocksToMarkdown($base_content_blocks),
                 'generated_at' => current_time('mysql'),
                 'source_updated_at' => $post->post_modified,
+                'extra_meta' => [
+                    'description' => $this->getPostDescription($post),
+                    'postUrl' => $this->getPostUrl($post),
+                ],
             ];
 
             $base_section['origin_hash'] = $this->calculateOriginHash($base_section);
@@ -343,6 +347,7 @@ private function parseKbSectionBlock(\WP_Post $post, array $block, int $sort_ord
         $doc_key = $attrs['docKey'] ?? null;
         $title = $attrs['title'] ?? null;
         $description = $attrs['description'] ?? null;
+        $post_url = $attrs['postUrl'] ?? null;
         $tags = $attrs['tags'] ?? null;
         $category = $attrs['category'] ?? null;
         $subcategory = $attrs['subcategory'] ?? null;
@@ -381,6 +386,7 @@ private function parseKbSectionBlock(\WP_Post $post, array $block, int $sort_ord
             'extra_meta' => [
                 'block_type' => 'gutenberg',
                 'description' => $description,
+                'postUrl' => $post_url,
                 'priority' => $priority,
             ],
         ];
@@ -416,6 +422,7 @@ private function parseGutenbergSimple(\WP_Post $post, array $blocks): array
             'source_updated_at' => $post->post_modified,
             'extra_meta' => [
                 'description' => $this->getPostDescription($post),
+                'postUrl' => $this->getPostUrl($post),
             ],
         ];
 
@@ -588,6 +595,7 @@ private function parseElementorWithSections(\WP_Post $post, array $elements): ar
                 'source_updated_at' => $post->post_modified,
                 'extra_meta' => [
                     'description' => $this->getPostDescription($post),
+                    'postUrl' => $this->getPostUrl($post),
                     'source_type' => 'elementor',
                 ],
             ];
@@ -679,6 +687,7 @@ private function parseElementorKbSection(\WP_Post $post, array $element, int $so
         $doc_key = $settings['kb_doc_key'] ?? null;
         $doc_title = $settings['kb_doc_title'] ?? null;
         $doc_description = $settings['kb_doc_description'] ?? null;
+        $doc_post_url = $settings['kb_post_url']['url'] ?? null;
         $title = $settings['kb_title'] ?? null;
         $category = $settings['kb_category'] ?? null;
         $subcategory = $settings['kb_subcategory'] ?? null;
@@ -733,6 +742,7 @@ private function parseElementorKbSection(\WP_Post $post, array $element, int $so
             'source_updated_at' => $post->post_modified,
             'extra_meta' => [
                 'description' => $doc_description,
+                'postUrl' => $doc_post_url,
                 'source_type' => 'elementor',
                 'priority' => $priority,
             ],
@@ -853,6 +863,7 @@ private function parseElementorSimple(\WP_Post $post, array $elements): array
             'source_updated_at' => $post->post_modified,
             'extra_meta' => [
                 'description' => $this->getPostDescription($post),
+                'postUrl' => $this->getPostUrl($post),
                 'source_type' => 'elementor',
             ],
         ];
@@ -900,6 +911,7 @@ private function parseClassicPost(\WP_Post $post): array
             'source_updated_at' => $post->post_modified,
             'extra_meta' => [
                 'description' => $this->getPostDescription($post),
+                'postUrl' => $this->getPostUrl($post),
             ],
         ];
 
@@ -968,6 +980,16 @@ private function getPostDescription(\WP_Post $post): ?string
         return $description !== '' ? $description : null;
     }
 
+    /**
+     * Get the canonical post URL when available.
+     */
+    private function getPostUrl(\WP_Post $post): ?string
+    {
+        $url = get_permalink($post);
+
+        return is_string($url) && $url !== '' ? $url : null;
+    }
+
     /**
      * Generate a stable section ID from block data
      */
diff --git a/ai-kit-blocks/dist/editor.asset.php b/ai-kit-blocks/dist/editor.asset.php
@@ -1 +1 @@
-<?php return array('dependencies' => array('react', 'react-dom', 'react-jsx-runtime', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n'), 'version' => 'ce7a317b779454e7ef4a');
+<?php return array('dependencies' => array('react', 'react-dom', 'react-jsx-runtime', 'wp-block-editor', 'wp-blocks', 'wp-components', 'wp-data', 'wp-element', 'wp-i18n'), 'version' => '8ffe613288822cef7625');
diff --git a/ai-kit-blocks/dist/editor.js b/ai-kit-blocks/dist/editor.js
diff --git a/ai-kit-blocks/dist/kb-section/block.json b/ai-kit-blocks/dist/kb-section/block.json
@@ -27,6 +27,9 @@
     "description": {
       "type": "string"
     },
+    "postUrl": {
+      "type": "string"
+    },
     "tags": {
       "type": "array",
       "default": [],
diff --git a/ai-kit-blocks/src/kb-section/block.json b/ai-kit-blocks/src/kb-section/block.json
@@ -27,6 +27,9 @@
     "description": {
       "type": "string"
     },
+    "postUrl": {
+      "type": "string"
+    },
     "tags": {
       "type": "array",
       "default": [],
diff --git a/ai-kit-blocks/src/kb-section/edit.tsx b/ai-kit-blocks/src/kb-section/edit.tsx
@@ -20,6 +20,7 @@ interface EditProps {
     docKey?: string;
     title?: string;
     description?: string;
+    postUrl?: string;
     tags?: string[];
     category?: string;
     subcategory?: string;
@@ -41,6 +42,7 @@ export default function Edit({
     docKey,
     title,
     description,
+    postUrl,
     tags,
     category,
     subcategory,
@@ -153,6 +155,16 @@ export default function Edit({
                   "smartcloud-ai-kit",
                 )}
               />
+              <TextControl
+                label={__("Source URL", "smartcloud-ai-kit")}
+                value={postUrl || ""}
+                onChange={(value: string) => setAttributes({ postUrl: value })}
+                help={__(
+                  "Optional URL stored in document metadata. Leave empty so separate documents can inherit the base document URL.",
+                  "smartcloud-ai-kit",
+                )}
+                placeholder="https://example.com/custom-page"
+              />
             </>
           )}
 
diff --git a/elementor-kb-section-widget.php b/elementor-kb-section-widget.php
@@ -118,6 +118,21 @@ public static function add_kb_controls($element, $args): void
             ]
         );
 
+        $element->add_control(
+            'kb_post_url',
+            [
+                'label' => __('Source URL', 'smartcloud-ai-kit'),
+                'type' => \Elementor\Controls_Manager::URL,
+                'placeholder' => ['url' => 'https://example.com/custom-page'],
+                'description' => __('Optional URL stored in document metadata. Leave empty so separate documents can inherit the base document URL.', 'smartcloud-ai-kit'),
+                'show_external' => false,
+                'condition' => [
+                    'kb_enabled' => 'yes',
+                    'kb_mode' => 'separate_doc',
+                ],
+            ]
+        );
+
         $element->add_control(
             'kb_section_key',
             [
diff --git a/readme.txt b/readme.txt
@@ -4,7 +4,7 @@ Tags: ai, chrome, seo, language, tools
 Requires at least: 6.2
 Tested up to: 6.9
 Requires PHP: 8.1
-Stable tag: 1.2.14
+Stable tag: 1.2.15
 License: MIT
 License URI: https://mit-license.org/
 Text Domain: smartcloud-ai-kit
@@ -199,6 +199,11 @@ AI-Kit Pro includes additional functionality (such as the AI-Kit Chatbot, backen
 
 == Changelog ==
 
+= 1.2.15 =
+* Feature: Extended Knowledge Base editing so separately defined KB sections can now override their own document title and URL.
+* Feature: Metadata for KB section-based documents is now editable from the Knowledge Base admin screen, including category, subcategory, and tags.
+* UX: Gives editors fuller control over section-level KB documents directly from the admin UI.
+
 = 1.2.14 =
 * Feature: Added a document description override option in the KB admin/editor UI.
 * Feature: The overridden description is used as the excerpt shown below the title in DocSearch result lists.
@@ -343,6 +348,9 @@ Fixed the pre-run language detection/translation flow for AiFeature blocks so it
 
 == Upgrade Notice ==
 
+= 1.2.15 =
+Expands Knowledge Base editing for section-based documents. You can now edit title, URL, and metadata such as category, subcategory, and tags directly for KB sections that are published as separate documents.
+
 = 1.2.14 =
 Adds a document description override option for Knowledge Base documents. The custom description is used as the excerpt shown under the title in DocSearch results.
 
diff --git a/smartcloud-ai-kit.php b/smartcloud-ai-kit.php
@@ -6,7 +6,7 @@
  * Requires at least: 6.2
  * Tested up to:      6.9
  * Requires PHP:      8.1
- * Version:           1.2.14
+ * Version:           1.2.15
  * Author:            Smart Cloud Solutions Inc.
  * Author URI:        https://smart-cloud-solutions.com
  * License:           MIT
@@ -18,7 +18,7 @@
 
 namespace SmartCloud\WPSuite\AiKit;
 
-const VERSION = '1.2.14';
+const VERSION = '1.2.15';
 const DB_VERSION = '1.3.1';
 
 if (!defined('ABSPATH')) {

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-<?php return array('dependencies' => array('jquery', 'react', 'react-dom', 'react-jsx-runtime', 'wp-components', 'wp-data', 'wp-i18n'), 'version' => 'fb86e5d1fe3b40905744');`
	`1`	`+<?php return array('dependencies' => array('jquery', 'react', 'react-dom', 'react-jsx-runtime', 'wp-components', 'wp-data', 'wp-i18n'), 'version' => '62ae99f41fce601125a5');`
Original file line number	Diff line number	Diff line change
`@@ -1146,6 +1146,9 @@ private function getEffectiveSectionMetadata(object $section, ?object $override)`
`1146`	`1146`	`if (is_array($extra_meta) && !empty($extra_meta['description']) && is_string($extra_meta['description'])) {`
`1147`	`1147`	`$metadata['description'] = $extra_meta['description'];`
`1148`	`1148`	`}`
	`1149`	`+ if (is_array($extra_meta) && !empty($extra_meta['postUrl']) && is_string($extra_meta['postUrl'])) {`
	`1150`	`+ $metadata['postUrl'] = $extra_meta['postUrl'];`
	`1151`	`+ }`
`1149`	`1152`	`if ($section->category) {`
`1150`	`1153`	`$metadata['category'] = $section->category;`
`1151`	`1154`	`}`