=== Category Submenu Builder ===
Contributors: rejoyan9009
Tags: category menu, submenu, woocommerce, menu builder, category navigation
Requires at least: 5.8
Tested up to: 7.1
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 WordPress and WooCommerce category menus, submenus, mega menus, and category navigation with visual builder and sync tools.

== Description ==
Category Submenu Builder is a WordPress category menu and submenu builder for organizing post categories or WooCommerce product categories into useful navigation structures. Build category menus, nested submenus, mega menus, and category navigation, then display or synchronize them with shortcodes, blocks, widgets, and native WordPress menus.

It is designed for site owners who need a category menu builder for blogs, content sites, and WooCommerce stores without depending on an external service.

= Main features =
* Create a main category and multiple subcategories in one operation.
* Reorder and manage category groups from a dedicated visual category builder.
* Build WordPress category menus and WooCommerce category navigation with nested submenu structures.
* 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 category 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 build WooCommerce category menus and submenus with them; otherwise it can work with normal WordPress post categories.

= Can I build a WooCommerce category menu? =
Yes. When WooCommerce is active, the plugin can organize product categories into nested category navigation, synchronize selected WordPress menus, and display category structures with the provided shortcodes and integrations.

= Can I build nested submenus and a mega menu? =
Yes. The builder supports hierarchical category structures, nested submenu organization, and visual mega menu settings for category navigation.

= 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.

== Screenshots ==
1. Builder dashboard for creating a main category, adding subcategories, and arranging the hierarchy for menu sync.
2. Category Manager for searching, reviewing, moving, duplicating, and managing category records.
3. Analytics view with category health checks for duplicate names, slugs, orphaned relationships, empty categories, and menu usage.
4. Backup, import, export, Security Center, Gutenberg, and Elementor integration tools.

== 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.
