consolidated: replace duplicate and stale installation wizard screenshots

[superdav42]

Supersedes #75 — this issue is the consolidated spec.

What

Replace the duplicate and potentially stale installation wizard screenshots in the Ultimate Multisite docs with fresh, accurate captures matching the current plugin UI.

Files to replace under static/img/installation/:

Filename	Description
plugin-activated.png	Post-activation notice/banner
wizard-welcome.png	Setup wizard welcome screen
wizard-pre-install-checks.png	Pre-install checks step
wizard-installation.png	Database installation step
wizard-recommended-plugins.png	Recommended plugins step
wizard-your-company.png	Company info step
wizard-default-content.png	Default content step
wizard-ready.png	Final "Ready" step
search-ultimate-multisite.png	Plugins → Add New search
add-new-plugin.png	Plugins → Add New page header
plugin-installed.png	UM installed but not activated

Also verify under static/img/installation/multisite-wizard/: wizard-installation-pending.png, wizard-installation-complete.png.

Affected doc: docs/user-guide/getting-started/installing-ultimate-multisite.md

Why

A byte-identical duplicate exists between two files that must depict distinct UI states:

static/img/installation/plugin-activated.png  (MD5: 74f697dd4b6ca93f0a307ceb0ff09bf3, 85 KB, 1024×768)
static/img/installation/wizard-welcome.png    (MD5: 74f697dd4b6ca93f0a307ceb0ff09bf3, 85 KB, 1024×768)

• plugin-activated.png must show the one-time post-activation admin notice/banner.
• wizard-welcome.png must show the first step of the UM setup wizard.

Several other wizard step screenshots may also be stale relative to the current UI. The relationship between multisite-wizard/wizard-welcome.png and installation/wizard-welcome.png has not been confirmed as intentional.

How

Prerequisites: Interactive session with browser access to wordpress.local:8080 and WordPress Network Admin credentials. Headless execution is not viable — see Context & Decisions.

Step 1 — Reproduce the full wizard flow:

1. Network Admin → Plugins → deactivate Ultimate Multisite.
2. Re-activate Ultimate Multisite.
3. The post-activation flow presents each wizard step — capture each one.

Step 2 — Capture screenshots:

Capture spec: 1280×800 viewport, browser chrome trimmed, < 200 KB each.

Filename	What to capture
static/img/installation/plugin-activated.png	Post-activation notice/banner right after activating UM
static/img/installation/wizard-welcome.png	First step of UM setup wizard — welcome screen
static/img/installation/wizard-pre-install-checks.png	Pre-install checks step (server requirements, write permissions)
static/img/installation/wizard-installation.png	Database installation step — running/spinner
static/img/installation/wizard-recommended-plugins.png	Recommended plugins step
static/img/installation/wizard-your-company.png	Company info step
static/img/installation/wizard-default-content.png	Default content step
static/img/installation/wizard-ready.png	Final "Ready" step
static/img/installation/search-ultimate-multisite.png	Plugins → Add New, searching for "Ultimate Multisite"
static/img/installation/add-new-plugin.png	Plugins → Add New page header
static/img/installation/plugin-installed.png	Plugins listing showing UM installed but not activated

Step 3 — Verify multisite-wizard subdirectory:

• Check static/img/installation/multisite-wizard/wizard-installation-pending.png and wizard-installation-complete.png for UI drift; replace if stale.
• Confirm whether multisite-wizard/wizard-welcome.png and installation/wizard-welcome.png refer to intentionally different wizard flows. Document the distinction in a comment on this issue.

Step 4 — Replace files in place:

Overwrite existing files. docs/user-guide/getting-started/installing-ultimate-multisite.md already references these filenames — no doc edits needed unless the multisite-wizard verification reveals a naming mismatch.

Step 5 — Verify no duplicates:

md5sum static/img/installation/*.png

Confirm all hashes are distinct before opening the PR.

Step 6 — Open PR:

git add static/img/installation/
git commit -m "feat(screenshots): replace duplicate and stale installation wizard captures"
gh pr create \
  --title "feat(screenshots): replace duplicate and stale installation wizard captures" \
  --body "Resolves #ISSUE_NUM
Ref #64

Replaces byte-identical duplicate plugin-activated.png/wizard-welcome.png
and verifies all installation wizard captures are current at 1280×800."

Acceptance Criteria

• md5sum static/img/installation/*.png shows no duplicate hashes.
• plugin-activated.png shows the post-activation admin notice, not the wizard welcome screen.
• wizard-welcome.png shows the wizard welcome screen.
• All 11 files in the table above are replaced with fresh 1280×800 captures < 200 KB each.
• static/img/installation/multisite-wizard/ files are verified (updated or confirmed current).
• The relationship between multisite-wizard/wizard-welcome.png and installation/wizard-welcome.png is documented in a comment.
• PR opened with Resolves for this issue and Ref #64.

Context & Decisions

Duplicate confirmed (per @superdav42, Comment 1 and Comment 2 on #75):
Two independent headless worker passes confirmed the byte-identical duplicate:

• MD5: 74f697dd4b6ca93f0a307ceb0ff09bf3
• Both files are 1024×768 PNG, 85 KB each.

Headless execution is blocked (per @superdav42, Comment 2 on #75):

• agent-browser (Chrome daemon) crashes in the current worker environment.
• Playwright, Selenium, and similar browser automation tools are not available.
• WordPress admin credentials were obtained and the installation was located, but screenshots cannot be taken without a working browser.
• This task must be executed in an interactive session with access to wordpress.local:8080.

Current file dimensions (per @superdav42, Comment 1 on #75):
Existing duplicate files are 1024×768. Required spec is 1280×800 — all replacements must meet the new size.

No doc file edits required (from parent body):
installing-ultimate-multisite.md already references the correct filenames — overwriting images in place is sufficient, unless the multisite-wizard verification reveals a naming mismatch.

Ref #64 — parent epic for installation documentation work.

Contributors

cc @superdav42

---

aidevops.sh v3.17.31 plugin for OpenCode v1.15.10 with claude-sonnet-4-6 spent 2m and 5,010 tokens on this as a headless worker.