# Pinery — WordPress Theme & Plugins for Amazon Affiliate Sites

> The Pinery Suite combines a masonry-grid WordPress theme (Pinery), an AI-powered content pipeline for Amazon.com US marketplace affiliates (Pinery Flow), and a static-export-to-Cloudflare-Pages plugin (Pinery Static). Auto-scrape best sellers, generate product lifestyle images, publish SEO-optimized posts automatically — then ship the whole site to the global edge.

## Quick Info

- **Product**: WordPress Theme + 2 Plugins (Pinery Flow, Pinery Static)
- **Version**: Theme 1.7.0 · Flow 1.6.4 · Static 0.2.1
- **License**: GPL-2.0+
- **Pricing**: Theme free / Pinery Flow freemium — Free plan (manual runs, 2 categories, 3 products/run, blog posts) or Pro $49 one-time (scheduled auto-runs, unlimited volume, WooCommerce publishing, buyer FAQ schema, live prices; Freemius-licensed, 1 site per license) / Pinery Static freemium — Free (unlimited export/deploy) or Pro $299 one-time
- **Marketplace**: Amazon.com US (Amazon Associates)
- **AI Providers**: xAI (Grok), OpenAI (GPT/DALL·E), Google Gemini
- **Demo**: https://demo.pinery.pro
- **Contact**: hello@pinery.pro
- **GitHub**: https://github.com/liuciming/pinery-theme

## English Pages

- [Home (EN)](https://www.pinery.pro/en/): Full landing page — hero, 12 feature cards, pricing cards, demo preview, FAQ accordion, CTA
- [Sitemap](https://www.pinery.pro/sitemap.xml): XML sitemap with 4 language variants and hreflang annotations
- [Robots.txt](https://www.pinery.pro/robots.txt): Welcomes all crawlers including AI bots
- [Theme Download](https://www.pinery.pro/downloads/pinery-theme-1.7.0.zip): Free theme ZIP (GPL-2.0+)
- [Plugin Purchase](https://checkout.freemius.com/plugin/32097/plan/52640/): Freemius checkout for Pinery Flow

## Localized Pages

- [繁體中文 (zh-TW)](https://www.pinery.pro/zh-TW/)
- [日本語 (ja)](https://www.pinery.pro/ja/)
- [한국어 (ko)](https://www.pinery.pro/ko/)

## About the Theme

A lightweight, image-led WordPress theme with:
- WooCommerce storefront support: shop, product and category pages render inside the theme layout; product cards styled to match, gallery zoom/lightbox/slider enabled, Shop link auto-added to the nav, mobile-safe product grid
- Accessibility built in: skip-to-content link, visible keyboard focus, underlined content links, screen-reader-friendly markup (WordPress.org review standard)
- Privacy/GDPR-friendly: Jost and Cormorant Garamond fonts bundled locally — zero external font requests
- Pinterest-style masonry grid (3 layout modes: Masonry, Grid, Mixed)
- Lightbox image preview with vertical swipe navigation
- Live WordPress Customizer (colors, Google Fonts, column counts)
- AdSense-ready ad zones (3 strategic placements)
- Infinite scroll homepage (IntersectionObserver, 10 posts/batch)
- Amazon Associates tag auto-append via `pinery_affiliate_default_tag`
- `rel="sponsored nofollow"` auto-added to all Amazon links
- Responsive (4K desktop → 320px mobile), RTL-ready, editor styles bundled
- Amazon product images hotlinked (never stored in media library)

## About the Plugin (Pinery Flow)

An AI-powered affiliate content automation plugin:
- Scrapes Amazon Best Sellers per browse-node category (30 products per category)
- Generates lifestyle product images via xAI Grok / OpenAI DALL·E / Google Gemini Imagen
- Writes SEO-optimized product copy using GPT / Grok / Gemini text models
- Auto-publishes WordPress posts with affiliate links, JSON-LD Product schema, and meta tags
- Amazon Creators API integration (OAuth 2.0, lowerCamelCase, `creatorsapi.amazon`) with auto-fallback to HTML scraping
- Category diversity scheduling (round-robin across selected departments)
- Real-time price refresh (hourly cron + frontend AJAX)
- Ad zone and price overlay rendering (delegated from theme via function_exists)

## Available Departments (41 categories, hundreds of subcategories)

Clothing Shoes & Jewelry, Beauty & Personal Care, Home & Kitchen, Electronics, Sports & Outdoors, Toys & Games, Pet Supplies, Baby Products, Office Products, Automotive, Tools & Home Improvement, Patio Lawn & Garden, Health & Household, Grocery & Gourmet Food, Kitchen & Dining, Books, Movies & TV, Music, Video Games, Software, Kindle Store, Industrial & Scientific, Arts Crafts & Sewing, Musical Instruments, Cell Phones & Accessories, Camera & Photo, Computers & Accessories, TV & Video, Portable Audio, Car Electronics, GPS & Navigation, Home Audio & Theater, Wearable Technology, Security & Surveillance, Office Electronics, Marine Electronics, Video Projectors, eBook Readers, Service Plans, Amazon Devices, Collectible Coins

## About the Plugin (Pinery Static) — Early Access

A static-export plugin that publishes the WordPress site to Cloudflare Pages:
- One-click crawl of the whole site into a static HTML build, deployed via Cloudflare Pages Direct Upload
- Pure PHP implementation (including a pure-PHP BLAKE3 hasher) — no Node, no wrangler, works on shared hosting
- Incremental exports: only changed pages are re-crawled; auto-deploy on publish (debounced WP-Cron)
- Dynamic features preserved on the static site: comments, search, and contact forms proxy back to WordPress via REST
- WooCommerce-aware: live prices, stock, and add-to-cart hydrate from the Store API on static pages; external/affiliate products link through untouched
- SEO preserved: canonical/og:url rewriting, sitemap.xml + robots.txt generated on every deploy, FAQPage/Product JSON-LD carried over
- Seamless same-domain migration via a bundled Cloudflare Worker router (dynamic paths → WordPress origin, everything else → Pages)
- Live example: https://demo-pinery.pages.dev (the static export of demo.pinery.pro)
- Pricing: Free plan (unlimited static export & deploy, incremental, SEO files) or Pro $299 one-time per site (auto-deploy on publish, comments/search/contact proxies, WooCommerce live prices, seamless-domain migration, one-click rollback)
- Free download: https://www.pinery.pro/downloads/pinery-static-free-0.2.1.zip

## Technical Architecture

The plugin (`pinery-flow`) uses a decoupled pipeline:
1. `resolve_categories()` → maps user-selected Amazon departments to browse-node URLs
2. `scrape_category()` → HTTP GET best-seller pages, regex-split `p13n-sc-uncoverable-faceout` cards, extract ASIN/title/price/rating/image/link (falls back to Creators API when available)
3. `filter_new()` → deduplicate against `pinery_flow_published_products` option by first-40-chars-of-title signature
4. `select_diverse()` → round-robin selection across categories for diversity
5. `process_product()` → generate copy (chat_completion) → generate image (img2img then text2img fallback) → build affiliate link → create post
6. `publish_to_pinterest()` → POST to `api.pinterest.com/v5/pins` (OAuth 2.0 Bearer token, Standard access required)
7. `refresh_published_prices()` → hourly cron, batches of 10 ASINs via Creators API GetItems

The theme is a pure presentation layer. All data logic (ad zones, price overlays, affiliate metabox) lives in the plugin. Theme calls plugin functions via `function_exists` guards and degrades gracefully without the plugin.