=== Shortcodes Analyzer ===
Contributors: wpspin
Donate link:
Tags: shortcode, shortcode finder, shortcode detector, cleanup, unused plugins
Requires at least: 4.0.0
Tested up to: 6.9
Stable tag: 1.0.1
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Scan your entire WordPress site in one click to find exactly where every shortcode is used across posts, pages, and custom post types.

== Description ==

🔍 **Shortcodes Analyzer** is a lightweight WordPress admin tool that scans your entire website and shows you exactly where each shortcode is being used — across posts, pages, and custom post types.

Whether you are cleaning up unused plugins, migrating content, troubleshooting broken shortcodes, or auditing your site before a redesign, this plugin gives you the complete picture in seconds with a single click.

No settings to configure. No database entries. Just install, activate, and scan.

= ✨ Key Features =

✅ **One-Click Full Site Scan** — Analyze every registered shortcode across your entire website instantly
✅ **Post, Page & CPT Support** — Detects shortcode usage in posts, pages, and all custom post types
✅ **Plugin Detection** — Shows which plugin provides each shortcode so you know the source
✅ **Direct Edit & View Links** — Jump straight to any post or page using a shortcode
✅ **All Shortcodes List** — View every registered shortcode and its callback function at a glance
✅ **Real-Time Progress** — Watch results appear live as each shortcode is scanned
✅ **Zero Configuration** — Works out of the box with no settings to configure
✅ **Lightweight & Fast** — No frontend scripts, no database bloat, admin-only functionality
✅ **Secure** — Nonce verification, prepared SQL queries, and proper output escaping throughout

= 📋 10+ Use Cases =

1. **🧹 Plugin Cleanup** — Find out if a plugin's shortcodes are actually used before deactivating or deleting it
2. **🔧 Troubleshoot Broken Shortcodes** — Quickly locate posts displaying raw shortcode text like `[shortcode_name]` instead of rendered content
3. **📦 Site Migration Prep** — Audit all shortcode dependencies before migrating to a new host or theme
4. **🎨 Theme Switching** — Check which shortcodes will break when switching themes (theme-registered shortcodes)
5. **📊 Content Audit** — Get a full inventory of shortcode usage as part of a site content review
6. **⚡ Performance Optimization** — Identify and remove plugins whose shortcodes are no longer in use to speed up your site
7. **🔄 Plugin Replacement** — When switching from one plugin to another (e.g., changing page builders), find all posts that need updating
8. **👥 Client Handoff** — Generate a shortcode usage report before handing a site to a client or new developer
9. **🛡️ Security Review** — Identify shortcodes from outdated or abandoned plugins that may pose security risks
10. **📝 Documentation** — Know exactly which plugins power which content areas when documenting a site's functionality
11. **🧪 Staging & Testing** — Verify shortcode usage matches between staging and production environments
12. **🗑️ Post-Redesign Cleanup** — After a site redesign, find leftover shortcodes from old plugins that are no longer needed

= 🛠️ How to Use =

**Step 1: Open the Analyzer**
Navigate to **Settings > Shortcodes Analyzer** in your WordPress admin dashboard.

**Step 2: Start Scanning**
Click the **"Start Analyzing"** button. The plugin will begin scanning all registered shortcodes across your website.

**Step 3: Review Results**
As each shortcode is processed, results appear in a table showing:

* **Plugin** — Which plugin provides the shortcode
* **Shortcode** — The shortcode name
* **Post Type** — Whether it is used in a post, page, or custom post type
* **Title** — The title of the content using the shortcode
* **Actions** — Quick links to View or Edit the post/page

**Step 4: Browse All Shortcodes**
Switch to the **"All Available Shortcodes"** tab to see every shortcode registered on your site along with its callback function.

= ⚙️ Settings =

This plugin requires **no configuration**. It works immediately after activation:

* **Location:** Settings > Shortcodes Analyzer
* **Access:** Administrator role required (manage_options capability)
* **Database:** No options or tables are created — the plugin is a pure scanning tool
* **Frontend:** No scripts or styles are loaded on the frontend — admin only

= 🤝 Works Great With These Popular Plugins =

Shortcodes Analyzer works with **any plugin or theme that registers shortcodes**. Here are some popular plugins it pairs well with:

* **WPBakery Page Builder** — Find all pages built with WPBakery shortcodes before migrating to another builder
* **Elementor** — Detect legacy shortcode-based widgets when transitioning between builders
* **Contact Form 7** — Locate every page where your contact forms are embedded
* **Gravity Forms** — Track which posts and pages use your Gravity Forms shortcodes
* **WooCommerce** — Find WooCommerce shortcodes like `[products]`, `[cart]`, and `[checkout]` across your site
* **TablePress** — Identify all posts displaying TablePress tables
* **Advanced Custom Fields (ACF)** — Detect ACF shortcode usage across content
* **Shortcodes Ultimate** — Audit usage of the many shortcodes this plugin registers
* **Easy Digital Downloads** — Track where EDD purchase buttons and download shortcodes appear
* **bbPress / BuddyPress** — Locate forum and community shortcodes embedded in pages

= 🔗 Need a Custom Plugin or Feature? =

Looking for custom WordPress development? Get in touch with us at [WPspin LLC](https://wpspins.com/) for custom plugin development and feature requests.

== Installation ==

1. Upload the `shortcodes-analyzer` folder to the `/wp-content/plugins/` directory
2. Activate the plugin through the **Plugins** menu in your WordPress Dashboard
3. Navigate to **Settings > Shortcodes Analyzer** to start scanning

== Screenshots ==

1. Dashboard view before starting the analysis
2. Dashboard view during the analysis process
3. Analysis results displaying detected shortcodes
4. List of all available shortcodes

== Frequently Asked Questions ==

= Does this plugin slow down my website? =

No. Shortcodes Analyzer only runs when you click the scan button in the admin panel. It loads no scripts or styles on the frontend and creates no database tables.

= Does it work with custom post types? =

Yes. The scanner checks all published content including posts, pages, and any registered custom post types.

= Can I find shortcodes from a specific plugin? =

Yes. The scan results show which plugin provides each detected shortcode, so you can filter by plugin name.

= Is it safe to use on a live site? =

Absolutely. The plugin only reads data — it never modifies your content, database, or files.

== Changelog ==

= 1.0.1 =
* Updated plugin description and documentation
* Updated tested up to WordPress 6.9
* Added support contact banner in admin
* Improved plugin tags for better discoverability

= 1.0.0 =
* First version of the plugin.
