Feat/add role user access controls

includes/Abstracts/Abstract_Feature.php

@@ -319,10 +319,81 @@ final public static function get_field_option_name( string $option_name ): strin
 		return 'wpai_feature_' . static::get_id() . '_field_' . $option_name;
 	}
 
+	/**
+	 * Registers WordPress infrastructure that must run for all users.
+	 *
+	 * Example use cases:
+	 * - Registering post/comment meta via register_meta() or register_post_meta()
+	 *   so the REST API schema is always available.
+	 * - Attaching plugin-deactivation hooks to clear transient caches.
+	 *
+	 * @since x.x.x
+	 *
+	 * @return void
+	 */
+	protected function register_infrastructure(): void {
+		// Default implementation is a no-op.
+	}
+
+	/**
+	 * Checks whether the current user can access this feature.
+	 *
+	 * @since x.x.x
+	 *
+	 * @return bool True if current user has access, false otherwise.
+	 */
+	public function current_user_can_access(): bool {
+		if ( ! $this->supports_access_control() ) {
+			return true;
+		}
+
+		return \WordPress\AI\current_user_can_access_feature( static::get_id() );
+	}
+
+	/**
+	 * Checks whether access control applies to this feature.
+	 *
+	 * Admin-category features do not have access controls by default,
+	 * except for features explicitly allowing it (e.g. comment-moderation, suggest-reply).
+	 *
+	 * @since x.x.x
+	 *
+	 * @return bool True if feature supports access control, false otherwise.
+	 */
+	public function supports_access_control(): bool {
+		return 'admin' !== $this->category
+			|| in_array( static::get_id(), array( 'comment-moderation', 'suggest-reply' ), true );
+	}
+
+	/**
+	 * Registers user-facing feature hooks and functionality.
+	 *
+	 * Subclasses should override this method to register abilities,
+	 * scripts, UI elements, and actions that require user access.
+	 *
+	 * @since x.x.x
+	 *
+	 * @return void
+	 */
+	protected function register_feature(): void {
+		// Default implementation is a no-op.
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *
-	 * Must be implemented by child classes to set up hooks and functionality.
+	 * Runs infrastructure setup for all users, then registers feature
+	 * hooks if the current user has access to this feature.
+	 *
+	 * @since 0.6.0
 	 */
-	abstract public function register(): void;
+	public function register(): void {
+		$this->register_infrastructure();
+
+		if ( ! $this->current_user_can_access() ) {
+			return;
+		}
+
+		$this->register_feature();
+	}
 }

includes/Experiments/Alt_Text_Generation/Alt_Text_Generation.php

@@ -5,7 +5,7 @@
  * @package WordPress\AI
  */
 
-declare( strict_types=1 );
+declare(strict_types=1);
 
 namespace WordPress\AI\Experiments\Alt_Text_Generation;
 
