# desktop-mode/0.9.1/includes/welcome-dialog.php OpenStation: Desktop Windows, Dock & Virtual Desktops for WP Admin, version 0.9.1. 752 lines. - Page: https://pluginprobe.com/plugins/desktop-mode/0.9.1/code/includes/welcome-dialog.php - Raw: https://pluginprobe.com/plugins/desktop-mode/0.9.1/raw/includes/welcome-dialog.php - Modified: 2026-06-07T20:55:46+00:00 Line numbers below start at 1. Link to a line or a range by appending a fragment to the page URL, for example `https://pluginprobe.com/plugins/desktop-mode/0.9.1/code/includes/welcome-dialog.php#L10-L20`. ```php ` shell components here because they only ship inside the * desktop bundle, which is precisely *not* loaded on the classic admin * screens where this dialog is allowed to appear. * * @package Desktop_Mode * @since 0.18.5 */ defined( 'ABSPATH' ) || exit; /** Slug stored in `desktop_mode_seen_intros` for this dialog. */ const DESKTOP_MODE_WELCOME_INTRO_SLUG = 'activation-welcome'; /** * Decides whether the welcome dialog should render on the current request. * * Six gates: * * 1. We're inside `/wp-admin` (`is_admin()`). * 2. The user is logged in and can `read` (sanity gate — the dialog has * no destructive surface, but anonymous output makes no sense). * 3. The request is NOT chromeless — chromeless pages are iframes * rendering inside the desktop shell; the parent shell already shows * its own UX. * 4. Desktop Mode is NOT already enabled for the user. This is a * "switch to Desktop Mode" promo, so it has nothing to say once the * user is in the shell. The desktop shell's *parent* page is admin * context and is not chromeless, so without this gate the dialog * re-renders there the moment the user clicks "Enable it now" — read * as a duplicate dialog, because the fire-and-forget seen-intro POST * races the redirect into the shell and often loses. * 5. The user has not already dismissed this intro. * 6. The `desktop_mode_show_welcome_dialog` filter returns truthy, so * sites can suppress the dialog entirely (e.g. managed-host onboarding * flows that ship their own). * * @since 0.18.5 * * @return bool */ function desktop_mode_should_show_welcome_dialog() { if ( ! is_admin() || ! is_user_logged_in() ) { return false; } if ( ! current_user_can( 'read' ) ) { return false; } if ( function_exists( 'desktop_mode_is_chromeless_request' ) && desktop_mode_is_chromeless_request() ) { return false; } if ( function_exists( 'desktop_mode_is_enabled' ) && desktop_mode_is_enabled() ) { return false; } $user_id = get_current_user_id(); if ( desktop_mode_has_seen_intro( $user_id, DESKTOP_MODE_WELCOME_INTRO_SLUG ) ) { return false; } /** * Filters whether the first-run welcome dialog should render for * the current user on the current request. All earlier gates * (admin context, capability, chromeless, seen-state) have * already passed by the time this filter fires. * * @since 0.18.5 * * @param bool $show Whether to render the dialog. Default true. * @param int $user_id Current user ID. */ return (bool) apply_filters( 'desktop_mode_show_welcome_dialog', true, $user_id ); } /** * Prints the welcome dialog markup, styles and dismiss script into * `admin_footer`. * * Self-contained on purpose: everything is scoped under the * `.desktop-mode-welcome` namespace so it cannot collide with the host * admin theme. The dismiss button POSTs to the seen-intros REST route, * which is exactly the same endpoint the in-shell intros use. * * @since 0.18.5 */ function desktop_mode_render_welcome_dialog() { if ( ! desktop_mode_should_show_welcome_dialog() ) { return; } $rest_url = esc_url_raw( rest_url( 'desktop-mode/v1/intros/seen' ) ); $rest_nonce = wp_create_nonce( 'wp_rest' ); $ajax_url = esc_url_raw( admin_url( 'admin-ajax.php' ) ); $ajax_nonce = wp_create_nonce( 'save-desktop-mode' ); $slug = DESKTOP_MODE_WELCOME_INTRO_SLUG; // All user-facing strings are passed through translation; the dialog // is keyboard-dismissible (Escape) and focus-trapped between the // close button and the "Got it" CTA. $title = __( 'Welcome to Desktop Mode', 'desktop-mode' ); $subtitle = __( 'A floating, window-based workspace for the WordPress admin — more like a real OS, less like a webpage.', 'desktop-mode' ); $body = __( 'Desktop Mode reimagines the WordPress admin as a true desktop environment. Open multiple admin screens side-by-side, drag and drop content between windows, and keep your work in view as you move between tasks.', 'desktop-mode' ); $cta = __( 'Got it', 'desktop-mode' ); $enable = __( 'Enable it now', 'desktop-mode' ); $enabling = __( 'Enabling…', 'desktop-mode' ); $close_a = __( 'Close', 'desktop-mode' ); $features = array( array( 'icon' => '🪟', 'title' => __( 'Multi-window workspace', 'desktop-mode' ), 'desc' => __( 'Open Posts, Media and Plugins in their own draggable, resizable windows. Tile, cascade or stack them however you work best.', 'desktop-mode' ), ), array( 'icon' => '⚡', 'title' => __( 'Native, table-driven apps', 'desktop-mode' ), 'desc' => __( 'Posts, Pages, Users and Plugins are reimplemented as fast native windows with sticky headers, bulk actions, multi-select and inline previews.', 'desktop-mode' ), ), array( 'icon' => '🎨', 'title' => __( 'Wallpapers, dock & themes', 'desktop-mode' ), 'desc' => __( 'Make it yours. Choose a wallpaper, pin your favorite screens to the dock, and switch accent colors — all from OS Settings.', 'desktop-mode' ), ), array( 'icon' => '🤖', 'title' => __( 'AI Copilot, built in', 'desktop-mode' ), 'desc' => __( 'Press ⌘K anywhere to ask the AI Assistant — it can run commands, navigate windows and answer questions about your site.', 'desktop-mode' ), ), ); ?>