Installation Guide
Installation Requirements
Before installing the Supervised AI Bots plugin, ensure your environment meets the following requirements:
- WordPress: Version 5.0 or higher.
- PHP: Version 7.4 or higher.
- Supervised AI Account: You will need the URLs of your hosted chatbots from Supervised AI.
Installation via WordPress Dashboard
The easiest way to install the plugin is directly through your WordPress admin interface.
- Download the Plugin: Obtain the plugin
.zipfile from the Supervised AI Bots website. - Navigate to Plugins: Log in to your WordPress dashboard and go to Plugins > Add New.
- Upload the File: Click the Upload Plugin button at the top of the page.
- Select Package: Click Choose File, select the
supervised-ai-bots.zipfile you downloaded, and click Install Now. - Activate: Once the installation is complete, click the Activate Plugin button.
Manual Installation (SFTP/FTP)
If you prefer to install the plugin manually via an FTP client (like FileZilla), follow these steps:
- Extract the Files: Unzip the
supervised-ai-bots.zipfile on your local computer. - Connect to Server: Connect to your web server using your preferred FTP/SFTP client.
- Upload Directory: Navigate to the
/wp-content/plugins/directory of your WordPress installation. - Transfer: Upload the unzipped
supervised-ai-botsfolder into the/wp-content/plugins/directory. - Activate: Log in to your WordPress dashboard, navigate to Plugins > Installed Plugins, and click Activate under Supervised AI Bots.
Post-Installation Setup
After activation, you must configure the plugin to link your specific chatbots.
1. Configure Bot URLs
Navigate to the Supervised AI Bots menu item in your WordPress admin sidebar. In the settings interface, enter your chatbot URLs into the provided textarea.
- Place one URL per line.
- The order of the URLs determines their ID (the first line is ID 1, the second is ID 2, etc.).
2. Verify Assets
The plugin automatically loads the necessary styles and scripts (custom-popup-style.css and custom-popup-script.js) to handle the chatbot overlay. No manual code injection is required.
3. Displaying the Bot
To display a chatbot on a specific page or post, use the provided shortcode:
[supervised_ai_bot id="1"]
Replace 1 with the row number corresponding to the URL you entered in the settings page.
Troubleshooting Installation
- Permissions Error: If you cannot upload the plugin via the dashboard, ensure your
/wp-content/uploads/and/wp-content/plugins/directories have the correct write permissions. - Shortcode Not Rendering: Ensure the plugin is activated in the Plugins menu. If the shortcode displays as plain text, the plugin may be deactivated.
- Styles Not Appearing: If the chatbot popup looks broken, clear your website cache (via plugins like WP Rocket or Cloudflare) to ensure the new CSS/JS files are being served.