Skip to content

Screenshots: Creating discount codes (14 placeholders + 6 orphans to wire) #89

@superdav42

Description

@superdav42

For #64.

Problem

docs/user-guide/configuration/creating-discount-codes.md references 14 distinct concepts but every image points to /img/config/discount-codes-list.png — including the very first one which is just ![](...) with no alt text. The doc walks through hover actions, the add button, the edit page, every field on the edit form, advanced options, and the saved code row — none of which is shown by the single list view used everywhere.

docs/user-guide/configuration/creating-discount-codes.md
  L16 ![](/img/config/discount-codes-list.png)
  L22 ![Discount codes list with hover actions](/img/config/discount-codes-list.png)
  L24 ![Add Discount Code button](/img/config/discount-codes-list.png)
  L28 ![Discount code edit page](/img/config/discount-codes-list.png)
  L36 ![Discount code name and description fields](/img/config/discount-codes-list.png)
  L40 ![Coupon code field](/img/config/discount-codes-list.png)
  L44 ![Discount percentage or fixed amount setting](/img/config/discount-codes-list.png)
  L50 ![Apply to renewals and setup fee discount options](/img/config/discount-codes-list.png)
  L54 ![Active toggle for discount code](/img/config/discount-codes-list.png)
  L64 ![Limit uses setting with uses and max uses fields](/img/config/discount-codes-list.png)
  L66 ![Start and expiration date fields](/img/config/discount-codes-list.png)
  L70 ![Limit products selection toggles](/img/config/discount-codes-list.png)
  L74 ![Save Discount Code button](/img/config/discount-codes-list.png)
  L78 ![Discount code in the list with edit and delete options](/img/config/discount-codes-list.png)
  L90 ![Product page with shareable link button](/img/config/products-list.png)  ← correct image, unrelated to the placeholder problem

L64 also has a markdown collision: the image and the following paragraph share a single line. Fix the markdown while updating the image path.

Orphan files already on disk

The following files exist in static/img/config/ but no doc references them. They look like the right per-step screenshots for this page — verify accuracy and wire in before re-capturing:

  • discount-codes-empty.png
  • discount-code-edit.png
  • discount-code-description.png
  • discount-code-active.png
  • discount-code-advanced.png
  • discount-code-save.png

If any are stale, overwrite them with fresh captures using the same filenames so the markdown only needs editing once.

Captures required

Setup: create at least one percentage code, one fixed-amount code, and one expired code so the list view shows variety.

# Doc line Capture target New filename
1 L16 Empty-state Discount Codes page (before any codes exist) — use the orphan discount-codes-empty.png static/img/config/discount-codes-empty.png
2 L22 Populated Discount Codes list with row hover actions visible static/img/config/discount-codes-list.png (replace existing if stale)
3 L24 Add Discount Code button highlighted (top-right of list) static/img/config/discount-codes-add-button.png
4 L28 Discount code edit page (full overview) — use the orphan discount-code-edit.png static/img/config/discount-code-edit.png
5 L36 Enter Discount Code + Description fields, cropped — use the orphan discount-code-description.png static/img/config/discount-code-description.png
6 L40 Coupon code field, cropped static/img/config/discount-code-coupon-field.png
7 L44 Discount field with percentage/fixed-amount toggle static/img/config/discount-code-amount.png
8 L50 Apply to renewals + Setup fee discount toggles static/img/config/discount-code-renewals.png
9 L54 Active toggle row — use the orphan discount-code-active.png static/img/config/discount-code-active.png
10 L64 Advanced Options with Uses + Max uses fields — use the orphan discount-code-advanced.png static/img/config/discount-code-advanced.png
11 L66 Start date + Expiration date fields static/img/config/discount-code-dates.png
12 L70 Limit products section with per-product toggles static/img/config/discount-code-limit-products.png
13 L74 Save Discount Code button — use the orphan discount-code-save.png static/img/config/discount-code-save.png
14 L78 Saved discount code row in list with Edit + Delete hover actions reuse the populated discount-codes-list.png

L90 already references the correct products-list.png — leave it.

Capture at 1280×800, crop to the relevant field/section. < 200 KB.

Doc edit

Update every replaced line in docs/user-guide/configuration/creating-discount-codes.md, fix the markdown collision on L64, add alt text to L16, and refine the other alt texts.

Done when

  • All 6 orphans verified and either wired in or recaptured.
  • All new PNGs added.
  • docs/user-guide/configuration/creating-discount-codes.md updated, L16 has alt text, L64 markdown fixed.
  • PR opened with Resolves for this issue and Ref #64.

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationhelp wantedExtra attention is needed

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions