feat: enforce unique product per repository mapping and rename settings labels

- Add unique_field support to repeater: product_id dropdown disables
  already-selected options across sibling rows
- Rename Default Status → Article Status, Duplicate Handling → Slug
  Conflict Handling, Deleted File Handling → When a File is Deleted;
  expand option labels for clarity
- Hide importer submenu page from KB nav (accessed via Tools instead)

Author: ajaydsouza

includes/admin/class-plugin-importers.php

@@ -96,6 +96,8 @@ public function admin_menu(): void {
 			$this->page_slug,
 			array( $this, 'render_page' )
 		);
+
+		remove_submenu_page( 'edit.php?post_type=wz_knowledgebase', $this->page_slug );
 	}
 
 	/**

includes/admin/class-settings.php

@@ -946,6 +946,7 @@ public static function settings_github() {
 				'add_button_text'           => esc_html__( 'Add Repository', 'knowledgebase' ),
 				'live_update_field'         => 'product_id',
 				'live_update_field_options' => $product_options,
+				'unique_field'              => 'product_id',
 				'pro'                       => true,
 				'fields'                    => array(
 					'product_id'         => array(
@@ -992,38 +993,38 @@ public static function settings_github() {
 						'size'    => 'large',
 					),
 					'default_status'     => array(
-						'name'    => esc_html__( 'Default Status', 'knowledgebase' ),
-						'desc'    => esc_html__( 'Override the frontmatter status when set. Leave on "No override" to respect frontmatter.', 'knowledgebase' ),
+						'name'    => esc_html__( 'Article Status', 'knowledgebase' ),
+						'desc'    => esc_html__( 'Force all imported articles to this status, overriding any status set in frontmatter. Leave on "Use frontmatter" to let each article control its own status.', 'knowledgebase' ),
 						'id'      => 'default_status',
 						'type'    => 'select',
 						'default' => '',
 						'options' => array(
-							''        => esc_html__( 'No override', 'knowledgebase' ),
+							''        => esc_html__( 'Use frontmatter', 'knowledgebase' ),
 							'publish' => esc_html__( 'Published', 'knowledgebase' ),
 							'draft'   => esc_html__( 'Draft', 'knowledgebase' ),
 						),
 					),
 					'duplicate_handling' => array(
-						'name'    => esc_html__( 'Duplicate Handling', 'knowledgebase' ),
-						'desc'    => esc_html__( 'What to do when an imported slug already exists in a non-GitHub article.', 'knowledgebase' ),
+						'name'    => esc_html__( 'Slug Conflict Handling', 'knowledgebase' ),
+						'desc'    => esc_html__( 'What to do when a GitHub file\'s slug matches an article that was not imported from GitHub.', 'knowledgebase' ),
 						'id'      => 'duplicate_handling',
 						'type'    => 'select',
 						'default' => 'overwrite',
 						'options' => array(
-							'overwrite'  => esc_html__( 'Overwrite existing', 'knowledgebase' ),
-							'skip'       => esc_html__( 'Skip', 'knowledgebase' ),
-							'create_new' => esc_html__( 'Create new with suffixed slug', 'knowledgebase' ),
+							'overwrite'  => esc_html__( 'Overwrite the existing article', 'knowledgebase' ),
+							'skip'       => esc_html__( 'Skip — leave the existing article unchanged', 'knowledgebase' ),
+							'create_new' => esc_html__( 'Create a new article with a suffixed slug', 'knowledgebase' ),
 						),
 					),
 					'delete_removed'     => array(
-						'name'    => esc_html__( 'Deleted File Handling', 'knowledgebase' ),
-						'desc'    => esc_html__( 'What to do when a tracked file is removed from the repository.', 'knowledgebase' ),
+						'name'    => esc_html__( 'When a File is Deleted', 'knowledgebase' ),
+						'desc'    => esc_html__( 'What to do with the linked article when its source file is removed from the repository.', 'knowledgebase' ),
 						'id'      => 'delete_removed',
 						'type'    => 'select',
 						'default' => 'draft',
 						'options' => array(
-							'draft'  => esc_html__( 'Set to draft', 'knowledgebase' ),
-							'delete' => esc_html__( 'Permanently delete', 'knowledgebase' ),
+							'draft'  => esc_html__( 'Switch to draft', 'knowledgebase' ),
+							'delete' => esc_html__( 'Delete permanently', 'knowledgebase' ),
 						),
 					),
 					'enable_push'        => array(

includes/admin/settings/class-settings-form.php

@@ -1016,6 +1016,9 @@ public function callback_repeater( $args ) {
 			<?php if ( ! empty( $live_update_options ) ) : ?>
 			data-live-update-field-options="<?php echo esc_attr( wp_json_encode( $live_update_options ) ); ?>"
 			<?php endif; ?>
+			<?php if ( ! empty( $args['unique_field'] ) ) : ?>
+			data-unique-field="<?php echo esc_attr( $args['unique_field'] ); ?>"
+			<?php endif; ?>
 			<?php echo $attributes; // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped ?>>
 
 			<div class="<?php echo esc_attr( $args['id'] ); ?>-items wz-repeater-items">

includes/admin/settings/js/settings-admin-scripts.js

@@ -139,6 +139,49 @@ jQuery(document).ready(function ($) {
 			}
 		});
 
+		// Enforce unique selection across rows for the field named in data-unique-field.
+		var uniqueField = wrapper.data('unique-field') || '';
+		function syncUniqueSelects() {
+			if (!uniqueField) {
+				return;
+			}
+			var $selects = itemsContainer.find('.wz-repeater-item select[name$="[fields][' + uniqueField + ']"]');
+			var usedValues = {};
+			$selects.each(function () {
+				var val = $(this).val();
+				if (val) {
+					usedValues[val] = true;
+				}
+			});
+			$selects.each(function () {
+				var $sel = $(this);
+				var ownVal = $sel.val();
+				$sel.find('option').each(function () {
+					var optVal = $(this).val();
+					if (!optVal) {
+						return;
+					}
+					$(this).prop('disabled', optVal !== ownVal && usedValues[optVal]);
+				});
+			});
+		}
+
+		if (uniqueField) {
+			syncUniqueSelects();
+			wrapper.on('change', '.wz-repeater-item select[name$="[fields][' + uniqueField + ']"]', function () {
+				syncUniqueSelects();
+			});
+			wrapper.on('click', '.remove-item', function () {
+				// Sync after DOM removal; removal handler fires before remove, so defer.
+				setTimeout(syncUniqueSelects, 0);
+			});
+			document.addEventListener('wz:repeater-item-added', function (e) {
+				if (wrapper.get(0).contains(e.detail.container)) {
+					syncUniqueSelects();
+				}
+			});
+		}
+
 		// Live update repeater title when the specified field changes.
 		// Handles text inputs (input event), selects (change event, uses option text),
 		// and TomSelect-enhanced inputs (change event, uses displayed text or value).