STRYD Assistant

Requires WordPress: 6.0+ Requires PHP: 8.0+ Requires WooCommerce: 7.0+

What is STRYD Assistant?

STRYD Assistant is a custom WordPress plugin built exclusively for the STRYD GH storefront. It turns the WooCommerce product management workflow into a fully AI-powered system — generating product names, SEO descriptions, tags, and pricing suggestions from a single product image, while also handling Telegram order notifications, stock alerts, performance tracking, and headless frontend routing.

Features

Installation

1. Download the plugin zip file
2. Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Upload the zip → click Install Now → click Activate
4. The STRYD menu item appears in the left sidebar

Setup Checklist

1. Claude API Key (required for all AI features)

1. Go to console.anthropic.com/api-keys
2. Create a new API key
3. In WordPress: STRYD → AI Settings → Claude API Key → paste your key → Save
4. Add credits at console.anthropic.com/billing — $5 lasts ~2,500 sessions

2. Telegram Notifications

1. Open Telegram → search @BotFather → send /newbot → follow prompts
2. Copy the bot token BotFather gives you
3. Message your new bot (so it can message you back)
4. Get your Chat ID: visit https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates after messaging the bot
5. In WordPress: STRYD → Telegram → paste token + chat ID → enable → Save → Send Test Message

3. Headless Redirect

1. Go to STRYD → AI Settings → Frontend Redirect
2. Set your frontend URL (e.g. https://strydgh.com)
3. Save — all public visitor requests to the WordPress backend are now silently redirected

4. Login Page Customizer (optional)

1. Go to STRYD → AI Settings → Login Page Customizer
2. Toggle on → Save
3. Visit yoursite.com/wp-login.php to see the branded login page

Usage

Single Product Generation

1. Open any product in WooCommerce (Products → Add New or Edit)
2. Upload the product image as the Featured Image (top right panel)
3. Click ✦ Generate with STRYD AI below the product title
4. Wait 3–5 seconds
5. Click a name suggestion to apply it to the title
6. Click Apply buttons to push descriptions to their fields
7. Click Fill Tag Field to populate tags — then press the WooCommerce Add button

Bulk Mode

1. Go to STRYD → Bulk Mode
2. Drag and drop up to 20 product images into the upload zone
3. Click ✦ Generate for All
4. Each image is processed in parallel — results appear as they complete
5. Click any name or text block to copy it

SEO Audit

1. Go to STRYD → SEO Audit
2. Click 🔍 Run SEO Audit Now
3. Red = error (blocks visibility) — fix these first
4. Amber = warning (improvements worth making)
5. Click Edit → on any product to fix it directly

Restock Alert

1. Set your threshold in STRYD → AI Settings → Restock Alert Threshold (e.g. 3 units)
2. Go to STRYD → Restock Alert
3. Low stock products load automatically
4. Click 📲 Send Telegram Restock Alert to message yourself a shopping list

Pricing Suggester

1. Go to STRYD → Pricing
2. Drop a product image into the upload zone
3. Click ✦ Suggest Price
4. AI returns a GHS price range, recommended price, STRYD tier, and reasoning

STRYD Naming System

The AI follows STRYD's naming convention for all suggestions.

Tier 1 — Resold brands (Nike, Adidas, Gucci, etc.)

The [Name]
The [Name] — [Colourway]

• Name: One capitalised word naming the feeling or energy, never the feature
• Colourway: Evocative single word (Onyx not Black, Terrain not Green, Chalk not White)
• Example: The Shadow — Onyx, The Luxe — Ocean, The Classic

Tier 2 — STRYD Originals (future)

STRYD Model [Number] — [Colourway]

• Example: STRYD Model 01 — Forest, STRYD Model 02 — Chalk

The golden rule: Name the feeling, not the feature.

File Structure

stryd-assistant/
├── stryd-naming-assistant.php      ← Main plugin file (admin UI, AJAX handlers)
├── includes/
│   ├── naming-history.php          ← Name history storage and retrieval
│   ├── whatsapp.php                ← Telegram notification logic (kept as whatsapp.php for compatibility)
│   ├── performance.php             ← WooCommerce sales data queries
│   ├── headless.php                ← Frontend redirect / headless mode
│   └── login-customizer.php       ← wp-login.php branding
├── assets/
│   ├── admin.css                   ← Dashboard styles (light + dark mode)
│   ├── admin.js                    ← Dashboard interactivity
│   ├── product.css                 ← Product page button styles
│   ├── product-assistant.js        ← Product page AI generation logic
│   ├── stryd.svg                   ← STRYD wordmark logo
│   ├── stryd-favicon.svg           ← Admin menu icon
│   └── stryd-loader.svg            ← Animated loading spinner (pulsing S)
└── README.md                       ← This file

Database / Storage

The plugin stores everything in the WordPress database using standard options and user meta — no custom tables.

AI Models

Switch model in STRYD → AI Settings → AI Model.

Cost Reference

At Haiku 4.5 pricing:

WooCommerce Order Number Format

STRYD uses custom order numbers configured separately via functions.php:

add_filter('woocommerce_order_number', function($order_id) {
    return 'STRYD-' . str_pad($order_id, 3, '0', STR_PAD_LEFT);
}, 1, 1);

This is not part of the plugin — it lives in the theme's functions.php.

Headless Mode Notes

The plugin redirects all public WordPress requests to your Vercel frontend using a 307 temporary redirect. The following are never redirected (bypassed automatically):

• /wp-admin/ — admin panel
• /wp-json/ — REST API (used by the Vercel frontend to fetch products)
• /wp-login.php — login page
• /wc-api/ — WooCommerce webhooks
• /?wc-ajax= — WooCommerce AJAX (cart, checkout)
• WordPress cron and REST requests

Telegram Integration Notes

• The includes/whatsapp.php filename is kept for code compatibility — it handles Telegram, not WhatsApp
• Supports multiple chat IDs (comma-separated) in the Chat ID field
• Notifications fire on woocommerce_order_status_processing and woocommerce_order_status_completed
• Duplicate notification protection: once sent per order, stored in order meta as _stryd_telegram_sent
• Debug logging active when WP_DEBUG is true

Changelog

v3.2.0

• Login page customizer (STRYD-branded wp-login.php)
• All "WhatsApp" labels updated to "Telegram" across dashboard
• Fixed dismiss_card AJAX storing empty strings in user meta
• README added

v3.1.0

• Bulk Mode (up to 20 images in parallel)
• SEO Audit (scans all products, flags errors and warnings)
• Pricing Suggester (GHS price range from product image)
• Restock Alert (Telegram shopping list)
• Animated STRYD spinner replacing CSS spinners
• Font sizes bumped +2px across dashboard
• Dismissable cards (per-user, restorable)
• Dynamic cost card (updates when model is changed)

v3.0.0

• Category Auto-Assignment
• Naming History Log (anti-repetition fed into AI prompt)
• Telegram notifications (replaced CallMeBot/WhatsApp)
• Performance Tracker (revenue chart, category breakdown, top products)
• Dark mode switcher (site-wide, persisted)
• Full STRYD-branded admin dashboard with navigation

v2.3.0

• Improved AI prompt (anti-repetition, creativity rules)
• Accra namedrop reduced in descriptions
• Tags expanded to 8–10 per product

v2.2.0

• Tag field population fix (comma-separated, manual Add)

v2.1.0 / v2.0.0

• Feature toggles (names, descriptions, short desc, tags)
• SEO description generation
• Short description generation
• Usage stats tracker
• Dark/light admin dashboard

v1.0.0

• Initial release: AI product naming from image
• Claude Haiku integration
• WooCommerce product page button