Skip to content

Restore the revisions easter egg - #13152

Open
adamsilverstein wants to merge 5 commits into
WordPress:trunkfrom
adamsilverstein:65907-restore-easter-egg
Open

Restore the revisions easter egg#13152
adamsilverstein wants to merge 5 commits into
WordPress:trunkfrom
adamsilverstein:65907-restore-easter-egg

Conversation

@adamsilverstein

@adamsilverstein adamsilverstein commented Aug 18, 2026

Copy link
Copy Markdown
Member

Description

Restores the admin easter egg WordPress used to trigger by comparing a revision to itself. It shipped for about a decade and came out in [24820] (see #24852) when the revisions UI was rewritten and the "compare a revision to itself" state stopped existing. It was not removed because anyone objected to it, only because its doorway disappeared.

The command palette is the new doorway. No command is registered: a registered command shows up in the results the moment its phrase matches, which hands the egg to anyone who happens to type near it. Instead a keydown handler watches for Enter while the palette is open and acts on the phrase itself. The palette shows its ordinary "No results found." state throughout, so typing the phrase looks exactly like a search that missed.

The phrase is compared through the same Dvorak/QWERTY substitution cipher the original used, so it is not a readable string in the admin bundle. It can be worked out from the source with a little effort, which seems like about the right amount.

The two files are named for what they do - teletype.js and teletype-loader.js - rather than for what they are. The loader is enqueued by name on every admin screen with the palette, so its src is right there in the markup, and a filename with "easter egg" in it gives away most of the fun before anyone goes looking. The docblocks still say plainly what this is; minification strips them, so they never reach a production page.

Trac ticket: https://core.trac.wordpress.org/ticket/65907

Notes on the payload

Timings, dialogue, and staging are faithful to the original. A few things needed updating after twelve years:

  • <blink> and text-decoration: blink are both gone from browsers. Replaced with a CSS @keyframes blink, plus a prefers-reduced-motion guard.
  • The original took over the document, rewriting html/body CSS and stripping nodes out of the page's first <p>. The scene now renders into its own overlay and touches nothing on the admin page.
  • The overlay is marked aria-hidden. Without it, text typed one character at a time lands in the accessibility tree one node at a time.
  • Scrolling is locked while the scene plays. Otherwise the page behind it stays scrollable and leaves a scrollbar strip down the side.

Only a small loader is added to admin pages. The scene itself is fetched at the moment it is invoked, so a normal admin load carries nothing else.

How has this been tested

  1. Open any admin screen and press Cmd/Ctrl+K.
  2. Type the phrase. The palette will say "No results found." the whole time, which is expected. Press Enter anyway.
  3. The scene runs for about 30 seconds. ESC or a click dismisses it at any point.

Also verified:

  • Ordinary palette commands still run. The handler is capture phase, so this one is worth a reviewer's eye.
  • Enter on a genuinely empty search does nothing.
  • The payload is not requested until the egg is invoked.
  • No console errors on normal admin screens.
  • grunt jshint:core and grunt typecheck:js pass, phpcs is clean.

Types of changes

  • Add the scene as src/js/_enqueues/admin/teletype.js, fetched on demand.
  • Add the loader as src/js/_enqueues/admin/teletype-loader.js, enqueued with the command palette.
  • Register and enqueue the loader in wp_enqueue_command_palette_assets().
  • Add both files to the Gruntfile admin-js build map.

AI Use

Both the code and this description came out of a back and forth with 🤖 Claude Code. I will review and test.

The revisions easter egg was removed in [24820] because the revisions UI it hooked
into was rewritten and its trigger disappeared with it, not because the egg was
unwanted. This gives the payload a new home: a command palette loader that returns
no commands, and so stays invisible, until its phrase is typed.

The 2013 original shipped as a Dean Edwards packed blob. It is unpacked here into
readable source and no longer depends on jQuery, since obfuscated code is not GPL
source. See #15262. The trigger phrase is still compared through the original
Dvorak/QWERTY cipher so that it is not a readable string in the admin bundle; that
is the only obfuscation retained, and it is aimed at users rather than developers.

The payload is fetched only once the egg has been invoked, so a normal admin page
load carries nothing but the loader. It renders into a self-contained overlay
instead of taking over the document as the original did.

See #24852.
… admin easter egg.

Browser testing surfaced three problems with the overlay.

The page behind it stayed scrollable, so the overlay measured 15px narrower than
the viewport and left a visible scrollbar strip down the side. Scrolling is now
locked on the document element while the scene plays and restored when it is
dismissed.

The scene inserts text one character at a time, and each character landed in the
accessibility tree as its own node. The overlay is purely decorative, so it is now
marked aria-hidden.

Act two ended on an empty black screen with no indication of how to leave it. It
now closes on the line the original used as its noscript fallback, which both ends
the scene deliberately and hints that the page is still there.
JSHint enforces single-quoted strings in core JS, and jshint:core failed on this one
double-quoted literal. It was written that way only because the line contains an
apostrophe, so escape the apostrophe instead.
A registered command appears in the palette as soon as its phrase matches, so anyone
typing near the phrase is shown the egg rather than discovering it. Nothing is
registered now. A keydown handler watches for Enter while the palette is open and
acts on the phrase itself, which leaves the palette showing its ordinary "No results
found." state throughout, indistinguishable from a search that missed.

The handler runs in the capture phase, so it is guarded on the palette being open and
the phrase matching before it touches the event. Verified that ordinary palette
commands still run and that Enter on a genuinely empty search does nothing.

Also drops the now-unused label constant, since no label is rendered.
@github-actions

Copy link
Copy Markdown

The following accounts have interacted with this PR and/or linked issues. I will continue to update these lists as activity occurs. You can also manually ask me to refresh this list by adding the props-bot label.

Core Committers: Use this line as a base for the props when committing in SVN:

Props adamsilverstein.

To understand the WordPress project's expectations around crediting contributors, please review the Contributor Attribution page in the Core Handbook.

@github-actions

Copy link
Copy Markdown

Test using WordPress Playground

The changes in this pull request can previewed and tested using a WordPress Playground instance.

WordPress Playground is an experimental project that creates a full WordPress instance entirely within the browser.

Some things to be aware of

  • All changes will be lost when closing a tab with a Playground instance.
  • All changes will be lost when refreshing the page.
  • A fresh instance is created each time the link below is clicked.
  • Every time this pull request is updated, a new ZIP file containing all changes is created. If changes are not reflected in the Playground instance,
    it's possible that the most recent build failed, or has not completed. Check the list of workflow runs to be sure.

For more details about these limitations and more, check out the Limitations page in the WordPress Playground documentation.

Test this pull request with WordPress Playground.

@adamsilverstein

Copy link
Copy Markdown
Member Author

Calling the files easter-egg-* is probably a bit too obvious, maybe we can come up with something a bit less so.

The loader is enqueued by name on every admin screen that loads the command
palette, so its src appears in the markup of an ordinary page load. A file
called easter-egg-loader.js announces that something is hidden before anyone
goes looking, which is most of what the egg has to offer.

Name both files for what they do instead. The payload types lines onto a
fullscreen overlay, so teletype.js and teletype-loader.js describe the
mechanism while giving away nothing about the surprise. The script handle,
the config global, and the overlay class follow.

The docblocks still say plainly what this is. Minification strips them, so
they never reach a production page, and a core developer reading the source
should not have to guess.
@adamsilverstein

Copy link
Copy Markdown
Member Author

Agreed. Renamed to teletype.js and teletype-loader.js in b2150a3 - named for what they do rather than for what they are, since the loader's src shows up in the markup of every admin page that loads the palette. The script handle, config global and overlay class follow. Docblocks still say plainly what this is, and minification strips those so they never reach a production page.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant