=== widgetIQ for Elementor ===
Contributors: shakibuix
Tags: elementor audit, elementor cleanup, elementor widgets, developer tools, site audit
Requires Plugins: elementor
Requires at least: 6.5
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html
Donate link: https://buymeacoffee.com/shakibuix

See exactly which pages and posts use any Elementor widget —
perfect for developers, designers, and agencies doing audits or migrations.

== Description ==

Ever wondered where a specific Elementor widget is being used across your site?
widgetIQ gives you the answer in seconds.

Whether you're doing a site audit, planning a migration, or just trying to clean
up an old build — widgetIQ scans your entire WordPress site and shows you exactly
which pages and posts use each Elementor widget.

**Why you'll love it:**

🔍 Scan Elementor content across pages, posts, templates, and supported addon content
📋 See exactly where every widget is used
⚡ Identify inactive widgets from deactivated Elementor addons
🧹 Find orphaned widget references before removing plugins
🔎 Search and filter by widget, plugin, or status
🖱️ Open matching content directly from the results panel
🛡️ Read-only scanning — no Elementor data is modified

**Perfect for:**

* Auditing Elementor websites
* Cleaning up unused Elementor addons
* Identifying inactive widget dependencies
* Preparing website migrations
* Troubleshooting broken layouts
* Understanding widget usage across large sites

= Features =

* Scan Elementor widgets across your site
* Detect widgets from Elementor and third-party addons
* Active / Inactive widget status detection
* Usage count per widget
* Usage count per document
* Usage details popup
* Plugin filtering
* Status filtering
* Live search
* Direct edit links
* Lightweight admin interface
* Read-only scanning
* Developer-friendly workflow

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/widgetiq-for-elementor` directory, or install the plugin through the WordPress Plugins screen directly.
2. Activate the plugin through the "Plugins" screen in WordPress.
3. Navigate to **Settings → widgetIQ**.
4. Click **Scan Widgets** to analyze your Elementor content.

== Frequently Asked Questions ==

= Does this support Elementor addon plugins? =

Yes. widgetIQ detects Elementor core widgets as well as many third-party Elementor addon widgets automatically.

= Does this modify my website? =

No. widgetIQ is completely read-only. It does not modify Elementor data, content, templates, or settings.

= Will this work on large websites? =

Yes. Very large Elementor websites may take longer to scan, depending on the amount of Elementor content stored on the site.

= Which Elementor versions are supported? =

widgetIQ for Elementor requires Elementor to be installed and activated. The plugin has been tested with Elementor versions 3.33.3 through 4.1.1 and WordPress 7.0. Earlier Elementor versions may work, but they have not been tested.

== Screenshots ==

1. widgetIQ dashboard with widget scanning in progress.
2. Widget inventory displaying widget usage statistics across the site.
3. Usage details modal showing where a widget is used, including page types and usage counts.

== Changelog ==

= 1.0.1 =

* Added: Active / Inactive widget status detection.
* Added: status filtering for easier widget audits.
* Added: detection of widgets from deactivated Elementor addon plugins.
* Added: plugin source identification for inactive widgets.
* Improved: scanning accuracy across Elementor templates and addon-generated content.
* Improved: usage details popup with additional document information.
* Improved: admin interface layout and responsiveness.
* Improved: empty-state, loading-state, and modal behavior.
* Improved: compatibility with Elementor ecosystem plugins.
* Fixed: multiple widget counting inconsistencies.
* Fixed: various UI spacing and layout issues.

= 1.0.0 =

* Initial public release.
* Scan Elementor widgets across pages and templates.
* Detect widgets from Elementor addons dynamically.
* View widget usage locations in a modal window.
* Search and filter widgets by plugin.
* Added security and code quality improvements.