← All changes | includes/dock-rail-renderer.php +25 -33 0.9.7 → 1.1.10 View file →

		@@ -2,10 +2,10 @@
2	2	/**
3	3	* Server-side opt-in for dock rail renderer scripts.
4	4	*
5	5	* Mirrors `includes/commands.php` exactly — a plugin enqueues a JS
6		- * bundle that registers a renderer with `wp.desktop.registerDockRailRenderer()`,
7		- * then calls `desktop_mode_register_dock_rail_renderer_script( $handle )`
	6	+ * bundle that registers a renderer with `wp.os.registerDockRailRenderer()`,
	7	+ * then calls `openstation_register_dock_rail_renderer_script( $handle )`
8	8	* to opt the script into the live-refresh payload. The shell loads
9	9	* the script over the chromeless bridge on activation, the JS calls
10	10	* `registerDockRailRenderer()`, and the OS Settings → Dock style picker
11	11	* surfaces the new option immediately — no F5.
		@@ -14,11 +14,9 @@
14	14	* tagged with `owner: '<handle>'` is unregistered. The active id falls
15	15	* back through the registry's chain (user pick → `default`) and the
16	16	* dispatcher rebuilds the rails with whatever resolves.
17	17	*
18		- * @since 0.6.0
19		- *
20		- * @package WPDesktopMode
	18	+ * @package OpenStation
21	19	*/
22	20
23	21	defined( 'ABSPATH' ) || exit;
24	22
		@@ -27,49 +25,45 @@
27	25	*
28	26	* Example:
29	27	*
30	28	* ```php
31		- * add_action( 'desktop_mode_shell_assets', function () {
	29	+ * add_action( 'openstation_shell_assets', function () {
32	30	* wp_register_script(
33	31	* 'orbit-rail',
34	32	* plugin_dir_url( __FILE__ ) . 'orbit-rail.js',
35		- * array( 'desktop-mode' ),
	33	+ * array( 'openstation' ),
36	34	* '1.0.0',
37	35	* true
38	36	* );
39	37	* wp_enqueue_script( 'orbit-rail' );
40	38	* } );
41		- * desktop_mode_register_dock_rail_renderer_script( 'orbit-rail' );
	39	+ * openstation_register_dock_rail_renderer_script( 'orbit-rail' );
42	40	* ```
43	41	*
44		- * The script's JS side calls `wp.desktop.registerDockRailRenderer( { … } )`
	42	+ * The script's JS side calls `wp.os.registerDockRailRenderer( { … } )`
