=== Taxonomy Submenu ===
Contributors: kodyt
Tags: block, taxonomy, menu, navigation, gutenberg
Requires at least: 6.1
Tested up to: 6.8
Stable tag: 1.0.0
Requires PHP: 7.4
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

A Gutenberg block that creates dynamic submenu items from any taxonomy and offers complete styling control beyond the default WordPress submenu block.

== Description ==

**Taxonomy Submenu Block** allows you to create dynamic submenu structures inside the Gutenberg Navigation block by simply selecting a taxonomy. All terms inside the chosen taxonomy automatically appear as submenu items.

Unlike the default WordPress submenu block, this plugin gives you **complete styling freedom** — you can customize every part of the submenu, including submenu container, submenu items, text, backgrounds, hover effects, spacing, borders, typography, and more.

Perfect for blogs, LMS websites, ecommerce stores, real-estate portals, directories, or any site where taxonomy-based menus improve navigation.

### **Key Features**

#### 🚀 Dynamic Taxonomy Menus
- Select any taxonomy (categories, tags, custom taxonomies)
- Submenu items are automatically generated from all terms
- Updates instantly when new terms are added

#### 🎨 Full Styling Control (More than WordPress Core)
You can style every element without writing a single line of CSS:

- Submenu container:  
  - Padding, margin, background, borders, radius, shadows
- Submenu item:  
  - Typography, spacing, border, text color, background color
- Link styling:  
  - Normal & hover colors  
  - Hover backgrounds  
  - Active state styling

#### 🧩 Editor-Friendly & Lightweight
- Works inside the Navigation block like a native element  
- Uses the same CSS variables as core Navigation for compatibility  
- No front-end performance impact  
- No admin pages or complex settings

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/taxonomy-submenu-block`, or install it from the Plugins screen.  
2. Activate the plugin.  
3. Open the block editor and insert **“Taxonomy Submenu”** inside your Navigation block.  
4. Choose a taxonomy from the block sidebar.  
5. Customize the design using the advanced styling panel.

== Frequently Asked Questions ==

### **Does it work with custom taxonomies?**
Yes. Any registered public taxonomy will appear in the selector.

### **Does it support advanced styling without custom CSS?**
Yes. You can style every part of the submenu using block controls.

### **Is it compatible with the default Navigation block?**
Yes. It behaves like a core block but offers many more styling options.

### **Will new taxonomy terms appear automatically?**
Yes. The submenu updates instantly when new terms are added.

### **Does it slow down the site?**
No. The plugin is lightweight and optimized for speed.

== Screenshots ==

1. The Taxonomy Submenu Block inside the Navigation editor  
2. Selecting taxonomy from the block settings  
3. Advanced styling controls  
4. Example of a fully customized submenu  

== Changelog ==

= 1.0.0 =
Initial release with full styling controls and dynamic taxonomy submenu generation.

== Upgrade Notice ==

= 1.0.0 =
First stable version of the Taxonomy Submenu Block.