Repository navigation
Description
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→ keepsettings-payment-gateways.pngif it's a full capture of the page; otherwise recapture asstatic/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→ keepsettings-general.pngif 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→ keepsettings-taxes.pngfor 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→ keepproduct-taxes.pngif 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-*.pngandstatic/img/integrations/paypal-*.pngfor 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.pngreferences with cropped captures of the Manual gateway settings panel. - Reduce the three
payments-list.pngreferences to a single legitimate "Payments list" reference; for the other two, capture the actual payment-edit screen (payment-edit.pngalready 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.pngstatic/img/admin/payment-edit-full.pngstatic/img/admin/settings-payments-bottom.pngstatic/img/admin/settings-payments-full.pngstatic/img/config/settings-payments-full.pngstatic/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
superdav42 commentedon May 19, 2026
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.
superdav42 commentedon May 19, 2026
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.
superdav42 commentedon May 19, 2026
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.