Requirements

Download

You receive a download link after purchase. The archive is:

wp-ai-assistant-1.0.0.zip   (~91 KB)

Installation steps

1. Upload the plugin

1. Log in to your WordPress admin (/wp-admin).
2. Navigate to Plugins → Add New.
3. Click Upload Plugin.
4. Click Choose File, select wp-ai-assistant-1.0.0.zip, then click Install Now.
5. After installation click Activate Plugin.

WordPress runs the activation hook which:

• Creates all 15 database tables using dbDelta().
• Registers 19 custom capabilities (e.g., wpai_use_chatbot, wpai_manage_scheduler).
• Seeds 5 default AI personalities in the database.
• Registers 3 WP-Cron events (wpai_run_due_jobs, wpai_provider_health, wpai_cleanup_old_data).

2. Configure at least one AI provider

1. In the WP admin sidebar, click JoomlaAI → Settings (or AI Assistant → Settings).
2. Enter your API key for at least one provider.
3. Select the Default Provider and Default Model.
4. Click Save Settings.

See Provider configuration for all six providers.

3. Assign capabilities to roles

Out of the box the administrator role has all 19 capabilities. Other roles have none.

1. Go to JoomlaAI → AI Roles.
2. For each WordPress role (Editor, Author, etc.), check the capabilities you want to grant.
3. Click Save Roles.

4. Verify WP-Cron is running

WP-Cron is triggered by page loads. For production sites with WP-Cron disabled in wp-config.php, add a real cron job:

* * * * *  php /path/to/wordpress/wp-cron.php >/dev/null 2>&1

Or if WP-CLI is installed:

* * * * *  wp --path=/path/to/wordpress cron event run --due-now >/dev/null 2>&1

First-time setup checklist

• Plugin activated without errors
• At least one provider API key entered
• Default provider + model chosen
• Capabilities assigned to roles
• WP-Cron verified (or real cron configured)
• Dashboard loads without errors
• Health Check (JoomlaAI → Health Check) shows no critical issues

REST API

The plugin exposes a REST API at:

POST /wp-json/wpai/v1/chat
GET  /wp-json/wpai/v1/personalities

Authentication uses WordPress nonces (X-WP-Nonce header). See REST API reference.

Updating

1. Download the new wp-ai-assistant-X.Y.Z.zip.
2. Plugins → Add New → Upload Plugin → upload the new zip → Replace current with uploaded.
3. Activation hooks are skipped on update; database migrations run on plugins_loaded when the DB version differs.

Deactivating vs. uninstalling

• Deactivate — plugin is disabled but all data and tables are preserved.
• Delete — triggers uninstall.php which drops all 15 tables and removes all 19 capabilities from every role.

⚠️ Deleting the plugin is irreversible. Export your data (Settings → Export) before deleting if you want to keep it.

Troubleshooting

Full troubleshooting → Troubleshooting guide.

_Last updated: 2026-05-19 · v1.0.0_