Common Issues
Common Issues and Troubleshooting
This section provides solutions for the most frequent issues encountered when setting up and using the Supervised AI Bots plugin.
Bot Not Displaying on Page
If you have added the shortcode but the chatbot does not appear, check the following:
- Incorrect ID Reference: The
idattribute in the shortcode corresponds to the line number of the URL in your settings. For example,[supervised_ai_bot id="1"]loads the first URL listed in the plugin settings. If you only have one URL and useid="2", the bot will not display. - Empty URL List: Ensure you have saved your bot URLs in the Supervised AI Bots settings page. Each URL must be on a new line.
- Shortcode Syntax: Ensure the shortcode is written exactly as
[supervised_ai_bot id="X"](replacing X with the row number). Using curly braces or incorrect quotes may prevent WordPress from processing the tag.
Chatbot Popup Not Opening
If the floating action button (blue circle) is visible but clicking it does not open the chat window:
- JavaScript Conflicts: Some themes or optimization plugins (like minifiers or "defer JS" tools) may interfere with the plugin's script. Check your browser console (F12 > Console) for any errors related to
togglePopuporclosePopup. - Z-Index Overlap: If your theme has a very high
z-indexfor its footer or other fixed elements, the popup container might be opening "behind" other elements. The plugin uses a defaultz-indexof1001for the popup and9999for the button. - Cache Issues: After activating the plugin or changing settings, clear your WordPress site cache (e.g., WP Rocket, W3 Total Cache) and your browser cache to ensure the latest scripts are loading.
Bot Content is Blank or Shows a "Refused to Connect" Error
If the popup opens but the iframe inside is empty or shows a connection error:
- Mixed Content (SSL): If your website uses
https://but you provided a bot URL starting withhttp://, most modern browsers will block the content for security reasons. Always use securehttps://URLs. - X-Frame-Options: The Supervised AI URL you are using must allow "iframing." If the bot provider has restricted their URL from being embedded in an iframe, the browser will block the content. Ensure your Supervised AI instance is configured to allow your website's domain.
Styling and Layout Overrides
The chatbot popup has a fixed width of 400px and a height of 670px. If this does not fit your theme's layout:
- CSS Overrides: You can adjust the appearance by adding Custom CSS to your theme (Appearance > Customize > Additional CSS).
- To change the button color:
.circle-button { background-color: #YOUR_COLOR_CODE !important; } - To adjust the popup size for mobile:
@media screen and (max-width: 480px) { .popup-container { width: 90% !important; right: 5% !important; } }
- To change the button color:
Shortcode Appearing as Plain Text
If you see the literal text [supervised_ai_bot id="1"] on your live site instead of the chatbot:
- Plugin Activation: Verify that the plugin is active under the Plugins menu.
- Widget Support: If you are using the shortcode inside a Sidebar or Footer widget, ensure your theme supports shortcodes in widgets. Most modern versions of WordPress support this by default, but some older themes may require a "Shortcode" block or custom HTML block.