BugWP logo BugWP
Back to Community
Home / Community / Plugin → Classic widgets

Troubleshooting Common Classic Widgets Plugin Issues: PHP, Blocks, and Shortcodes

23 threads Sep 9, 2025 Plugin → Classic widgets

Content

The Classic Widgets plugin is a popular tool for WordPress users who prefer the traditional widgets interface over the newer block editor. However, like any software, users can occasionally encounter issues. Based on community reports, this guide covers the most common problems and their solutions.

1. PHP Version Compatibility

The Problem: Users have reported issues when running the plugin on PHP 8.1 and 8.2, including blank screens or widgets not appearing in the admin area.

Why It Happens: Newer PHP versions deprecate or remove certain functions that older code might rely on, leading to fatal errors.

The Solution: The plugin is generally reported to work with PHP 8+. If you encounter a problem, it is often due to a conflict with another plugin or theme. A specific fatal error related to WP_Widget::__construct() is likely caused by a separate, outdated widget plugin and not by Classic Widgets itself. To troubleshoot:

  • Test your site on a staging environment first.
  • Temporarily disable all other plugins to see if the issue resolves.
  • Switch to a default WordPress theme (like Twenty Twenty-Four) to rule out a theme conflict.

2. Plugin Doesn't Activate or the Block Editor Still Appears

The Problem: The plugin is installed and activated, but the block editor for widgets is still visible on some or all sites, particularly in multisite networks.

Why It Happens: Caching (either in the browser, a caching plugin, or the server) can sometimes prevent the new settings from taking effect immediately.

The Solution:

  • Clear your browser cache and cookies.
  • Clear any caching from your WordPress caching plugins or CDN.
  • Check if the issue is isolated to one site in a multisite network; network activation is generally confirmed to work, but individual site configurations can vary.

3. Shortcodes Not Working in Widgets

The Problem: Shortcodes work on pages and posts but do not execute when placed inside a widget area.

Why It Happens: This is a known behavior difference between widget types in the classic interface.

The Solution: Do not use the 'Custom HTML' widget for shortcodes. Instead, use the classic 'Text' widget. Copy your shortcode into a Text widget, and it should execute correctly on the front end of your site.

4. Unable to Insert Media into a Text Widget

The Problem: The 'Add Media' button in a Text widget does not insert the selected image.

Why It Happens: This is almost always caused by a JavaScript conflict introduced by another active plugin or the theme.

The Solution: Follow a standard conflict-testing procedure:

  1. Open your browser's console (F12) to check for any JavaScript errors when clicking the button.
  2. Temporarily switch to a default WordPress theme (e.g., Twenty Twenty-Four). If the problem goes away, the issue is with your theme.
  3. If the problem persists, disable all other plugins one by one, testing after each deactivation, to identify the conflicting plugin.

General Best Practices

  • Always Test First: Before updating PHP, WordPress, or any plugin on your live site, test the changes in a staging environment. Many hosting providers offer staging tools, or you can use a local development tool like Local by Flywheel.
  • Check for Updates: The Classic Widgets plugin is maintained by WordPress contributors and is tested with recent versions of WordPress. Ensure you are running the latest version of the plugin for the best compatibility.

By following these troubleshooting steps, most common issues with the Classic Widgets plugin can be identified and resolved.

Related Support Threads Support