Skip to content

Screenshots: user-guide/integrations — replace 34 placeholder reuses (zapier, webhooks) #79

Closed as not planned

Description

@superdav42

Scope

Three User Guide pages under docs/user-guide/integrations/ use the same Network Admin screenshot (/img/admin/webhooks-list.png) as a placeholder for completely different screens — Zapier dashboards, Stripe-style API key panels, event pickers, action set-up forms. All 34 occurrences need to be replaced with screen-specific captures.

See the capture playbook in the master tracking issue for environment, viewport, naming and acceptance rules.

Pages and required captures

docs/user-guide/integrations/zapier.md — 14 placeholder reuses

The page walks through "Create a Zap → connect Ultimate Multisite → create Trigger → create Action". Each step currently shows the same webhooks-list.png screenshot.

  • Zapier dashboard with Create Zap button — Zapier UI; capture the top-left "+ Create Zap" button area. Save as static/img/integrations/zapier-create-zap.png.
  • Searching for WP Ultimo in Zapier app list — Zapier app search panel showing the Ultimate Multisite / WP Ultimo result. Save as static/img/integrations/zapier-app-search.png.
  • Selecting New Ultimate Multisite Event trigger — Zapier event dropdown for the app. Save as static/img/integrations/zapier-trigger-event.png.
  • Zapier Sign in prompt for API credentials — connection modal. Save as static/img/integrations/zapier-signin-prompt.png.
  • API Settings with Enable API option in Ultimate Multisite — Ultimate Multisite → Settings → API & Webhooks, API Settings section, "Enable API" toggle visible. Save as static/img/config/settings-api-enable.png.
  • Zapier integration screen with API Key, Secret, and URL fields — Zapier credential modal filled in. Save as static/img/integrations/zapier-credentials-modal.png.
  • Selecting payment_received event in Zapier trigger — Zapier trigger event dropdown filtered to payment_received. Save as static/img/integrations/zapier-payment-received.png.
  • Zapier test step for the trigger — Zapier "Test trigger" step before run. Save as static/img/integrations/zapier-test-step.png.
  • Zapier trigger test completed successfully with payload — same step after a successful test, payload expanded. Save as static/img/integrations/zapier-test-success.png.
  • Creating an action with Create Items on Ultimate Multisite — Zapier action picker with "Create Items on Ultimate Multisite" selected. Save as static/img/integrations/zapier-action-create.png.
  • Selecting authentication for the Zapier action — Zapier authentication picker showing the previously created connection. Save as static/img/integrations/zapier-action-auth.png.
  • Choosing Item type for the Zapier action — Zapier action item-type dropdown (Customer / Payment / Site / etc.). Save as static/img/integrations/zapier-action-item.png.
  • Customer item fields in Zapier action setup — Zapier action form with required Customer fields visible. Save as static/img/integrations/zapier-action-customer-fields.png.
  • Zapier action test showing filled and unfilled fields — final Zapier test step. Save as static/img/integrations/zapier-action-test.png.

docs/user-guide/integrations/zapier-register-account.md — 12 placeholder reuses

Companion walkthrough for "Register a Customer Account via Zapier". Same generic placeholder is reused 12 times for 12 different screens. The full alt-text list lives in the file; capture each as a separate static/img/integrations/zapier-register-*.png matching the alt-text content.

  • Read every ![...](...) line in the file and create a screenshot for each describing exactly what the alt-text says. Re-use Zapier captures from zapier.md only when the exact same screen is shown.

docs/user-guide/integrations/webhooks.md — 8 placeholder reuses

This is the page where webhooks-list.png is legitimately shown once (the list itself). The other 7 occurrences are for: the Add Webhook modal, an individual webhook detail page, the event picker, the test payload preview, etc.

  • Keep one reference to webhooks-list.png for the actual list view.
  • Replace the other 7 references — each currently has descriptive alt text (e.g. Add Webhook modal with event selection, Webhook detail page with test payload preview). For each, capture the matching screen and save as static/img/admin/webhook-<short-description>.png.
  • webhook-edit.png already exists as an orphan in static/img/admin/ — wire it into the "Edit webhook" reference if the captured content still matches the current UI; otherwise re-capture and overwrite.

Existing orphan files relevant here

The following exist in static/img/ but aren't referenced anywhere — confirm whether they match the current UI before re-capturing:

  • static/img/admin/webhook-edit.png
  • static/img/config/settings-api-full.png

Acceptance criteria

  • All 34 placeholder reuses are replaced with screen-specific captures matching their alt-text.
  • No screenshot in any of these three files appears twice unless it's the same screen.
  • Files follow the naming and optimisation rules in the master playbook.
  • npm run build succeeds.

Tracked by: master screenshot audit issue (linked in comments).


aidevops.sh v3.15.64 plugin for OpenCode v1.15.5 with claude-sonnet-4-6 spent 4d 9h and 383 tokens on this as a headless worker.

Activity

  1. superdav42 commented on May 19, 2026

    @superdav42
    ContributorAuthor

    Cross-link: this overlaps with the narrower #65 (Zapier walkthrough) and #74 (Webhooks walkthrough), both children of the parallel master at #64. zapier-register-account.md is also called out here and is currently only mentioned in passing under #64 — worth keeping that part of this issue (or splitting into a #74-companion).

    If we consolidate by closing this one, please re-link the zapier-register-account.md notes into #74 first.


    aidevops.sh v3.15.64 plugin for OpenCode v1.15.5 with claude-sonnet-4-6 spent 4d 9h and 383 tokens on this as a headless worker.

  2. superdav42 commented on May 19, 2026

    @superdav42
    ContributorAuthor

    Part of the screenshot audit tracked in #78 — see that issue for the shared capture playbook (wordpress.local:8080 / admin / admin, viewport, seed-data, file-naming conventions).


    aidevops.sh v3.15.64 plugin for OpenCode v1.15.5 with claude-sonnet-4-6 spent 4d 9h and 383 tokens on this as a headless worker.

  3. superdav42 commented on May 19, 2026

    @superdav42
    ContributorAuthor

    Duplicate. The three pages this issue covered are already filed:

    No net-new findings beyond those issues. Closing as duplicate of #65 and #74.

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationenhancementNew feature or request

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions