`docs/SHOPIFY-DIGITAL-DOWNLOADS-APP.md`

53 lines
# Shopify Digital Downloads app — delivery setup (chosen path, 2026-05-29)

**Decision (DTD 2026-05-29):** deliver the 3 wallco.ai mini-pack bundles via Shopify's
native **Digital Downloads** app instead of the wallco.ai webhook + token system.

**Why this over the webhook:** the app auto-delivers a download link on the order
confirmation page AND in the confirmation email — zero per-order work, Shopify handles
re-download links and download limits. The `orders/paid` webhook handler + token DB
become **redundant** for these bundles (keep them dormant as a fallback; don't delete).

**Hard limitation:** the Digital Downloads app has **no Admin API**. Attaching a file
to a product is UI-only. This whole doc is therefore a manual Shopify-admin runbook —
nothing here can be scripted.

## Files staged for you

`~/Desktop/wallco-shopify-downloads/` — drag-drop these into the app:

| Upload this file                 | …to this product                                                              |
|----------------------------------|-------------------------------------------------------------------------------|
| `Cactus-2-Pack.zip` (5.3 MB)     | `cactus-2-pack-seamless-wallpaper-bundle-mini-pack-digital-download`           |
| `Designer-Zoo-Calm-2-Pack.zip` (3.1 MB) | `designer-zoo-calm-2-pack-seamless-wallpaper-bundle-mini-pack-digital-download` |
| `Drunk-Monkeys-V2-1-Pack.zip` (7.3 MB)  | `drunk-monkeys-v2-1-pack-seamless-wallpaper-bundle-mini-pack-digital-download`  |

Each ZIP = `<id>_source_1024.png` + `<id>_print_3600.png` per design + `cover_grid.png` + `README.txt`. Verified intact.

## Steps (~5 min, all in Shopify admin for the designerwallcoverings.com store)

1. **Install the app** (if not already): Shopify admin → **Apps** → search **"Digital Downloads"**
   (Shopify-built, free) → Install. If it's already installed it shows under Apps.

2. **Open Digital Downloads** → it lists products. Click **"Add file"** / select a product.

3. For each of the 3 products above:
   - Find the product (search by handle/title).
   - Upload the matching ZIP from `~/Desktop/wallco-shopify-downloads/`.
   - Confirm the variant is marked **"This is a digital product or service"** so no
     shipping is requested at checkout. (The app sets the digital flag when you attach a file.)

4. **Test:** place a $0/test order on one bundle (or use a Bogus Gateway / draft order
   marked paid) → confirm the **download link appears on the order-status page** and in
   the **order confirmation email**.

## After it works

- The wallco.ai `orders/paid` webhook + `wallco_download_tokens` system are no longer the
  delivery path for these 3 bundles. Leave the code in place (dormant fallback); no need
  to register the webhook in Shopify after all.
- The `wallco_ai.bundle_download_url` / `bundle_download_file_id` metafields set by
  `attach-shopify-bundle-files.js` are also redundant for delivery now — harmless to keep.
- New future bundles: re-run `attach-shopify-bundle-files.js` only if you want the ZIP
  hosted on Shopify's CDN; for delivery, just attach the same ZIP in the Digital Downloads app.