$path ); if ( ! empty( $content_module ) ) { $route['content_module'] = $content_module; } if ( ! empty( $route_module ) ) { $route['route_module'] = $route_module; } $wp_options_connectors_routes[] = $route; } /** * Register a menu item for the options-connectors page. * * @param string $id Menu item ID. * @param string $label Display label. * @param string $to Route path to navigate to. * @param string $parent_id Optional. Parent menu item ID. * @param string $parent_type Optional. Parent type: 'drilldown' or 'dropdown'. */ function wp_register_options_connectors_menu_item( $id, $label, $to, $parent_id = '', $parent_type = '' ) { global $wp_options_connectors_menu_items; $menu_item = array( 'id' => $id, 'label' => $label, 'to' => $to, ); if ( ! empty( $parent_id ) ) { $menu_item['parent'] = $parent_id; } if ( ! empty( $parent_type ) && in_array( $parent_type, array( 'drilldown', 'dropdown' ), true ) ) { $menu_item['parent_type'] = $parent_type; } $wp_options_connectors_menu_items[] = $menu_item; } /** * Get all registered routes for the options-connectors page. * * @return array Array of route objects. */ function wp_get_options_connectors_routes() { global $wp_options_connectors_routes; return $wp_options_connectors_routes ?? array(); } /** * Get all registered menu items for the options-connectors page. * * @return array Array of menu item objects. */ function wp_get_options_connectors_menu_items() { global $wp_options_connectors_menu_items; return $wp_options_connectors_menu_items ?? array(); } /** * Preload REST API data for the options-connectors page. * Automatically called during page rendering. */ function wp_options_connectors_preload_data() { // Define paths to preload - same for all pages // Please also change packages/core-data/src/entities.js when changing this. $preload_paths = array( '/?_fields=description,gmt_offset,home,image_sizes,image_size_threshold,image_output_formats,jpeg_interlaced,png_interlaced,gif_interlaced,name,site_icon,site_icon_url,site_logo,timezone_string,url,page_for_posts,page_on_front,show_on_front', array( '/wp/v2/settings', 'OPTIONS' ), ); // Use rest_preload_api_request to gather the preloaded data $preload_data = array_reduce( $preload_paths, 'rest_preload_api_request', array() ); // Register the preloading middleware with wp-api-fetch wp_add_inline_script( 'wp-api-fetch', sprintf( 'wp.apiFetch.use( wp.apiFetch.createPreloadingMiddleware( %s ) );', wp_json_encode( $preload_data ) ), 'after' ); } /** * Render the options-connectors page. * Call this function from add_menu_page or add_submenu_page. */ function wp_options_connectors_render_page() { // Load build constants $build_constants = require __DIR__ . '/../../constants.php'; // Set current screen set_current_screen(); // Remove unwanted deprecated handler remove_action( 'admin_head', 'wp_admin_bar_header' ); // Remove unwanted scripts and styles that were enqueued during `admin_init` foreach ( wp_scripts()->queue as $script ) { wp_dequeue_script( $script ); } foreach ( wp_styles()->queue as $style ) { wp_dequeue_style( $style ); } // Fire init action for extensions to register routes and menu items do_action( 'options-connectors_init' ); // Enqueue command palette assets for boot-based pages if ( function_exists( 'wp_enqueue_command_palette_assets' ) ) { wp_enqueue_command_palette_assets(); } // Preload REST API data wp_options_connectors_preload_data(); // Get all registered routes and menu items $menu_items = wp_get_options_connectors_menu_items(); $routes = wp_get_options_connectors_routes(); // Get boot module asset file for dependencies $asset_file = ABSPATH . WPINC . '/js/dist/script-modules/boot/index.min.asset.php'; if ( file_exists( $asset_file ) ) { $asset = require $asset_file; // This script serves two purposes: // 1. It ensures all the globals that are made available to the modules are loaded. // 2. It initializes the boot module as an inline script. wp_register_script( 'options-connectors-prerequisites', '', $asset['dependencies'], $asset['version'], true ); // Add inline script to initialize the app $init_modules = []; wp_add_inline_script( 'options-connectors-prerequisites', sprintf( 'import("@wordpress/boot").then(mod => mod.init({mountId: "%s", menuItems: %s, routes: %s, initModules: %s, dashboardLink: "%s"}));', 'options-connectors-app', wp_json_encode( $menu_items, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ), wp_json_encode( $routes, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ), wp_json_encode( $init_modules, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ), esc_url( admin_url( '/' ) ) ) ); // Register prerequisites style by filtering script dependencies to find registered styles $style_dependencies = array_filter( $asset['dependencies'], function ( $handle ) { return wp_style_is( $handle, 'registered' ); } ); wp_register_style( 'options-connectors-prerequisites', false, $style_dependencies, $asset['version'] ); // Build dependencies for options-connectors module $boot_dependencies = array( array( 'import' => 'static', 'id' => '@wordpress/boot', ), ); // Add init modules as static dependencies // No init modules configured // Add all registered routes as dependencies foreach ( $routes as $route ) { if ( isset( $route['route_module'] ) ) { $boot_dependencies[] = array( 'import' => 'static', 'id' => $route['route_module'], ); } if ( isset( $route['content_module'] ) ) { $boot_dependencies[] = array( 'import' => 'dynamic', 'id' => $route['content_module'], ); } } // Dummy script module to ensure dependencies are loaded wp_register_script_module( 'options-connectors', $build_constants['build_url'] . 'pages/options-connectors/loader.js', $boot_dependencies ); // Enqueue the boot scripts and styles wp_enqueue_script( 'options-connectors-prerequisites' ); wp_enqueue_script_module( 'options-connectors' ); wp_enqueue_style( 'options-connectors-prerequisites' ); } // Output the HTML ?> >