=== OOW Custom Menu Shortcode === Contributors: oowpress Donate link: https://profiles.wordpress.org/oowpress/ Tags: custom menu shortcode, wordpress menu shortcode, navigation menu shortcode, inline menu shortcode, vertical menu shortcode, multilingual menu shortcode, wpml menu shortcode, polylang menu shortcode, custom navigation menu, wordpress navigation shortcode, menu styling shortcode, horizontal menu shortcode, menu separator shortcode, fallback menu shortcode, menu css shortcode, menu widget shortcode, wordpress custom menu, navigation menu plugin, custom menu plugin, multilingual navigation menu, wordpress menu customization, menu layout shortcode, menu design shortcode, translation menu shortcode, wordpress menu attributes, dynamic menu shortcode, flexible menu shortcode, responsive menu shortcode, menu display shortcode, custom menu integration, wordpress menu extension, menu shortcode attributes, lightweight menu plugin, wordpress menu solution, advanced menu shortcode, menu accessibility shortcode, oow custom menu shortcode, oowcode custom menu Requires at least: 5.8 Tested up to: 6.8 Stable tag: 1.6 Requires PHP: 7.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Effortlessly display and customize WordPress menus anywhere on your site with a flexible, lightweight shortcode. == Description == **OOW Custom Menu Shortcode** is a versatile and user-friendly plugin that lets you showcase WordPress menus in posts, pages, or widgets using a simple shortcode. Whether you’re building a sleek navigation bar, a vertical menu, or a breadcrumb-style layout, this plugin gives you full control without requiring any theme modifications. Perfect for beginners and developers alike, it combines ease of use with powerful customization options. ### Why Choose OOW Custom Menu Shortcode? - **Simple to Use**: Drop a shortcode anywhere to display your menu—no coding needed. - **Dual Shortcode Support**: Use either `[oow_custom_menu]` or `[oowcode_custom_menu]` for flexibility. - **Highly Customizable**: Choose between vertical (list) or horizontal (inline) layouts, add custom separators, and apply your own CSS styles. - **Multilingual Ready**: Seamlessly integrates with WPML, Polylang, and other translation plugins for language-specific menus. - **Reliable Fallbacks**: Display custom content if a menu is missing, ensuring a smooth user experience. - **Performance Optimized**: Leverages API caching for a fast and efficient dashboard. - **Modern Admin Interface**: Manage settings with a clean, light/dark-themed dashboard. - **Extensible**: Discover and install other OOWCODE plugins directly from the admin. ### Example Shortcodes - Basic menu: `[oow_custom_menu name="main-menu"]` or `[oowcode_custom_menu name="main-menu"]` - Inline menu with separator: `[oow_custom_menu name="main-menu" style="inline" separator=" > "]` - Styled menu: `[oowcode_custom_menu name="footer-menu" class="footer-nav"]` - Multilingual menu: `[oow_custom_menu name="main-menu" lang="fr"]` - Menu with fallback: `[oowcode_custom_menu name="missing-menu" fallback="No menu available"]` ### Available Shortcode Attributes - **name** (required): The slug or name of the menu (e.g., "main-menu"). - **class** (optional): Custom CSS class for styling (e.g., "my-menu"). - **style** (optional): Menu layout—`list` (default, vertical) or `inline` (horizontal). - **separator** (optional): Separator for inline menus (default: `|`). - **lang** (optional): Language code for multilingual menus (e.g., "es"). - **fallback** (optional): Content to show if the menu doesn’t exist (e.g., "No menu found"). Explore more at [OOWCODE](https://oowcode.com) or connect with us for support at [support@oowcode.com](mailto:support@oowcode.com). == Installation == 1. **Install the Plugin**: - Download the plugin ZIP from WordPress.org or search for "OOW Custom Menu Shortcode" in your WordPress admin under Plugins > Add New. - Upload the ZIP via Plugins > Add New > Upload Plugin, or install directly from the repository. - Click "Install Now" and then "Activate". 2. **Add the Shortcode**: - Use `[oow_custom_menu name="your-menu-slug"]` or `[oowcode_custom_menu name="your-menu-slug"]` in any post, page, or widget. - Find your menu slug in Appearance > Menus in the WordPress admin. 3. **Customize (Optional)**: - Adjust attributes like `style`, `class`, or `separator` to match your design. - Explore the plugin’s admin page under the OOWCODE menu for more options. == Frequently Asked Questions == = How do I find my menu’s slug? = Go to Appearance > Menus in your WordPress admin. The menu’s slug is typically a lowercase, hyphenated version of its name (e.g., "Main Menu" becomes "main-menu"). = What’s the difference between [oow_custom_menu] and [oowcode_custom_menu]? = Both shortcodes work identically and display the same menu. Use whichever suits your preference for consistency with your site’s branding. = Can I create a horizontal menu? = Yes! Use `style="inline"`: `[oow_custom_menu name="main-menu" style="inline" separator=" - "]`. = How do I style the menu with my theme’s CSS? = Add a custom class: `[oowcode_custom_menu name="main-menu" class="my-menu"]`, then style `.my-menu` in your theme’s stylesheet. = Does it support multilingual menus? = Absolutely! Use the `lang` attribute with plugins like WPML or Polylang: `[oow_custom_menu name="main-menu" lang="fr"]`. = What happens if a menu is missing? = Set a fallback message: `[oowcode_custom_menu name="missing-menu" fallback="No menu available"]`. = Where can I get support? = Reach out at [support@oowcode.com](mailto:support@oowcode.com) or visit [OOWCODE](https://oowcode.com). == Screenshots == 1. **Admin Interface**: A modern, user-friendly dashboard with tabs for Instructions, Extensions, and About Us. [assets/screenshot-1.png] 2. **Inline Menu Example**: A horizontal menu with a custom separator, styled via shortcode attributes. [assets/screenshot-2.png] 3. **List Menu Example**: A vertical menu displayed in a page using the default list style. [assets/screenshot-3.png] == Changelog == = 1.6 = * Fixed minor compatibility issues. * Updated documentation. = 1.5 = * Added support for both `[oow_custom_menu]` and `[oowcode_custom_menu]` shortcodes for greater flexibility. * Updated documentation to reflect dual shortcode compatibility. = 1.4 = * Added `lang` attribute for full multilingual support (WPML, Polylang, etc.). * Introduced `fallback` attribute to display custom content for missing menus. * Optimized shortcode attributes for consistency (`style` for layout control). * Implemented caching for WordPress Plugins API to boost dashboard performance. * Enhanced plugin installation with automatic activation in the Extensions tab. * Improved accessibility with ARIA attributes for menu output. * Updated admin interface with light/dark theme toggle. = 1.3 = * Improved shortcode performance and code organization. * Enhanced customization options for separators and styles. = 1.2 = * Added support for multiple languages, including Arabic, German, English, Spanish, and French. * Updated translation `.pot` file for easier localization. = 1.1 = * Introduced multilingual support and refined shortcode options. * Modernized admin dashboard UI for better usability. = 1.0 = * Initial release with core shortcode functionality. == Upgrade Notice == = 1.5 = Upgrade to use either `[oow_custom_menu]` or `[oowcode_custom_menu]` shortcodes interchangeably, offering more flexibility for your menu integration. == License == This plugin is licensed under the GPLv2 or later. See [License URI](https://www.gnu.org/licenses/gpl-2.0.html) for details. == Credits == Developed by [OOWPRESS](https://oowpress.com), powered by [OOWCODE](https://oowcode.com). Special thanks to our community for feedback and contributions!