=== Shortcode Finder & Audit ===
Contributors: simpliplugins
Tags: shortcode, audit, scanner, cleanup, maintenance
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Scan your WordPress database for shortcodes, audit them against active plugins and themes, and find orphan shortcodes.

== Description ==

**Shortcode Finder & Audit** helps WordPress administrators, developers, and SEO teams maintain clean, reliable content by scanning the entire database for shortcode usage and identifying broken or orphaned shortcodes.

Shortcodes are bracket-based placeholders like `[gallery]` or `[contact-form]` that render dynamic content. When plugins are deactivated or removed, their shortcodes often remain embedded in posts, pages, widgets, and custom fields—displaying as ugly raw text to visitors.

= Key Features =

* **Full database scan** — Searches post content, excerpts, post meta, widgets/options, and comments
* **Custom post type support** — Includes all public and custom post types
* **Orphan detection** — Flags shortcodes with no active handler
* **Inactive plugin detection** — Identifies shortcodes tied to deactivated plugins
* **Source attribution** — Maps registered shortcodes to plugins, themes, or core
* **Registered shortcode inventory** — View all currently active shortcode handlers
* **Detailed occurrence report** — See exactly where each shortcode is used
* **CSV export** — Download audit results for content cleanup workflows
* **Batch scanning** — AJAX-powered scans avoid PHP timeout issues on large sites

= Use Cases =

* **Clean up ghost code** after uninstalling plugins
* **Prepare for theme migration** by inventorying layout dependencies
* **Troubleshoot broken shortcodes** across thousands of pages
* **Content audits** for multi-author or enterprise sites

= Privacy =

This plugin scans your local WordPress database only. No data is sent to external servers.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/` or install via the WordPress Plugins screen.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to **Tools → Shortcode Audit** to run your first scan.

== Frequently Asked Questions ==

= What is an orphan shortcode? =

An orphan shortcode is a shortcode found in your content that has no currently registered handler. It typically means the plugin that provided the shortcode was removed or deactivated.

= Does this plugin delete shortcodes? =

No. This is an audit and reporting tool. It helps you find shortcodes so you can manually clean them up or use other tools to remove them.

= Will this work on large sites? =

Yes. Scans run in batches via AJAX to reduce the risk of PHP timeouts.

= What post types are scanned? =

All public post types and non-builtin custom post types are included by default. You can toggle post types before starting a scan.

== Screenshots ==

1. Audit dashboard with summary statistics
2. Detailed shortcode occurrence report
3. Registered shortcodes inventory

== Changelog ==

= 1.0.0 =
* Initial release
* Database scanner for posts, meta, widgets, and comments
* Orphan and inactive shortcode detection
* CSV export
* Registered shortcode inventory

== Upgrade Notice ==

= 1.0.0 =
Initial release of Shortcode Finder & Audit.