45	43	* with `owner: 'orbit-rail'` (matching the handle) so deactivation
46	44	* cleanly removes the renderer.
47	45	*
48		- * @since 0.6.0
49		- *
50	46	* @param string $handle WP-registered script handle.
51	47	* @return true|WP_Error `true` on success; `WP_Error` on validation failure.
52	48	*/
53		-function desktop_mode_register_dock_rail_renderer_script( $handle ) {
	49	+function openstation_register_dock_rail_renderer_script( $handle ) {
54	50	$handle = (string) $handle;
55	51	if ( '' === $handle ) {
56		- return desktop_mode_registration_error(
57		- 'desktop_mode_missing_handle',
	52	+ return openstation_registration_error(
	53	+ 'openstation_missing_handle',
58	54	__( 'Dock rail renderer script registration requires a non-empty script handle.', 'desktop-mode' )
59	55	);
60	56	}
61	57
62		- desktop_mode_dock_rail_renderer_script_registry( $handle, true );
	58	+ openstation_dock_rail_renderer_script_registry( $handle, true );
63	59
64	60	/**
65	61	* Fires after a desktop dock rail renderer script handle is registered.
66	62	*
67		- * @since 0.6.0
68		- *
69	63	* @param string $handle The registered script handle.
70	64	*/
71		- do_action( 'desktop_mode_dock_rail_renderer_script_registered', $handle );
	65	+ do_action( 'openstation_dock_rail_renderer_script_registered', $handle );
72	66
73	67	return true;
74	68	}
75	69
		@@ -76,9 +70,8 @@
76	70	/**
77	71	* Internal module-level registry for dock rail renderer script handles.
78	72	* Read by the payload builder, written by the registration API.
79	73	*
80		- * @since 0.6.0
81	74	* @internal
82	75	*
83	76	* @param string $handle Script handle to read or write.
84	77	* @param bool|null $value Pass `true` to register; `null` to read only.
		@@ -83,9 +76,9 @@
83	76	* @param string $handle Script handle to read or write.
84	77	* @param bool|null $value Pass `true` to register; `null` to read only.
85	78	* @return array|bool When called with no args returns the full store.
86	79	*/
87		-function desktop_mode_dock_rail_renderer_script_registry( $handle = '', $value = null ) {
	80	+function openstation_dock_rail_renderer_script_registry( $handle = '', $value = null ) {
88	81	static $store = array();
89	82
90	83	if ( '__flush__' === (string) $handle ) {
91	84	$store = array();
		@@ -101,14 +94,12 @@
101	94	}
102	95
103	96	/**
104	97	* Test-only: clear the registry between PHPUnit cases. See
105		- * {@see desktop_mode_flush_script_handle_registries()}.
106		- *
107		- * @since 0.6.0
	98	+ * {@see openstation_flush_script_handle_registries()}.
108	99	*/
109		-function desktop_mode_flush_dock_rail_renderer_script_registry() {
110		- desktop_mode_dock_rail_renderer_script_registry( '__flush__' );
	100	+function openstation_flush_dock_rail_renderer_script_registry() {
	101	+ openstation_dock_rail_renderer_script_registry( '__flush__' );
111	102	}
112	103
113	104	/**
114	105	* Build the payload fed to the shell. Resolves each registered handle
		@@ -116,14 +107,12 @@
116	107	* scriptTranslations }` entry; handles that aren't currently enqueued
117	108	* (plugin not active this request) resolve to an empty URL and are
118	109	* dropped.
119	110	*
120		- * @since 0.6.0
121		- *
122	111	* @return array[]
123	112	*/
124		-function desktop_mode_build_dock_rail_renderer_scripts_payload() {
125		- $registry = desktop_mode_dock_rail_renderer_script_registry();
	113	+function openstation_build_dock_rail_renderer_scripts_payload() {
	114	+ $registry = openstation_dock_rail_renderer_script_registry();
126	115	if ( ! is_array( $registry ) || empty( $registry ) ) {
127	116	return array();
128	117	}
129	118
		@@ -132,18 +121,18 @@
132	121	foreach ( $registry as $handle => $active ) {
133	122	if ( ! $active || isset( $seen[ $handle ] ) ) {
134	123	continue;
135	124	}
136		- $payload = desktop_mode_resolve_script_payload( $handle );
	125	+ $payload = openstation_resolve_script_payload( $handle );
137	126	if ( '' === $payload['url'] ) {
138		- desktop_mode_warn_unresolvable_script_handle(
139		- 'desktop_mode_register_dock_rail_renderer_script',
	127	+ openstation_warn_unresolvable_script_handle(
	128	+ 'openstation_register_dock_rail_renderer_script',
140	129	'Dock rail renderer',
141	130	(string) $handle
142	131	);
143	132	continue;
144	133	}
145		- $out[] = array(
	134	+ $out[] = array(
146	135	'handle' => (string) $handle,
147	136	'scriptUrl' => $payload['url'],
148	137	'scriptBefore' => $payload['before'],
149	138	'scriptAfter' => $payload['after'],
		@@ -148,8 +137,11 @@
148	137	'scriptBefore' => $payload['before'],
149	138	'scriptAfter' => $payload['after'],
150	139	'scriptL10n' => $payload['l10n'],
151	140	'scriptTranslations' => $payload['translations'],
	141	+ // The handle's dependency closure, replayed before the bundle
	142	+ // on its lazy load — see `openstation_resolve_script_dependencies()`.
	143	+ 'scriptDeps' => openstation_resolve_script_dependencies( $handle ),
152	144	);
153	145	$seen[ $handle ] = true;
154	146	}
155	147	return $out;