Skip to content

consolidated: replace duplicate and stale installation wizard screenshots #113

Closed

Description

@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.

Activity

  1. added
    documentationImprovements or additions to documentation
    origin:workerCreated by headless/pulse worker session
    status:queuedWorker dispatched, not yet started
    consolidatedIssue superseded by a consolidated child
    on May 25, 2026
  2. self-assigned this
    on May 25, 2026
  3. added and removed
    status:queuedWorker dispatched, not yet started
    on May 25, 2026
  4. removed their assignment
    on May 25, 2026
  5. added
    status:queuedWorker dispatched, not yet started
    and removed on May 25, 2026
  6. self-assigned this
    on May 25, 2026
  7. superdav42 commented on May 25, 2026

    @superdav42
    ContributorAuthor

    CLAIM_RELEASED reason=worker_complete runner=superdav42 ts=2026-05-25T08:34:48Z aidevops_version=3.17.31 opencode_version=1.15.10

  8. removed their assignment
    on May 25, 2026
  9. 11 remaining items

  10. added
    status:queuedWorker dispatched, not yet started
    and removed on Jun 18, 2026
  11. self-assigned this
    on Jun 18, 2026
  12. superdav42 commented on Jun 18, 2026

    @superdav42
    ContributorAuthor

    CLAIM_RELEASED reason=worker_failed runner=superdav42 ts=2026-06-18T15:28:25Z aidevops_version=3.20.88 opencode_version=1.17.7

  13. removed their assignment
    on Jun 18, 2026
  14. added and removed
    status:queuedWorker dispatched, not yet started
    on Jun 18, 2026
  15. added
    status:queuedWorker dispatched, not yet started
    and removed on Jun 29, 2026
  16. self-assigned this
    on Jun 29, 2026
  17. added
    status:in-reviewNon-draft PR ready for review/merge
    and removed
    status:queuedWorker dispatched, not yet started
    on Jun 29, 2026
  18. superdav42 commented on Jun 29, 2026

    @superdav42
    ContributorAuthor

    Verified the two wizard-welcome screenshot families during the #113 replacement pass:

    • static/img/installation/wizard-welcome.png is 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.png is 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.

  19. superdav42 commented on Jun 29, 2026

    @superdav42
    ContributorAuthor

    CLAIM_RELEASED reason=worker_complete runner=superdav42 ts=2026-06-29T07:14:50Z aidevops_version=3.29.31 opencode_version=1.17.11

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

Metadata

Metadata

Assignees

Labels

consolidatedIssue superseded by a consolidated childdocumentationImprovements or additions to documentationgood first issueGood for newcomersorigin:workerCreated by headless/pulse worker sessionstatus:in-reviewNon-draft PR ready for review/merge

Type

No type

Projects

No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions