Add Command Palette support

assets/src/js/commands/admin-commands.js

@@ -0,0 +1,193 @@
+/**
+ * Admin Commands
+ *
+ * Core WordPress commands for Secure Custom Fields administration.
+ * This file registers navigation commands for all primary SCF admin screens,
+ * enabling quick access through the WordPress commands interface (Cmd+K / Ctrl+K).
+ *
+ * @since 6.5.0
+ */
+
+/**
+ * WordPress dependencies
+ */
+import { __ } from '@wordpress/i18n';
+import { createElement } from '@wordpress/element';
+import { Icon } from '@wordpress/components';
+import { dispatch } from '@wordpress/data';
+import { createQueue } from '@wordpress/priority-queue';
+
+/**
+ * Initialize deferred execution queue and context
+ */
+const queue = createQueue();
+const context = {};
+
+/**
+ * Register admin commands for SCF
+ */
+queue.add( context, () => {
+	if ( ! dispatch( 'core/commands' ) || ! window.acf?.data ) {
+		return;
+	}
+
+	const commandStore = dispatch( 'core/commands' );
+	const adminUrl = window.acf?.data?.admin_url || '';
+
+	const commands = [
+		{
+			name: 'field-groups',
+			label: __( 'Field Groups', 'secure-custom-fields' ),
+			url: 'edit.php?post_type=acf-field-group',
+			icon: 'layout',
+			description: __(
+				'SCF: View and manage custom field groups',
+				'secure-custom-fields'
+			),
+			keywords: [
+				'acf',
+				'custom fields',
+				'field editor',
+				'manage fields',
+			],
+		},
+		{
+			name: 'new-field-group',
+			label: __( 'Create New Field Group', 'secure-custom-fields' ),
+			url: 'post-new.php?post_type=acf-field-group',
+			icon: 'plus',
+			description: __(
+				'SCF: Create a new field group to organize custom fields',
+				'secure-custom-fields'
+			),
+			keywords: [
+				'add',
+				'new',
+				'create',
+				'field group',
+				'custom fields',
+			],
+		},
+		{
+			name: 'post-types',
+			label: __( 'Post Types', 'secure-custom-fields' ),
+			url: 'edit.php?post_type=acf-post-type',
+			icon: 'admin-post',
+			description: __(
+				'SCF: Manage custom post types',
+				'secure-custom-fields'
+			),
+			keywords: [ 'cpt', 'content types', 'manage post types' ],
+		},
+		{
+			name: 'new-post-type',
+			label: __( 'Create New Post Type', 'secure-custom-fields' ),
+			url: 'post-new.php?post_type=acf-post-type',
+			icon: 'plus',
+			description: __(
+				'SCF: Create a new custom post type',
+				'secure-custom-fields'
+			),
+			keywords: [ 'add', 'new', 'create', 'cpt', 'content type' ],
+		},
+		{
+			name: 'taxonomies',
+			label: __( 'Taxonomies', 'secure-custom-fields' ),
+			url: 'edit.php?post_type=acf-taxonomy',
+			icon: 'category',
+			description: __(
+				'SCF: Manage custom taxonomies for organizing content',
+				'secure-custom-fields'
+			),
+			keywords: [ 'categories', 'tags', 'terms', 'custom taxonomies' ],
+		},
+		{
+			name: 'new-taxonomy',
+			label: __( 'Create New Taxonomy', 'secure-custom-fields' ),
+			url: 'post-new.php?post_type=acf-taxonomy',
+			icon: 'plus',
+			description: __(
+				'SCF: Create a new custom taxonomy',
+				'secure-custom-fields'
+			),
+			keywords: [
+				'add',
+				'new',
+				'create',
+				'taxonomy',
+				'categories',
+				'tags',
+			],
+		},
+		{
+			name: 'options-pages',
+			label: __( 'Options Pages', 'secure-custom-fields' ),
+			url: 'edit.php?post_type=acf-ui-options-page',
+			icon: 'admin-settings',
+			description: __(
+				'SCF: Manage custom options pages for global settings',
+				'secure-custom-fields'
+			),
+			keywords: [ 'settings', 'global options', 'site options' ],
+		},
+		{
+			name: 'new-options-page',
+			label: __( 'Create New Options Page', 'secure-custom-fields' ),
+			url: 'post-new.php?post_type=acf-ui-options-page',
+			icon: 'plus',
+			description: __(
+				'SCF: Create a new custom options page',
+				'secure-custom-fields'
+			),
+			keywords: [ 'add', 'new', 'create', 'options', 'settings page' ],
+		},
+		{
+			name: 'tools',
+			label: __( 'SCF Tools', 'secure-custom-fields' ),
+			url: 'admin.php?page=acf-tools',
+			icon: 'admin-tools',
+			description: __(
+				'SCF: Access SCF utility tools',
+				'secure-custom-fields'
+			),
+			keywords: [ 'utilities', 'import export', 'json' ],
+		},
+		{
+			name: 'import',
+			label: __( 'Import SCF Data', 'secure-custom-fields' ),
+			url: 'admin.php?page=acf-tools&tool=import',
+			icon: 'upload',
+			description: __(
+				'SCF: Import field groups, post types, taxonomies, and options pages',
+				'secure-custom-fields'
+			),
+			keywords: [ 'upload', 'json', 'migration', 'transfer' ],
+		},
+		{
+			name: 'export',
+			label: __( 'Export SCF Data', 'secure-custom-fields' ),
+			url: 'admin.php?page=acf-tools&tool=export',
+			icon: 'download',
+			description: __(
+				'SCF: Export field groups, post types, taxonomies, and options pages',
+				'secure-custom-fields'
+			),
+			keywords: [ 'download', 'json', 'backup', 'migration' ],
+		},
+	];
+
+	commands.forEach( ( command ) => {
+		commandStore.registerCommand( {
+			name: 'scf/' + command.name,
+			label: command.label,
+			icon: createElement( Icon, { icon: command.icon } ),
+			context: 'admin',
+			description: command.description,
+			keywords: command.keywords,
+			callback: ( { close } ) => {
+				document.location = adminUrl + command.url;
+				close();
+			},
+		} );
+	} );
+} );

