Add Command Palette support

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

@@ -0,0 +1,179 @@
+/**
+ * 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
+ */
+
+wp.domReady( () => {
+	if ( ! wp.data?.dispatch?.( 'core/commands' ) || ! acf?.data ) {
+		return;
+	}
+
+	const { __ } = wp.i18n;
+	const { createElement } = wp.element;
+	const { Icon } = wp.components;
+	const commandStore = wp.data.dispatch( 'core/commands' );
+
+	const adminUrl = acf?.data?.admin_url || '';
+
+	const commands = [
+		{
+			name: 'field-groups',
+			label: __( 'Field Groups', 'secure-custom-fields' ),
+			url: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: `${ adminUrl }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: 'acf/' + command.name,
+			label: command.label,
+			icon: createElement( Icon, { icon: command.icon } ),
+			context: 'admin',
+			description: command.description,
+			keywords: command.keywords,
+			callback: ( { close } ) => {
+				document.location = command.url;
+				close();
+			},
+		} );
+	} );
+} );

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

@@ -0,0 +1,99 @@
+/**
+ * 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
+ */
+
+wp.domReady( () => {
+	// Only proceed when WordPress commands API and there are custom post types accessible
+	if (
+		! wp.data?.dispatch?.( 'core/commands' ) ||
+		! acf?.data?.customPostTypes?.length
+	) {
+		return;
+	}
+
+	const { __, sprintf } = wp.i18n;
+	const { createElement } = wp.element;
+	const { Icon } = wp.components;
+	const commandStore = wp.data.dispatch( 'core/commands' );
+	const adminUrl = acf.data.admin_url || '';
+	const postTypes = 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: `acf/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 || '',
+			],
+			callback: ( { close } ) => {
+				document.location = `${ adminUrl }edit.php?post_type=${ encodeURIComponent(
+					postType.name
+				) }`;
+				close();
+			},
+		} );
+
+		// Register "Add New" command for this post type
+		commandStore.registerCommand( {
+			name: `acf/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 || '',
+			],
+			callback: ( { close } ) => {
+				document.location = `${ adminUrl }post-new.php?post_type=${ encodeURIComponent(
+					postType.name
+				) }`;
+				close();
+			},
+		} );
+	} );
+} );

includes/admin/admin-commands.php

@@ -0,0 +1,88 @@
+<?php
+/**
+ * SCF Commands Integration
+ *
+ * @package Secure Custom Fields
+ */
+
+if ( ! defined( 'ABSPATH' ) ) {
+	exit; // Exit if accessed directly.
+}
+
+/**
+ * Initializes SCF commands integration
+ *
+ * This function handles the integration with WordPress Commands (Cmd+K / Ctrl+K),
+ * providing navigation commands for SCF admin pages and custom post types.
+ *
+ * The implementation follows these principles:
+ * 1. Only loads in screens where WordPress commands are available.
+ * 2. Performs capability checks to ensure users only see commands they can access.
+ * 3. Core administrative commands are only shown to users with SCF admin capabilities.
+ * 4. Custom post type commands are conditionally shown based on edit_posts capability
+ *    for each specific post type.
+ * 5. Post types must have UI enabled (show_ui setting) to appear in commands.
+ *
+ * @since 6.5.0
+ */
+function acf_commands_init() {
+	// Only load on admin screens.
+	if ( ! is_admin() ) {
+		return;
+	}
+
+	// Ensure we only load our commands where the WordPress commands API is available.
+	if ( ! wp_script_is( 'wp-commands', 'registered' ) ) {
+		return;
+	}
+
+	$custom_post_types = array();
+
+	if ( function_exists( 'acf_get_acf_post_types' ) ) {
+		$scf_post_types = acf_get_acf_post_types();
+
+		foreach ( $scf_post_types as $post_type ) {
+			// Skip if post type name is not set (defensive) or post type is inactive.
+			if ( empty( $post_type['post_type'] ) || ( isset( $post_type['active'] ) && ! $post_type['active'] ) ) {
+				continue;
+			}
+
+			$plural_label   = $post_type['labels']['name'] ?? $post_type['label'] ?? $post_type['post_type'];
+			$singular_label = $post_type['labels']['singular_name'] ?? $post_type['singular_label'] ?? $plural_label;
+
+			$post_type_obj = get_post_type_object( $post_type['post_type'] );
+
+			// Three conditions must be met to include this post type in the commands:
+			// 1. Post type object must exist
+			// 2. Current user must have permission to edit posts of this type.
+			// 3. Post type must have admin UI enabled (show_ui setting).
+			if ( $post_type_obj &&
+				current_user_can( $post_type_obj->cap->edit_posts ) &&
+				$post_type_obj->show_ui ) {
+				$custom_post_types[] = array(
+					'name'           => $post_type['post_type'],
+					'label'          => $plural_label,
+					'singular_label' => $singular_label,
+					'icon'           => $post_type['menu_icon'] ?? '',
+				);
+			}
+		}
+	}
+
+	acf_localize_data(
+		array(
+			'customPostTypes' => $custom_post_types,
+		)
+	);
+
+	if ( ! empty( $custom_post_types ) ) {
+		wp_enqueue_script( 'commands-custom-post-types' );
+	}
+
+	// Only load admin commands if user has SCF admin capabilities.
+	if ( current_user_can( acf_get_setting( 'capability' ) ) ) {
+		wp_enqueue_script( 'commands-admin' );
+	}
+}
+
+add_action( 'admin_enqueue_scripts', 'acf_commands_init' );