# desktop-mode/1.1.4/includes/desktop-themes/assets.php

OpenStation: Desktop Windows, Dock & Virtual Desktops for WP Admin, version 1.1.4. 159 lines.

- Page: https://pluginprobe.com/plugins/desktop-mode/1.1.4/code/includes/desktop-themes/assets.php
- Raw: https://pluginprobe.com/plugins/desktop-mode/1.1.4/raw/includes/desktop-themes/assets.php
- Modified: 2026-08-07T20:39:04+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/1.1.4/code/includes/desktop-themes/assets.php#L10-L20`.

```php
<?php
/**
 * OpenStation — Desktop-theme enqueue + body class + shell config.
 *
 * **Zero cost when no theme is active.** Every entry point here
 * early-returns on an empty selection before it reads an option,
 * touches the filesystem, or registers a handle. A site whose users
 * all sit on "System default" pays one user-meta read that the OS
 * settings layer was doing anyway.
 *
 * @package OpenStation
 */

defined( 'ABSPATH' ) || exit;

/** Style handle for the compiled desktop-theme stylesheet. */
const OPENSTATION_DESKTOP_THEME_STYLE_HANDLE = 'os-desktop-theme';

/**
 * Resolve the desktop theme a user has selected, if it still exists.
 *
 * Orphans degrade silently: a user whose selected theme was deleted
 * (or whose registering plugin was deactivated) gets `''` here and
 * sees the system default, with no user-meta rewrite and no error.
 *
 * @param int $user_id User id. Defaults to the current user.
 * @return string Slug, or `''` for the system default.
 */
function openstation_active_desktop_theme_slug( $user_id = 0 ) {
	$user_id = (int) $user_id;
	if ( $user_id <= 0 ) {
		$user_id = get_current_user_id();
	}
	if ( $user_id <= 0 ) {
		return '';
	}

	$settings = openstation_get_os_settings( $user_id );
	$slug     = isset( $settings['desktopTheme'] ) ? sanitize_key( (string) $settings['desktopTheme'] ) : '';
	if ( '' === $slug ) {
		return '';
	}

	// Existence check across both sources. This is the safety net
	// that lets the os-settings sanitizer stay a cheap pattern check
	// instead of loading the themes option on every settings write.
	if ( null !== openstation_desktop_theme_get( $slug ) ) {
		return $slug;
	}
	if ( null !== openstation_desktop_theme_registry( $slug ) ) {
		return $slug;
	}
	return '';
}

/**
 * Whether this request should carry desktop-theme assets at all.
 *
 * @internal
 *
 * @return bool
 */
function openstation_desktop_theme_request_is_themable() {
	return openstation_is_enabled()
		&& ! openstation_is_chromeless_request()
		&& ! openstation_is_classic_request();
}

/**
 * Enqueue the active theme's compiled stylesheet.
 *
 * The `os-variables` dependency is load-bearing, not
 * decoration: the compiled selectors weigh the same as the
 * per-admin-color-scheme blocks in `variables.css`, and a
 * specificity tie is settled by source order. Drop the dependency
 * and a themed token silently loses to the color scheme.
 */
function openstation_enqueue_desktop_theme_style() {
	if ( ! openstation_desktop_theme_request_is_themable() ) {
		return;
	}
	$slug = openstation_active_desktop_theme_slug();
	if ( '' === $slug ) {
		// The whole point: nothing registered, nothing enqueued, no
		// extra request, no extra bytes.
		return;
	}

	$uploaded = openstation_desktop_theme_get( $slug );
	if ( is_array( $uploaded ) ) {
		$version = isset( $uploaded['installedAt'] ) ? (string) (int) $uploaded['installedAt'] : OPENSTATION_VERSION;
		wp_enqueue_style(
			OPENSTATION_DESKTOP_THEME_STYLE_HANDLE,
			openstation_desktop_themes_url( $slug ) . '/theme.css',
			array( 'os-variables' ),
			$version
		);
		return;
	}

	$code = openstation_desktop_theme_registry( $slug );
	if ( is_array( $code ) && ! empty( $code['cssText'] ) ) {
		// Code themes have no file to link. Register a src-less stub
		// so `wp_add_inline_style()` has a handle to hang off, and
		// keep the same dependency so print order is identical.
		wp_register_style(
			OPENSTATION_DESKTOP_THEME_STYLE_HANDLE,
			false,
			array( 'os-variables' ),
			OPENSTATION_VERSION
		);
		wp_enqueue_style( OPENSTATION_DESKTOP_THEME_STYLE_HANDLE );
		wp_add_inline_style( OPENSTATION_DESKTOP_THEME_STYLE_HANDLE, (string) $code['cssText'] );
	}
}
add_action( 'admin_enqueue_scripts', 'openstation_enqueue_desktop_theme_style', 20 );

/**
 * Add `os-desktop-theme-<slug>` to the admin body classes.
 *
 * The compiled stylesheet scopes to this class as well as to the
 * shell root, because toasts / dialogs / tooltips / context menus
 * mount on `document.body`, outside `#os-shell`.
 *
 * `admin_body_class` is a STRING filter — concatenate, never
 * array-push.
 *
 * @param string $classes Space-separated class list.
 * @return string
 */
function openstation_desktop_theme_body_class( $classes ) {
	if ( ! openstation_desktop_theme_request_is_themable() ) {
		return $classes;
	}
	$slug = openstation_active_desktop_theme_slug();
	if ( '' === $slug ) {
		return $classes;
	}
	return trim( $classes . ' os-desktop-theme-' . $slug );
}
add_filter( 'admin_body_class', 'openstation_desktop_theme_body_class', 20 );

/**
 * Inject the desktop-theme bits of the shell config.
 *
 * Uses the public `openstation_shell_config` filter rather than
 * editing the config literal in `includes/render/assets.php`, the
 * same way the stored-files module contributes `desktopStorage`.
 *
 * @param array $config Shell config.
 * @return array
 */
function openstation_desktop_theme_inject_shell_config( $config ) {
	$config['canManageDesktopThemes'] = current_user_can( openstation_desktop_theme_upload_capability() );
	$config['desktopThemesUrl']       = esc_url_raw( rest_url( 'desktop-mode/v1/desktop-themes' ) );
	return $config;
}
add_filter( 'openstation_shell_config', 'openstation_desktop_theme_inject_shell_config', 20 );

```