================================================================================
ROYAL MACAW - SINGLE PRODUCT TEMPLATE GUIDE (JSON / TXT)
================================================================================

This guide explains how to format product templates (.json or .txt) to upload
rich content for Royal Macaw footwear and apparel products.

FORMAT PRIORITY:
1. .json (First Priority & Recommended)
2. .txt (Plain text format)

--------------------------------------------------------------------------------
1. ACCORDION TABS & CONTENT HIERARCHY
--------------------------------------------------------------------------------
On the Single Product Page, content is organized as follows:

A. SHORT DESCRIPTION (Lead Paragraph):
   - Displays directly below the price and variant selector.
   - Set via "lead" in the template or WooCommerce Short Description.
   - If left empty, nothing is rendered here (no dummy placeholder).

B. MAIN ACCORDION TABS:
   1. Description:
      - Full detailed product description paragraphs.
      - Sourced ONLY from "description" in the template or WooCommerce
        Long Description.
      - Short description is NEVER mixed into this tab.
      - If no long description exists, this accordion remains hidden.

   2. Details:
      - Sourced from "product_details" (label/value pairs) in the template.
      - If not in template, automatically generated from real WooCommerce
        metadata (Brand, Category, SKU, Available EU Sizes, Origin).

   3. Fit & sizing:
      - Sourced from "fit_sizing" in the template.
      - If omitted in template, falls back to storewide default policy set in
        WordPress Plugin -> Single Product Page Content & Policies.

   4. Delivery & payment:
      - Sourced from "delivery_payment" in the template.
      - If omitted, falls back to storewide delivery policy.

   5. Exchanges & returns:
      - Sourced from "exchanges_returns" in the template.
      - If omitted, falls back to storewide 7-day size exchange policy.

   6. Care:
      - Sourced from "care" in the template.
      - If omitted, falls back to storewide footwear care guidelines.

--------------------------------------------------------------------------------
2. JSON TEMPLATE STRUCTURE (.json - RECOMMENDED)
--------------------------------------------------------------------------------
{
  "template_version": 1,
  "lead": "Classic court low silhouette crafted with premium synthetic leather, padded collar, and cushioned cupsole. Checked by hand in Khulna before dispatch.",
  "benefits": [
    "Synthetic leather with clean contrast panels",
    "Padded collar & cushioned insole for all-day comfort",
    "Non-slip flexible rubber cupsole",
    "Hand-inspected in Khulna before dispatch"
  ],
  "description": [
    "The Royal Macaw Court Low is designed for everyday versatility. Built with clean proportions, durable synthetic leather paneling, and tonal stitching, it pairs effortlessly with denim, trousers, or relaxed streetwear.",
    "A cushioned EVA insole absorbs impact on city streets, while the textured rubber outsole ensures dependable grip in wet or dry conditions. Laces are waxed for secure tie-down without fraying.",
    "Every pair is inspected individually by hand in Khulna to ensure stitch alignment, sole bond integrity, and flawless finish before heading to your doorstep."
  ],
  "product_details": [
    { "label": "Upper", "value": "Premium synthetic leather with contrast overlay" },
    { "label": "Sole", "value": "Non-slip flexible rubber cupsole" },
    { "label": "Insole", "value": "Cushioned EVA foam with arch support" },
    { "label": "Closure", "value": "Lace-up with waxed cotton laces" },
    { "label": "Origin", "value": "Hand-inspected in Khulna, Bangladesh" }
  ],
  "fit_sizing": [
    "Runs true to size. Leather softens within a few days of wear for a comfortable personalized fit.",
    "If you have wider feet or fall between two EU sizes, order one size up.",
    "Refer to our size guide for exact centimetre foot measurements."
  ],
  "delivery_payment": [
    "Inside Dhaka 24–48 hours (৳80), outside Dhaka 2–3 days (৳130). Free delivery on orders over ৳3,000.",
    "Cash on delivery nationwide — pay the rider after checking. bKash, Nagad, and cards are also accepted.",
    "You may open the parcel and inspect the pair in front of the delivery rider before completing payment."
  ],
  "exchanges_returns": [
    "7-day free size exchange nationwide. The rider brings the replacement pair and collects the original in the same trip.",
    "Shoes must be unworn with original box, tissue, and tags intact.",
    "If an item arrives damaged or incorrect, we replace it immediately or issue a full refund."
  ],
  "care": [
    "Wipe clean with a damp microfiber cloth and let air-dry away from direct sunlight or heaters.",
    "Do not machine wash or submerge in water — machine washing weakens the sole adhesive.",
    "Store with laces loosened to preserve the upper's shape."
  ],
  "product": {
    "name": "Retro Court Low Sneakers",
    "regular_price": 2850,
    "sale_price": 2450,
    "brand": "Royal Macaw",
    "category": ["Sneakers", "Men"]
  }
}

--------------------------------------------------------------------------------
3. TXT TEMPLATE STRUCTURE (.txt)
--------------------------------------------------------------------------------
@product
name :: Retro Court Low Sneakers
regular_price :: 2850
sale_price :: 2450
brand :: Royal Macaw
category :: Sneakers, Men

@lead
Classic court low silhouette crafted with premium synthetic leather, padded collar, and cushioned cupsole. Checked by hand in Khulna before dispatch.

@benefits
- Synthetic leather with clean contrast panels
- Padded collar & cushioned insole for all-day comfort
- Non-slip flexible rubber cupsole
- Hand-inspected in Khulna before dispatch

@description
The Royal Macaw Court Low is designed for everyday versatility. Built with clean proportions, durable synthetic leather paneling, and tonal stitching, it pairs effortlessly with denim, trousers, or relaxed streetwear.

A cushioned EVA insole absorbs impact on city streets, while the textured rubber outsole ensures dependable grip in wet or dry conditions. Laces are waxed for secure tie-down without fraying.

Every pair is inspected individually by hand in Khulna to ensure stitch alignment, sole bond integrity, and flawless finish before heading to your doorstep.

@product_details
Upper :: Premium synthetic leather with contrast overlay
Sole :: Non-slip flexible rubber cupsole
Insole :: Cushioned EVA foam with arch support
Closure :: Lace-up with waxed cotton laces
Origin :: Hand-inspected in Khulna, Bangladesh

@fit_sizing
Runs true to size. Leather softens within a few days of wear for a comfortable personalized fit.
If you have wider feet or fall between two EU sizes, order one size up.
Refer to our size guide for exact centimetre foot measurements.

@delivery_payment
Inside Dhaka 24–48 hours (৳80), outside Dhaka 2–3 days (৳130). Free delivery on orders over ৳3,000.
Cash on delivery nationwide — pay the rider after checking. bKash, Nagad, and cards are also accepted.
You may open the parcel and inspect the pair in front of the delivery rider before completing payment.

@exchanges_returns
7-day free size exchange nationwide. The rider brings the replacement pair and collects the original in the same trip.
Shoes must be unworn with original box, tissue, and tags intact.
If an item arrives damaged or incorrect, we replace it immediately or issue a full refund.

@care
Wipe clean with a damp microfiber cloth and let air-dry away from direct sunlight or heaters.
Do not machine wash or submerge in water — machine washing weakens the sole adhesive.
Store with laces loosened to preserve the upper's shape.
================================================================================
