Skip to content

Screenshots: user-guide/payment-gateways — replace placeholder reuses (stripe, paypal, manual, getting-paid, tax-handling) #80

Closed as not planned

Description

@superdav42

Scope

Five User Guide pages under docs/user-guide/payment-gateways/ reuse the same one or two screenshots throughout — most aggressively in stripe.md (one image used 12×) and tax-handling.md (one image used 15×). Every occurrence currently has descriptive alt text that does not match the placeholder image. Replace each with a screen-specific capture.

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

Pages and required captures

docs/user-guide/payment-gateways/stripe.md — 12× settings-payment-gateways.png

Every screenshot in the file is the same. The page walks through enabling Stripe, getting API keys from the Stripe dashboard, setting up the webhook endpoint, and verifying the connection.

Required captures (file path = current alt-text → suggested filename):

  • Enabling Stripe in active payment gateways → static/img/config/settings-payments-active-stripe.png (UM Settings → Payments → Active Payment Gateways with Stripe toggled on).
  • Stripe inline credit card field during checkout → static/img/frontend/checkout-stripe-inline.png (frontend checkout with the Stripe inline card field visible).
  • Stripe Checkout redirect page during checkout → static/img/frontend/checkout-stripe-redirect.png (Stripe Checkout hosted page).
  • Stripe API key fields and sandbox mode toggle → static/img/config/stripe-api-key-fields.png (UM Stripe gateway settings with publishable + secret + sandbox).
  • Stripe dashboard Developers section with API Keys → static/img/integrations/stripe-dashboard-api-keys.png (Stripe's dashboard, Developers → API keys).
  • Stripe Viewing test data toggle → static/img/integrations/stripe-test-data-toggle.png.
  • Stripe publishable and secret key values → static/img/integrations/stripe-keys-revealed.png (use Stripe test keys, never live).
  • Pasting Stripe keys in Ultimate Multisite settings → static/img/config/stripe-keys-pasted.png.
  • Stripe Webhooks page with Add endpoint button → static/img/integrations/stripe-webhooks-add-endpoint.png.
  • Webhook Listener URL field in Stripe gateway settings → static/img/config/stripe-webhook-listener-url.png.
  • Pasting endpoint URL in Stripe webhook setup → static/img/integrations/stripe-webhook-endpoint-url.png.
  • Selecting all events and adding the Stripe endpoint → static/img/integrations/stripe-webhook-events.png.

Never screenshot live Stripe keys — flip the Stripe dashboard to test mode first.

docs/user-guide/payment-gateways/getting-paid.md — 11× settings-general.png + 7× settings-payment-gateways.png

This is the gateway overview page. Each image illustrates a different settings panel or add-on install dialog.

  • Payment settings page in Ultimate Multisite → keep settings-payment-gateways.png if it's a full capture of the page; otherwise recapture as static/img/config/settings-payments-full.png (file already exists as an orphan — check first).
  • Force auto-renew toggle setting → static/img/config/settings-payments-auto-renew.png (cropped to that one row).
  • Allow trials without payment method toggle → static/img/config/settings-payments-trial-toggle.png.
  • Send invoice on payment confirmation toggle → static/img/config/settings-payments-send-invoice.png.
  • Invoice numbering scheme selection → static/img/config/settings-payments-invoice-numbering.png.
  • Sequential invoice number and prefix settings → static/img/config/settings-payments-invoice-prefix.png.
  • Active payment gateways list → static/img/config/settings-payments-active-list.png.
  • Settings page with add-ons section → keep settings-general.png if accurate; otherwise recapture.
  • Add-ons page listing available add-ons → static/img/admin/addons-page.png (this file already exists — confirm it's still up-to-date).
  • WooCommerce add-on install dialog → static/img/admin/addon-install-woocommerce.png.
  • Network Activate the WooCommerce add-on → static/img/admin/addons-list-woocommerce-activated.png.
  • WooCommerce activation reminder notice → static/img/admin/notice-woocommerce-required.png.
  • GoCardless add-on install dialog → static/img/admin/addon-install-gocardless.png.
  • Network Activate the GoCardless add-on → static/img/admin/addons-list-gocardless-activated.png.
  • Payfast add-on install dialog → static/img/admin/addon-install-payfast.png.
  • Network Activate the Payfast add-on → static/img/admin/addons-list-payfast-activated.png.

docs/user-guide/payment-gateways/tax-handling.md — 15× settings-taxes.png

A long walkthrough of tax setup, tax categories, VAT add-on install, VAT enable, VAT validation on the frontend. Every screenshot is currently the same image of the Taxes settings page.

  • Enable Taxes toggle in tax settings → keep settings-taxes.png for this one (it actually shows the toggle).
  • Inclusive Tax setting toggle → static/img/config/settings-taxes-inclusive.png (cropped to that row).
  • Manage Tax Rates button on the sidebar → static/img/config/settings-taxes-manage-rates.png.
  • Tax rates editor with Add new Row button → static/img/config/tax-rates-editor.png.
  • Add new Tax Category button → static/img/config/tax-categories-add.png.
  • Creating a new tax category → static/img/config/tax-categories-create-modal.png.
  • Switch between tax categories → static/img/config/tax-categories-switch.png.
  • Selecting a tax category to view → static/img/config/tax-categories-select.png.
  • Product taxes tab with tax category and taxable toggle → keep product-taxes.png if accurate (already wired).
  • Settings page with add-ons sidebar link → static/img/config/settings-taxes-addons-link.png.
  • VAT add-on on the add-ons page → static/img/admin/addons-page-vat.png.
  • VAT add-on install dialog → static/img/admin/addon-install-vat.png.
  • Network Activate the VAT add-on → static/img/admin/addons-list-vat-activated.png.
  • Enable VAT Support toggle in tax settings → static/img/config/settings-taxes-vat-toggle.png.
  • VAT rates pulling options with Update EU VAT Rates button → static/img/config/tax-rates-vat-pull.png.
  • VAT number field on the checkout form → static/img/frontend/checkout-vat-field.png.

Note: settings-taxes-full.png already exists as an orphan and could be the canonical full-page capture if up-to-date.

docs/user-guide/payment-gateways/paypal.md — 5× settings-payment-gateways.png

PayPal-equivalent of the Stripe page: enable PayPal, paste credentials, configure IPN, etc.

  • Replace each placeholder with a PayPal-specific capture matching its alt-text. Suggested filenames: static/img/config/paypal-*.png and static/img/integrations/paypal-*.png for the PayPal dashboard screens.

docs/user-guide/payment-gateways/manual-payments.md — 3× settings-payment-gateways.png + 3× payments-list.png

Configuration of the manual / off-line payment method, and processing manual payments from the admin.

  • Replace the three settings-payment-gateways.png references with cropped captures of the Manual gateway settings panel.
  • Reduce the three payments-list.png references to a single legitimate "Payments list" reference; for the other two, capture the actual payment-edit screen (payment-edit.png already exists as an orphan — wire it in if still accurate).

Existing orphan files relevant here

These exist in static/img/ but no doc references them — wire in / overwrite as needed:

  • static/img/admin/payment-edit.png
  • static/img/admin/payment-edit-full.png
  • static/img/admin/settings-payments-bottom.png
  • static/img/admin/settings-payments-full.png
  • static/img/config/settings-payments-full.png
  • static/img/config/settings-taxes-full.png

Acceptance criteria

  • All placeholder reuses replaced.
  • No file under static/img/ is referenced 5+ times from a single page unless it really is the same screen.
  • Stripe / PayPal dashboard screenshots use test mode.
  • Files follow the naming and optimisation rules in the master playbook.

Tracked by: master screenshot audit issue.


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 #66 (Stripe walkthrough) and #67 (PayPal walkthrough), both children of the parallel master at #64. This issue additionally covers manual-payments.md, getting-paid.md, and tax-handling.md which are not yet ticketed under the #64 series — those three are worth keeping (or splitting into their own follow-ups) regardless of whether we close this one.


    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 of #66 (Stripe), #67 (PayPal) and #71 (Settings → Payments tabs).

    The three additional pages this issue surfaced — getting-paid.md, manual-payments.md, tax-handling.md — are not yet covered by existing per-page issues. They have been transferred to the master gap-analysis comment on #64 as candidates for new per-page issues:

    #64 (comment)

    Closing.

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