ProofMEDIA

ProofMEDIA Shortcode Finder Plugin User Manual

Overview: The ProofMEDIA Shortcode Finder is an enterprise-grade plugin designed to help WordPress administrators identify, manage, and clean up shortcodes across their entire website.

How it works

The plugin leverages an efficient AJAX-driven batch processing system to scan your WordPress site’s content. Here is what happens under the hood:

  • Batch Processing: Instead of querying the entire database at once (which often causes server timeouts on large enterprise sites), the scanner queries posts, pages, and custom post types in small batches of 20 at a time.
  • Regex Matching: It uses the native WordPress shortcode regular expression pattern to parse post content and extract any embedded shortcodes.
  • Status Verification: Each discovered shortcode is cross-referenced against the currently registered shortcodes in your WordPress environment to determine its status. If a shortcode tag is registered, it’s marked as Active. If the plugin or theme providing the shortcode has been removed or disabled, it’s marked as Orphaned.

How to use it

Using the plugin is straightforward and entirely managed from the WordPress admin dashboard:

  1. Navigate to the tool: Log in to your WordPress admin dashboard. In the left-hand menu, look for and click on ProofMEDIA Shortcode Finder.
  2. Start the Scan: Click the primary Start Scan button. You will see a progress bar indicating how many posts have been scanned so far.
  3. Stop: If you need to halt the process, you can click the Stop Scan button at any time.
  4. Review the Results: Once the scan reaches 100%, an interactive table will appear. This table displays:
    • The Page/Post where the shortcode was found (with quick links to View or Edit the post).
    • The Type of content (e.g., page, post).
    • The Location (Post Content).
    • The exact Shortcode string found.
    • The Status (Active or Orphaned).
  5. Search and Sort: You can use the built-in search box to find specific shortcodes or sort the table columns by clicking their headers.
  6. Export Data: Click the Export CSV button to download a spreadsheet of your results. This is highly recommended for offline analysis or to share with your development team.

Why it is useful

This plugin is a critical maintenance tool for any robust WordPress installation. Here are the primary benefits:

  • Site Cleanup: Over a website’s lifespan, plugins and themes are frequently changed or deactivated. This often leaves behind raw, unrendered shortcode text (like [old_gallery_plugin id="123"]) visible to your visitors. This tool easily identifies these “Orphaned” shortcodes so you can remove them.
  • Performance Stability: Thanks to the AJAX batching architecture, the scanner is completely safe to run on massive enterprise sites with tens of thousands of posts without crashing your server or encountering PHP memory limits.
  • Content Auditing: The CSV export feature allows content managers and developers to systematically track down where specific shortcodes are being used, which is incredibly useful when migrating away from a specific plugin.
  • Improved User Experience: By finding and eliminating broken shortcodes, you ensure a polished, professional, and error-free experience for your website’s front-end visitors.