Troubleshooting FAQ

Troubleshooting & FAQ

This section addresses common issues you might encounter while setting up or using the Supervised AI Bots plugin.

Shortcode Issues

Why is my shortcode appearing as plain text on the page?

If you see [supervised_ai_bot id="1"] on your live site instead of the chatbot icon, check the following:

1. Plugin Activation: Ensure the plugin is activated under Plugins > Installed Plugins.
2. Syntax Check: Ensure there are no curly quotes (smart quotes) in your shortcode. It should use straight quotes: id="1".
3. Draft Status: Ensure you have saved or published the page where the shortcode is placed.

How do I determine the correct id for my bot?

The id attribute corresponds to the line number of the URL you entered in the plugin settings.

• Row 1 URL = id="1"
• Row 2 URL = id="2"

Example:

[supervised_ai_bot id="2"]

Display & CSS Issues

The chatbot button is hidden behind other site elements.

The plugin uses a z-index of 9999 for the floating button and 1001 for the popup container. If your theme has a "sticky" header or other elements with a higher z-index, the bot may be hidden.

Solution: Add custom CSS to your theme to increase the priority:

/* Increase button priority */
.circle-button {
    z-index: 99999 !important;
}

/* Increase popup priority */
.popup-container {
    z-index: 99998 !important;
}

The chatbot is overlapping my "Back to Top" button.

By default, the chatbot is fixed to the bottom: 20px and right: 20px. You can adjust this position by adding custom CSS to your WordPress Customizer (Appearance > Customize > Additional CSS):

.circle-button, .popup-container {
    right: 80px; /* Move it further to the left */
    bottom: 30px; /* Raise it higher */
}

Iframe & Loading Issues

The popup opens, but the chatbot content is blank or shows an "error" message.

This is usually caused by one of three things:

1. Invalid URL: Double-check that the URL entered in the plugin settings is a valid, working URL for your Supervised AI bot.
2. Mixed Content: If your website uses https://, your chatbot URL must also use https://. Browsers will block insecure http:// iframes on secure sites.
3. X-Frame-Options: Ensure your Supervised AI bot settings allow it to be embedded in an iframe. If the bot's server sends a X-Frame-Options: DENY or SAMEORIGIN header, it will not load on your WordPress site.

The chatbot container is too small or too large.

The plugin uses a standard height of 670px and a width of 400px. If you need to change the dimensions to fit your bot's interface, use the following CSS:

.popup-container {
    height: 500px; /* Adjust height */
    width: 350px;  /* Adjust width */
}

.iframe-container, .popup-body {
    height: 500px; /* Match the height of the container */
}

General Configuration

I updated my bot URLs, but the changes aren't showing.

If you have updated the URLs in the 'Supervised AI Bots' settings page but the old bots are still appearing:

1. Clear Plugin Cache: If you use a caching plugin (e.g., WP Rocket, W3 Total Cache), clear your site cache.
2. Clear Browser Cache: Perform a hard refresh (Ctrl + F5 or Cmd + Shift + R) to ensure your browser is loading the latest settings.