Skip to content

docs(compat): record the non-autoloaded option as differentiator D4 - #152

Merged
dknauss merged 4 commits into
mainfrom
docs/ame-autoload-differentiator
Aug 12, 2026
Merged

docs(compat): record the non-autoloaded option as differentiator D4#152
dknauss merged 4 commits into
mainfrom
docs/ame-autoload-differentiator

Conversation

@dknauss

@dknauss dknauss commented Aug 12, 2026

Copy link
Copy Markdown
Owner

Why

Dan observed on live sites that Admin Menu Editor's option row can dominate wp_options and become an admin-load bottleneck. That checks out — it is known and acknowledged upstream — and Maestro's storage model is the direct counter-position. But that position was recorded nowhere except one cell of the 2026-08-01 architecture table, and the feature sweep was scoped to skip it.

What changed

PRIOR-ART-admin-menu-editor.md — new D4 in Differentiate. The storage-row consequence of the existing V2 finding ("do not adopt a stored full-tree"), not a new claim:

  • AME's ws_menu_editor is autoloaded, so every request the site serves — front end included, where the data is never used — pays to fetch and unserialize it, and it grows with the whole admin menu (every installed plugin adds to the stored tree) rather than with what the user edited.
  • Evidence is upstream, not inferred. Elsts confirms the autoload behavior in a wordpress.org thread and declines to flip it because non-autoloaded "would mean an additional SQL query on every admin page." Three size mitigations across 2.5 (2017 compress), 2.11 (2020 + zlib), 2.27 (2025 "Optimize menu configuration size") per the Pro changelog — three rounds over eight years is what makes it structural rather than a bug.
  • Maestro's side with the measured numbers from docs/performance/config-size-and-page-load.md, and the trade named honestly: non-autoloaded costs 1 extra admin-page query — exactly Elsts' objection — taken because it is admin-only, memoized once per request, zero with a persistent object cache, while public traffic pays nothing.
  • Flagged as the strongest of D1–D4 for positioning because it is the only one a third party can verify without installing either plugin: wp option list --autoload=on.

Feature-sweep todo — carve-out so the matrix carries it. The todo put storage entirely out of scope, so the sweep would have missed this. Format stays out (architecture, already answered); the consequences are in, because AME's two Settings-tab toggles — "Compress menu configuration data" and "Optimize menu configuration size" — are user-facing features. They earn rows, landing deliberately-not: a config that is sparse and outside alloptions never needs a compression toggle.

class-config.php — stale comment. The MAX_CONFIG_BYTES docblock said the cap protects "every autoloaded read of it," contradicting the update_option( …, false ) two methods below. Now says admin-request read, and states that the option is never part of alloptions.

Open evidence question, tracked

D4's autoload flag comes from the author's reply and the changelog, not from a source read — the 1.15.1 spike recorded the storage format but not the update_option call. The sweep already opens the free zip, so the todo now carries confirming that call as a check, which upgrades the row to source-read.

Verification

Comment-only code change: php -l clean, phpcs --standard=phpcs.xml.dist includes/class-config.php clean (1/1, 0 errors). No behavior change, so no test run beyond lint.

Not done deliberately

README.md and readme.txt already state the facts accurately (README: "Not autoloaded, so it adds nothing to alloptions"; readme.txt 134–135). The gap was competitive framing, not accuracy — and naming a competitor's performance problem in a wordpress.org readme cuts against directory norms. Happy to sharpen the public copy without naming AME if wanted.

🤖 Generated with Claude Code

dknauss and others added 4 commits August 11, 2026 19:14
Dan observed on live sites that Admin Menu Editor's option row can dominate
wp_options and slow admin loads. It is a known, acknowledged issue upstream,
and Maestro's storage model is the direct counter-position -- but that was
recorded nowhere except one cell of the 2026-08-01 architecture table.

- PRIOR-ART: add D4 to Differentiate. AME's `ws_menu_editor` is autoloaded, so
  every request -- front end included, where the data is unused -- pays to fetch
  and unserialize it, and it grows with the whole admin menu rather than with
  what the user edited. Evidence is upstream, not inferred: Elsts confirms the
  autoload behavior in a wordpress.org thread and declines to flip it (an extra
  admin query), plus three size mitigations across 2.5 / 2.11 / 2.27 -- which is
  what makes it structural. Maestro's side is stated with the measured numbers
  and with the trade named honestly (1 extra admin-page query, exactly Elsts'
  objection; zero front-end cost, which is the bulk of real traffic).
  Framed as the storage-row consequence of the existing V2 finding, not a new
  claim. Notes the evidence caveat: the autoload flag comes from the reply and
  the changelog, not from the 1.15.1 source read.

- Feature-sweep todo: the sweep had storage entirely out of scope and would have
  missed this. Carve out the footprint consequences -- format stays out, but
  AME's two Settings-tab toggles ("Compress menu configuration data",
  "Optimize menu configuration size") are user-facing features and earn rows,
  landing `deliberately-not`. Folds in the open evidence question so the zip
  read confirms the `update_option` call and upgrades D4 to `source-read`.

- class-config.php: the MAX_CONFIG_BYTES docblock said the cap protects "every
  autoloaded read of it", contradicting the design two methods below it. Say
  admin-request read, and state that the option is never in `alloptions`.

