auto-save: 2026-07-21T17:38:50 (1 files) — deploy-faqs-bymaterial.py

e415f0e6fb28a59e65c4700bd9923fe980768680 · 2026-07-21 17:38:50 -0700 · Steve Abrams
Files touched

A deploy-faqs-bymaterial.py
Diff

commit e415f0e6fb28a59e65c4700bd9923fe980768680
Author: Steve Abrams <steve@designerwallcoverings.com>
Date:   Tue Jul 21 17:38:50 2026 -0700

    auto-save: 2026-07-21T17:38:50 (1 files) — deploy-faqs-bymaterial.py
---
 deploy-faqs-bymaterial.py | 142 ++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 142 insertions(+)

diff --git a/deploy-faqs-bymaterial.py b/deploy-faqs-bymaterial.py
new file mode 100644
index 0000000..f636124
--- /dev/null
+++ b/deploy-faqs-bymaterial.py
@@ -0,0 +1,142 @@
+#!/usr/bin/env python3
+"""
+deploy-faqs-bymaterial.py — set a grounded custom.faq metafield on EVERY category
+collection that has a real description, by matching the collection to a material FAQ
+(grasscloth/faux-leather/velvet/cork/silk/suede/metallic/linen/vinyl/mural). The live
+theme renders it as a collapsed "Learn about…" panel + FAQPage schema.
+Private-label safe. Idempotent (skips a collection that already has custom.faq unless --force).
+Run:  ! python3 ~/Projects/secrets-manager/deploy-faqs-bymaterial.py            # dry-run
+      ! python3 ~/Projects/secrets-manager/deploy-faqs-bymaterial.py --apply
+"""
+import re, json, sys, urllib.request
+
+APPLY = '--apply' in sys.argv; FORCE = '--force' in sys.argv
+env = open('/Users/macstudio3/Projects/secrets-manager/.env').read()
+tok = re.search(r'^SHOPIFY_CONTENT_TOKEN=(.+)$', env, re.M).group(1).strip().strip('"').strip("'")
+S = "designer-laboratory-sandbox.myshopify.com"; A = "2024-10"
+def api(p, method="GET", body=None):
+    data = json.dumps(body).encode() if body else None
+    r = urllib.request.Request(f"https://{S}/admin/api/{A}/{p}", data=data, method=method,
+        headers={"X-Shopify-Access-Token": tok, "Content-Type": "application/json"})
+    return json.load(urllib.request.urlopen(r, timeout=30))
+Q = lambda q, a: {"q": q, "a": a}
+
+M = {
+ "grasscloth": [
+  Q("What is grasscloth wallcovering?", "Grasscloth is a natural-fiber wallcovering handwoven from grasses, jute, hemp, sisal and similar sustainable fibers, adding depth and tactile richness paint cannot replicate."),
+  Q("What rooms suit grasscloth?", "It shines as a feature or accent wall in dining rooms, bedrooms, studies and entries. In high-moisture or high-scrub areas, use it as a feature wall or choose a coated natural."),
+  Q("Does grasscloth have color and seam variation?", "Yes — woven from real plant fibers, subtle shading and visible seams between panels are inherent and part of its handcrafted appeal. Order all yardage from one dye lot."),
+  Q("Can I order grasscloth samples first?", "Yes. Designer Wallcoverings offers complimentary samples for the trade so you can check the weave and colorway in your own light before ordering."),
+ ],
+ "faux-leather": [
+  Q("What is faux leather wallcovering?", "A vinyl wallcovering engineered to mimic genuine leather — cruelty-free, more sustainable, and far more durable than the real hide."),
+  Q("Is it good for high-traffic or commercial spaces?", "Yes. Its enhanced durability suits high-traffic and commercial interiors while keeping a luxurious leather appearance."),
+  Q("How do you clean faux leather wallcovering?", "The vinyl surface wipes clean with a damp cloth, part of why it performs so well in busy residential and commercial spaces."),
+  Q("Can I order samples before buying?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can compare grain and color in your space."),
+ ],
+ "velvet": [
+  Q("What is flocked velvet wallcovering?", "Flock was created to imitate cut-velvet hangings — fibers applied to an adhesive ground form a raised, velvet-like texture, today using synthetic pile such as polyester or rayon."),
+  Q("What look does it create?", "A tactile, dimensional, luxurious surface ideal for formal rooms and dramatic feature walls where you want depth and richness."),
+  Q("How do you care for flocked wallcovering?", "Treat the pile gently — dust lightly and avoid abrasion so the raised velvet texture stays crisp."),
+  Q("Can I order samples?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can feel the pile and see the colorway first."),
+ ],
+ "cork": [
+  Q("What is cork wallcovering?", "Cork wallcovering is made from the bark of the cork oak tree, offering a warm, earthy texture with natural variation that makes every panel distinctive."),
+  Q("Is cork wallcovering sustainable?", "Yes — cork is harvested from the tree's bark without cutting it down, making it a renewable, eco-friendly surface."),
+  Q("What rooms suit cork?", "Cork works beautifully as a feature wall in studies, offices, bedrooms and living spaces, and its structure also helps soften sound."),
+  Q("Can I order cork samples first?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can see the natural texture and tone in your own light."),
+ ],
+ "silk": [
+  Q("What is faux silk wallcovering?", "Faux silk captures the soft luster and refined drape of real silk in a more durable, easier-care material — the elegance without the fragility."),
+  Q("What look does it create?", "A gentle sheen and quiet luxury suited to bedrooms, dining rooms and formal living spaces where you want a soft, light-catching backdrop."),
+  Q("Is faux silk more durable than real silk?", "Yes — it resists the wear and delicacy of genuine silk while keeping the same lustrous appearance."),
+  Q("Can I order samples before buying?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can check the sheen and color against your furnishings."),
+ ],
+ "suede": [
+  Q("What is suede wallcovering?", "A premium microfiber suede wallcovering with the soft, tactile look of real suede in a durable, cleanable material engineered for walls."),
+  Q("Where is it used?", "It creates a luxurious, upholstered-look feature wall in residential and commercial interiors — a rich surface that reads far more expensive than paint."),
+  Q("How do you care for it?", "As a microfiber it is more durable and cleanable than natural suede, holding its soft nap in everyday interiors."),
+  Q("Can I order samples first?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can feel the texture and check the colorway."),
+ ],
+ "metallic": [
+  Q("What is metallic wallcovering?", "A wallcovering with a reflective metallic finish that catches and changes with the light, often on a durable vinyl ground."),
+  Q("What rooms suit metallic wallcovering?", "It makes a striking feature wall in powder rooms, dining rooms, entries and commercial spaces where the reflective sheen adds depth and drama."),
+  Q("Is it durable and cleanable?", "On a vinyl ground it is scrubbable and hard-wearing, suited to both residential feature walls and high-traffic commercial interiors."),
+  Q("Can I order samples?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can see how the finish reads in your lighting."),
+ ],
+ "linen": [
+  Q("What is linen wallcovering?", "A textile wallcovering woven from linen fibers, bringing a soft, natural weave and understated elegance with a tailored, organic texture."),
+  Q("What rooms suit linen wallcovering?", "It suits bedrooms, studies, dining rooms and living spaces where you want warmth and refinement without a bold pattern."),
+  Q("Does linen have natural variation?", "Yes — as a natural woven textile, subtle slubs and shading are part of its character; order all yardage from one run."),
+  Q("Can I order samples first?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can feel the weave and check the tone in your space."),
+ ],
+ "vinyl": [
+  Q("What is vinyl wallcovering?", "A durable, wipeable wallcovering engineered for performance — the go-to for high-traffic residential and commercial interiors."),
+  Q("Is vinyl good for commercial spaces?", "Yes — Type II vinyl is scrubbable and hard-wearing, standing up to high-traffic corridors, hospitality and healthcare environments."),
+  Q("How do you clean vinyl wallcovering?", "It wipes clean with a damp cloth, which is why it performs so well where durability and maintenance matter."),
+  Q("Can I order samples before buying?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can confirm the texture and color in your space."),
+ ],
+ "mural": [
+  Q("What is a wallcovering mural?", "A large-scale, panelized design printed to cover a wall as a single continuous scene or pattern — made to order to your wall's dimensions."),
+  Q("Are murals made to order?", "Yes — murals are produced to your wall size, so accurate measurements are important before ordering."),
+  Q("Where do murals work best?", "As a statement feature wall in entries, dining rooms, bedrooms and commercial lobbies where you want an immersive, room-defining scene."),
+  Q("Can I order a sample first?", "Yes. Designer Wallcoverings offers complimentary trade samples so you can check color and print quality before committing to a full mural."),
+ ],
+}
+# match order: specific -> general
+MATCH = [
+ ("faux-leather", r'faux.?leather|leather'),
+ ("velvet",       r'flock|velvet'),
+ ("suede",        r'suede'),
+ ("cork",         r'\bcork'),
+ ("silk",         r'silk'),
+ ("metallic",     r'metallic|mylar|foil'),
+ ("linen",        r'linen'),
+ ("mural",        r'mural'),
+ ("grasscloth",   r'grasscloth|sisal|jute|hemp|raffia|\bnatural'),
+ ("vinyl",        r'vinyl'),
+]
+
+cols = []
+for kind in ("custom_collections", "smart_collections"):
+    since = 0
+    while True:
+        d = api(f"{kind}.json?limit=250&since_id={since}&fields=id,handle,title,body_html")[kind]
+        if not d: break
+        for c in d:
+            body = re.sub(r'<[^>]+>', '', c.get('body_html') or '').strip()
+            cols.append({"id": c['id'], "h": c['handle'], "t": c['title'], "blen": len(body)})
+        since = d[-1]['id']
+
+plan = []
+for c in cols:
+    if c['blen'] < 50: continue          # skip bare grids (no description to pair with)
+    hay = (c['h'] + ' ' + c['t']).lower()
+    mat = next((m for m, rx in MATCH if re.search(rx, hay)), None)
+    if mat: plan.append((c, mat))
+
+print(f"{len(plan)} category collections matched a material (of {len(cols)} total):")
+from collections import Counter
+print("  by material:", dict(Counter(m for _, m in plan)))
+
+changed = skipped = 0
+for c, mat in plan:
+    if not APPLY:
+        continue
+    existing = api(f"collections/{c['id']}/metafields.json?namespace=custom&key=faq")['metafields']
+    if existing and not FORCE:
+        skipped += 1; continue
+    body = {"metafield": {"namespace": "custom", "key": "faq", "type": "json",
+                          "value": json.dumps(M[mat], ensure_ascii=False)}}
+    res = api(f"collections/{c['id']}/metafields.json", "POST", body)
+    if 'metafield' in res: changed += 1
+    else: print(f"  FAIL {c['h']}: {json.dumps(res)[:120]}")
+
+if not APPLY:
+    print("\nDRY-RUN — sample of what would be set:")
+    for c, mat in plan[:20]:
+        print(f"  {mat:12} <- {c['h']}")
+    print(f"\n(+{max(0,len(plan)-20)} more)   re-run with --apply")
+else:
+    print(f"\nAPPLIED — set={changed} skipped(existing)={skipped} of {len(plan)} matched")
+    print("Verify: https://designerwallcoverings.com/collections/grasscloth-wallpaper-collection")
← 1b7fdd1 auto-save: 2026-07-21T17:08:42 (5 files) — deploy-collection · back to Secrets Manager · auto-save: 2026-07-21T18:09:04 (3 files) — hero-image-fallba 3d0b1df →