Admin guide
All plugin screens live under one WooCommerce submenu.
Path: WordPress Admin → WooCommerce → AI Assistant URL: wp-admin/admin.php?page=aiwsa-assistant Capability: manage_woocommerce Credentials: manage_options for AI Provider keys
Query args: tab, section. Example: admin.php?page=aiwsa-assistant&tab=settings§ion=language
Screens
| Top nav | Purpose | Docs |
|---|---|---|
| Dashboard | Live counts; empty ≠ broken | Dashboard |
| AI Provider | Keys, models | settings/ai-provider |
| Product Search | Search strategy + tools | settings/product-search |
| Recommendations | Upsell/cross-sell | settings/recommendations |
| Product Q&A | Detail/variation/stock/content tools | settings/product-qa |
| Cart Assistant | Cart tools | settings/cart-assistant |
| Cart Recovery | Overview, carts, settings, AI log | Cart Recovery |
| Analytics | Overview + settings + order attribution | Analytics |
| Order Assistant | Order tools | settings/orders |
| Sales Agent | Playbook toggles | settings/sales-agent |
| Settings | Sidebar: General, Quick Actions, Chatbot, AI Language, Appearance, Access & Privacy, Usage & Costs, Logs, Developer & Debug | matching files under docs/settings/ |
Admin Page: Dashboard
Purpose
Live status for this store.
Available Sections
Stat cards + Search insights (when samples exist).
Settings
None on this view.
Recommended Configuration
Use after traffic exists. Empty cards are expected on a new install.
Save/Reset Behavior
N/A.
Notices/Warnings
Welcome notice after activation. Schema error if tables failed.
Common Issues
All “No data yet”: assistant not enabled or no storefront use.
Details: dashboard.md.
Admin Page: Settings (all sections)
Purpose
Persist options via options.php (groups aiwsa_general, aiwsa_providers, aiwsa_prompts, aiwsa_tools).
Save/Reset Behavior
Each card has Save. Appearance Reset colors writes factory hex. AI Language Reset on fallbacks clears only ai_fallback_messages. Re-activation does not overwrite existing options.
Notices/Warnings
WordPress settings_errors() render inside the plugin shell. Invalid custom base URL shows a rejection notice.
Common Issues
Changes not applying: you saved a different card (each form is separate). Cached storefront HTML: widget still loads fresh /config.
Admin Page: Cart Recovery
Purpose
Abandoned carts, reminder emails, recovered revenue.
Available Sections
Subnav: Overview, Abandoned carts, Settings, and AI log (when AI log feature allowed). section=view opens one cart (emails masked).
Settings
Recommended Configuration
Off until From address, template, and consent are set. Start with 1 email.
Save/Reset Behavior
Multiple forms on Settings. Destructive: delete all tracking data, clear logs, per-cart actions via admin_post_aiwsa_recovery_action.
Notices/Warnings
Success/error after admin-post redirects.
Common Issues
Empty overview: recovery disabled or no tracked carts. Emails not sending: cron, consent, mail.
Admin Page: Analytics
Purpose
Funnel and revenue attribution.
Available Sections
Overview, Settings, Attribution details (section=order&order_id=).
Settings
Recommended Configuration
Analytics on; 7-day window; 90-day retention.
Save/Reset Behavior
Settings form. Export and insights use admin-post handlers.
Notices/Warnings
None beyond empty states.
Common Issues
See Analytics feature.
WooCommerce Status
A plugin panel is added on WooCommerce → Status (System_Status). Use it plus Developer & Debug for support.
AJAX (admin, logged-in only)
| Action | Purpose |
|---|---|
aiwsa_test_api_key | Test provider key |
aiwsa_remove_api_key | Remove stored key |
aiwsa_recovery_preview | Preview recovery email |
aiwsa_recovery_test_email | Send test recovery email |
No wp_ajax_nopriv handlers.