Skip to content

Screenshots: user-guide/configuration — checkout-forms, discount-codes, site-templates, products, registration flow #81

Closed as not planned

Description

@superdav42

Scope

Seven pages under docs/user-guide/configuration/ reuse a small set of screenshots for many different UI steps. Notably:

  • creating-discount-codes.md uses discount-codes-list.png 14 times for 14 different screens.
  • site-templates.md uses 5 different images 16 times combined.
  • checkout-forms.md uses 4 different images 15 times combined.
  • customizing-your-registration-form.md uses 3 images 14 times combined.
  • creating-your-first-subscription-product.md uses 5 images 13 times combined.
  • the-registration-flow.md uses 3 images 9 times combined.
  • auto-search-and-replace-in-site-templates.md uses settings-sites.png twice.

Several of the per-step screenshots already exist as orphans in static/img/config/ (discount-code-edit.png, discount-code-save.png, discount-code-active.png, discount-code-advanced.png, discount-code-description.png, discount-codes-empty.png, site-template-edit.png, site-template-description.png, checkout-form-editor-overview.png, checkout-form-delete.png, …). The first action in most cases is "wire up the existing orphan instead of re-using the list view".

See the master tracking issue for the capture playbook.

Pages

docs/user-guide/configuration/creating-discount-codes.md — 14× discount-codes-list.png

Existing orphans to wire in first (recapture if no longer accurate):

  • discount-codes-empty.png — for the empty-state shown before any codes exist.
  • discount-code-edit.png — for the "edit discount code" overview.
  • discount-code-description.png — for the "Description" field section.
  • discount-code-advanced.png — for the "Advanced Options" section.
  • discount-code-active.png — for the "Active" toggle.
  • discount-code-save.png — for the "Save Discount Code" button.

Then capture the screens for which no file exists yet:

  • Discount codes list with hover actions → keep discount-codes-list.png (one canonical reference, with seed data and the hover-row actions visible).
  • Add Discount Code button → crop of the top-right button on the list. Save as static/img/config/discount-codes-add-button.png.
  • Coupon code field → static/img/config/discount-code-coupon-field.png.
  • Discount percentage or fixed amount setting → static/img/config/discount-code-amount.png.
  • Apply to renewals and setup fee discount options → static/img/config/discount-code-renewals.png.
  • Limit uses setting with uses and max uses fields → static/img/config/discount-code-limit-uses.png.
  • Start and expiration date fields → static/img/config/discount-code-dates.png.
  • Limit products selection toggles → static/img/config/discount-code-limit-products.png.
  • Discount code in the list with edit and delete options → can re-use the list capture if the row hover state is captured cleanly.

The trailing products-list.png reference is legitimate and can stay.

docs/user-guide/configuration/site-templates.md — 16 reuses across 5 images

  • Wire in site-template-edit.png and site-template-description.png orphans where appropriate.
  • Capture missing per-step screenshots for: creating a new template site, the template duplication flow, the template visibility toggles per product, and the customer-facing template picker (frontend).
  • Save new captures under static/img/config/site-template-*.png and static/img/frontend/site-template-picker.png for the frontend view.

docs/user-guide/configuration/checkout-forms.md — 15 reuses

The Checkout Form editor has lots of UI state. The current screenshots loop the same handful.

  • Wire in orphan checkout-form-editor-overview.png for the high-level overview reference.
  • Capture distinct screenshots for: empty form, adding a step, adding a field via the field dialog, configuring a Pricing Table field, configuring a Period Selection field, configuring an Order Summary field, the "Hover actions" UI, the Advanced settings tab, saving, deleting (checkout-form-delete.png orphan exists).
  • New files: static/img/config/checkout-form-<state>.png.

docs/user-guide/configuration/customizing-your-registration-form.md — 14 reuses

Same editor as checkout-forms.md but explained from a different angle. Where the same screen genuinely appears in both files, share the single screenshot file — don't duplicate.

  • Re-use the captures created for checkout-forms.md where they show the same screen.
  • Add new captures for the registration-specific bits (auto-generated fields, link to the registration page, customer landing).

docs/user-guide/configuration/creating-your-first-subscription-product.md — 13 reuses

Walks through product creation tabs: General, Pricing, Site Templates, Themes, Plugins, Post Types, Visits, Disk Space, Custom Domains, Users, Upgrades, Taxes, Customer Role, Image, Sites, Reset Limitations.

  • Capture one screenshot per distinct tab/section of the product editor. Reuse files where the doc references the same tab from different angles. Use the existing product-*.png filenames where they already cover the topic.
  • Orphans to consider: product-hide-credits.png, product-price-variations.png.

docs/user-guide/configuration/the-registration-flow.md — 9 reuses

End-to-end flow: configure checkout form → customer fills it → payment → site spin-up.

  • Capture the frontend registration page (/register) at small, medium, and large pricing-table widths.
  • Capture each step of the checkout from the customer's perspective (fields, payment, success).
  • Save frontend captures under static/img/frontend/.

docs/user-guide/configuration/auto-search-and-replace-in-site-templates.md — 2× settings-sites.png

Small page; replace one of the two with a screenshot of the actual search-and-replace settings row. Save as static/img/config/settings-sites-search-replace.png.

Existing orphan files relevant here

  • static/img/config/checkout-form-delete.png
  • static/img/config/checkout-form-editor-overview.png
  • static/img/config/checkout-frontend-registration.png
  • static/img/config/discount-code-active.png
  • static/img/config/discount-code-advanced.png
  • static/img/config/discount-code-description.png
  • static/img/config/discount-code-edit.png
  • static/img/config/discount-code-save.png
  • static/img/config/discount-codes-empty.png
  • static/img/config/frontend-checkout-pricing-table.png
  • static/img/config/period-selection-field-options.png
  • static/img/config/pricing-table-force-durations.png
  • static/img/config/product-hide-credits.png
  • static/img/config/product-price-variations.png
  • static/img/config/settings-login-registration-full.png
  • static/img/config/settings-membership-full.png
  • static/img/config/settings-membership.png
  • static/img/config/settings-whitelabel-full.png
  • static/img/config/settings-whitelabel.png
  • static/img/config/shortcodes-page.png
  • static/img/config/site-template-description.png
  • static/img/config/site-template-edit.png

Acceptance criteria

  • No image appears more than 3× in any single page unless it really is the same screen.
  • Each existing orphan listed above is either wired in (and accurate) or deleted (if obsolete).
  • New captures follow the master playbook conventions.

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

    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.

  2. superdav42 commented on May 19, 2026

    @superdav42
    ContributorAuthor

    Duplicate of #69 (Product limitation tabs), #72 (Checkout forms), #73 (Customizing registration form) and #77 (Site templates + auto-search-and-replace).

    The additional pages this issue surfaced — creating-discount-codes.md (14 placeholder reuses) and the-registration-flow.md — are not yet covered. They have been transferred to the master gap-analysis comment on #64:

    #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