$path ); if ( ! empty( $content_module ) ) { $route['content_module'] = $content_module; } if ( ! empty( $route_module ) ) { $route['route_module'] = $route_module; } $wp_options_connectors_wp_admin_routes[] = $route; } /** * Register a menu item for the options-connectors-wp-admin page. * Note: Menu items are registered but not displayed in single-page mode. * * @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. */ function wp_register_options_connectors_wp_admin_menu_item( $id, $label, $to, $parent_id = '' ) { global $wp_options_connectors_wp_admin_menu_items; $menu_item = array( 'id' => $id, 'label' => $label, 'to' => $to, ); if ( ! empty( $parent_id ) ) { $menu_item['parent'] = $parent_id; } $wp_options_connectors_wp_admin_menu_items[] = $menu_item; } /** * Get all registered routes for the options-connectors-wp-admin page. * * @return array Array of route objects. */ function wp_get_options_connectors_wp_admin_routes() { global $wp_options_connectors_wp_admin_routes; return $wp_options_connectors_wp_admin_routes ?? array(); } /** * Get all registered menu items for the options-connectors-wp-admin page. * * @return array Array of menu item objects. */ function wp_get_options_connectors_wp_admin_menu_items() { global $wp_options_connectors_wp_admin_menu_items; return $wp_options_connectors_wp_admin_menu_items ?? array(); } /** * Preload REST API data for the options-connectors-wp-admin page. * Automatically called during page rendering. */ function wp_options_connectors_wp_admin_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' ); } /** * Enqueue scripts and styles for the options-connectors-wp-admin page. * Hooked to admin_enqueue_scripts. * * @param string $hook_suffix The current admin page. */ function wp_options_connectors_wp_admin_enqueue_scripts( $hook_suffix ) { // Check all possible ways this page can be accessed: // 1. Menu page via admin.php?page=options-connectors-wp-admin (plugin) // 2. Direct file via options-connectors.php (Core) - screen ID will be 'options-connectors' $current_screen = get_current_screen(); $is_our_page = ( ( isset( $_GET['page'] ) && 'options-connectors-wp-admin' === $_GET['page'] ) || // phpcs:ignore WordPress.Security.NonceVerification.Recommended ( $current_screen && 'options-connectors' === $current_screen->id ) ); if ( ! $is_our_page ) { return; } // Load build constants $build_constants = require __DIR__ . '/../../constants.php'; // Fire init action for extensions to register routes and menu items do_action( 'options-connectors-wp-admin_init' ); // Preload REST API data wp_options_connectors_wp_admin_preload_data(); // Get all registered routes $routes = wp_get_options_connectors_wp_admin_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-wp-admin-prerequisites', '', $asset['dependencies'], $asset['version'], true ); /* * Add inline script to initialize the app using initSinglePage (no menuItems). * The dynamic import is deferred until DOMContentLoaded so that all classic * script dependencies of @wordpress/boot (wp-private-apis, wp-components, * wp-theme, etc.) have finished parsing and executing before the boot module * evaluates. Otherwise, a modulepreloaded @wordpress/boot can win the race * against the classic-script-printing pass on fast CDN-fronted hosts in * Chrome, evaluating before wp.theme.privateApis is defined and throwing * "Cannot unlock an undefined object". See . */ $init_js_function = <<<'JS' ( mountId, routes ) => { const run = async () => { const mod = await import( "@wordpress/boot" ); mod.initSinglePage( { mountId, routes } ); }; if ( document.readyState === "loading" ) { document.addEventListener( "DOMContentLoaded", run ); } else { run(); } } JS; wp_add_inline_script( 'options-connectors-wp-admin-prerequisites', sprintf( '( %s )( %s, %s );', $init_js_function, wp_json_encode( 'options-connectors-wp-admin-app', JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ), wp_json_encode( $routes, JSON_HEX_TAG | JSON_UNESCAPED_SLASHES ) ) ); // 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-wp-admin-prerequisites', false, $style_dependencies, $asset['version'] ); // Build dependencies for options-connectors-wp-admin module $boot_dependencies = array( array( 'import' => 'static', 'id' => '@wordpress/boot', ), ); // 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-wp-admin', $build_constants['build_url'] . 'pages/options-connectors/loader.js', $boot_dependencies ); // Enqueue the boot scripts and styles wp_enqueue_script( 'options-connectors-wp-admin-prerequisites' ); wp_enqueue_script_module( 'options-connectors-wp-admin' ); wp_enqueue_style( 'options-connectors-wp-admin-prerequisites' ); } } /** * Render the options-connectors-wp-admin page. * Call this function from add_menu_page or add_submenu_page. * This renders within the normal WordPress admin interface. */ function wp_options_connectors_wp_admin_render_page() { ?>