=== Export Pattern & Block Location ===
Contributors: lruizcode, bubuku
Donate link: https://www.bubuku.com/
Tags: gutenberg, blocks, patterns, export, search
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Search and export CSS classes, Gutenberg blocks, and WordPress patterns locations across all your content.

== Description ==

Export Pattern & Block Location is a powerful tool for WordPress developers and site administrators that helps you find where specific CSS classes, Gutenberg blocks, and WordPress patterns are being used across your entire site.

= Features =

- CSS Class Search - Find all occurrences of specific CSS classes in your content
- Gutenberg Block Search - Locate all uses of specific blocks (including nested blocks)
- Pattern Search - Find where WordPress block patterns are being used
- CSV Export - Download results as a CSV file for easy analysis
- JSON Export - Get results in JSON format via REST API
- WPML Support - Filter searches by language for multilingual sites
- Admin Interface - Easy-to-use admin page under Tools menu
- REST API - Programmatic access for automation and integrations

= Use Cases =

- Find all pages using a deprecated CSS class before removing it
- Audit which posts are using a specific Gutenberg block
- Track pattern usage across your site for design consistency
- Prepare for theme or plugin updates by knowing what is in use
- Generate reports for content inventory

== Installation ==

1. Upload the `export-pattern-block-location` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to Tools > Export Pattern & Block Locations to use the admin interface.

== Frequently Asked Questions ==

= What post types are searched? =

By default, the plugin searches all public post types including posts, pages, and custom post types.

= Can I search multiple terms at once? =

Yes! Simply separate your search terms with commas. For example: `btn-primary, container, hero-section`

= Does it search nested blocks? =

Yes, the plugin recursively searches through all nested blocks to find matches.

= Can I use this with WPML? =

Yes, the plugin supports WPML and allows you to filter searches by language.

= Is there a REST API? =

Yes, the plugin provides a REST API endpoint at `/wp-json/epbl-search/v1/run` for programmatic access.

= How do I authenticate API requests? =

You can either be logged in as an administrator, or use an access token defined in your wp-config.php:
`define( 'EPBL_ACCESS_TOKEN', 'your-secure-token-here' );`

== Screenshots ==

1. Admin interface showing the search form
2. Search results with success message
3. Example of exported CSV file

== Development ==
This plugin uses a build process to generate the JavaScript and CSS files
distributed in `assets/build/`.

The original, human-readable source files are available in the
`assets/src/` directory included in this plugin.

== Changelog ==

= 1.0.0 =
* Initial release.
* Admin interface for searching and exporting.
* REST API endpoint for programmatic access.
* Support for CSS classes, Gutenberg blocks, and patterns.
* CSV and JSON export formats.
* WPML language filtering support.

== Upgrade Notice ==

= 1.0.0 =
Initial release.
