=== Category Submenu Builder ===
Contributors: rejoyan9009
Tags: category, menu, submenu, navigation, taxonomy
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 3.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Build, arrange, display, import, back up, and sync WordPress or WooCommerce category menus from one dashboard.

== Description ==
Category Submenu Builder helps site owners organize WordPress post categories or WooCommerce product categories, turn them into menu structures, and display them with shortcodes, blocks, widgets, and native WordPress menus.

= Main features =
* Create a main category and multiple subcategories in one operation.
* Reorder and manage category groups from a dedicated builder.
* Category Manager with search, edit, delete, move, duplicate, bulk actions, and recovery snapshots.
* Category analytics and health checks for duplicate names, invalid slugs, orphaned relationships, empty categories, and menu usage.
* Safe repair tools with automatic lightweight backups before selected repairs.
* WooCommerce product auto-assignment rules based on title, SKU, tags, and configured keywords.
* Product/post count badges with zero-count and placement controls.
* Category display controls for hidden, featured, badge, schedule, SEO title, SEO description, and short description metadata.
* WordPress Appearance > Menus integration with category highlighting, nesting, duplicate cleanup, and menu synchronization.
* Visual Mega Menu settings with columns, images, counts, badges, limits, and hover behavior.
* Smart utilities including shortcode generation, category intelligence, badge suggestions, and one-click storefront setup.
* Storefront layout presets plus a theme compatibility checker.
* Gutenberg blocks and Elementor integration when those editors are available.
* JSON backup/export/import and CSV export.
* CSV, TXT, TSV, and XLSX category import with preview, duplicate handling, rollback, and import history.
* Security Center with upload validation, activity history, permission checks, and plugin file integrity checks.
* Performance tools with local cache management and diagnostics.
* Optional uninstall cleanup. Category/product/post content is preserved; plugin metadata is removed only when the administrator explicitly enables cleanup.

= Shortcodes =
* `[wpcb_menu]`
* `[wpcb_category_grid]`
* `[wpcb_category_cards]`
* `[wpcb_featured_categories]`
* `[wpcb_category_carousel]`
* `[wpcb_mobile_category_bar]`
* `[wpcb_mobile_category_drawer]`
* `[wpcb_category_search]`
* `[wpcb_mega_menu]`

Common options include `hide_empty`, `show_count`, `depth`, `columns`, `limit`, `show_images`, `show_badges`, `style`, and `icon` where supported.

= Privacy and external services =
The plugin does not send analytics, telemetry, category data, or user data to an external service. Category, menu, backup, diagnostics, and settings operations run on the WordPress site.

= Source code =
Human-readable PHP and JavaScript are included in the plugin package. Readable source counterparts are also included for minified production assets so the shipped code can be reviewed and maintained.


== Installation ==
1. In WordPress, go to Plugins > Add New > Upload Plugin.
2. Upload the plugin ZIP and activate it.
3. If WooCommerce is active, open WooCommerce > Category Builder. Otherwise open Posts > Category Builder.
4. Choose the target category location in Settings.
5. Create or arrange category groups in Builder.
6. Add `[wpcb_menu]` or another provided shortcode where you want the category navigation to appear.

== Frequently Asked Questions ==

= Does WooCommerce have to be installed? =
No. When WooCommerce product categories are available the plugin can work with them; otherwise it can work with normal WordPress post categories.

= Does uninstalling delete my categories or products? =
No. Site content is preserved. Optional plugin metadata cleanup runs only when the administrator enables the uninstall cleanup setting before uninstalling.

= Does the plugin contact an external API? =
No external API is required for the included functionality.

= Can I use the native WordPress menu editor? =
Yes. The plugin includes tools for adding and nesting category items in WordPress menus and can synchronize a selected menu after category changes.

== Changelog ==

= 3.0.0 =
* Initial WordPress.org-ready public release.
* Hardened form handling with nonce verification, input validation, sanitization, and output escaping.
* Added internationalization translator context and updated deprecated WordPress API/date handling.
* Added human-readable source counterparts for production assets.
* Preserved category, menu, shortcode, backup, import, analytics, automation, design, integration, performance, and security functionality.
* Added clear admin text rendering for improved readability.

== Upgrade Notice ==

= 3.0.0 =
Initial WordPress.org-ready public release.
