docs: dedicated ticket-voucher lookup page under fluent

Move the ticket-voucher API into its own standalone doc
(docs/fluentforms-ticket-vouchers.md) — endpoint, 0/1/2 rules, config, form
snippet, and curl test — so it's easy to find and hand off for the lookup. The
donor-discount doc now links to it instead of duplicating the section.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
Hank 2026-07-10 06:36:39 +00:00
parent 0b4ad1c99f
commit 718d1515b0
2 changed files with 119 additions and 91 deletions

View file

@ -147,94 +147,6 @@ member/donor distinction.
## Ticket-voucher entitlement
Returns how many **free tickets** a donor has earned from their giving, based on
donations **on/after a cutoff date** (default `2025-09-04` — "9/4 last year").
```
GET https://scan.beartariacampgrounds.com/api/public/ticket-vouchers?key=<SECRET>&email=<email>
-> {"vouchers": 0} | {"vouchers": 1} | {"vouchers": 2}
```
**Rules** (donations summed on/after the cutoff):
| Total since cutoff | Vouchers |
|---|---|
| ≥ $1000 | 2 |
| ≥ $400 | 1 |
| otherwise | 0 |
**Config** (backend `.env`):
| Var | Default | Meaning |
|---|---|---|
| `VOUCHER_SINCE` | `2025-09-04` | Only donations on/after this date count. Bump each year. |
| `VOUCHER_TIER1_MIN` | `400` | Dollar total for 1 voucher |
| `VOUCHER_TIER2_MIN` | `1000` | Dollar total for 2 vouchers |
> The count is computed from the **dated transaction tables** (online + offline)
> — the master-list rollups have no dates. Only `Paid` transactions count.
### Form snippet
Displays the voucher count and (optionally) sets a hidden field / caps a
quantity. Same pattern as the discount lookup — paste into a Custom HTML element
and set `KEY`.
```html
<div id="voucher-status" style="margin:6px 0;font-size:14px;font-weight:600;"></div>
<script>
(function () {
var API = "https://scan.beartariacampgrounds.com/api/public/ticket-vouchers";
var KEY = "REPLACE_WITH_PUBLIC_LOOKUP_SECRET";
var EMAIL_SELECTOR = 'input[name="email"]';
var statusEl = document.getElementById("voucher-status");
var last = "";
function show(n) {
if (n > 0) {
statusEl.textContent = "🎟️ You've earned " + n + " free ticket" + (n > 1 ? "s" : "") + "!";
statusEl.style.color = "#1b7f3b";
} else {
statusEl.textContent = "";
}
// Optional: write n into a hidden field named "free_tickets" for conditional
// logic / to cap a quantity. (Uses the native setter so FF's Vue model sees it.)
var el = document.querySelector('input[name="free_tickets"]');
if (el) {
var proto = Object.getOwnPropertyDescriptor(Object.getPrototypeOf(el), "value");
(proto && proto.set ? proto.set : function (v) { el.value = v; }).call(el, String(n));
el.dispatchEvent(new Event("input", { bubbles: true }));
el.dispatchEvent(new Event("change", { bubbles: true }));
}
}
function check(email) {
if (!email || email === last) return;
last = email;
fetch(API + "?key=" + encodeURIComponent(KEY) + "&email=" + encodeURIComponent(email))
.then(function (r) { return r.json(); })
.then(function (d) { show(d && d.vouchers ? d.vouchers : 0); })
.catch(function () { show(0); });
}
function bind() {
var el = document.querySelector(EMAIL_SELECTOR);
if (!el) { return setTimeout(bind, 500); }
el.addEventListener("blur", function () { check(el.value.trim().toLowerCase()); });
}
bind();
})();
</script>
```
### Test
```
curl "https://scan.beartariacampgrounds.com/api/public/ticket-vouchers?key=<SECRET>&email=<a-real-donor-email>"
# -> {"vouchers":2} (>= $1000 since the cutoff)
```
> **Heads-up on the cutoff:** with `VOUCHER_SINCE=2025-09-04`, everyone currently
> returns `0` because the donation data in NocoDB ends **2025-05-22** — there are
> no transactions after the cutoff yet. Adjust `VOUCHER_SINCE` (or wait for new
> donations to sync) so the window matches real giving.
The donor **ticket-voucher lookup** (how many free tickets a donor earned) is a
separate endpoint documented on its own page:
[`fluentforms-ticket-vouchers.md`](./fluentforms-ticket-vouchers.md).