Repository navigation
Description
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.pngmust show the one-time post-activation admin notice/banner.wizard-welcome.pngmust 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:
- Network Admin → Plugins → deactivate Ultimate Multisite.
- Re-activate Ultimate Multisite.
- 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.pngandwizard-installation-complete.pngfor UI drift; replace if stale. - Confirm whether
multisite-wizard/wizard-welcome.pngandinstallation/wizard-welcome.pngrefer 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/*.pngConfirm 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/*.pngshows no duplicate hashes. -
plugin-activated.pngshows the post-activation admin notice, not the wizard welcome screen. -
wizard-welcome.pngshows 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.pngandinstallation/wizard-welcome.pngis documented in a comment. - PR opened with
Resolvesfor this issue andRef #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.
Activity
superdav42 commentedon May 25, 2026
CLAIM_RELEASED reason=worker_complete runner=superdav42 ts=2026-05-25T08:34:48Z aidevops_version=3.17.31 opencode_version=1.15.10
11 remaining items
superdav42 commentedon Jun 18, 2026
CLAIM_RELEASED reason=worker_failed runner=superdav42 ts=2026-06-18T15:28:25Z aidevops_version=3.20.88 opencode_version=1.17.7
superdav42 commentedon Jun 29, 2026
Verified the two wizard-welcome screenshot families during the #113 replacement pass:
static/img/installation/wizard-welcome.pngis the Ultimate Multisite product setup wizard shown after the plugin is network-active (wp-admin/network/admin.php?page=wp-ultimo-setup&step=welcome). It starts the product configuration flow: checks, installation, company details, default content, recommended plugins, and ready state.static/img/installation/multisite-wizard/wizard-welcome.pngis the separate WordPress Multisite enablement wizard (wp-admin/admin.php?page=wp-ultimo-multisite-setup&step=welcome). It appears for standard non-multisite WordPress installs and explains enabling WordPress Multisite before the product setup wizard.The relationship is intentional: same plugin family, different setup flows.
superdav42 commentedon Jun 29, 2026
CLAIM_RELEASED reason=worker_complete runner=superdav42 ts=2026-06-29T07:14:50Z aidevops_version=3.29.31 opencode_version=1.17.11