5ad4de1d2c
Thin WordPress/Woo bridge — RecordGod owns catalog/stock/pricing/shipping; the plugin is a storefront
skin + checkout adapter over /shop:
- storefront: SSR /records (browse) + /release/{id} inside the theme, with title/meta/JSON-LD MusicAlbum
- on-the-fly Woo product: /?rg_add=<sku> mints a hidden WC_Product_Simple from /shop/item (the WowPlatter
trick — 25k catalog, only sold items become Woo products)
- shipping: WC_Shipping_Method quoting /shop/shipping/quote by cart item count (AusPost flat rate)
- orders: order_status_completed -> POST /shop/woo-order (X-Bridge-Key), idempotent, marks SKUs sold
- settings page: base URL + bridge key + store id
Backend: added thumb to /shop/browse + /shop/release so storefront pages have cover art.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
1.9 KiB
1.9 KiB
RecordGod Bridge (WordPress plugin)
Thin successor to WowPlatter. RecordGod owns the catalog, stock, pricing and shipping; this plugin is a
storefront skin + checkout adapter over its /shop API. WordPress/WooCommerce is kept lean — Woo only ever
sees the records people actually buy.
What it does
| Concern | How |
|---|---|
| Storefront (SEO) | class-rg-storefront.php — server-renders /records (browse) and /release/{id} inside the theme, with <title>, meta description, and JSON-LD MusicAlbum/Offer. Pulls /shop/browse + /shop/release. |
| On-the-fly Woo product | class-rg-cart.php — the WowPlatter trick. /?rg_add=<sku> looks the SKU up (wc_get_product_id_by_sku); if absent, mints a hidden WC_Product_Simple from /shop/item (price, image, stock=1) then adds it to the cart. 25k catalog, ~handful of Woo products. |
| Shipping | class-rg-shipping.php — a WC_Shipping_Method that quotes postage from /shop/shipping/quote?units=<cart item count> (AusPost Parcel/Express flat rate, 280g/record). Add it to a Woo shipping zone. |
| Order webhook | class-rg-orders.php — on order_status_completed, POSTs the order back to /shop/woo-order (with X-Bridge-Key). RecordGod marks the SKUs sold + logs the online sale. Idempotent. |
| Settings | Settings → RecordGod Bridge: base URL, bridge key (must match RecordGod's bridge_key secret), store id. |
Install
- Copy
wp-bridge/towp-content/plugins/recordgod-bridge/and activate (flushes rewrite rules). - Settings → RecordGod Bridge: set base URL (
https://recordgod.com) + bridge key. - WooCommerce → Settings → Shipping → add RecordGod Postage to your AU zone.
- Visit
/records. (If pages 404, re-save Permalinks once.)
Not in scope (stays where it is)
- Woo handles payment + transactional emails.
- RecordGod sends its own receipts (
mailer.py) and holds Discogs/import auth — no OAuth in this plugin.