=== OOWCODE Custom Menu Shortcode ===

Contributors: oowpress  
Donate link: https://profiles.wordpress.org/oowpress/  
Tags: menu, shortcode, custom menus, navigation, inline menu  
Requires at least: 5.8  
Tested up to: 6.8  
Stable tag: 1.4  
License: GPLv2 or later  
License URI: https://www.gnu.org/licenses/gpl-2.0.html  

A powerful shortcode plugin to display and customize WordPress menus with ease.

== Description ==

**OOWCODE Custom Menu Shortcode** is a powerful and flexible tool that allows you to display WordPress menus using a simple shortcode. This plugin is perfect for users looking to customize the appearance and behavior of menus without needing to modify the theme's code.

= Features =
* Display any WordPress menu using a shortcode.
* Options to switch between list-style or inline-style menus.
* Customizable separators for inline menus.
* Add custom CSS classes for further styling control.
* Multilingual support with `.pot` files included for translations.
* Fallback content for missing menus.
* Improved performance with API caching.
* User-friendly dashboard for managing menus easily.

= Example Shortcodes =
1. `[oowcode_custom_menu name="main-menu"]`
2. `[oowcode_custom_menu name="main-menu" style="inline" separator=" - "]`
3. `[oowcode_custom_menu name="main-menu" class="custom-menu-style"]`
4. `[oowcode_custom_menu name="main-menu" lang="fr"]`
5. `[oowcode_custom_menu name="nonexistent-menu" fallback="Default Menu"]`

= Available Shortcode Attributes =
* **name** (required): The name or slug of the menu to display.
* **class** (optional): A custom CSS class for styling the menu container.
* **style** (optional): Display the menu as a list (`list`, default) or inline (`inline`).
* **separator** (optional): The separator used between items in an inline menu (default is `|`).
* **lang** (optional): Display the menu in a specific language (requires multilingual setup).
* **fallback** (optional): A fallback message or alternative content if the specified menu is not found.

For additional support or to contribute, visit [OOWCODE](https://oowcode.com).

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/oowcode-custom-menu-shortcode` directory, or install the plugin directly through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Add the shortcode `[oowcode_custom_menu name="your-menu slugs"]` to the post, page, or widget where you want to display the menu.

== Frequently Asked Questions ==

= What is the main shortcode for the plugin? =  
Use `[oowcode_custom_menu name="your-menu-slug"]` to display your menu.

= Can I add a custom CSS class to the menu? =  
Yes, use the `class` attribute: `[oowcode_custom_menu name="your-menu-slug" class="custom-menu"]`.

= Does the plugin support inline menus? =  
Yes, set `style="inline"` and use `separator`: `[oowcode_custom_menu name="main-menu" style="inline" separator=" - "]`.

= How do I use the multilingual feature? =  
Use the `lang` attribute: `[oowcode_custom_menu name="main-menu" lang="es"]`.

== Changelog ==

= 1.4 =
* Added full support for `lang` attribute with multilingual plugins (e.g., WPML, Polylang).
* Implemented `fallback` attribute for missing menus.
* Harmonized shortcode attributes (`style` instead of `inline`).
* Added caching for WordPress Plugins API calls to improve dashboard performance.
* Improved plugin installation with automatic activation.
* Enhanced accessibility with ARIA attributes in menus.

= 1.3 =
* Upgrade to version 1.3 for improved code structure, performance, and enhanced customization options.

= 1.2 =
* Added support for multiple languages (Arabic, German, English, Spanish, French, etc.).
* Updated `.pot` file for translations.

= 1.1 =
* Improved shortcode options and performance.
* Added multilingual support and updated dashboard UI.

= 1.0 =
* Initial release with core shortcode functionality.

== Upgrade Notice ==

= 1.4 =
* Upgrade for new features like multilingual support, fallback content, and performance improvements.

== License ==

This plugin is licensed under the GPLv2 or later.