File: /var/www/html/emmacooper.org/wp-content/themes/astra/inc/abilities/class-astra-abilities-init.php
<?php
/**
* Abilities Init
*
* Main initialization class for Astra Abilities API integration.
* Registers the 'astra' category and loads all ability classes.
*
* @package Astra
* @subpackage Abilities
* @since 4.12.6
*/
// Exit if accessed directly.
if ( ! defined( 'ABSPATH' ) ) {
exit;
}
/**
* Class Astra_Abilities_Init
*/
class Astra_Abilities_Init {
/**
* Instance of this class.
*
* @var self|null
*/
private static $instance = null;
/**
* Whether abilities have been registered.
*
* @var bool
*/
private $registered = false;
/**
* Whether categories have been registered.
*
* @var bool
*/
private $categories_registered = false;
/**
* Get singleton instance.
*
* @return self
*/
public static function get_instance() {
if ( null === self::$instance ) {
self::$instance = new self();
}
return self::$instance;
}
/**
* Constructor.
*/
public function __construct() {
// Support both pre-6.9 and 6.9+ (core) action names.
add_action( 'abilities_api_categories_init', array( $this, 'register_categories' ) );
add_action( 'wp_abilities_api_categories_init', array( $this, 'register_categories' ) );
add_action( 'abilities_api_init', array( $this, 'register_abilities' ) );
add_action( 'wp_abilities_api_init', array( $this, 'register_abilities' ) );
// Register dedicated Astra MCP server when enabled and the MCP Adapter is active.
if ( Astra_API_Init::get_admin_settings_option( 'enable_mcp_server', false ) && function_exists( 'wp_register_ability' ) && class_exists( 'WP\MCP\Plugin' ) ) {
add_action( 'mcp_adapter_init', array( $this, 'register_mcp_server' ) );
}
}
/**
* Register ability categories.
*
* @return void
*/
public function register_categories() {
if ( $this->categories_registered ) {
return;
}
if ( ! function_exists( 'wp_register_ability_category' ) ) {
return;
}
wp_register_ability_category(
'astra',
array(
'label' => __( 'Astra Theme', 'astra' ),
'description' => __( 'Astra theme customization abilities for typography, colors, layout, and design settings.', 'astra' ),
)
);
$this->categories_registered = true;
}
/**
* Register all Astra abilities.
*
* @return void
*/
public function register_abilities() {
if ( $this->registered ) {
return;
}
if ( ! function_exists( 'wp_register_ability' ) ) {
return;
}
$abilities_dir = ASTRA_THEME_DIR . 'inc/abilities/';
$ability_files = array(
// Performance abilities.
'admin/settings/performance/class-astra-get-performance',
'admin/settings/performance/class-astra-update-performance',
'admin/settings/performance/class-astra-flush-local-fonts',
'admin/settings/performance/class-astra-get-load-google-fonts-locally',
'admin/settings/performance/class-astra-get-preload-local-fonts',
'admin/settings/performance/class-astra-update-load-google-fonts-locally',
'admin/settings/performance/class-astra-update-preload-local-fonts',
// Typography abilities.
'customizer/globals/typography/class-astra-get-body-font',
'customizer/globals/typography/class-astra-update-body-font',
'customizer/globals/typography/class-astra-get-headings-font',
'customizer/globals/typography/class-astra-update-headings-font',
'customizer/globals/typography/class-astra-list-font-families',
// Individual heading typography abilities (H1-H6) — registered via loop.
'customizer/globals/typography/class-astra-get-heading-font',
'customizer/globals/typography/class-astra-update-heading-font',
// Paragraph margin and underline links abilities.
'customizer/globals/typography/class-astra-get-paragraph-margin',
'customizer/globals/typography/class-astra-update-paragraph-margin',
'customizer/globals/typography/class-astra-get-underline-links-status',
'customizer/globals/typography/class-astra-toggle-underline-links',
// Colors abilities.
'customizer/globals/colors/class-astra-get-global-palette',
'customizer/globals/colors/class-astra-update-global-palette',
'customizer/globals/colors/class-astra-get-background-colors',
'customizer/globals/colors/class-astra-update-background-colors',
'customizer/globals/colors/class-astra-update-theme-colors',
// Container abilities.
'customizer/globals/container/class-astra-get-container-layout',
'customizer/globals/container/class-astra-update-container-layout',
'customizer/globals/container/class-astra-list-container-settings',
// Buttons abilities.
'customizer/globals/buttons/class-astra-get-global-buttons',
'customizer/globals/buttons/class-astra-update-global-buttons',
// Header Builder abilities.
'customizer/header/class-astra-get-header-builder',
'customizer/header/class-astra-get-header-builder-design',
'customizer/header/class-astra-update-header-builder',
'customizer/header/class-astra-update-header-builder-design',
'customizer/header/class-astra-migrate-header-components',
'customizer/header/builder/class-astra-list-header-builder-settings',
// Transparent Header abilities.
'customizer/header/transparent/class-astra-get-transparent-header',
'customizer/header/transparent/class-astra-update-transparent-header',
// Footer Builder abilities.
'customizer/footer/class-astra-get-footer-builder',
'customizer/footer/class-astra-get-footer-builder-design',
'customizer/footer/class-astra-update-footer-builder',
'customizer/footer/class-astra-update-footer-builder-design',
// Blogs / Post Types abilities.
'customizer/posttypes/blog/class-astra-get-blog-archive',
'customizer/posttypes/blog/class-astra-update-blog-archive',
'customizer/posttypes/blog/class-astra-get-single-post',
'customizer/posttypes/blog/class-astra-update-single-post',
'customizer/posttypes/blog/class-astra-get-single-page',
'customizer/posttypes/blog/class-astra-update-single-page',
// Site Identity abilities.
'customizer/siteidentity/class-astra-get-site-title-logo',
'customizer/siteidentity/class-astra-update-site-title-logo',
// Breadcrumb abilities.
'customizer/general/breadcrumb/class-astra-get-breadcrumb',
'customizer/general/breadcrumb/class-astra-update-breadcrumb',
// Post Meta abilities.
'admin/postmeta/class-astra-get-postmeta',
'admin/postmeta/class-astra-update-postmeta',
// Sidebar abilities.
'customizer/general/sidebar/class-astra-get-sidebar',
'customizer/general/sidebar/class-astra-get-sidebar-layout',
'customizer/general/sidebar/class-astra-get-sidebar-style',
'customizer/general/sidebar/class-astra-get-sidebar-width',
'customizer/general/sidebar/class-astra-get-sticky-sidebar',
'customizer/general/sidebar/class-astra-update-sidebar',
'customizer/general/sidebar/class-astra-update-sidebar-layout',
'customizer/general/sidebar/class-astra-update-sidebar-style',
'customizer/general/sidebar/class-astra-update-sidebar-width',
'customizer/general/sidebar/class-astra-update-sticky-sidebar',
// Scroll to Top abilities.
'customizer/general/scroll-to-top/class-astra-get-scroll-to-top',
'customizer/general/scroll-to-top/class-astra-update-scroll-to-top',
);
foreach ( $ability_files as $file ) {
require_once $abilities_dir . $file . '.php';
}
$this->registered = true;
}
/**
* Register a dedicated Astra MCP server.
*
* Creates an MCP server endpoint at /wp-json/astra/v1/mcp
* that only includes astra/ prefixed abilities.
*
* @param object $adapter The MCP adapter instance.
* @return void
* @since 4.13.0
*/
public function register_mcp_server( $adapter ) {
$abilities = wp_get_abilities();
$tools = array();
foreach ( $abilities as $ability ) {
if ( 0 === strpos( $ability->get_name(), 'astra/' ) ) {
$tools[] = $ability->get_name();
}
}
$transport_class = class_exists( '\WP\MCP\Transport\HttpTransport' )
? \WP\MCP\Transport\HttpTransport::class
: \WP\MCP\Transport\Http\RestTransport::class;
$adapter->create_server(
'astra',
'astra/v1',
'mcp',
__( 'Astra MCP Server', 'astra' ),
__( 'Astra MCP Server for theme customization and design settings.', 'astra' ),
ASTRA_THEME_VERSION,
array( $transport_class ),
\WP\MCP\Infrastructure\ErrorHandling\ErrorLogMcpErrorHandler::class,
\WP\MCP\Infrastructure\Observability\NullMcpObservabilityHandler::class,
$tools,
array(),
array()
);
}
}