Troubleshooting Stames Floating Widget Issues on WordPress

If the Stames Floating Widget is not displaying properly or at all on your WordPress site, there could be a few common causes. Follow these troubleshooting steps to identify and fix the issue.

1. Ensure jQuery is Enabled and Up-to-Date

The Stames Floating Widget relies on jQuery to function correctly. If jQuery is not enabled or an outdated version is being used, the widget may not work as expected.

How to Check and Update jQuery:

Install and activate the jQuery Updater Plugin to ensure you are using the latest version.

You can also manually check by adding the following code to your theme’s functions.php file:

function update_jquery_version() {
    if (!is_admin()) {
        wp_deregister_script('jquery');
        wp_register_script('jquery', 'https://ajax.googleapis.com/ajax/libs/jquery/3.7.1/jquery.min.js', false, '3.7.1', true);
        wp_enqueue_script('jquery');
    }
}
add_action('wp_enqueue_scripts', 'update_jquery_version');

After updating, clear your cache and refresh your site.

2. Verify Stames Data Key

The widget requires a valid Stames Data Key to function. If the data key is incorrect or missing, the widget will not load.

Steps to Fix:

Navigate to Tools > Stames Floating Widget in your WordPress admin panel.
Check if the Stames Data Key field is set.
If missing or incorrect, retrieve the correct data key from your Stames account and update it. Here is a tutorial on how to access data key.
Click Save Changes and refresh your site.

If the Web Widget is turned off in settings, it will not be displayed on your website.

Steps to Fix:

Go to Stames subscription account by visiting here. In the Stames subscription account, go to Account Settings > Integration Settings > General Settings Tab.
Ensure that the Activate Web Widget option is set to On.

Save changes and refresh your website.

4. Check JavaScript Conflicts

Some themes or plugins may have conflicting JavaScript that interferes with the Stames Floating Widget.

Steps to Diagnose:

Open your browser console (Press F12 > Navigate to Console tab) and check for JavaScript errors.
If errors mention jQuery is not defined, make sure jQuery is properly loaded.
Temporarily disable other plugins to see if any conflict is causing the issue.

5. Clear Cache

Caching plugins or CDN services like Cloudflare may prevent changes from reflecting immediately.

Steps to Fix:

Clear your WordPress cache from any caching plugin (e.g., W3 Total Cache, WP Super Cache, Litespeed Cache).
If using Cloudflare or another CDN, purge the cache from their dashboard.
Refresh your website.

Conclusion

Following these troubleshooting steps should help resolve most issues with the Stames Floating Widget. If problems persist, reach out to Stames support for further assistance at support@stamesoft.com or visit https://www.stamesoft.com/support/home to access Stames Support Center. If you looking to install and configure Stames web widget on wordpress or any website, check out this tutorial.