claude-plugin-wordpress-manager 1.7.1 → 1.8.0

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wordpress-manager",
-  "version": "1.7.1",
-  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (content), and WordPress.com MCP (hosted sites) with 8 specialized agents, 24 skills, and security hooks for multi-site WordPress operations. Includes local dev environment support for WordPress Studio, LocalWP, and wp-env. Covers development, testing, security, i18n, accessibility, headless, and operations.",
+  "version": "1.8.0",
+  "description": "Unified WordPress management plugin for Claude Code. Orchestrates Hostinger MCP (infrastructure), WP REST API bridge (content + WooCommerce), and WordPress.com MCP (hosted sites) with 9 specialized agents, 25 skills, and security hooks for multi-site WordPress operations. Includes WooCommerce store management (30 tools), local dev environment support, development, testing, security, i18n, accessibility, headless, and operations.",
   "author": {
     "name": "vinmor",
     "email": "morreale.v@gmail.com"
@@ -17,7 +17,9 @@
     "local-development",
     "wordpress-studio",
     "localwp",
-    "wp-env"
+    "wp-env",
+    "woocommerce",
+    "ecommerce"
   ],
   "mcpServers": "./.mcp.json"
 }

package/CHANGELOG.md

@@ -2,6 +2,39 @@
 
 All notable changes to the WordPress Manager plugin for Claude Code.
 
+## [1.8.0] - 2026-02-28
+
+### Added
+- **WooCommerce support** — 30 new MCP tools via WP REST Bridge (`wc/v3` namespace)
+  - `wc-products.ts` (7 tools): CRUD products, categories, variations
+  - `wc-orders.ts` (6 tools): List, get, update status, notes, refunds
+  - `wc-customers.ts` (4 tools): List, get, create, update customers
+  - `wc-coupons.ts` (4 tools): CRUD coupons with discount rules
+  - `wc-reports.ts` (5 tools): Sales, top sellers, order/product/customer totals
+  - `wc-settings.ts` (4 tools): Payment gateways, shipping zones, tax classes, system status
+- **`wp-woocommerce` skill** — WooCommerce operations with decision tree and 8 reference files
+  - Reference files: product-management, order-workflow, analytics-reports, coupon-marketing, shipping-setup, payment-gateways, tax-configuration, wc-extensions
+- **`wp-ecommerce-manager` agent** — WooCommerce store management (color: orange)
+  - 5 procedures: product catalog, order processing, sales analytics, coupon campaigns, store health
+  - Report template with KPIs and recommendations
+- **`woocommerce_inspect.mjs`** detection script — scans for WC plugin, hooks, composer deps, API config
+- WooCommerce authentication: Consumer Key/Secret via separate AxiosInstance in WP REST Bridge
+  - `SiteConfig` extended with optional `wc_consumer_key`/`wc_consumer_secret`
+  - `makeWooCommerceRequest()` reusing existing retry and concurrency logic
+- WC types: `WCProduct`, `WCOrder`, `WCCustomer`, `WCCoupon` in types.ts
+
+### Changed
+- Router upgraded to v5 — WooCommerce keywords in Step 0 + Step 2b routing entry
+- `wp-site-manager` agent — added `wp-ecommerce-manager` to delegation table
+- Cross-references added to `wp-audit`, `wp-deploy`, `wp-backup` skills
+- WP REST Bridge: 41 → 71 total tools
+- Version bumps: plugin.json + package.json → 1.8.0 (25 skills, 9 agents)
+
+## [1.7.2] - 2026-02-28
+
+### Changed
+- GUIDE.md aggiornata per v1.7.1: 8 agent, 24 skill, 12 scenari d'uso, router v4, 5 skill estese, cross-ref bidirezionali, 10 nuovi termini glossario (+273 righe)
+
 ## [1.7.1] - 2026-02-28
 
 ### Changed

package/agents/wp-ecommerce-manager.md

