hook = AddsynapseMenu::add_page(
'Store Assistant',
'Store Assistant',
Config::capability(),
self::SLUG,
array( $this, 'render' )
);
if ( $this->hook ) {
add_filter( 'admin_body_class', array( $this, 'body_class' ) );
}
}
/**
* Adds a body class on our screen only.
*
* @param string $classes Classes.
*/
public function body_class( string $classes ): string {
$screen = get_current_screen();
if ( $screen && $screen->id === $this->hook && 'chat' === self::current_tab() ) {
$classes .= ' aiops-screen';
}
return $classes;
}
/**
* The small stylesheet of the server-rendered screens (Settings, approval page, Overview). `?ver=` = version +
* file time, so a cached copy never outlives a change (guide §2.5).
*/
public static function enqueue_admin_css(): void {
$file = ADDSYNAPSE_ASSISTANT_PLUGIN_DIR . 'assets/admin.css';
wp_enqueue_style( self::STYLE_HANDLE, ADDSYNAPSE_ASSISTANT_PLUGIN_URL . 'assets/admin.css', array(), ADDSYNAPSE_ASSISTANT_VERSION . '.' . ( is_readable( $file ) ? (int) filemtime( $file ) : 0 ) );
}
/**
* Enqueues the app on our screen.
*
* @param string $hook_suffix Current screen hook.
*/
public function enqueue( string $hook_suffix ): void {
if ( $hook_suffix !== $this->hook ) {
return;
}
if ( self::is_settings_tab() ) {
// Server-rendered Settings: the small stylesheet + the «are you sure?» script, no React bundle.
self::enqueue_admin_css();
$script = ADDSYNAPSE_ASSISTANT_PLUGIN_DIR . 'assets/settings.js';
wp_enqueue_script( 'addsynapse-assistant-settings', ADDSYNAPSE_ASSISTANT_PLUGIN_URL . 'assets/settings.js', array(), ADDSYNAPSE_ASSISTANT_VERSION . '.' . ( is_readable( $script ) ? (int) filemtime( $script ) : 0 ), true );
return;
}
// The opt-in card / announcements above the chat are server-rendered.
self::enqueue_admin_css();
// Chat and "Change history" share the bundle.
$asset_file = ADDSYNAPSE_ASSISTANT_PLUGIN_DIR . 'build/index.asset.php';
if ( ! is_readable( $asset_file ) ) {
return;
}
$asset = require $asset_file;
wp_enqueue_script(
self::HANDLE,
ADDSYNAPSE_ASSISTANT_PLUGIN_URL . 'build/index.js',
$asset['dependencies'],
$asset['version'],
true
);
wp_enqueue_style(
self::HANDLE,
ADDSYNAPSE_ASSISTANT_PLUGIN_URL . 'build/index.css',
array( 'wp-components' ),
$asset['version']
);
wp_set_script_translations( self::HANDLE, 'addsynapse-store-assistant' );
$user = wp_get_current_user();
wp_add_inline_script(
self::HANDLE,
'window.addsynapseAssistant = ' . wp_json_encode(
array(
'restRoot' => esc_url_raw( rest_url( RestRoutes::NAMESPACE . '/' ) ),
'adminUrl' => esc_url_raw( admin_url() ),
'homeUrl' => esc_url_raw( home_url( '/' ) ),
'nonce' => wp_create_nonce( 'wp_rest' ),
'locale' => str_replace( '_', '-', get_user_locale() ),
'userId' => (int) $user->ID,
'userName' => $user->display_name,
'debug' => defined( 'WP_DEBUG' ) && WP_DEBUG,
'version' => ADDSYNAPSE_ASSISTANT_VERSION,
'streaming' => Config::streaming_enabled(),
'settingsUrl' => esc_url_raw( SettingsPage::url() ),
'chatUrl' => esc_url_raw( self::url() ),
'timezone' => wp_timezone_string(),
// `shop` (WooCommerce) | `site` (plain WordPress): suggestions, /help, card links.
'siteType' => Environment::site_type(),
'canSettings' => current_user_can( Config::settings_capability() ),
'voice' => SettingsPage::voice_enabled(),
// Links to the separate Store Assistant Pro add-on (none once another plugin provides it).
'pro' => ProOffers::client_state(),
// Images from the chat: only when WordPress lets this user upload media.
'images' => array(
'enabled' => current_user_can( 'upload_files' ),
'maxBytes' => Config::image_max_bytes(),
),
)
) . ';',
'before'
);
}
/**
* Whether the Settings tab is requested.
*/
public static function is_settings_tab(): bool {
return 'settings' === self::current_tab();
}
/**
* Current tab: chat | settings.
*/
public static function current_tab(): string {
// Navigation only (which tab to show), matched against a fixed list — never an action.
$tab = sanitize_key( (string) filter_input( INPUT_GET, 'tab', FILTER_UNSAFE_RAW ) );
return 'settings' === $tab ? $tab : 'chat';
}
/**
* URL of a tab.
*
* @param string $tab chat | settings.
*/
public static function url( string $tab = 'chat' ): string {
$args = array( 'page' => self::SLUG );
if ( 'chat' !== $tab ) {
$args['tab'] = $tab;
}
return add_query_arg( $args, admin_url( 'admin.php' ) );
}
/**
* Tab navigation (server-rendered pages).
*
* @param string $active Active tab.
*/
private static function render_nav( string $active ): void {
$tabs = array(
'chat' => __( 'Chat', 'addsynapse-store-assistant' ),
'settings' => __( 'Settings', 'addsynapse-store-assistant' ),
);
echo '';
}
/**
* Page markup (the React app mounts into #addsynapse-assistant-root; Settings is server-rendered).
*/
public function render(): void {
if ( ! current_user_can( Config::capability() ) ) {
wp_die( esc_html__( 'You are not allowed to access this page.', 'addsynapse-store-assistant' ) );
}
if ( self::is_settings_tab() ) {
if ( ! current_user_can( Config::settings_capability() ) ) {
wp_die( esc_html__( 'You are not allowed to access this page.', 'addsynapse-store-assistant' ) );
}
echo '' . esc_html( 'Store Assistant' ) . '
';
self::render_nav( 'settings' );
Announcements::render( 'settings' );
ReviewRequest::render( 'settings' );
( new SettingsPage() )->render();
echo '';
return;
}
if ( ! is_readable( ADDSYNAPSE_ASSISTANT_PLUGIN_DIR . 'build/index.js' ) ) {
echo '' . esc_html__( 'Store Assistant assets are missing. Run "npm run build" in the plugin folder.', 'addsynapse-store-assistant' ) . '
' . esc_html( 'Store Assistant' ) . '
';
// Inside a container: the chat screen hides stray admin notices that are direct children of the wrap.
echo '
';
Announcements::render( 'chat' );
ReviewRequest::render( 'chat' );
OptIn::render( 'chat' );
echo '