Installation
Requirements
- WordPress 6.5+
- PHP 8.0+
- Orravo Core (hard dependency)
- WooCommerce 8.0+ (hard dependency)
- An API key from one of the supported LLM providers (you bring your own)
Upload and activate
- Upload the
oassist/folder to/wp-content/plugins/. - Activate via Plugins -> Installed Plugins.
- If Orravo Core or WooCommerce is missing, an admin notice blocks activation.
- Find OAssist under the Orravo Core admin menu.
HPOS compatibility
OAssist declares compatibility with WooCommerce's High-Performance Order Storage (custom order tables) and the Cart/Checkout Blocks on before_woocommerce_init. No configuration needed.
What activation creates
OAssist_Activator::activate() runs OAssist_DB::install(), which creates 10 tables prefixed with oas_:
| Table | Purpose |
|---|---|
oas_sources | Indexed knowledge sources (products, pages, posts, files) |
oas_chunks | RAG chunks with embeddings (BLOB) |
oas_conversations | Chat sessions (channel, user, status, tokens, cost) |
oas_messages | Per-turn messages with tool calls, citations, token counts |
oas_providers | LLM provider configs (API key encrypted, default model) |
oas_tools | Tool registry (name, JSON schema, scope, handler) |
oas_escalations | Human escalation tickets (reason, channel, assigned_to) |
oas_intents | Auto-detected intents per conversation |
oas_cache | Prompt cache (sha256 hash -> response) |
oas_budget | Daily spend tracking (cost, tokens, conversations) |
oas_audit | Action audit log |
Activation also:
- Registers 13 built-in tools (search_products, get_product, check_stock, get_order_status, track_shipment, apply_coupon, get_loyalty_balance, get_subscription_status, get_wishlist, get_booking_availability, escalate_to_human, create_support_ticket, log_feedback).
- Seeds 7 inactive provider rows (OpenAI, Anthropic, Google Gemini, Azure OpenAI, Groq, OpenRouter, plus OpenAI embeddings) ready to be configured.
- Schedules
oassist_cron_reindex(daily) andoassist_cron_cleanup(daily).
Plugin constants
phpOASSIST_VERSION // '1.0.4'
OASSIST_PATH // Plugin path
OASSIST_URL // Plugin URL
OASSIST_REST_NS // 'oassist/v1'
OASSIST_DB_VERSION // '1.0.0'