wpm

remove-empty-shortcodes

plugin

1.0.0 • public • Published yesterday

Automatically removes empty or inactive shortcodes from your content while preserving your original database entries.

cleanupcontentcontent managementmaintenanceshortcodes
Overview Versions Dependencies

Description

Remove Empty Shortcodes helps maintain clean content by removing shortcodes that no longer work or generate output. This commonly happens when:

  • You've deactivated a plugin that provided shortcodes
  • You're trying different plugins and some left behind inactive shortcodes
  • You have shortcodes from plugins that weren't properly uninstalled

Key Features

  • Automatically removes inactive shortcodes from displayed content
  • Preserves your original content in the database
  • Works with all public post types
  • Handles both self-closing and wrapped shortcodes
  • Admin scanner to find and review unregistered shortcodes
  • On-demand scanning with cached results
  • Ignore specific shortcodes you want to keep
  • Zero configuration required for automatic removal

How It Works

The plugin checks your content for shortcodes when pages are displayed. If it finds shortcodes that:

  • Don't produce any output
  • Aren't registered with WordPress
  • Are empty or inactive

It removes them from the displayed content while keeping your original content intact in the database.

Use Cases

  • Clean up content after removing plugins that used shortcodes
  • Remove inactive shortcodes without editing posts manually
  • Maintain clean content for readers and search engines
  • Preserve original content in case you reinstall removed plugins

Installation

  1. Upload remove-empty-shortcodes to your /wp-content/plugins/ directory
  2. Activate the plugin through the 'Plugins' menu in WordPress
  3. That's it! No configuration needed

Frequently Asked Questions

Does this work with all shortcodes?

Yes, the plugin works with any WordPress shortcode, whether from themes or plugins.

How do I find unregistered shortcodes on my site?

Go to Tools > Empty Shortcodes in your WordPress admin. Click "Run Scan" to search all your content for shortcodes that are no longer registered with WordPress.

Is there any configuration needed?

No. The plugin works automatically once activated.

What does "Ignore" do in the scanner?

Ignoring a shortcode adds it to a global ignore list. The scanner will no longer flag that shortcode, and the automatic removal feature will leave it untouched. Use this for shortcodes you intentionally want to keep.

What happens if I reinstall a plugin that uses the removed shortcodes?

Since your original content is preserved, the shortcodes will start working again automatically when you reinstall the plugin that handles them.

Will this affect shortcodes that are working correctly?

No. The plugin only removes shortcodes that are either unregistered or produce no output.

Will this modify my database content?

No. The plugin only filters content when it's displayed. Your original content remains unchanged in the database.

Screenshots

Scanner ready to scan your content for unregistered shortcodes

Scanner ready to scan your content for unregistered shortcodes

Scan results showing unregistered shortcodes found across your site

Scan results showing unregistered shortcodes found across your site

Expanded view showing context preview and edit options for each shortcode

Expanded view showing context preview and edit options for each shortcode

By Post view showing all affected posts with their shortcodes

By Post view showing all affected posts with their shortcodes

Changelog

1.0.0

  • Admin page under Tools menu for scanning and managing unregistered shortcodes
  • On-demand scanning with progress indicator and cached results
  • Two view modes: By Shortcode and By Post
  • Context preview showing surrounding text for each shortcode
  • Global ignore list for shortcodes you want to keep
  • Support for all public post types
  • Fixed false positive shortcode detection
  • New abstract blue branding
  • Restructured plugin with class-based architecture

0.7.0

  • Update support for WordPress 6.8

0.6.0

  • Added support for multi-line shortcode detection
  • Added a banner and icon for the WP plugin repository
  • Improved handling of unregistered shortcodes
  • Updated shortcode pattern matching
  • Removed Composer dependencies
  • Enhanced performance and reliability

0.5.0

  • Added latest version of PHPStan
  • Fixed page content processing
  • Updated namespace structure

0.4.0

  • Added page post type support
  • Fixed subscriber content handling

0.3.0

  • Initial public release
  • Added standard post type support
  • Improved shortcode detection

Upgrade Notice

0.6.0

Improved shortcode detection and removal with better support for multi-line shortcodes. Removes Composer dependency for simpler installation.