| 1 |
=== Desktop Mode === |
| 2 |
Contributors: automattic, allterraindeveloper, epeicher |
| 3 |
Tags: admin, dashboard, desktop, productivity, ai |
| 4 |
Requires at least: 6.0 |
| 5 |
Tested up to: 7.0 |
| 6 |
Requires PHP: 7.4 |
| 7 |
Stable tag: 0.9.3 |
| 8 |
License: GPLv2 or later |
| 9 |
License URI: https://www.gnu.org/licenses/gpl-2.0.html |
| 10 |
|
| 11 |
Turn wp-admin into a desktop OS — windows, dock, virtual desktops, and an AI assistant. Per-user opt-in, zero Core changes. By Automattic. |
| 12 |
|
| 13 |
== Description == |
| 14 |
|
| 15 |
**Your WordPress admin, reimagined as a desktop.** Every admin screen opens as a draggable, resizable window — edit a post, browse the Media Library, and moderate comments side by side instead of one page at a time. |
| 16 |
|
| 17 |
https://www.youtube.com/watch?v=jii_gGbqUx4 |
| 18 |
|
| 19 |
Desktop Mode is opt-in per user: one click in the admin bar switches you in, one click switches you back. Nobody else on the site sees any change, and deactivating the plugin restores the classic admin exactly. Zero Core patches — every feature runs through public WordPress hooks. |
| 20 |
|
| 21 |
Built and maintained by [Automattic](https://automattic.com), the company behind WordPress.com, Jetpack, WooCommerce, and Tumblr. |
| 22 |
|
| 23 |
= A real desktop = |
| 24 |
|
| 25 |
* **Windows** — drag, resize, minimize, maximize, snap, tile. Every admin page works, including plugin pages. |
| 26 |
* **Dock & taskbar** — the admin menu becomes an icon dock; open windows live in a macOS-style taskbar. |
| 27 |
* **Virtual desktops (Spaces)** — one desktop for writing, another for the store, another for moderation. |
| 28 |
* **Files on the desktop** — drop posts, media, and links onto the wallpaper, organize them into folders, trash them to a Recycle Bin. |
| 29 |
* **Session restore** — reload the browser and every window comes back exactly where you left it. |
| 30 |
|
| 31 |
= Make it yours = |
| 32 |
|
| 33 |
* **Wallpapers** — color presets, animated scenes, or your own image. |
| 34 |
* **Widgets & desktop icons** — pin live widgets and shortcuts to the wallpaper; plugins can register their own. |
| 35 |
|
| 36 |
= Superpowers = |
| 37 |
|
| 38 |
* **AI Assistant (optional)** — press Cmd+K and ask *"Which post had the comment asking for the recipe?"* It searches your own content. Off by default; see "External services" below. |
| 39 |
* **Content Graph** — an interactive, zoomable map of how your posts, pages, and products link together. |
| 40 |
* **Cross-window drag & drop** — drag an image from the Media Library window straight into the editor in another window. |
| 41 |
* **Command palette** — the full WordPress command palette plus slash commands from plugins, all under Cmd+K. |
| 42 |
|
| 43 |
= Built to be extended = |
| 44 |
|
| 45 |
Every significant behavior is hookable. Register windows, dock items, wallpapers, widgets, desktop icons, commands, settings tabs, and AI tools from your own plugin — stable `desktop_mode_register_*` PHP APIs, a typed JavaScript API, and copy-paste examples in the [developer docs on GitHub](https://github.com/WordPress/desktop-mode/tree/trunk/docs). |
| 46 |
|
| 47 |
= External services = |
| 48 |
|
| 49 |
This plugin's optional **AI Assistant** sends data to **OpenAI** (`https://api.openai.com/v1/responses`) when, and only when, an administrator configures an OpenAI API key in **Settings → AI**. With no key configured, no external requests are made. |
| 50 |
|
| 51 |
When the AI Assistant is enabled and a user invokes it (via Cmd+K or the slash-command palette): |
| 52 |
|
| 53 |
* **What is sent:** the user's prompt, the conversation history for the active session, the chosen model identifier (e.g. `gpt-4o-mini`), and tool-call metadata. The plugin's built-in tools (`search_posts`, `search_pages`, `search_comments`) run WordPress's native keyword search and may include excerpts of the matching posts/pages/comments in tool results, which are then sent back to OpenAI as part of the agentic loop. |
| 54 |
* **When it is sent:** on user-initiated AI requests, and (if enabled) on comment-save hooks for spam analysis. Comment spam analysis runs server-side as part of the comment-insert flow. Posts, pages, and taxonomy terms are not sent automatically. |
| 55 |
* **Why it is sent:** to obtain model completions and tool-call decisions that drive the AI Assistant. |
| 56 |
* **Who provides the service:** OpenAI, L.L.C. — see the [OpenAI Terms of Use](https://openai.com/policies/row-terms-of-use/) and the [OpenAI Privacy Policy](https://openai.com/policies/row-privacy-policy/). |
| 57 |
|
| 58 |
The AI Assistant's provider layer is also extensible: third-party plugins may register additional providers via `desktop_mode_register_ai_provider()`. Those providers may send data to other endpoints; review each plugin's own privacy disclosure separately. |
| 59 |
|
| 60 |
No other external services are contacted by this plugin. |
| 61 |
|
| 62 |
== Installation == |
| 63 |
|
| 64 |
1. Upload the plugin folder to `/wp-content/plugins/`, or install via **Plugins → Add New → Upload Plugin**. |
| 65 |
2. Activate the plugin through the **Plugins** screen in WordPress. |
| 66 |
3. Click the **desktop** icon in the admin bar's top-right corner. The admin reloads inside the desktop shell. |
| 67 |
4. Click the same icon again at any time to return to the classic admin. |
| 68 |
|
| 69 |
= Optional: enable the AI Assistant = |
| 70 |
|
| 71 |
1. Open **Settings → AI** inside desktop mode. |
| 72 |
2. Paste an OpenAI API key and pick a model. |
| 73 |
3. Press **Cmd+K** (or **Ctrl+K**) anywhere in desktop mode to open the AI palette. |
| 74 |
|
| 75 |
== Frequently Asked Questions == |
| 76 |
|
| 77 |
= Does this change anything for users who don't opt in? = |
| 78 |
|
| 79 |
No. The classic admin is untouched until a user toggles desktop mode on for themselves. Deactivating the plugin restores vanilla Core exactly. |
| 80 |
|
| 81 |
= Does the plugin require an external service to function? = |
| 82 |
|
| 83 |
No. The desktop shell, windowing, dock, taskbar, virtual desktops, widgets, wallpapers, and all extension APIs work entirely on-site. The AI Assistant is the only feature that contacts an external service, and it is disabled until an administrator configures an API key. See "External services" in the description. |
| 84 |
|
| 85 |
= Does it patch WordPress core? = |
| 86 |
|
| 87 |
No. Every feature is wired through public WordPress actions and filters. |
| 88 |
|
| 89 |
= How do I disable desktop mode for my user? = |
| 90 |
|
| 91 |
Click the desktop icon in the admin bar a second time to flip the toggle off. The plugin can also be deactivated globally from the Plugins screen. |
| 92 |
|
| 93 |
= Where is the developer documentation? = |
| 94 |
|
| 95 |
In `docs/` inside the plugin, and on [GitHub](https://github.com/WordPress/desktop-mode/tree/trunk/docs). The hook reference, JavaScript reference, bridge protocol, and copy-paste examples all live there. |
| 96 |
|
| 97 |
== Screenshots == |
| 98 |
|
| 99 |
1. Real multitasking — Users, Media, and content editing open side by side as windows. |
| 100 |
2. Your admin, your desktop — custom wallpapers and live widgets registered by plugins. |
| 101 |
3. The AI Assistant (Cmd+K) answers questions about your own posts, pages, and comments. |
| 102 |
4. Content Graph — an interactive map of how your content links together. |
| 103 |
5. OS Settings — pick a wallpaper preset, an animated scene, or upload your own image. |
| 104 |
6. Files on the desktop — drag posts, media, and links onto the wallpaper and into folders. |
| 105 |
7. The Recycle Bin collects trashed posts, media, folders, and shortcuts in one window. |
| 106 |
|
| 107 |
== Credits == |
| 108 |
|
| 109 |
Desktop Mode is brought to you by [Automattic](https://automattic.com). The plugin is open source under GPLv2-or-later; contributions are welcome on [GitHub](https://github.com/WordPress/desktop-mode). |
| 110 |
|
| 111 |
= Third-party libraries = |
| 112 |
|
| 113 |
The plugin bundles the following third-party JavaScript library, loaded on demand only when a feature that needs it is in use: |
| 114 |
|
| 115 |
* **[PixiJS](https://pixijs.com/)** (MIT License) — used by the interactive **OS Settings → About** scene, the **Content Graph** window, and built-in canvas wallpapers (e.g. the animated WordPress logo). PixiJS is loaded from the plugin's own `assets/vendor/` directory; no CDN requests are made. |
| 116 |
|
| 117 |
== Changelog == |
| 118 |
|
| 119 |
= 0.9.3 = |
| 120 |
* Rewrite WordPress.org plugin page, leaner copy, video embed, screenshots |
| 121 |
* Review: doc/comment accuracy, security hardening, and cleanups across the plugin |
| 122 |
|
| 123 |
= 0.9.2 = |
| 124 |
* Persist welcome-dialog dismissal when Desktop Mode is disabled |
| 125 |
* Welcome dialog reappears on every page when the admin is served from an origin that differs from `site_url` |
| 126 |
|
| 127 |
= 0.9.1 = |
| 128 |
* Make native list windows opt-in (Beta) instead of opt-out |
| 129 |
* Scope AI to comment spam + native-search assistant |
| 130 |
* Feat/unfocus window effects |
| 131 |
* Fix placement, gear/Help, and dock⇄desktop visibility bugs |
| 132 |
* Fix Guidelines-experiment 404 noise, duplicate welcome dialog, and unused-preload warnings |
| 133 |
* Add "View activity footprint" row action in Users list |
| 134 |
|
| 135 |
= 0.9.0 = |
| 136 |
* Gate per-user REST routes on desktop mode enabled |
| 137 |
* Refine recycle bin badge styling and sync on stop |
| 138 |
* Clear comments selection after applying action |
| 139 |
* Don't let a failing sync block the agent |
| 140 |
* Make the AI-disabled error link to AI Settings |
| 141 |
|
| 142 |
= 0.8.9 = |
| 143 |
* Improve drag-and-drop handling in chromeless bridge and iframe bridge |
| 144 |
* The whole shell loads faster, especially the first time you open wp-admin |
| 145 |
* Open an app from the wallpaper or from the dock — it's the same window now (no more two copies floating around) |
| 146 |
* Minimize a window and the dock icon shows it's minimized — even if you opened it from the desktop icon |
| 147 |
* Click "+ New" twice and you get two editors. Drafting a post and want to start another? Just click again |
| 148 |
* "Switch to Desktop Mode" always takes you to the dashboard, so you know where you're starting from |
| 149 |
* Resizing a window and accidentally letting go over the desktop no longer minimizes everything |
| 150 |
* WooCommerce: the "Add Order" button is back on the Orders page |
| 151 |
* "Add New" buttons (Add Post, Add Order, Add anything) stay visible inside every plugin page |
| 152 |
* After we ship a fix, you get it on your next page load — no more "try refreshing twice" |
| 153 |
|
| 154 |
= 0.8.8 = |
| 155 |
* Align dock badge with in-window update count |
| 156 |
* Make every dock scrollable, keep system tiles pinned |
| 157 |
* No more flash when you create, move, or delete a file or shortcut on the desktop |
| 158 |
* Trashing a folder that contained other folders now works (used to silently fail) |
| 159 |
* Drag an image from the Media Library straight into a Gutenberg post, it now inserts |
| 160 |
* Edit User screen: the form is centered instead of pinned to the left |
| 161 |
* Title-bar icons (Help, etc.) are now visually centered |
| 162 |
* Sticky notes powered by WP Guidelines |
| 163 |
|
| 164 |
= 0.8.7 = |
| 165 |
* Bump Tested up to WordPress 7.0 |
| 166 |
* Fix plugins window stale-nonce 'Cookie check failed' on long-running sessions |
| 167 |
* Fix plugin .zip drop routing to Media Library uploader |
| 168 |
* Add server-side search to entity list views |
| 169 |
* Rename Browse tab to Add Plugin |
| 170 |
* Drag and drop improvements |
| 171 |
|
| 172 |
= 0.8.6 = |
| 173 |
* Light indicators for native-window-target dock icons |
| 174 |
* Additional fixes and polish |
| 175 |
* Add compatibility layer for Divi script dependencies and tests |
| 176 |
* Show plugin icons |
| 177 |
* Open off-site menu items in a new browser tab |
| 178 |
|
| 179 |
= 0.8.6-rc1 = |
| 180 |
* Tag cloud & category mindmap: search, clustering, server cache |
| 181 |
* Drag & Drop from local desktop |
| 182 |
* Implement loading skeletons and staggered animations for file tiles |
| 183 |
* Arrow-key shortcuts + Overview-from-Show-Desktop fix |
| 184 |
* Shortcuts popover, dock-style tooltips, reorder |
| 185 |
* Add Featured Plugins View and Ribbon Component |
| 186 |
* Add "Automatic Updates" column and related functionality to Plugins window |
| 187 |
* Add window notices feature with persistent dismissal and server sync |
| 188 |
* Polish four framework surfaces for plugin authors |
| 189 |
* Disable focus on other window actions |
| 190 |
* Add Media section to "My WordPress" + uniform preview-pane hook surface |
| 191 |
* Refactor My WordPress to use `<wpd-tile>` + add post status ribbons |
| 192 |
* Allow deactivating plugins in CMO desktop & dock |
| 193 |
* OS-file drop — progress UI, live refresh, cancel cleanup, CMO |
| 194 |
* Group-by selector + click-to-deselect + focused-icon centering |
| 195 |
* Test against PHP 8.3 and 8.4 |
| 196 |
* Enhance minimize/restore behavior to preserve pre-minimize state and add cross-state transition tests |
| 197 |
|
| 198 |
= 0.8.5 = |
| 199 |
* Shared folders, heartbeat widget, and heartbeat-pipeline hardening |
| 200 |
* Recycle Bin: show item type badges inline next to title |
| 201 |
* Plugins window: expandable rows with rich plugin details |
| 202 |
* Remember native window size across opens |
| 203 |
* Fix blank plugin icons in the Plugins window |
| 204 |
* Restore "Show desktop on wallpaper click" as an opt-in setting |
| 205 |
* Fix plugin update refresh, dock badge, and stuck-row failures |
| 206 |
* Trash bin polish: URL badge, live placement badge, no media auto-trash |
| 207 |
* Throw on empty REST body to avoid TypeError after self-replace |
| 208 |
* Hide Media filter tab when MEDIA_TRASH is off |
| 209 |
* Sequence openCurrentPage after restoreSession to avoid duplicate windows |
| 210 |
* Fix window refresh issue on new sessions |
| 211 |
|
| 212 |
= 0.8.4 = |
| 213 |
* Faster Desktop Mode, main bundle cut by 59 % |
| 214 |
* "Edit Post" from the front-end admin bar opens nothing |
| 215 |
* Cross-page admin-link clicks: state, destructive actions, referer hint |
| 216 |
* Warn loudly when a `<wpd-*>` tag is used without being imported |
| 217 |
* Support re-uploading existing plugins, add post-install Activate panel |
| 218 |
* Restore the full WordPress command palette inside Cmd+K |
| 219 |
|
| 220 |
= 0.8.3 = |
| 221 |
* Feat comments as native windows |
| 222 |
* Chrome <111 titlebars + duplicate-placement REST 500s |
| 223 |
* SW navigation interception caused window-in-window after core update |
| 224 |
* Open each post as its own window from the Posts window |
| 225 |
* Fix Users window data + live-refresh, plus per-window REST clients |
| 226 |
* Session-expiry cascade + Plugins window sync |
| 227 |
* Narrow scope to /wp-admin/ and throttle SW reloads |
| 228 |
* Plugins window: real updates, not just a phantom badge |
| 229 |
* Support plain permalinks for REST URL construction |
| 230 |
* Hide registered icons from desktop instead of trashing |
| 231 |
|
| 232 |
= 0.8.2 = |
| 233 |
* Many fixes and new features |
| 234 |
* Add unit test to ensure bridge script skips core AJAX update buttons |
| 235 |
* Native Plugins window + `<wpd-card>` |
| 236 |
* Appearance window polish + dock-peek fixes |
| 237 |
* Fix upload theme |
| 238 |
* Implement favicon resolver and associated tests for desktop mode |
| 239 |
* Auto-inject X-WP-Nonce for REST API requests |
| 240 |
* Enhance user management functionality in WordPress REST API |
| 241 |
* Fix user role updates |
| 242 |
* Fix plugin native issues |
| 243 |
* Enhance color scheme preview functionality by adding shell scheme flipping |
| 244 |
* Fix rearrange icons out of desktop |
| 245 |
* Open each post in its own window |
| 246 |
* Add item visibility and dock order settings |
| 247 |
* Add first-run welcome dialog for Desktop Mode |
| 248 |
* Fix dock management |
| 249 |
* Refetch desktop placements on Recycle Bin restore |
| 250 |
|
| 251 |
= 0.8.1 = |
| 252 |
* Framework rework and stability improvements — significant internals refactor, smoother window lifecycle, and more reliable bridging between iframe and native windows. |
| 253 |
* Drag and drop reworked end-to-end: calmer pointer behavior, more accurate hit-testing, and reliable handoff across windows. |
| 254 |
* Posts, Pages, and Users now open as native desktop windows — direct DOM rendering inside the shell instead of an iframe, faster open, instant interaction, and UI tailored to the windowing model. |
| 255 |
* New Content Graph tool — an interactive map of how your content links together. Pan, zoom, and focus a node to explore its neighborhood. |
| 256 |
* Cross-page admin link routing in the chromeless bridge so links across the admin stay inside the desktop shell. |
| 257 |
* Many bug fixes across the admin bar, Fullscreen toggle, resize handles over iframes, real-time icon refresh on plugin activation, and the PWA shell. |
| 258 |
|
| 259 |
= 0.5.1 = |
| 260 |
* Code editor and framework improvements. |
| 261 |
* Enhanced AI provider integration: third-party providers may register through `desktop_mode_register_ai_provider()`. |
| 262 |
* Title-bar button registry with icon painting for plugin authors. |
| 263 |
* OS Settings tabs are now extensible via `desktop_mode_register_settings_tab_script()` / `desktop_mode_register_settings_tab()`. |
| 264 |
* AI Copilot extensibility: server-side tool registry (`desktop_mode_register_ai_tool()`) and client-side `wp.desktop.ai.ask()` programmatic entry point. |
| 265 |
* UI component kit expansion (~25 `<wpd-*>` web components). |
| 266 |
* Backtick hotkey to cycle window focus. |
| 267 |
* Unified command palettes via the palette registry. |
| 268 |
* OS Settings Help tab. |
| 269 |
|
| 270 |
= 0.5.0 = |
| 271 |
* Command registration APIs (`desktop_mode_register_command_script()` / `desktop_mode_register_command()`) with live install/activate refresh. |
| 272 |
* Media-library enhancement enabled by default, with opt-out. |
| 273 |
* Dock CSS selectors updated; overflow handling improved. |
| 274 |
|
| 275 |
See the [GitHub releases page](https://github.com/WordPress/desktop-mode/releases) for the full history. |
| 276 |
|
| 277 |
== Upgrade Notice == |
| 278 |
|
| 279 |
= 0.8.1 = |
| 280 |
Framework and stability rework, reworked drag and drop, native Posts/Pages/Users windows, and a new Content Graph tool. Backwards-compatible. |
| 281 |
|
| 282 |
= 0.5.1 = |
| 283 |
Adds AI Copilot extensibility (server-side tools, multi-provider support) and a title-bar button registry. Backwards-compatible. |
| 284 |
|