@@ -78,7 +78,7 @@ protected function load_metadata(): array {
 	/**
 	 * {@inheritDoc}
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'enqueue_block_editor_assets', array( $this, 'enqueue_editor_assets' ) );
 		add_action( 'wp_enqueue_media', array( $this, 'enqueue_media_frame_assets' ) );
@@ -253,9 +253,9 @@ public function render_attachment_meta_box( \WP_Post $post ): void {
 
 		printf(
 			'<div class="ai-alt-text-media-actions" style="margin-top: 16px;">' .
-				'<button id="ai-alt-text-generate-button" class="button button-secondary" type="button" data-attachment-id="%1$d">%2$s</button>' .
-				'<span class="spinner" aria-hidden="true" style="margin-inline-start: 8px; float: none;"></span>' .
-				'<p class="description" aria-live="polite" style="margin-top: 10px; line-height: 1.3;"></p>' .
+			'<button id="ai-alt-text-generate-button" class="button button-secondary" type="button" data-attachment-id="%1$d">%2$s</button>' .
+			'<span class="spinner" aria-hidden="true" style="margin-inline-start: 8px; float: none;"></span>' .
+			'<p class="description" aria-live="polite" style="margin-top: 10px; line-height: 1.3;"></p>' .
 			'</div>',
 			absint( $post->ID ),
 			esc_html( $button_text )
@@ -409,9 +409,9 @@ public function add_button_to_media_modal( array $fields, ?\WP_Post $post ): arr
 			'show_in_edit' => false,
 			'html'         => sprintf(
 				'<div class="ai-alt-text-media-actions">' .
-					'<button id="ai-alt-text-generate-button" class="button button-secondary" type="button" data-attachment-id="%1$d">%2$s</button>' .
-					'<span class="spinner" aria-hidden="true" style="margin-inline-start: 8px; float: none;"></span>' .
-					'<p class="description" aria-live="polite" style="margin-top: 6px; font-size: 12px;"></p>' .
+				'<button id="ai-alt-text-generate-button" class="button button-secondary" type="button" data-attachment-id="%1$d">%2$s</button>' .
+				'<span class="spinner" aria-hidden="true" style="margin-inline-start: 8px; float: none;"></span>' .
+				'<p class="description" aria-live="polite" style="margin-top: 6px; font-size: 12px;"></p>' .
 				'</div>',
 				absint( $post->ID ),
 				esc_html( $button_text )

includes/Experiments/Comment_Moderation/Comment_Moderation.php

@@ -307,18 +307,25 @@ protected function load_metadata(): array {
 		);
 	}
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * @since x.x.x
+	 */
+	protected function register_infrastructure(): void {
+		// Moderate new comments automatically in the background.
+		add_action( 'wp_insert_comment', array( $this, 'moderate_comment' ) );
+	}
+
 	/**
 	 * {@inheritDoc}
 	 *
 	 * @since 0.9.0
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		// Register abilities.
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 
-		// Moderate new comments.
-		add_action( 'wp_insert_comment', array( $this, 'moderate_comment' ) );
-
 		// Add columns to comments list table.
 		add_filter( 'manage_edit-comments_columns', array( $this, 'add_columns' ) );
 		add_action( 'manage_comments_custom_column', array( $this, 'render_column' ), 10, 2 );

includes/Experiments/Content_Classification/Content_Classification.php

@@ -5,7 +5,7 @@
  * @package WordPress\AI
  */
 
-declare( strict_types=1 );
+declare(strict_types=1);
 
 namespace WordPress\AI\Experiments\Content_Classification;
 
@@ -31,6 +31,7 @@
  */
 class Content_Classification extends Abstract_Feature {
 
+
 	/**
 	 * The default taxonomy strategy.
 	 *
@@ -97,7 +98,7 @@ protected function load_metadata(): array {
 	/**
 	 * {@inheritDoc}
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
 	}

includes/Experiments/Content_Resizing/Content_Resizing.php

@@ -49,7 +49,7 @@ protected function load_metadata(): array {
 	/**
 	 * {@inheritDoc}
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
 	}

includes/Experiments/Content_Translation/Content_Translation.php

@@ -54,7 +54,7 @@ protected function load_metadata(): array {
 	 *
 	 * @since 1.3.0
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
 		add_action( 'enqueue_block_assets', array( $this, 'enqueue_block_assets' ) );

includes/Experiments/Editorial_Notes/Editorial_Notes.php

@@ -5,7 +5,7 @@
  * @package WordPress\AI
  */
 
-declare( strict_types=1 );
+declare(strict_types=1);
 
 namespace WordPress\AI\Experiments\Editorial_Notes;
 
@@ -31,6 +31,7 @@
  */
 class Editorial_Notes extends Abstract_Feature {
 
+
 	/**
 	 * {@inheritDoc}
 	 */
@@ -52,9 +53,19 @@ protected function load_metadata(): array {
 	/**
 	 * {@inheritDoc}
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'enqueue_block_editor_assets', array( $this, 'enqueue_assets' ) );
+	}
+
+	/**
+	 * {@inheritDoc}
+	 *
+	 * Registers comment meta and the REST insert filter.
+	 *
+	 * @since x.x.x
+	 */
+	protected function register_infrastructure(): void {
 		add_filter( 'rest_pre_insert_comment', array( $this, 'maybe_set_ai_author' ), 10, 2 );
 
 		register_meta(

includes/Experiments/Editorial_Updates/Editorial_Updates.php

@@ -5,7 +5,7 @@
  * @package WordPress\AI
  */
 
-declare( strict_types=1 );
+declare(strict_types=1);
 
 namespace WordPress\AI\Experiments\Editorial_Updates;
 
@@ -29,6 +29,7 @@
  */
 class Editorial_Updates extends Abstract_Feature {
 
+
 	/**
 	 * {@inheritDoc}
 	 */
@@ -54,7 +55,7 @@ protected function load_metadata(): array {
 	 *
 	 * @since 0.8.0
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'enqueue_block_editor_assets', array( $this, 'enqueue_assets' ) );
 	}

includes/Experiments/Excerpt_Generation/Excerpt_Generation.php

@@ -5,7 +5,7 @@
  * @package WordPress\AI
  */
 
-declare( strict_types=1 );
+declare(strict_types=1);
 
 namespace WordPress\AI\Experiments\Excerpt_Generation;
 
@@ -27,6 +27,7 @@
  */
 class Excerpt_Generation extends Abstract_Feature {
 
+
 	/**
 	 * {@inheritDoc}
 	 */
@@ -48,7 +49,7 @@ protected function load_metadata(): array {
 	/**
 	 * {@inheritDoc}
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
 	}

includes/Experiments/Meta_Description/Meta_Description.php

@@ -5,7 +5,7 @@
  * @package WordPress\AI
  */
 
-declare( strict_types=1 );
+declare(strict_types=1);
 
 namespace WordPress\AI\Experiments\Meta_Description;
 
@@ -31,6 +31,7 @@
  */
 class Meta_Description extends Abstract_Feature {
 
+
 	/**
 	 * {@inheritDoc}
 	 */
@@ -54,13 +55,22 @@ protected function load_metadata(): array {
 	 *
 	 * @since 0.7.0
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
-		add_action( 'deactivated_plugin', array( $this, 'clear_active_plugin_cache' ) );
+	}
 
-		$this->maybe_output_meta_description();
+	/**
+	 * {@inheritDoc}
+	 *
+	 * Registers post meta, the deactivated_plugin cache hook, and frontend meta description output.
+	 *
+	 * @since x.x.x
+	 */
+	protected function register_infrastructure(): void {
 		$this->register_post_meta();
+		$this->maybe_output_meta_description();
+		add_action( 'deactivated_plugin', array( $this, 'clear_active_plugin_cache' ) );
 	}
 
 	/**

includes/Experiments/Slug_Generation/Slug_Generation.php

@@ -54,7 +54,7 @@ protected function load_metadata(): array {
 	 *
 	 * @since 1.3.0
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );
 	}

includes/Experiments/Suggest_Reply/Suggest_Reply.php

@@ -53,7 +53,7 @@ protected function load_metadata(): array {
 	 *
 	 * @since 1.2.0
 	 */
-	public function register(): void {
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_filter( 'comment_row_actions', array( $this, 'add_row_action' ), 10, 2 );
 		add_action( 'admin_enqueue_scripts', array( $this, 'enqueue_assets' ) );

includes/Experiments/Summarization/Summarization.php

@@ -5,7 +5,7 @@
  * @package WordPress\AI
  */
 
-declare( strict_types=1 );
+declare(strict_types=1);
 
 namespace WordPress\AI\Experiments\Summarization;
 
@@ -69,11 +69,9 @@ protected function load_metadata(): array {
 	/**
 	 * {@inheritDoc}
 	 */
-	public function register(): void {
-		$this->register_post_meta();
+	protected function register_feature(): void {
 		add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
 		add_action( 'enqueue_block_editor_assets', array( $this, 'enqueue_assets' ), 5 );
-		add_action( 'enqueue_block_assets', array( $this, 'enqueue_block_assets' ) );
 
 		add_action( 'load-edit.php', array( $this, 'register_bulk_action_hooks_for_screen' ) );
 		add_action( 'admin_enqueue_scripts', array( $this, 'maybe_enqueue_bulk_assets' ) );
@@ -121,6 +119,18 @@ public function register_bulk_action_hooks_for_screen(): void {
 		add_filter( "handle_bulk_actions-edit-{$post_type}", array( $this, 'handle_bulk_action' ), 10, 3 );
 	}
 
+	/**
+	 * {@inheritDoc}
+	 *
+	 * Registers post meta.
+	 *
+	 * @since x.x.x
+	 */
+	protected function register_infrastructure(): void {
+		add_action( 'enqueue_block_assets', array( $this, 'enqueue_block_assets' ) );
+		$this->register_post_meta();
+	}
+
 	/**
 	 * Register any needed post meta.
 	 *