| 1 |
=== Desktop Mode === |
| 2 |
Contributors: automattic, allterraindeveloper, epeicher, mmtr86, nickhamze |
| 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.6 |
| 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. Requires an AI provider configured in **Settings → Connectors** (WordPress 7.0+); 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 the **AI provider you configure in WordPress's Settings → Connectors** (for example OpenAI, Anthropic, or Google). Generation is routed through WordPress 7.0's built-in AI Client, which supplies the credentials stored in Connectors — the plugin never handles an API key itself. With no provider configured in Connectors, no external AI 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, 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 the provider as part of the agentic loop. |
| 54 |
* **When it is sent:** on user-initiated AI requests, and (if an administrator enables "Score new comments with AI") on comment-save hooks for spam analysis. 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:** whichever provider you configured in Settings → Connectors. Which provider (and endpoint) receives the data depends entirely on that configuration — review the chosen provider's own terms and privacy policy (e.g. OpenAI, Anthropic, or Google). |
| 57 |
|
| 58 |
No other external services are contacted by this plugin. |
| 59 |
|
| 60 |
== Installation == |
| 61 |
|
| 62 |
1. Upload the plugin folder to `/wp-content/plugins/`, or install via **Plugins → Add New → Upload Plugin**. |
| 63 |
2. Activate the plugin through the **Plugins** screen in WordPress. |
| 64 |
3. Click the **desktop** icon in the admin bar's top-right corner. The admin reloads inside the desktop shell. |
| 65 |
4. Click the same icon again at any time to return to the classic admin. |
| 66 |
|
| 67 |
= Optional: enable the AI Assistant = |
| 68 |
|
| 69 |
1. In **Settings → Connectors**, set up an AI provider (OpenAI, Anthropic, or Google). Requires WordPress 7.0+. |
| 70 |
2. In desktop mode, open **OS Settings → Features** and turn on **AI assistant** (it's off by default). |
| 71 |
3. Press **Cmd+K** (or **Ctrl+K**) anywhere in desktop mode to open the AI assistant. |
| 72 |
|
| 73 |
== Frequently Asked Questions == |
| 74 |
|
| 75 |
= Does this change anything for users who don't opt in? = |
| 76 |
|
| 77 |
No. The classic admin is untouched until a user toggles desktop mode on for themselves. Deactivating the plugin restores vanilla Core exactly. |
| 78 |
|
| 79 |
= Does the plugin require an external service to function? = |
| 80 |
|
| 81 |
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 stays inert until an administrator configures an AI provider in Settings → Connectors. See "External services" in the description. |
| 82 |
|
| 83 |
= Does it patch WordPress core? = |
| 84 |
|
| 85 |
No. Every feature is wired through public WordPress actions and filters. |
| 86 |
|
| 87 |
= How do I disable desktop mode for my user? = |
| 88 |
|
| 89 |
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. |
| 90 |
|
| 91 |
= Where is the developer documentation? = |
| 92 |
|
| 93 |
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. |
| 94 |
|
| 95 |
== Screenshots == |
| 96 |
|
| 97 |
1. Real multitasking — Users, Media, and content editing open side by side as windows. |
| 98 |
2. Your admin, your desktop — custom wallpapers and live widgets registered by plugins. |
| 99 |
3. The AI Assistant (Cmd+K) answers questions about your own posts, pages, and comments. |
| 100 |
4. Content Graph — an interactive map of how your content links together. |
| 101 |
5. OS Settings — pick a wallpaper preset, an animated scene, or upload your own image. |
| 102 |
6. Files on the desktop — drag posts, media, and links onto the wallpaper and into folders. |
| 103 |
7. The Recycle Bin collects trashed posts, media, folders, and shortcuts in one window. |
| 104 |
|
| 105 |
== Credits == |
| 106 |
|
| 107 |
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). |
| 108 |
|
| 109 |
= Third-party libraries = |
| 110 |
|
| 111 |
The plugin bundles the following third-party JavaScript library, loaded on demand only when a feature that needs it is in use: |
| 112 |
|
| 113 |
* **[PixiJS](https://pixijs.com/)** (MIT License) — used by the interactive **OS Settings → About** scene, the **Content Graph** window, built-in canvas wallpapers (e.g. the animated WordPress logo), and the **Inkfall** typing game. PixiJS is loaded from the plugin's own `assets/vendor/` directory; no CDN requests are made. |
| 114 |
|
| 115 |
= Data files = |
| 116 |
|
| 117 |
The **Inkfall** game's word list (`assets/games/inkfall/words.txt`) is generated from the following sources (attribution also ships in the file's header): |
| 118 |
|
| 119 |
* **[FrequencyWords](https://github.com/hermitdave/FrequencyWords)** by Hermit Dave (CC-BY-SA 4.0) — English word-frequency ranking derived from the OpenSubtitles corpus. |
| 120 |
* **[english-words](https://github.com/dwyl/english-words)** by dwyl (Unlicense) — used as a validity filter. |
| 121 |
* **[LDNOOBW English list](https://github.com/LDNOOBW/List-of-Dirty-Naughty-Obscene-and-Otherwise-Bad-Words)** (CC-BY 4.0) — used as an exclusion filter. |
| 122 |
|
| 123 |
== Changelog == |
| 124 |
|
| 125 |
= 0.9.6 = |
| 126 |
* Improved button accessibility and visual feedback by implementing the missing busy spinner and aria-busy attributes on the Button component |
| 127 |
* AI assistant as the shell's ⌘K palette (Commands + Ask AI) |
| 128 |
* Add pinned notes: paper notes with a pushpin, composed in a Note Pad widget |
| 129 |
* Improve minimized window UX with restore support and count badges |
| 130 |
* Surface core admin notices once in the desktop shell |
| 131 |
* Convert pinned notes into draft posts |
| 132 |
* Normalize AI Copilot tool schemas for the provider |
| 133 |
* Add a game system: Games hub, unified scoreboard, challenges, and Inkfall |
| 134 |
* Keep URL-style menu slugs (ACF) as direct admin links |
| 135 |
* Add Alphabet Soup game; generalize game infra out of Inkfall |
| 136 |
* Fix 404 from wallpaper Sort By when a synthetic tile is on the desktop |
| 137 |
* Fix illegible text fields inside wpd-modal dialogs |
| 138 |
* Fix empty custom-gradient editor after re-selecting the wallpaper |
| 139 |
* Add Related-entities title-bar navigation with open PHP/JS filter surface |
| 140 |
* Admin bar visibility when fullscreen window is minimized |
| 141 |
* Allow selecting window from Overview view |
| 142 |
* Show open window indicators for bottom dock tiles |
| 143 |
* Add busy state and spinner to wpd-button |
| 144 |
* Redesign session-expiry recovery: one login prompt, in-place recovery |
| 145 |
* Fix folder rename not reflected on the desktop until refresh |
| 146 |
* Live-refresh list windows on content changes (posts, CPTs, comments, WooCommerce orders) |
| 147 |
* Add real file/folder storage on the desktop |
| 148 |
* Fix gamepad icon missing from the window title bar (data-URI window icons) |
| 149 |
* Fix content graph taxonomy fallback |
| 150 |
|
| 151 |
= 0.9.5 = |
| 152 |
* AI Copilot now uses WordPress 7.0 providers: configure a provider once in Settings → Connectors and the assistant uses it — no more per-plugin keys |
| 153 |
* AI Copilot tools are now WordPress Abilities, so the assistant works across any configured provider; plugin authors add their own tools with the Abilities API (`desktop_mode_register_ai_tool()` was removed) |
| 154 |
* Removed the OS Settings → AI tab; the per-user "AI assistant" toggle now lives in OS Settings → Features next to "Score new comments with AI" |
| 155 |
* Requires WordPress 7.0 for the AI assistant only; on older WordPress the assistant is hidden and the rest of Desktop Mode is unaffected |
| 156 |
* Stored AI keys are deleted from the database on upgrade |
| 157 |
* Five new built-in widgets: Recent Comments, Post Stats, Site Views, Jazz Quote, and Starter |
| 158 |
* Widgets can now be resized, and docked widget heights persist across sessions |
| 159 |
* Two new wallpapers, Living Tree and Snow, plus per-wallpaper settings dialogs |
| 160 |
* Window links: windows showing related content are visually connected, with pluggable link renderers for plugin authors |
| 161 |
* Spring-loading: hovering a window while dragging anything brings it to the front |
| 162 |
* New developer mode setting (OS Settings → Features) unlocks developer-facing surfaces |
| 163 |
* WordPress update notices now surface once in the desktop shell instead of repeating in every window |
| 164 |
* Desktop shortcuts stay in sync and core icons follow the spatial layout |
| 165 |
* Extended options merged into the OS Settings → Features tab |
| 166 |
* Fixed selection bugs that could point destructive actions at the wrong files |
| 167 |
* Closing a window with unsaved changes now warns instead of silently losing work |
| 168 |
* Fixed windows and dock state leaking across virtual desktops |
| 169 |
* Fixed Overview keyboard navigation and focus trapping |
| 170 |
* The dock now refreshes live when a plugin registers a new post type |
| 171 |
* Fixed dock icon alignment, "Add New" window titles and icons, and count-label pluralization |
| 172 |
|
| 173 |
= 0.9.3 = |
| 174 |
* Rewrite WordPress.org plugin page, leaner copy, video embed, screenshots |
| 175 |
* Review: doc/comment accuracy, security hardening, and cleanups across the plugin |
| 176 |
|
| 177 |
= 0.9.2 = |
| 178 |
* Persist welcome-dialog dismissal when Desktop Mode is disabled |
| 179 |
* Welcome dialog reappears on every page when the admin is served from an origin that differs from `site_url` |
| 180 |
|
| 181 |
= 0.9.1 = |
| 182 |
* Make native list windows opt-in (Beta) instead of opt-out |
| 183 |
* Scope AI to comment spam + native-search assistant |
| 184 |
* Feat/unfocus window effects |
| 185 |
* Fix placement, gear/Help, and dock⇄desktop visibility bugs |
| 186 |
* Fix Guidelines-experiment 404 noise, duplicate welcome dialog, and unused-preload warnings |
| 187 |
* Add "View activity footprint" row action in Users list |
| 188 |
|
| 189 |
= 0.9.0 = |
| 190 |
* Gate per-user REST routes on desktop mode enabled |
| 191 |
* Refine recycle bin badge styling and sync on stop |
| 192 |
* Clear comments selection after applying action |
| 193 |
* Don't let a failing sync block the agent |
| 194 |
* Make the AI-disabled error link to AI Settings |
| 195 |
|
| 196 |
= 0.8.9 = |
| 197 |
* Improve drag-and-drop handling in chromeless bridge and iframe bridge |
| 198 |
* The whole shell loads faster, especially the first time you open wp-admin |
| 199 |
* Open an app from the wallpaper or from the dock — it's the same window now (no more two copies floating around) |
| 200 |
* Minimize a window and the dock icon shows it's minimized — even if you opened it from the desktop icon |
| 201 |
* Click "+ New" twice and you get two editors. Drafting a post and want to start another? Just click again |
| 202 |
* "Switch to Desktop Mode" always takes you to the dashboard, so you know where you're starting from |
| 203 |
* Resizing a window and accidentally letting go over the desktop no longer minimizes everything |
| 204 |
* WooCommerce: the "Add Order" button is back on the Orders page |
| 205 |
* "Add New" buttons (Add Post, Add Order, Add anything) stay visible inside every plugin page |
| 206 |
* After we ship a fix, you get it on your next page load — no more "try refreshing twice" |
| 207 |
|
| 208 |
= 0.8.8 = |
| 209 |
* Align dock badge with in-window update count |
| 210 |
* Make every dock scrollable, keep system tiles pinned |
| 211 |
* No more flash when you create, move, or delete a file or shortcut on the desktop |
| 212 |
* Trashing a folder that contained other folders now works (used to silently fail) |
| 213 |
* Drag an image from the Media Library straight into a Gutenberg post, it now inserts |
| 214 |
* Edit User screen: the form is centered instead of pinned to the left |
| 215 |
* Title-bar icons (Help, etc.) are now visually centered |
| 216 |
* Sticky notes powered by WP Guidelines |
| 217 |
|
| 218 |
= 0.8.7 = |
| 219 |
* Bump Tested up to WordPress 7.0 |
| 220 |
* Fix plugins window stale-nonce 'Cookie check failed' on long-running sessions |
| 221 |
* Fix plugin .zip drop routing to Media Library uploader |
| 222 |
* Add server-side search to entity list views |
| 223 |
* Rename Browse tab to Add Plugin |
| 224 |
* Drag and drop improvements |
| 225 |
|
| 226 |
= 0.8.6 = |
| 227 |
* Light indicators for native-window-target dock icons |
| 228 |
* Additional fixes and polish |
| 229 |
* Add compatibility layer for Divi script dependencies and tests |
| 230 |
* Show plugin icons |
| 231 |
* Open off-site menu items in a new browser tab |
| 232 |
|
| 233 |
= 0.8.6-rc1 = |
| 234 |
* Tag cloud & category mindmap: search, clustering, server cache |
| 235 |
* Drag & Drop from local desktop |
| 236 |
* Implement loading skeletons and staggered animations for file tiles |
| 237 |
* Arrow-key shortcuts + Overview-from-Show-Desktop fix |
| 238 |
* Shortcuts popover, dock-style tooltips, reorder |
| 239 |
* Add Featured Plugins View and Ribbon Component |
| 240 |
* Add "Automatic Updates" column and related functionality to Plugins window |
| 241 |
* Add window notices feature with persistent dismissal and server sync |
| 242 |
* Polish four framework surfaces for plugin authors |
| 243 |
* Disable focus on other window actions |
| 244 |
* Add Media section to "My WordPress" + uniform preview-pane hook surface |
| 245 |
* Refactor My WordPress to use `<wpd-tile>` + add post status ribbons |
| 246 |
* Allow deactivating plugins in CMO desktop & dock |
| 247 |
* OS-file drop — progress UI, live refresh, cancel cleanup, CMO |
| 248 |
* Group-by selector + click-to-deselect + focused-icon centering |
| 249 |
* Test against PHP 8.3 and 8.4 |
| 250 |
* Enhance minimize/restore behavior to preserve pre-minimize state and add cross-state transition tests |
| 251 |
|
| 252 |
= 0.8.5 = |
| 253 |
* Shared folders, heartbeat widget, and heartbeat-pipeline hardening |
| 254 |
* Recycle Bin: show item type badges inline next to title |
| 255 |
* Plugins window: expandable rows with rich plugin details |
| 256 |
* Remember native window size across opens |
| 257 |
* Fix blank plugin icons in the Plugins window |
| 258 |
* Restore "Show desktop on wallpaper click" as an opt-in setting |
| 259 |
* Fix plugin update refresh, dock badge, and stuck-row failures |
| 260 |
* Trash bin polish: URL badge, live placement badge, no media auto-trash |
| 261 |
* Throw on empty REST body to avoid TypeError after self-replace |
| 262 |
* Hide Media filter tab when MEDIA_TRASH is off |
| 263 |
* Sequence openCurrentPage after restoreSession to avoid duplicate windows |
| 264 |
* Fix window refresh issue on new sessions |
| 265 |
|
| 266 |
= 0.8.4 = |
| 267 |
* Faster Desktop Mode, main bundle cut by 59 % |
| 268 |
* "Edit Post" from the front-end admin bar opens nothing |
| 269 |
* Cross-page admin-link clicks: state, destructive actions, referer hint |
| 270 |
* Warn loudly when a `<wpd-*>` tag is used without being imported |
| 271 |
* Support re-uploading existing plugins, add post-install Activate panel |
| 272 |
* Restore the full WordPress command palette inside Cmd+K |
| 273 |
|
| 274 |
= 0.8.3 = |
| 275 |
* Feat comments as native windows |
| 276 |
* Chrome <111 titlebars + duplicate-placement REST 500s |
| 277 |
* SW navigation interception caused window-in-window after core update |
| 278 |
* Open each post as its own window from the Posts window |
| 279 |
* Fix Users window data + live-refresh, plus per-window REST clients |
| 280 |
* Session-expiry cascade + Plugins window sync |
| 281 |
* Narrow scope to /wp-admin/ and throttle SW reloads |
| 282 |
* Plugins window: real updates, not just a phantom badge |
| 283 |
* Support plain permalinks for REST URL construction |
| 284 |
* Hide registered icons from desktop instead of trashing |
| 285 |
|
| 286 |
= 0.8.2 = |
| 287 |
* Many fixes and new features |
| 288 |
* Add unit test to ensure bridge script skips core AJAX update buttons |
| 289 |
* Native Plugins window + `<wpd-card>` |
| 290 |
* Appearance window polish + dock-peek fixes |
| 291 |
* Fix upload theme |
| 292 |
* Implement favicon resolver and associated tests for desktop mode |
| 293 |
* Auto-inject X-WP-Nonce for REST API requests |
| 294 |
* Enhance user management functionality in WordPress REST API |
| 295 |
* Fix user role updates |
| 296 |
* Fix plugin native issues |
| 297 |
* Enhance color scheme preview functionality by adding shell scheme flipping |
| 298 |
* Fix rearrange icons out of desktop |
| 299 |
* Open each post in its own window |
| 300 |
* Add item visibility and dock order settings |
| 301 |
* Add first-run welcome dialog for Desktop Mode |
| 302 |
* Fix dock management |
| 303 |
* Refetch desktop placements on Recycle Bin restore |
| 304 |
|
| 305 |
= 0.8.1 = |
| 306 |
* Framework rework and stability improvements — significant internals refactor, smoother window lifecycle, and more reliable bridging between iframe and native windows. |
| 307 |
* Drag and drop reworked end-to-end: calmer pointer behavior, more accurate hit-testing, and reliable handoff across windows. |
| 308 |
* 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. |
| 309 |
* New Content Graph tool — an interactive map of how your content links together. Pan, zoom, and focus a node to explore its neighborhood. |
| 310 |
* Cross-page admin link routing in the chromeless bridge so links across the admin stay inside the desktop shell. |
| 311 |
* Many bug fixes across the admin bar, Fullscreen toggle, resize handles over iframes, real-time icon refresh on plugin activation, and the PWA shell. |
| 312 |
|
| 313 |
= 0.5.1 = |
| 314 |
* Code editor and framework improvements. |
| 315 |
* Enhanced AI provider integration: third-party providers may register through `desktop_mode_register_ai_provider()`. |
| 316 |
* Title-bar button registry with icon painting for plugin authors. |
| 317 |
* OS Settings tabs are now extensible via `desktop_mode_register_settings_tab_script()` / `desktop_mode_register_settings_tab()`. |
| 318 |
* AI Copilot extensibility: server-side tool registry (`desktop_mode_register_ai_tool()`) and client-side `wp.desktop.ai.ask()` programmatic entry point. |
| 319 |
* UI component kit expansion (~25 `<wpd-*>` web components). |
| 320 |
* Backtick hotkey to cycle window focus. |
| 321 |
* Unified command palettes via the palette registry. |
| 322 |
* OS Settings Help tab. |
| 323 |
|
| 324 |
= 0.5.0 = |
| 325 |
* Command registration APIs (`desktop_mode_register_command_script()` / `desktop_mode_register_command()`) with live install/activate refresh. |
| 326 |
* Media-library enhancement enabled by default, with opt-out. |
| 327 |
* Dock CSS selectors updated; overflow handling improved. |
| 328 |
|
| 329 |
See the [GitHub releases page](https://github.com/WordPress/desktop-mode/releases) for the full history. |
| 330 |
|
| 331 |
== Upgrade Notice == |
| 332 |
|
| 333 |
= 0.8.1 = |
| 334 |
Framework and stability rework, reworked drag and drop, native Posts/Pages/Users windows, and a new Content Graph tool. Backwards-compatible. |
| 335 |
|
| 336 |
= 0.5.1 = |
| 337 |
Adds AI Copilot extensibility (server-side tools, multi-provider support) and a title-bar button registry. Backwards-compatible. |
| 338 |
|
