1. Overview & Quick Links
This procedure outlines how to process, upload, update, and manage local business specials for the Whangaparāoa Treasure Hunt walking trail.
Note: If you are unsure what you are doing, if you've already been working on the site that day, you may wish to do a site backup before starting and that way if you mess up all you need to do is revert to the backup (remember an automatic backup is also completed every 24 hours so no need to panic at any stage!)
2. How the Voucher Claim System Works
The claim system is designed to be exclusive to trail participants, tamper-proof for local businesses, and hands-off for website operators.
- Scan at Checkpoint: Walkers scan the unique QR code on a physical checkpoint sign along the trail.
- Access Rewards Hub: From the checkpoint landing page, clicking "Business Specials" links the walker to the central rewards page. The link includes a URL parameter (e.g.,
?checkpoint=1) that automatically filters Oxygen Builder to show only specials near that specific checkpoint.
- Screenshot Voucher: The walker clicks to unlock their local specials and takes a screenshot of the digital voucher on their phone. Each voucher automatically bakes in:
- Business Logo & Offer Details
- Dynamic "Found On" Date: Generated dynamically in real time when scanned (e.g., Found On: 22 April 2026), proving when they visited the checkpoint.
- In-Store Redemption: Walkers show their screenshot in-store to redeem. Staff simply check that the "Found On" date on the screenshot is within the last 28 days.
3. Procedure: Adding a New Business Special
When a business submits a new offer via the Online Submission Form:
Step 1: Open the Rewards Page in Oxygen Builder
- Log into the WordPress Dashboard.
- Go to Pages > Treasure Hunt Business Specials (or designated rewards page).
- Click Edit with Oxygen.
Step 2: Add or Duplicate the Voucher Container
- In Oxygen’s right-hand Structure Panel, expand the Checkpoint Section corresponding to the business’s area (Checkpoints 1–8) (expand menu from top menu expand icon).
- Select an existing business voucher block/div and click Duplicate
- Move your new block to the page section you want it to appear (check point section).
Step 3: Update Business Information
Update the text and image elements in the newly duplicated block with the form submission details:
- Business Name & Location/Address
- Business Logo Image (upload logo to Media Library and select)
- Special Offer Wording (e.g., "Free regular coffee with any main purchased")
Step 4: Confirm Required Dynamic Elements
Verify that the voucher block includes the dynamic date shortcode:
- Dynamic "Found On" Date Code:
Found On:
Step 5: Check Display Conditions & Save
- Ensure the parent Checkpoint Section has its Oxygen condition set correctly to match the URL parameter:
- Condition:
Dynamic Data > get_trail_checkpoint == [Checkpoint Number]
- Click Save in Oxygen Builder.
Step 6: Notify the Business
Send a confirmation email to the business confirming their special is live, providing their checkpoint preview link, and reminding them how staff verify screenshots using the "Found On" date (28-day window).
4. Procedure: Changing or Updating an Existing Special
When an existing participating business submits a change to their offer:
- Log into WordPress > Pages > Treasure Hunt Business Specials > Edit with Oxygen.
- In the Structure Panel, locate the specific business’s voucher block/div.
- Simply edit the text for the Special Offer Details (or upload a new logo if requested).
- Click Save.
- Send the business a quick confirmation email letting them know the offer text has been updated.
If a business removes a special just delete the block in the structure drop down. Remember there is always an undo button top left of your screen!
5. Maintenance & Support Notes
