CMS Project Sync
This commit is contained in:
@@ -0,0 +1,262 @@
|
||||
<?php
|
||||
/**
|
||||
* Core Abilities registration.
|
||||
*
|
||||
* @package WordPress
|
||||
* @subpackage Abilities_API
|
||||
* @since 6.9.0
|
||||
*/
|
||||
|
||||
declare( strict_types = 1 );
|
||||
|
||||
/**
|
||||
* Registers the core ability categories.
|
||||
*
|
||||
* @since 6.9.0
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
function wp_register_core_ability_categories(): void {
|
||||
wp_register_ability_category(
|
||||
'site',
|
||||
array(
|
||||
'label' => __( 'Site' ),
|
||||
'description' => __( 'Abilities that retrieve or modify site information and settings.' ),
|
||||
)
|
||||
);
|
||||
|
||||
wp_register_ability_category(
|
||||
'user',
|
||||
array(
|
||||
'label' => __( 'User' ),
|
||||
'description' => __( 'Abilities that retrieve or modify user information and settings.' ),
|
||||
)
|
||||
);
|
||||
}
|
||||
|
||||
/**
|
||||
* Registers the default core abilities.
|
||||
*
|
||||
* @since 6.9.0
|
||||
*
|
||||
* @return void
|
||||
*/
|
||||
function wp_register_core_abilities(): void {
|
||||
$category_site = 'site';
|
||||
$category_user = 'user';
|
||||
|
||||
$site_info_properties = array(
|
||||
'name' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The site title.' ),
|
||||
),
|
||||
'description' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The site tagline.' ),
|
||||
),
|
||||
'url' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The site home URL.' ),
|
||||
),
|
||||
'wpurl' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The WordPress installation URL.' ),
|
||||
),
|
||||
'admin_email' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The site administrator email address.' ),
|
||||
),
|
||||
'charset' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The site character encoding.' ),
|
||||
),
|
||||
'language' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The site language locale code.' ),
|
||||
),
|
||||
'version' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The WordPress version.' ),
|
||||
),
|
||||
);
|
||||
$site_info_fields = array_keys( $site_info_properties );
|
||||
|
||||
wp_register_ability(
|
||||
'core/get-site-info',
|
||||
array(
|
||||
'label' => __( 'Get Site Information' ),
|
||||
'description' => __( 'Returns site information configured in WordPress. By default returns all fields, or optionally a filtered subset.' ),
|
||||
'category' => $category_site,
|
||||
'input_schema' => array(
|
||||
'type' => 'object',
|
||||
'properties' => array(
|
||||
'fields' => array(
|
||||
'type' => 'array',
|
||||
'items' => array(
|
||||
'type' => 'string',
|
||||
'enum' => $site_info_fields,
|
||||
),
|
||||
'description' => __( 'Optional: Limit response to specific fields. If omitted, all fields are returned.' ),
|
||||
),
|
||||
),
|
||||
'additionalProperties' => false,
|
||||
'default' => array(),
|
||||
),
|
||||
'output_schema' => array(
|
||||
'type' => 'object',
|
||||
'properties' => $site_info_properties,
|
||||
'additionalProperties' => false,
|
||||
),
|
||||
'execute_callback' => static function ( $input = array() ) use ( $site_info_fields ): array {
|
||||
$input = is_array( $input ) ? $input : array();
|
||||
$requested_fields = ! empty( $input['fields'] ) ? $input['fields'] : $site_info_fields;
|
||||
|
||||
$result = array();
|
||||
foreach ( $requested_fields as $field ) {
|
||||
$result[ $field ] = get_bloginfo( $field );
|
||||
}
|
||||
|
||||
return $result;
|
||||
},
|
||||
'permission_callback' => static function (): bool {
|
||||
return current_user_can( 'manage_options' );
|
||||
},
|
||||
'meta' => array(
|
||||
'annotations' => array(
|
||||
'readonly' => true,
|
||||
'destructive' => false,
|
||||
'idempotent' => true,
|
||||
),
|
||||
'show_in_rest' => true,
|
||||
),
|
||||
)
|
||||
);
|
||||
|
||||
wp_register_ability(
|
||||
'core/get-user-info',
|
||||
array(
|
||||
'label' => __( 'Get User Information' ),
|
||||
'description' => __( 'Returns basic profile details for the current authenticated user to support personalization, auditing, and access-aware behavior.' ),
|
||||
'category' => $category_user,
|
||||
'output_schema' => array(
|
||||
'type' => 'object',
|
||||
'required' => array( 'id', 'display_name', 'user_nicename', 'user_login', 'roles', 'locale' ),
|
||||
'properties' => array(
|
||||
'id' => array(
|
||||
'type' => 'integer',
|
||||
'description' => __( 'The user ID.' ),
|
||||
),
|
||||
'display_name' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The display name of the user.' ),
|
||||
),
|
||||
'user_nicename' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The URL-friendly name for the user.' ),
|
||||
),
|
||||
'user_login' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The login username for the user.' ),
|
||||
),
|
||||
'roles' => array(
|
||||
'type' => 'array',
|
||||
'description' => __( 'The roles assigned to the user.' ),
|
||||
'items' => array(
|
||||
'type' => 'string',
|
||||
),
|
||||
),
|
||||
'locale' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The locale string for the user, such as en_US.' ),
|
||||
),
|
||||
),
|
||||
'additionalProperties' => false,
|
||||
),
|
||||
'execute_callback' => static function (): array {
|
||||
$current_user = wp_get_current_user();
|
||||
|
||||
return array(
|
||||
'id' => $current_user->ID,
|
||||
'display_name' => $current_user->display_name,
|
||||
'user_nicename' => $current_user->user_nicename,
|
||||
'user_login' => $current_user->user_login,
|
||||
'roles' => $current_user->roles,
|
||||
'locale' => get_user_locale( $current_user ),
|
||||
);
|
||||
},
|
||||
'permission_callback' => static function (): bool {
|
||||
return is_user_logged_in();
|
||||
},
|
||||
'meta' => array(
|
||||
'annotations' => array(
|
||||
'readonly' => true,
|
||||
'destructive' => false,
|
||||
'idempotent' => true,
|
||||
),
|
||||
'show_in_rest' => false,
|
||||
),
|
||||
)
|
||||
);
|
||||
|
||||
wp_register_ability(
|
||||
'core/get-environment-info',
|
||||
array(
|
||||
'label' => __( 'Get Environment Info' ),
|
||||
'description' => __( 'Returns core details about the site\'s runtime context for diagnostics and compatibility (environment, PHP runtime, database server info, WordPress version).' ),
|
||||
'category' => $category_site,
|
||||
'output_schema' => array(
|
||||
'type' => 'object',
|
||||
'required' => array( 'environment', 'php_version', 'db_server_info', 'wp_version' ),
|
||||
'properties' => array(
|
||||
'environment' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The site\'s runtime environment classification (can be one of these: production, staging, development, local).' ),
|
||||
'enum' => array( 'production', 'staging', 'development', 'local' ),
|
||||
),
|
||||
'php_version' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The PHP runtime version executing WordPress.' ),
|
||||
),
|
||||
'db_server_info' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The database server vendor and version string reported by the driver.' ),
|
||||
),
|
||||
'wp_version' => array(
|
||||
'type' => 'string',
|
||||
'description' => __( 'The WordPress core version running on this site.' ),
|
||||
),
|
||||
),
|
||||
'additionalProperties' => false,
|
||||
),
|
||||
'execute_callback' => static function (): array {
|
||||
global $wpdb;
|
||||
|
||||
$env = wp_get_environment_type();
|
||||
$php_version = phpversion();
|
||||
$db_server_info = '';
|
||||
if ( method_exists( $wpdb, 'db_server_info' ) ) {
|
||||
$db_server_info = $wpdb->db_server_info() ?? '';
|
||||
}
|
||||
$wp_version = get_bloginfo( 'version' );
|
||||
|
||||
return array(
|
||||
'environment' => $env,
|
||||
'php_version' => $php_version,
|
||||
'db_server_info' => $db_server_info,
|
||||
'wp_version' => $wp_version,
|
||||
);
|
||||
},
|
||||
'permission_callback' => static function (): bool {
|
||||
return current_user_can( 'manage_options' );
|
||||
},
|
||||
'meta' => array(
|
||||
'annotations' => array(
|
||||
'readonly' => true,
|
||||
'destructive' => false,
|
||||
'idempotent' => true,
|
||||
),
|
||||
'show_in_rest' => true,
|
||||
),
|
||||
)
|
||||
);
|
||||
}
|
||||
Reference in New Issue
Block a user