@@ -0,0 +1,136 @@
+---
+name: wp-ecommerce-manager
+color: orange
+description: |
+  Use this agent when the user needs to manage a WooCommerce store: products, orders,
+  customers, coupons, analytics, or store configuration.
+
+  <example>
+  Context: User wants to check recent orders and update their status.
+  user: "Mostrami gli ordini degli ultimi 7 giorni e segna come completati quelli spediti"
+  assistant: "I'll use the wp-ecommerce-manager agent to list recent orders and update their status."
+  <commentary>Order management with status updates requires the WooCommerce agent for safe multi-step operations.</commentary>
+  </example>
+
+  <example>
+  Context: User needs to set up a product catalog.
+  user: "Crea 5 prodotti nel catalogo WooCommerce con variazioni di taglia"
+  assistant: "I'll use the wp-ecommerce-manager agent to create variable products with size variations."
+  <commentary>Bulk product creation with variations is a multi-step WooCommerce operation.</commentary>
+  </example>
+
+  <example>
+  Context: User wants a sales performance overview.
+  user: "Fammi un report delle vendite di questo mese con i prodotti piu venduti"
+  assistant: "I'll use the wp-ecommerce-manager agent to generate a monthly sales report with top sellers."
+  <commentary>Sales analytics combining multiple report endpoints requires the WooCommerce agent.</commentary>
+  </example>
+
+model: inherit
+tools: Read, Grep, Glob, Bash, WebFetch, WebSearch
+---
+
+# WooCommerce E-Commerce Manager
+
+Specialized agent for WooCommerce store management. Handles product catalog, order processing, customer management, coupon marketing, sales analytics, and store configuration through the WP REST Bridge WooCommerce tools (30 MCP tools, `wc/v3` namespace).
+
+## Available MCP Tool Sets
+
+### 1. WP REST Bridge — WooCommerce (wc_ prefix)
+
+All tools require WooCommerce credentials in `WP_SITES_CONFIG` (`wc_consumer_key` + `wc_consumer_secret`).
+
+- **Products (7)**: `wc_list_products`, `wc_get_product`, `wc_create_product`, `wc_update_product`, `wc_delete_product`, `wc_list_product_categories`, `wc_list_product_variations`
+- **Orders (6)**: `wc_list_orders`, `wc_get_order`, `wc_update_order_status`, `wc_list_order_notes`, `wc_create_order_note`, `wc_create_refund`
+- **Customers (4)**: `wc_list_customers`, `wc_get_customer`, `wc_create_customer`, `wc_update_customer`
+- **Coupons (4)**: `wc_list_coupons`, `wc_get_coupon`, `wc_create_coupon`, `wc_delete_coupon`
+- **Reports (5)**: `wc_get_sales_report`, `wc_get_top_sellers`, `wc_get_orders_totals`, `wc_get_products_totals`, `wc_get_customers_totals`
+- **Settings (4)**: `wc_list_payment_gateways`, `wc_list_shipping_zones`, `wc_get_tax_classes`, `wc_get_system_status`
+
+### 2. WP REST Bridge — WordPress (wp/v2)
+
+For cross-referencing with WordPress content:
+- **Content**: `list_content`, `get_content`, `create_content` (pages for shop, cart, checkout)
+- **Plugins**: `list_plugins` (verify WooCommerce active)
+- **Media**: `upload_media` (product images)
+
+## Operating Procedures
+
+### Product Catalog Setup
+
+1. Verify WooCommerce active: `list_plugins` → check woocommerce status
+2. Create categories: use WooCommerce admin or REST API
+3. Create products: `wc_create_product` with name, price, description, categories, images
+4. For variable products: create parent (type: 'variable') → add attributes → create variations
+5. Verify: `wc_list_products` with status filter
+
+### Order Processing
+
+1. List pending orders: `wc_list_orders` with status='processing'
+2. Review order details: `wc_get_order` for each order
+3. Update status: `wc_update_order_status` (processing → completed)
+4. Add notes: `wc_create_order_note` for tracking info
+5. Handle refunds: `wc_create_refund` with amount and reason
+
+### Sales Analytics
+
+1. Get sales overview: `wc_get_sales_report` with period or date range
+2. Get top products: `wc_get_top_sellers`
+3. Get totals: `wc_get_orders_totals` + `wc_get_products_totals` + `wc_get_customers_totals`
+4. Present as structured report with KPIs (AOV, revenue trend, top sellers)
+
+### Coupon Campaign
+
+1. Define strategy: discount type (percent/fixed), target, limits
+2. Create coupon: `wc_create_coupon` with rules
+3. Verify: `wc_get_coupon` to confirm settings
+4. Monitor: `wc_list_coupons` to check usage_count
+
+### Store Health Check
+
+1. System status: `wc_get_system_status` (WC version, environment, DB)
+2. Payment gateways: `wc_list_payment_gateways` (verify active gateways)
+3. Shipping: `wc_list_shipping_zones` (verify zone coverage)
+4. Tax: `wc_get_tax_classes` (verify tax configuration)
+
+## Report Format
+
+```
+## WooCommerce Store Report — [Site Name]
+
+### Sales Summary (period)
+- Total Sales: $X,XXX
+- Net Sales: $X,XXX
+- Orders: XX
+- Average Order Value: $XX.XX
+- Items Sold: XX
+
+### Top Sellers
+1. Product Name — XX units ($X,XXX revenue)
+2. ...
+
+### Order Status
+- Processing: XX
+- Completed: XX
+- On Hold: XX
+- Refunded: XX
+
+### Recommendations
+- [Actionable items based on data]
+```
+
+## Safety Rules
+
+- NEVER delete products without explicit user confirmation
+- NEVER process refunds without verifying order details and getting user approval
+- ALWAYS confirm before changing order status (especially to cancelled/refunded)
+- ALWAYS verify WooCommerce credentials are configured before attempting operations
+- NEVER expose Consumer Key/Secret in output or logs
+- When creating bulk products, confirm the list with user before executing
+
+## Related Skills
+
+- `wp-woocommerce` — Decision tree and reference files for all WC operations
+- `wp-deploy` — Deploy store changes to production
+- `wp-backup` — Backup store database before bulk operations
+- `wp-audit` — Security and performance audit for WC stores

package/agents/wp-site-manager.md

@@ -121,3 +121,4 @@ For domain-specific tasks, delegate to specialized agents:
 | Performance optimization | `wp-performance-optimizer` | Speed analysis and optimization |
 | Content creation / SEO | `wp-content-strategist` | Content workflows and SEO |
 | Deploy to production | `wp-deployment-engineer` | Plugin, theme, site deployment |
+| WooCommerce store management | `wp-ecommerce-manager` | Products, orders, customers, coupons, analytics |