assets/src/js/commands/custom-post-type-commands.js

@@ -0,0 +1,118 @@
+/**
+ * Custom Post Type Commands
+ *
+ * Dynamic commands for user-created custom post types in Secure Custom Fields.
+ * This file generates navigation commands for each registered post type that
+ * the current user has access to, creating both "View All" and "Add New" commands.
+ *
+ * Post type data is provided via acf.data.customPostTypes, which is populated
+ * by the PHP side after capability checks ensure the user has appropriate access.
+ *
+ * @since 6.5.0
+ */
+
+/**
+ * WordPress dependencies
+ */
+import { __, sprintf } from '@wordpress/i18n';
+import { createElement } from '@wordpress/element';
+import { Icon } from '@wordpress/components';
+import { dispatch } from '@wordpress/data';
+import { createQueue } from '@wordpress/priority-queue';
+
+/**
+ * Initialize deferred execution queue and context
+ */
+const queue = createQueue();
+const context = {};
+
+/**
+ * Register custom post type commands
+ */
+queue.add( context, () => {
+	// Only proceed when WordPress commands API and there are custom post types accessible
+	if (
+		! dispatch( 'core/commands' ) ||
+		! window.acf?.data?.customPostTypes?.length
+	) {
+		return;
+	}
+
+	const commandStore = dispatch( 'core/commands' );
+	const adminUrl = window.acf.data.admin_url || '';
+	const postTypes = window.acf.data.customPostTypes;
+
+	postTypes.forEach( ( postType ) => {
+		// Skip invalid post types
+		if ( ! postType?.name ) {
+			return;
+		}
+
+		const pluralLabel = postType.label || postType.name;
+		const singularLabel = postType.singular_label || pluralLabel;
+
+		// Register "View All" command for this post type
+		commandStore.registerCommand( {
+			name: `scf/cpt-${ postType.name }`,
+			label: pluralLabel,
+			icon: createElement( Icon, { icon: 'admin-page' } ),
+			context: 'admin',
+			description:
+				/* translators: %s: Post type plural label */
+				sprintf(
+					__( 'SCF: View all %s', 'secure-custom-fields' ),
+					pluralLabel
+				),
+			keywords: [
+				'post type',
+				'content',
+				'cpt',
+				postType.name,
+				...( postType.label ? [ postType.label ] : [] ),
+			],
+			callback: ( { close } ) => {
+				document.location =
+					adminUrl +
+					`edit.php?post_type=${ encodeURIComponent(
+						postType.name
+					) }`;
+				close();
+			},
+		} );
+
+		// Register "Add New" command for this post type
+		commandStore.registerCommand( {
+			name: `scf/new-${ postType.name }`,
+			label:
+				/* translators: %s: Post type singular label */
+				sprintf(
+					__( 'Add New %s', 'secure-custom-fields' ),
+					singularLabel
+				),
+			icon: createElement( Icon, { icon: 'plus' } ),
+			context: 'admin',
+			description:
+				/* translators: %s: Post type singular label */
+				sprintf(
+					__( 'SCF: Create a new %s', 'secure-custom-fields' ),
+					singularLabel
+				),
+			keywords: [
+				'add',
+				'new',
+				'create',
+				'content',
+				postType.name,
+				...( postType.label ? [ postType.label ] : [] ),
+			],
+			callback: ( { close } ) => {
+				document.location =
+					adminUrl +
+					`post-new.php?post_type=${ encodeURIComponent(
+						postType.name
+					) }`;
+				close();
+			},
+		} );
+	} );
+} );