WP_REST_Abilities_V1_Run_Controller

19class WP_REST_Abilities_V1_Run_Controller extends WP_REST_Controller {20 21	/**22	 * REST API namespace.23	 *24	 * @since 6.9.025	 * @var string26	 */27	protected $namespace = 'wp-abilities/v1';28 29	/**30	 * REST API base route.31	 *32	 * @since 6.9.033	 * @var string34	 */35	protected $rest_base = 'abilities';36 37	/**38	 * Registers the routes for ability execution.39	 *40	 * @since 6.9.041	 *42	 * @see register_rest_route()43	 */44	public function register_routes(): void {45		register_rest_route(46			$this->namespace,47			'/' . $this->rest_base . '/(?P<name>[a-zA-Z0-9\-\/]+?)/run',48			array(49				'args'   => array(50					'name' => array(51						'description' => __( 'Unique identifier for the ability.' ),52						'type'        => 'string',53						'pattern'     => '^[a-zA-Z0-9\-\/]+$',54					),55				),56 57				// TODO: We register ALLMETHODS because at route registration time, we don't know which abilities58				// exist or their annotations (`destructive`, `idempotent`, `readonly`). This is due to WordPress59				// load order - routes are registered early, before plugins have registered their abilities.60				// This approach works but could be improved with lazy route registration or a different61				// architecture that allows type-specific routes after abilities are registered.62				// This was the same issue that we ended up seeing with the Feature API.63				array(64					'methods'             => WP_REST_Server::ALLMETHODS,65					'callback'            => array( $this, 'execute_ability' ),66					'permission_callback' => array( $this, 'check_ability_permissions' ),67					'args'                => $this->get_run_args(),68				),69				'schema' => array( $this, 'get_run_schema' ),70			)71		);72	}73 74	/**75	 * Executes an ability.76	 *77	 * @since 6.9.078	 *79	 * @param WP_REST_Request $request Full details about the request.80	 * @return WP_REST_Response|WP_Error Response object on success, or WP_Error object on failure.81	 */82	public function execute_ability( $request ) {83		$ability = wp_has_ability( $request['name'] ) ? wp_get_ability( $request['name'] ) : null;84		if ( ! $ability ) {85			return new WP_Error(86				'rest_ability_not_found',87				__( 'Ability not found.' ),88				array( 'status' => 404 )89			);90		}91 92		$input  = $this->get_input_from_request( $request );93		$result = $ability->execute( $input );94		if ( is_wp_error( $result ) ) {95			return $result;96		}97 98		return rest_ensure_response( $result );