Comment-only code change: php -l and phpcs both clean.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…load cost lands

Lead the Performance section with the alloptions point instead of burying it
fourth, since it is the claim that distinguishes Maestro and the one a user can
verify themselves -- `wp option list --autoload=on` does not list maestro_config.
Adds the sparse-delta framing (storage tracks edits, not installed-plugin count)
and the measured 0.1 ms / 1 ms figures with a link to the method. No competitor
is named, and no comparative claim is made about any other plugin -- the copy
describes the WordPress mechanism and what Maestro does with it.

Also tightens D4 in the prior-art note. "Every request pays to fetch and
unserialize it" was loose: wp_load_alloptions() pulls every autoloaded row in
one query and holds it in memory, but the option's own maybe_unserialize() runs
only when get_option() asks for it. The front-end tax is the bundle -- transfer,
memory, and with a persistent object cache a per-request fetch and unserialize
of the whole alloptions object, which is where a fat row hurts most. Notes that
full-page caching spares requests that never boot WP.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
…and retag

Per Dan: state the performance advantage head-on rather than leaving the reader
to infer it from the mechanism. Wording is his. The "nothing to compress,
optimize, or tune" clause moves up into it, so it is dropped from the
sparse-delta bullet to avoid saying it twice.

Tags: drop "admin menu editor" -- guideline 12 treats a competitor's plugin name
as spam, and the phrase is already in our plugin TITLE, which the directory
weights far above tags, so the SEO cost is close to nil. (Evidence that tags are
weak: Admin Menu Editor ranks #1 for "hide admin menu", "menu editor", "admin
menu icons" and "hide menu items" while tagging none of them -- it tags only
admin/dashboard/menu/security/wpmu.)

Filled the slot with "rename menu items" rather than the requested "hide admin
menu": Hide Admin Menu is itself a plugin (20k installs), so that swap would
have reproduced the exact problem being fixed. "rename menu items" collides with
no plugin name, pairs with the existing "hide menu items", and covers the one
core capability the tag set had no term for.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
The directory indexes the whole readme and weights the title and body far above
tags -- AME ranks #1 for "hide admin menu", "menu editor", "admin menu icons"
and "hide menu items" while tagging none of them. So the description, not the
tag line, is where discoverability is won, and ours led with "orchestrate the
appearance of the WordPress admin menu": true to the product, but containing
almost none of the literal phrases people type.

- Short description now leads with "Hide admin menu items per user role", the
  highest-intent phrase we can claim. 146 chars, same as before, still under the
  150 limit.
- Opening bold line names the four capabilities in searchable form (rename /
  reorder / change icons / hide admin menu items) instead of only "orchestrate".
- New second paragraph frames the jobs -- declutter a client site, rename
  cryptic plugin labels, reorder, hide per role -- so the phrases appear in
  prose a human wants to read rather than as a keyword list. Guideline 12 bars
  keyword stuffing; this stays on the right side of that line by describing real
  use cases.
- Adds a one-line performance tease pointing at the footprint section, so the
  differentiator is visible above the fold rather than only near the bottom.

The inline-editing paragraph is unchanged apart from a closing line, since that
premise is still the lead story.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@dknauss
dknauss merged commit a8f8106 into main Aug 12, 2026
16 checks passed
@dknauss
dknauss deleted the docs/ame-autoload-differentiator branch August 12, 2026 01:37
dknauss added a commit that referenced this pull request Aug 12, 2026
Version strings bumped via bin/prep-release.sh. Changelog derived from the
`v1.5.1..main` DIFF, which is one shippable file: includes/class-config.php
(+46/-3), the normalizing-equivalent-key dedupe from #153.

⚠️ DO NOT TAG YET. A second ultrareview is still running in another session and
may confirm further bugs. If it does, they belong in THIS patch: tagging now would
either ship a fix whose changelog omits its siblings, or force a v1.5.3 days
later. v1.4.0's gate 8 caught a changelog overclaim by diffing the real commits —
the same discipline says do not finalise the changelog until the commit set is.

Two changelog entries, both from the one fix, split because they are different
audiences:

- The general one: an override could silently stop applying when a single save
  carried two spellings of the same item's address. Written to name the symptom a
  user would actually notice — a rename or visibility rule that stops working
  while still showing in settings — rather than the mechanism.
- The authorization one: it also closes a way for a saver who cannot list users to
  undo an administrator's per-person rule. Stated plainly, with the cosmetic-only
  guarantee restated, because that is the claim people will check.

NOT framed as a security release. Hiding is cosmetic: no capability was granted
or removed and the page stayed URL-reachable throughout. Same framing as 1.4.1.

Also riding along, not changelog material: the readme listing copy rewritten in
#152 (D4 non-autoloaded differentiator, tags, description). It publishes with the
release but is directory copy, not plugin behaviour.

Upgrade Notice is 271 chars (Plugin Check limit 300).

Gate (Docker-free lanes): unit 167/167 (223 assertions), WPCS clean, PHPStan 0,
doc-links clean. Integration/e2e ran green on #153 and re-run here in CI.

Co-authored-by: Claude Opus 5 <noreply@anthropic.com>
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