desktop-mode / includes / my-wordpress / integrations / woocommerce-customer-window.php

woocommerce-customer-window.php in OpenStation: Desktop Windows, Dock & Virtual Desktops for WP Admin 1.0.1, at includes/my-wordpress/integrations/woocommerce-customer-window.php

127 lines 4.0 KB

Raw Download Zip

1	<?php
2	/**
3	* OpenStation — the Customer window.
4	*
5	* A native window that opens on one customer: who they are, what they
6	* are worth, what they bought, and where it ships. Double-clicking a
7	* customer tile lands here.
8	*
9	* It exists because the two things WordPress offers instead are both
10	* the wrong screen. The activity footprint answers "what has this
11	* person published", which for someone who came to buy a hat is an
12	* empty page. `user-edit.php` is a settings form — the place you go to
13	* change someone's role, not to understand them.
14	*
15	* Singleton and retargeting, like the profile window: the id is
16	* "the customer window", and which customer is an open-time param
17	* (`{ customerId }`). Params ride the session, so a reload brings the
18	* window back on the same person rather than on a default.
19	*
20	* Everything here is inert unless WooCommerce is active and the
21	* viewer may see customer money.
22	*
23	* @package OpenStation
24	*/
25
26	defined( 'ABSPATH' ) \|\| exit;
27
28	/**
29	* The window's template body.
30	*
31	* Deliberately a bare mount point rather than a markup skeleton: the
32	* whole surface is data-driven, so a static shell would only be a
33	* second place for the layout to live and drift.
34	*
35	* @return void
36	*/
37	function openstation_my_wordpress_woo_customer_window_template() {
38	ob_start();
39	?>
40	<div class="os-woo-customer-window" data-os-woo-customer-root>
41	<div class="os-woo-customer-window__loading" data-os-woo-customer-loading>
42	<os-spinner></os-spinner>
43	</div>
44	</div>
45	<?php
46	$html = (string) ob_get_clean();
47
48	/**
49	* Filter the Customer window's template HTML.
50	*
51	* Keep `data-os-woo-customer-root` intact — the render callback
52	* mounts into it.
53	*
54	* Status: Experimental
55	*
56	* @param string $html Default template HTML.
57	*/
58	$filtered = (string) apply_filters( 'openstation_my_wordpress_woo_customer_window_template_html', $html );
59
60	if ( function_exists( 'openstation_kses_native_window_template' ) ) {
61	echo openstation_kses_native_window_template( $filtered ); // phpcs:ignore WordPress.Security.EscapeOutput.OutputNotEscaped -- helper kses-escapes.
62	} else {
63	echo wp_kses( $filtered, wp_kses_allowed_html( 'post' ) );
64	}
65	}
66
67	/**
68	* Register the Customer window.
69	*
70	* `placement => 'none'`: it is never opened from a dock tile, because
71	* "the customer window" with no customer means nothing. It is always
72	* opened with a `customerId` param from a tile, a menu, or a session
73	* restore.
74	*
75	* @return void
76	*/
77	function openstation_my_wordpress_woo_customer_window_register() {
78	if ( ! openstation_my_wordpress_woo_active() ) {
79	return;
80	}
81	if ( ! function_exists( 'openstation_register_window' ) ) {
82	return;
83	}
84	if ( true !== openstation_my_wordpress_woo_customers_permission() ) {
85	return;
86	}
87
88	$args = array(
89	'title' => __( 'Customer', 'desktop-mode' ),
90	'icon' => 'dashicons-businessperson',
91	'template' => 'openstation_my_wordpress_woo_customer_window_template',
92	// Rides the integration bundle that already ships the
93	// summary transport and the panel renderers — one more
94	// window, no second bundle.
95	'script' => 'os-my-wordpress-woocommerce',
96	'style' => 'os-my-wordpress-woocommerce',
97	'width' => 880,
98	'height' => 700,
99	'min_width' => 520,
100	'min_height' => 420,
101	'placement' => 'none',
102	'config' => array(
103	'restRoot' => esc_url_raw( rest_url( 'desktop-mode/v1/woocommerce/' ) ),
104	'restNonce' => wp_create_nonce( 'wp_rest' ),
105	),
106	);
107
108	/**
109	* Filter the Customer window's registration args.
110	*
111	* Status: Experimental
112	*
113	* @param array $args `openstation_register_window()` args.
114	*/
115	$args = (array) apply_filters( 'openstation_my_wordpress_woo_customer_window_args', $args );
116
117	$registered = openstation_register_window( 'desktop-mode-woo-customer', $args );
118	if ( is_wp_error( $registered ) ) {
119	// phpcs:ignore WordPress.PHP.DevelopmentFunctions.error_log_error_log
120	error_log(
121	'[openstation] Customer window registration failed: '
122	. $registered->get_error_message()
123	);
124	}
125	}
126	add_action( 'init', 'openstation_my_wordpress_woo_customer_window_register', 25 );
127