| @@ -1,565 +1,198 @@ | ||
| 1 | -=== Responsive Menu === | |
| 2 | -Contributors: ResponsiveMenu, peterfeatherstone | |
| 3 | -Donate link: https://responsive.menu/donate | |
| 4 | -Tags: responsive, menu, responsive menu, mobile menu, wordpress responsive menu, wp responsive menu, tablet menu, hamburger menu, hamburger, mobile, tablet, 3 lines, 3 line, three line, three lines | |
| 1 | +=== Responsive Menu – Mobile Menu & Hamburger Menu Builder === | |
| 2 | +Contributors: expresstech, responsivemenu, moha12351, infosatech | |
| 3 | +Tags: mobile menu, hamburger menu, off canvas menu, accessibility, navigation | |
| 5 | 4 | Requires at least: 3.6 |
| 6 | -Tested up to: 4.9 | |
| 7 | -Stable tag: 3.1.9 | |
| 5 | +Tested up to: 7.1.3 | |
| 6 | +Stable tag: 4.7.4 | |
| 7 | +Requires PHP: 7.1 | |
| 8 | 8 | License: GPLv2 or later |
| 9 | 9 | License URI: http://www.gnu.org/licenses/gpl-2.0.html |
| 10 | 10 | |
| 11 | -Highly customisable Responsive Menu plugin with 150+ options. No coding knowledge needed to design it exactly as you want. | |
| 11 | +Mobile menu & hamburger menu builder for WordPress. Accessible, keyboard-friendly and works with any theme or page builder. 150+ options, no code. | |
| 12 | 12 | |
| 13 | 13 | == Description == |
| 14 | -**Description:** | |
| 15 | -<br /><br /> | |
| 16 | -Highly customisable Responsive Menu Plugin for WordPress. With over 150 customisable options you get a combination of 22,500 options! No coding experience or knowledge is needed with an easy to use interface you can get it looking exactly as you want with minimal fuss. | |
| 17 | -<br /><br /> | |
| 18 | -**See it in action:** | |
| 19 | -<br /><br /> | |
| 20 | -<a href="https://responsive.menu">https://responsive.menu</a> | |
| 21 | -<br /><br /> | |
| 22 | -<a href="https://demo.responsive.menu">https://demo.responsive.menu</a> | |
| 23 | -<br /><br /> | |
| 24 | -**Requirements:** | |
| 25 | -<br /><br /> | |
| 26 | -PHP 5.4+ | |
| 27 | -<br /><br /> | |
| 28 | -**Fully documented:** | |
| 29 | -<br /><br /> | |
| 30 | -<a href="https://responsive.menu/docs/">https://responsive.menu/docs/</a> | |
| 31 | -<br /><br /> | |
| 32 | -**Fully unit tested:** | |
| 33 | -<br /><br /> | |
| 34 | -100% unit test coverage with tests included in the plugin so you can run them yourself for peace of mind | |
| 35 | -<br /><br /> | |
| 36 | -**Basic Functionality:** | |
| 37 | -<ul> | |
| 38 | -<li>Change every text, background and border colour</li> | |
| 39 | -<li>Set the fonts, font sizes and text alignment you want to use</li> | |
| 40 | -<li>Set which side and where you want the button to show</li> | |
| 41 | -<li>Set which side the menu appears from (left, right, top or bottom)</li> | |
| 42 | -<li>Use background image for the menu</li> | |
| 43 | -<li>Choice of menu animations (slide over the top or push the content)</li> | |
| 44 | -<li>Choice of which Menu to use</li> | |
| 45 | -<li>Choice of screen size at which the menu will be shown</li> | |
| 46 | -<li>Choice of CSS elements to hide when menu is showing</li> | |
| 47 | -<li>Choice of Sub-menu depth to display down to</li> | |
| 48 | -<li>Choice of Animation Types & Speeds for the Menu & Button</li> | |
| 49 | -<li>Integrated search (fully customisable)</li> | |
| 50 | -<li>Ability to disable and re-order the different components</li> | |
| 51 | -<li>Ability to fix the button to the top or to let it scroll with the page</li> | |
| 52 | -<li>Ability to upload logos, sub-arrow images etc.</li> | |
| 53 | -<li>Ability to include Scripts externally, minified and in footer</li> | |
| 54 | -<li>Ability to import and export options in a click of a button</li> | |
| 55 | -<li>Ability to add custom HTML components</li> | |
| 56 | -<li>Ability to choose custom menu triggers</li> | |
| 57 | -<li>WPML/Polylang Support</li> | |
| 58 | -<li>RTL Support</li> | |
| 59 | -<li>Plus much, much more!</li> | |
| 60 | -</ul> | |
| 61 | 14 | |
| 62 | -**Advanced & Pro Functionality:** | |
| 63 | -<ul> | |
| 64 | -<li>Preview your changes before implementing</li> | |
| 65 | -<li>Animate the menu items when menu is opened</li> | |
| 66 | -<li>FontIcon Support for individual menu items</li> | |
| 67 | -<li>15 button animation effects</li> | |
| 68 | -<li>Colour opacity for all colours</li> | |
| 69 | -<li>Custom overlay colour and opacity</li> | |
| 70 | -<li>Integrated header bar</li> | |
| 71 | -<li>Let the plugin provide and style your main menu as well as hamburger menu</li> | |
| 72 | -</ul> | |
| 15 | +**Responsive Menu is a free mobile menu and hamburger menu plugin for WordPress.** More than 70,000 sites use it, and it's rated 4.5★ from 570+ reviews. Pick any WordPress menu and Responsive Menu turns it into a hamburger button and a slide-in mobile menu. It works with any theme, keyboard and screen-reader users can use it, and you set it up from one screen without writing CSS. | |
| 73 | 16 | |
| 74 | -For more reasons to go Pro, please visit <a target="_blank" href="https://responsive.menu/why-go-pro/">this page</a>. | |
| 17 | +**See it in action:** [responsive.menu](https://responsive.menu/?utm_source=readme&utm_medium=plugin&utm_campaign=responsivemenu_plugin) · [Live demo](https://demo.responsive.menu/?utm_source=readme&utm_medium=plugin&utm_campaign=responsivemenu_plugin) | |
| 75 | 18 | |
| 76 | -[youtube https://www.youtube.com/watch?v=aj6ba0tGKPg] | |
| 19 | +[youtube https://www.youtube.com/watch?v=t3jLRvtRiDE] | |
| 77 | 20 | |
| 78 | -== Installation == | |
| 21 | += Why choose Responsive Menu = | |
| 79 | 22 | |
| 80 | -1. Upload `responsive-menu` to the `/wp-content/plugins/` directory | |
| 81 | -2. Activate the plugin through the `Plugins` menu in WordPress | |
| 82 | -3. Set your options from the Responsive Menu admin area | |
| 23 | +* **Works with any theme or page builder.** Classic themes, block themes, Elementor, Divi and others all work. Responsive Menu adds its own mobile menu and hides your theme's menu, so you don't need to rebuild your header. | |
| 24 | +* **Accessible out of the box.** The menu button is a real `<button>` with `aria-expanded`. Submenu toggles are labelled, focus stays inside the open menu, Escape closes it, focus outlines are visible, and reduced motion is respected. We test it with axe-core against WCAG 2.0–2.2 A/AA rules ([see the results](https://responsive.menu/features/accessible-mobile-menu/?utm_source=readme&utm_medium=plugin&utm_campaign=responsivemenu_plugin)). | |
| 25 | +* **150+ options, no code.** Set colours, fonts, animations, position, breakpoints and sub-menu depth in a live editor with phone, tablet and desktop previews. | |
| 26 | +* **Pre-built menu themes.** Start from a ready-made design and adjust it. | |
| 27 | +* **One menu to maintain.** Responsive Menu reads from your existing WordPress menu, so when you edit the menu, the mobile version updates too. | |
| 28 | +* **Show items to the right people.** Hide menu items from logged-in or logged-out visitors, or show them only to selected user roles. | |
| 83 | 29 | |
| 84 | -Alternatively: | |
| 30 | += Popular ways to use Responsive Menu = | |
| 85 | 31 | |
| 86 | -1. Login to your WordPress admin area | |
| 87 | -2. Search for `Responsive Menu` | |
| 88 | -3. Click install `Responsive Menu` | |
| 89 | -4. Activate through the `Plugins` menu in WordPress or when asked during installation | |
| 90 | -5. Set your options from the Responsive Menu admin area | |
| 32 | +* **Mobile hamburger menu.** Add a tap-friendly hamburger menu to any theme. | |
| 33 | +* **Off-canvas side menu.** Slide the menu in from the left, right, top or bottom, with a slide or push animation. | |
| 34 | +* **Fix a theme menu that breaks on mobile.** Replace a theme or page-builder menu that doesn't work well on phones. | |
| 35 | +* **Sticky mobile header.** Keep the menu button fixed as visitors scroll. | |
| 36 | +* **Member-aware menus.** Show "My account" to logged-in users and "Log in" to everyone else. | |
| 91 | 37 | |
| 92 | -== Frequently Asked Questions == | |
| 38 | += Free features = | |
| 93 | 39 | |
| 94 | -To view our FAQ, please go to <a href="https://responsive.menu/faq">https://responsive.menu/faq</a> | |
| 40 | +* Live editor with phone, tablet and desktop preview | |
| 41 | +* Pre-built menu themes, plus import and export of settings | |
| 42 | +* Every text, background and border colour, with opacity | |
| 43 | +* Fonts, font sizes and text alignment | |
| 44 | +* Menu side (left, right, top or bottom) and slide or push animation | |
| 45 | +* Button position, fixed or scrolling, with custom icon colours | |
| 46 | +* Breakpoint: choose the screen width where the mobile menu takes over | |
| 47 | +* Hide your theme's original menu with a CSS selector | |
| 48 | +* Sub-menu depth, active-item highlighting and custom menu triggers | |
| 49 | +* Integrated search, logo, title, social and action icons (call, email, links) | |
| 50 | +* Custom HTML content and custom SVG or icon code on menu items | |
| 51 | +* Hide items by login state or user role | |
| 52 | +* Keyboard and screen-reader accessibility (see above) | |
| 53 | +* Translation-ready | |
| 54 | +* Option to load scripts minified and in the footer | |
| 95 | 55 | |
| 96 | -== Screenshots == | |
| 56 | += Responsive Menu Pro = | |
| 97 | 57 | |
| 98 | -1. Animated Screencast | |
| 99 | -2. Example Front End Menu Button | |
| 100 | -3. Front End Expanded Menu with Background Image | |
| 101 | -4. Alternative Example Front End Expanded Menu with Background Image | |
| 102 | -5. Alternative Example Front End Expanded Menu with Background Image | |
| 103 | -6. Alternative Example Front End Expanded Menu with Background Image | |
| 104 | -7. Admin Initial Setup Section | |
| 105 | -8. Admin Container Section | |
| 106 | -9. Admin Menu Section | |
| 107 | -10. Admin Sub Menus Section | |
| 108 | -11. Admin Button Section | |
| 109 | -12. Admin Technical Section | |
| 110 | -13. Admin Advanced Section | |
| 111 | -14. Admin Header Bar Section | |
| 112 | -15. Admin Desktop Menu Section | |
| 58 | +Pro adds desktop navigation and finer control. Every plan includes every Pro feature: | |
| 113 | 59 | |
| 114 | -== Changelog == | |
| 60 | +* **Desktop & mega menu.** Build multi-column dropdowns with links and widgets. On phones the same menu becomes the slide-in menu, so you only maintain one menu. | |
| 61 | +* **Header bar** with logo, title, search and custom content. | |
| 62 | +* **26 animated hamburger buttons**, from Spin to Vortex. | |
| 63 | +* **Font icons** on any menu item. | |
| 64 | +* **Show on specific pages.** Include or exclude the menu page by page and by device. | |
| 65 | +* **WooCommerce menu cart** with an item count, opened as a dropdown, drawer or link. | |
| 66 | +* **WPML and Polylang**, so the menu follows the visitor's language. | |
| 67 | +* **Scroll lock** to stop the page scrolling behind an open menu. | |
| 68 | +* **Priority support** from the team that builds the plugin. | |
| 115 | 69 | |
| 116 | -= 3.1.9 (17th November 2017) = | |
| 117 | -* **Requires PHP 5.4** | |
| 118 | -* Fix for drop-downs not saving their information. | |
| 119 | -* Fix for Desktop Menu with 3rd level drop-down items. | |
| 120 | -* Fix for Touch Gestures stopping the Search box being selectable. | |
| 121 | -* Fix for Touch Gestures stopping menu scrolling. | |
| 122 | -* Center Desktop Menu option added. - Pro | |
| 70 | +Plans start at $49 a year, with a 14-day refund policy. Your menu keeps working if you stop renewing. [Compare Free vs Pro](https://responsive.menu/pricing/?utm_source=readme&utm_medium=plugin&utm_campaign=responsivemenu_plugin) | |
| 123 | 71 | |
| 124 | -= 3.1.8 (26th October 2017) = | |
| 125 | -* **Requires PHP 5.4** | |
| 126 | -* Added a new dark admin theme | |
| 127 | -* Updated the old light admin theme | |
| 128 | -* Added a "hide pro options" button to remove some of the clutter | |
| 129 | -* Improved UI interface | |
| 130 | -* Made the Word Wrap option a free feature | |
| 131 | -* Change database option value type to LONGTEXT to accept longer values | |
| 132 | -* Fixed bug with Enable Gestures option - Pro | |
| 133 | -* Complete overhaul of the Desktop Menu options including Mega Menus and more - Pro | |
| 134 | -* Added vw and vh sizing units - Pro | |
| 72 | += More from ExpressTech = | |
| 135 | 73 | |
| 136 | -= 3.1.7 (22nd September 2017) = | |
| 137 | -* **Requires PHP 5.4** | |
| 138 | -* Added depth padding side option | |
| 139 | -* Enabled touch gestures - Pro Only | |
| 140 | -* Fixed fade animation hiding the single menu bug - Pro Only | |
| 74 | +⏱️ [Quiz and Survey Master](https://wordpress.org/plugins/quiz-master-next/): create quizzes, surveys and exams in WordPress and turn your site into a lead-generation tool. | |
| 141 | 75 | |
| 142 | -= 3.1.6 (28th July 2017) = | |
| 143 | -* **Requires PHP 5.4** | |
| 144 | -* Added more translatable options to PolyLang and WPML | |
| 145 | -* Added option to turn sub-menu descriptions on | |
| 76 | +⚡ [InstaWP](https://instawp.com/): launch a WordPress sandbox site in seconds. | |
| 146 | 77 | |
| 147 | -= 3.1.5 (22nd July 2017) = | |
| 148 | -* **Requires PHP 5.4** | |
| 149 | -* Added ability to use description in menu items | |
| 150 | -* Added option for button open title | |
| 151 | -* Added ability to have the menu automatically opened on page load - Pro Only | |
| 152 | -* Added ability to use keyboard shortcuts to close the menu - Pro Only | |
| 153 | -* Added ability to use keyboard shortcuts to open the menu - Pro Only | |
| 154 | -* Added ability to disable plugins FontAwesome and BootStrap scripts in case you want to load your own - Pro Only | |
| 155 | -* Improve selection of menu items by menu item drop-down selection rather than by ID - Pro Only | |
| 156 | -* Fixed bug with 3Dx animation and hover colours - Pro Only | |
| 157 | -* Optimised twig imports to only include what is needed. | |
| 78 | +== Installation == | |
| 158 | 79 | |
| 159 | -= 3.1.4 (10th June 2017) = | |
| 160 | -* **Requires PHP 5.4** | |
| 161 | -* Added CSRF protection using nonces in admin | |
| 162 | -* Updated wpdb method to use replace() instead of update() to protect from migration issues | |
| 163 | -* Added selectize JS library | |
| 164 | -* Allow custom trigger types for button - Pro Only | |
| 165 | -* Fixed custom HTML icon bug - Pro Only | |
| 80 | +1. In your WordPress admin, go to **Plugins → Add New** and search for "Responsive Menu". | |
| 81 | +2. Click **Install Now**, then **Activate**. | |
| 82 | +3. Open **Responsive Menu** in the admin menu, pick the WordPress menu to use, and choose a theme or design your own. | |
| 83 | +4. If your theme's menu still shows on mobile, add its CSS selector under "Hide theme menu". | |
| 166 | 84 | |
| 167 | -= 3.1.3 (19th May 2017) = | |
| 168 | -* **Requires PHP 5.4** | |
| 169 | -* RTL improvements for admin UI | |
| 170 | -* Added options to change the depth level values | |
| 171 | -* Fixed twig deprecation notices - thanks to stodorovic for this | |
| 172 | -* Fixed bug where having auto-height would break menu scrolling - Pro only | |
| 85 | +Manual install: upload the `responsive-menu` folder to `/wp-content/plugins/` and activate it from the **Plugins** screen. | |
| 173 | 86 | |
| 174 | -= 3.1.2 (11th May 2017) = | |
| 175 | -* **Requires PHP 5.4** | |
| 176 | -* Updated badge counts | |
| 177 | -* Updated Font Icon area text | |
| 178 | -* Fixed bug with single menu breakpoint width - Pro Only | |
| 179 | -* Fixed bug with empty Font Icons - Pro Only | |
| 180 | -* Fixed bug with WP CLI | |
| 87 | +== Frequently Asked Questions == | |
| 181 | 88 | |
| 182 | -= 3.1.1 (5th May 2017) = | |
| 183 | -* **Requires PHP 5.4** | |
| 184 | -* Added filter box in admin for options | |
| 185 | -* Added menu container background colour option | |
| 186 | -* Added hover line colour option | |
| 187 | -* Added active line colour option | |
| 188 | -* Added active button background colour option | |
| 189 | -* Added migration scripts to make data upgrades smoother | |
| 190 | -* Added option to choose custom Font Icons - Pro Only | |
| 191 | -* Removed browser button outline and enabled focus/active states for better accessibility | |
| 192 | -* Bug fixes | |
| 89 | += Is Responsive Menu free? = | |
| 90 | +Yes. The free plugin builds a complete mobile and hamburger menu. Responsive Menu Pro adds a desktop and mega menu, a header bar, page-by-page rules and more. | |
| 193 | 91 | |
| 194 | -= 3.1.0 (25th April 2017) = | |
| 195 | -* **Requires PHP 5.4** | |
| 196 | -* Massive overhaul of codebase | |
| 197 | -* Speed improvements to front and back end | |
| 198 | -* Admin now uses BootStrap | |
| 199 | -* Twig templating engine implemented | |
| 200 | -* Added admin form validation to help catch data errors | |
| 201 | -* Added a rebuild database option | |
| 202 | -* Done away with SASS on the fly compilation | |
| 203 | -* Back to on slide effect now customisable - Pro only | |
| 204 | -* Added option to adjust for WP Admin bar - Pro only | |
| 205 | -* Bug fixes and compatibility fixes | |
| 92 | += Does it work with Elementor, Divi or other page builders? = | |
| 93 | +Yes. Responsive Menu doesn't depend on your theme or page builder. It adds its own mobile menu to the page, and you hide the original menu with a CSS selector. That's why many people use it when a theme's or builder's mobile menu won't behave. | |
| 206 | 94 | |
| 207 | -= 3.0.18 (2nd February 2017) = | |
| 208 | -* **Requires PHP 5.4** | |
| 209 | -* Improved border sizes for sub-menus | |
| 210 | -* Improved "Back to" text on beta slider menu functionality | |
| 95 | += Does it work with block themes and WordPress 7.0? = | |
| 96 | +Yes. Responsive Menu is tested with WordPress 7.1.3, and it works on block themes as well as classic themes. | |
| 211 | 97 | |
| 212 | -= 3.0.17 (26th November 2016) = | |
| 213 | -* **Requires PHP 5.4** | |
| 214 | -* Fixed bug that stripped slashes from text inputs in admin screen | |
| 215 | -* Fixed junk pixel residue left behind on screen on menu close issue | |
| 216 | -* Fixed hiding of menu items in slide animation beta | |
| 217 | -* Fixed "Back to %previous_category_name%" text check on slide animation beta | |
| 218 | -* Bug fixes | |
| 98 | += WordPress has a Navigation block. Why use Responsive Menu? = | |
| 99 | +The Navigation block only works on block themes and in the Site Editor. Responsive Menu works on any theme or page builder, gives you 150+ design options in a live editor, lets you hide items by login state or user role, and lets you export and reuse your settings on other sites. Pro adds page-by-page rules, a mega menu and a WooCommerce cart. | |
| 219 | 100 | |
| 220 | -= 3.0.16 (21st October 2016) = | |
| 221 | -* **Requires PHP 5.4** | |
| 222 | -* Added functionality for admin to remember last saved tab | |
| 223 | -* Improved local scope of self = this variable in JavaScript | |
| 224 | -* Improved slide across animation option (Pro only) | |
| 101 | += Is the menu accessible? = | |
| 102 | +Yes. The menu works with a keyboard: Tab and Shift+Tab move through it, Escape closes it, and focus stays inside the open menu. Buttons and submenus are labelled for screen readers, and the menu respects "reduce motion". It passes axe-core checks against WCAG 2.0–2.2 A/AA rules. Contrast and tap-target size depend on the colours and sizes you choose. Our [accessibility page](https://responsive.menu/features/accessible-mobile-menu/?utm_source=readme&utm_medium=plugin&utm_campaign=responsivemenu_plugin) has the full test results and a checklist. | |
| 225 | 103 | |
| 226 | -= 3.0.15 (11th October 2016) = | |
| 227 | -* **Requires PHP 5.4** | |
| 228 | -* Added border size option | |
| 229 | -* Made submenu active colours free | |
| 230 | -* Improved FontAwesome Icon check (Pro only) | |
| 231 | -* Added sizing unit options (Pro only) | |
| 232 | -* Bug fixes | |
| 104 | += My theme's menu still shows on mobile. How do I hide it? = | |
| 105 | +Find the CSS selector of your theme's menu (for example `.main-navigation`) and add it under the "Hide theme menu" option. Our [guide to hiding the original menu](https://responsive.menu/knowledgebase/hiding-original-wordpress-menu/?utm_source=readme&utm_medium=plugin&utm_campaign=responsivemenu_plugin) shows how to find it. | |
| 233 | 106 | |
| 234 | -= 3.0.14 (4th October 2016) = | |
| 235 | -* **Requires PHP 5.4** | |
| 236 | -* Improved PHP check on pre 5.3 systems | |
| 237 | -* Improved width of first and last menu item borders | |
| 238 | -* Added animation of menu items when menu opened (Pro only) | |
| 239 | -* Added slide effect animation option instead of standard dropdown (Pro only) | |
| 240 | -* Removed button from header bar to aid with z-indexing (Pro only) | |
| 241 | -* Bug fixes | |
| 107 | += Can I use a different mobile menu from my desktop menu? = | |
| 108 | +Yes. Responsive Menu uses the WordPress menu you pick in its own settings, which can be different from your theme's menu. | |
| 242 | 109 | |
| 243 | -= 3.0.13 (22nd September 2016) = | |
| 244 | -* **Requires PHP 5.4** | |
| 245 | -* Made menu background image option free (feeling generous today!) | |
| 110 | += Can I choose which side the menu slides in from? = | |
| 111 | +Yes. The menu can open from the left, right, top or bottom, with a slide or push animation. | |
| 246 | 112 | |
| 247 | -= 3.0.12 (22nd September 2016) = | |
| 248 | -* **Requires PHP 5.4** | |
| 249 | -* Fixed close menu on link click bug with single header (Pro only) | |
| 250 | -* Fixed conflict bug with "close on link clicks" and "disable parent click" options | |
| 251 | -* Added header bar title link to WPML/Polylang | |
| 252 | -* Added alt tag option for every image | |
| 253 | -* Link target now taken into account with "Close Menu on Link Clicks" | |
| 113 | += Does it support translations and multilingual sites? = | |
| 114 | +The plugin is translation-ready. Pro adds WPML and Polylang support, so the menu follows the visitor's language. | |
| 254 | 115 | |
| 255 | -= 3.0.11 (29th August 2016) = | |
| 256 | -* **Requires PHP 5.4** | |
| 257 | -* Fixed export options bug (Pro only) | |
| 258 | -* Fixed shortcode attributes bug | |
| 116 | += What happens if I stop renewing Pro? = | |
| 117 | +Your menu keeps working. You stop getting updates and priority support. | |
| 259 | 118 | |
| 260 | -= 3.0.10 (27th August 2016) = | |
| 261 | -* **Requires PHP 5.4** | |
| 262 | -* Improved RTL support | |
| 263 | -* Additional Content added to WPML/Polylang | |
| 264 | -* Added sub-arrow active colours - Pro only | |
| 265 | -* Added sub-arrow positioning side option | |
| 266 | -* Allow 0 values to be entered | |
| 267 | -* Switched sub-menu padding round if right text-alignment used | |
| 268 | -* Added item link colours to transition list | |
| 269 | -* Minor bug fixes | |
| 119 | += Where can I get support? = | |
| 120 | +Free support is on the [WordPress.org support forum](https://wordpress.org/support/plugin/responsive-menu/). Guides are in the [knowledge base](https://responsive.menu/knowledgebase/?utm_source=readme&utm_medium=plugin&utm_campaign=responsivemenu_plugin). | |
| 270 | 121 | |
| 271 | -= 3.0.9 (4th August 2016) = | |
| 272 | -* **Requires PHP 5.4** | |
| 273 | -* Added current item border colour option | |
| 274 | -* Added current item border hover colour option | |
| 275 | -* Apply title link to title image | |
| 276 | -* Fixed transition bug with iPhone Safari iOS on links | |
| 277 | -* Fixed Import option bug | |
| 278 | -* Import native jquery-ui-core instead of externally | |
| 279 | -* Minor bug fixes | |
| 122 | +== Screenshots == | |
| 280 | 123 | |
| 281 | -= 3.0.8 (25th July 2016) = | |
| 282 | -* **Requires PHP 5.4** | |
| 283 | -* Added placeholder search text colour option | |
| 284 | -* Improved update process (no longer need to login to admin to trigger) | |
| 285 | -* Bug fixes | |
| 124 | +1. The Responsive Menu dashboard: build your mobile menu in one place. | |
| 125 | +2. Start from a ready-made menu theme. | |
| 126 | +3. Live editor: colours, fonts, animations and 150+ options. | |
| 127 | +4. Mobile preview: your hamburger menu on phones and tablets. | |
| 128 | +5. Desktop preview: control when and how the menu appears on larger screens. | |
| 129 | +6. Customise the hamburger toggle button. | |
| 130 | +7. Your responsive menu live on the front end. | |
| 286 | 131 | |
| 287 | -= 3.0.7 (22nd July 2016) = | |
| 288 | -* **Requires PHP 5.4** | |
| 289 | -* Added preview option - Pro only | |
| 290 | -* Added search box text colour option | |
| 291 | -* Added search box background colour option | |
| 292 | -* Added search box border colour option | |
| 293 | -* Fixed header bar bug with disabled scrolling - PRO | |
| 294 | -* Fixed smooth scrolling issue on iOS with disabled scrolling - PRO | |
| 295 | -* Added string translation to Search text | |
| 132 | +== Changelog == | |
| 133 | += 4.7.4 (1st October 2026) = | |
| 134 | +* Feature: Added an option to display menu items only to selected user roles. | |
| 135 | +* Enhancement: Improved keyboard and screen reader accessibility. | |
| 136 | +* Bug: Fixed an issue where sub-items of a hidden menu item appeared in its place instead of remaining hidden. | |
| 137 | +* Bug: Fixed an issue where editing a menu in the Customizer reset per-item visibility settings. | |
| 138 | +* Bug: Fixed a PHP 8 fatal error that occurred when saving a menu theme. | |
| 139 | +* Bug: Fixed the live preview showing the wrong element for the title, search and social icons. | |
| 140 | +* Bug: Fixed admin notices not appearing on Responsive Menu screens. | |
| 296 | 141 | |
| 297 | -= 3.0.6 (13th July 2016) = | |
| 298 | -* **Requires PHP 5.4** | |
| 299 | -* Improved Database Migration Scripts | |
| 300 | -* Changed sub-arrows to only show border on left edge | |
| 301 | -* Improved button title text spacing | |
| 302 | -* Improved PHP version checking process | |
| 142 | += 4.7.3 (20th August 2026) = | |
| 143 | +* Security: Prevented menu theme ZIPs from placing executable files in public uploads | |
| 144 | +* Enhancement: Added pre-extraction validation and plugin-level permissions for theme uploads | |
| 145 | +* Enhancement: Resolved PHP 8+ deprecation warnings and theme upload rejection messages | |
| 303 | 146 | |
| 304 | -= 3.0.5 (13th July 2016) = | |
| 305 | -* **Requires PHP 5.4** | |
| 306 | -* Fixed bug with push animation | |
| 307 | -* Improved PHP version check functionality | |
| 308 | -* Fixed issue where custom menu classes weren't being added | |
| 147 | += 4.7.2 (20th May 2026) = | |
| 148 | +* Patch: Resolved a cross-site scripting (XSS) vulnerability in additional content HTML | |
| 309 | 149 | |
| 310 | -= 3.0.4 (9th July 2016) = | |
| 311 | -* **Requires PHP 5.4** | |
| 312 | -* Fixed bug with overwriting values with shortcode | |
| 150 | += 4.7.1 (2nd March 2026) = | |
| 151 | +* Bug: Resolved the menu item ordering issue | |
| 313 | 152 | |
| 314 | -= 3.0.3 (9th July 2016) = | |
| 315 | -* **Requires PHP 5.4** | |
| 316 | -* Fixed bug with custom trigger | |
| 317 | -* Updated Polylang Support | |
| 318 | -* Removed extend() function from Pimple Container as it was throwing security notices in VaultPress - thanks to Brin @ WinningWp.com | |
| 153 | += 4.7.0 (12th February 2026) = | |
| 154 | +* Feature: Added support for placing action/social icons inside the menu container (e.g., call, email, facebook, social links) | |
| 319 | 155 | |
| 320 | -= 3.0.2 (8th July 2016) = | |
| 321 | -* **Requires PHP 5.4** | |
| 322 | -* Fixed issue with close on link click option | |
| 323 | -* Improved database migration scripts | |
| 324 | -* Updated default button size | |
| 325 | -* Improved License Checks (Pro) | |
| 326 | -* Removed tab memory (too resource intensive) | |
| 327 | -* Fixed Query Monitor "IF" error - thanks to KTS915 | |
| 328 | -* Bug fixes | |
| 156 | += 4.6.0 (23rd July 2025) = | |
| 157 | +* Feature: Added option to hide menu items for logged in and non logged in users | |
| 329 | 158 | |
| 330 | -= 3.0.1 (7th July 2016) = | |
| 331 | -* **Requires PHP 5.4** | |
| 332 | -* Initial Bug Fixes | |
| 333 | -* Catch non-updated option errors | |
| 334 | -* Those using under PHP 5.4 will not crash their site but deactivate | |
| 335 | -* License Key Checking Fixed (Pro) | |
| 159 | += 4.5.1 (21st April 2025) = | |
| 160 | +* Bug: Fixed PHP error with SCSS library | |
| 336 | 161 | |
| 337 | -= 3.0.0 (5th July 2016) = | |
| 338 | -* **Requires PHP 5.4** - Please ensure you have it installed to work | |
| 339 | -* Version 3 released! | |
| 340 | -* Please login to your admin and hit 'Update Options' upon installing on all sites | |
| 341 | -* Awesome FontIcon integration | |
| 342 | -* Much Smoother Animations | |
| 343 | -* Button Animations | |
| 344 | -* And much, much more | |
| 345 | -* Many bug fixes | |
| 346 | -* Completely re-written from the ground up | |
| 162 | += 4.5.0 (6th November 2024) = | |
| 163 | +* Feature: Enable users to customize the colors of hamburger icons | |
| 164 | +* Enhancement: Optimize RM editor performance and format JavaScript for better efficiency | |
| 347 | 165 | |
| 348 | -= 2.8.9 (17th June 2016) = | |
| 349 | -* Last Version 2 release with beta notice | |
| 166 | += 4.4.2 (13th August 2024) = | |
| 167 | +* Bug: Resolved parent menu active class issue | |
| 350 | 168 | |
| 351 | -= 2.8.8 (12th May 2016) = | |
| 352 | -* Added class to body when menu is opened | |
| 169 | += 4.4.1 (26th July 2024) = | |
| 170 | +* Bug: Fixed compatibility issues with php 8.3 | |
| 353 | 171 | |
| 354 | -= 2.8.7 = | |
| 355 | -* Added absolute paths to file inclusions | |
| 356 | -* Added ability to set menu title text location (top, bottom, left, right) | |
| 357 | -* Added ability to set menu title text line height (useful for above) | |
| 358 | -* Fixed width on custom menu images for consistency | |
| 172 | += 4.4.0 (4th July 2024) = | |
| 173 | +* Feature: Added option to use custom SVG or icon code in menu item | |
| 174 | +* Enhancement: Improved security and addressed vulnerabilities | |
| 359 | 175 | |
| 360 | -= 2.8.6 (28th January 2016) = | |
| 361 | -* Added Menu Title Link to WPML | |
| 362 | -* Fixed issue with fixed menu widths and push animation | |
| 176 | += 4.3.5 (25th April 2024) = | |
| 177 | +* Enhancement: Update scssphp library to 1.12.1 | |
| 363 | 178 | |
| 364 | -= 2.8.5 (11th Sept 2015) = | |
| 365 | -* Fixed menu not opening on first click bug | |
| 366 | -* Added empty check to additional html content | |
| 179 | += 4.3.4 (17th April 2024) = | |
| 180 | +* Enhancement: Added option to minimize script file | |
| 367 | 181 | |
| 368 | -= 2.8.4 (19th Aug 2015) = | |
| 369 | -* Fixed middle mouse scroll button bug | |
| 182 | += 4.3.3 (11th March 2024) = | |
| 183 | +* Feature: Added the functionality to navigate menus using the tab key for improved accessibility | |
| 370 | 184 | |
| 371 | -= 2.8.3 (13th Aug 2015) = | |
| 372 | -* Fixed bug with accordion sub arrows not re-setting correctly | |
| 185 | += 4.3.2 (27th Dec 2023) = | |
| 186 | +* Enhancement: Added class to highlight active parent menus | |
| 373 | 187 | |
| 374 | -= 2.8.2 (13th Aug 2015) = | |
| 375 | -* Fixed bug with push animation from right side | |
| 188 | += 4.3.1 (14th Aug 2023) = | |
| 189 | +* Bug Fix: Addressed the problem related to hamburger line height option | |
| 190 | +* Enhancement: Anchored tags are now removed if not utilized within the title | |
| 376 | 191 | |
| 377 | -= 2.8.1 (27th July 2015) = | |
| 378 | -* Import/Export issue with geometric shapes fixed | |
| 379 | -* Default export.xml file added | |
| 380 | -* Other bugfixes | |
| 381 | 192 | |
| 382 | -= 2.8 (26th July 2015) = | |
| 383 | -* Launched Pro Version 1.0 with: | |
| 384 | - - Ability to use as the only menu on the site (responsive and desktop) | |
| 385 | - - Option to only show on mobile using wp_is_mobile() | |
| 386 | - - Various colour themes | |
| 387 | - - Header bar creator | |
| 388 | - - Menu Auto-Height option | |
| 389 | - - Background scrolling disabled option | |
| 390 | -* Added "Reset to default" option | |
| 391 | -* Removed Metatag check | |
| 392 | -* Improved transient caching | |
| 393 | -* Bugfixes | |
| 193 | +Older versions: see [changelog.txt](https://plugins.svn.wordpress.org/responsive-menu/trunk/changelog.txt). | |
| 394 | 194 | |
| 395 | -= 2.7 (14th June 2015) = | |
| 396 | -* Added Navigation Tabs for Admin Pages -thanks to mkdgs for this! | |
| 397 | -* Bugfixes | |
| 398 | - | |
| 399 | -= 2.6 (26th May 2015) = | |
| 400 | -* Added Theme Location options - useful for Polylang - Thanks to mkdgs for this | |
| 401 | -* Fixed Issue with Auto-Expanding Links | |
| 402 | -* Fixed Issue with Data Folders Incorrect Location | |
| 403 | - | |
| 404 | -= 2.5 (20th May 2015) = | |
| 405 | -* Fixed issue with duplicate sub menu arrows | |
| 406 | -* Added option to set if menu is shown on left or right | |
| 407 | -* Fixed issue with custom sub menu classes | |
| 408 | -* Button now compatible with Apple Voiceover | |
| 409 | -* Changed "X" close icon to the math symbol "x" - Thanks to patlog for the idea! | |
| 410 | -* Added many more shortcode options as below: | |
| 411 | - | |
| 412 | - - "title" | |
| 413 | - - "title_link" | |
| 414 | - - "title_open" | |
| 415 | - - "title_img" | |
| 416 | - - "html" | |
| 417 | - - "html_loc" | |
| 418 | - - "search_loc" | |
| 419 | - - "btn_img" | |
| 420 | - - "btn_img_clicked" | |
| 421 | - - "btn_title" | |
| 422 | - | |
| 423 | -= 2.4 (18th Feb 2015) = | |
| 424 | - | |
| 425 | -* Added option to turn transient caching off as it causes issues with active link colours etc. | |
| 426 | -* Made Menu clear the transient caches and rebuild menu on Menu/Page/Post updates. | |
| 427 | - | |
| 428 | -= 2.3 (16th Feb 2015) = | |
| 429 | - | |
| 430 | -* Added ability to set custom click menu trigger | |
| 431 | -* Added ability to set custom walker function - Thanks to Mickael Desgranges for this | |
| 432 | -* Added option to push menu button with animation | |
| 433 | -* Added option to change Current Page background hover colour | |
| 434 | -* Added option to change Current Page Link hover colour | |
| 435 | -* Fixed issue with accordion menu not retracting | |
| 436 | -* Enabled 0 values for animation speed to in affect remove animation | |
| 437 | -* Added easy view of Shortcode options in admin | |
| 438 | -* Added ability to place shortcodes in extra html content - Thanks to Mickael Desgranges for this | |
| 439 | -* Leveraged WordPress persistent transient caching to significantly increase load speed | |
| 440 | - | |
| 441 | -= 2.2 (29th Oct 2014) = | |
| 442 | - | |
| 443 | -* Added Ability to Export Options | |
| 444 | -* Added Ability to Import Options | |
| 445 | -* Added option to change 3 lines width | |
| 446 | -* Added option to change 3 lines height | |
| 447 | -* Added option to change 3 lines margin | |
| 448 | -* Added option to change sub arrows using HTML shape or Image | |
| 449 | -* Added option to change the click menu image once clicked | |
| 450 | -* Sub Menu Animation added to improve smoothness | |
| 451 | -* Accordion sub menu animation option | |
| 452 | -* Added shortcode option to change menu (use "RM" argument) eg. [responsive-menu RM="footer-menu"] | |
| 453 | -* Minor bug fixes | |
| 454 | - | |
| 455 | -= 2.1 (17th Aug 2014) = | |
| 456 | - | |
| 457 | -* Basic shortcode support added - To use, tick the option in the admin and use the shortcode [responsive-menu] | |
| 458 | -* Multiple bug fixes | |
| 459 | - | |
| 460 | -= 2.0 (13th Aug 2014) = | |
| 461 | - | |
| 462 | -*** WE HAVE REACHED OVER 50 CUSTOMISABLE OPTIONS! *** | |
| 463 | - | |
| 464 | -* Complete overhaul of the codebase | |
| 465 | -* Increased menu depth to 5 | |
| 466 | -* Added Spanish Translation - Massive thanks to Andrew @ <a href="http://www.webhostinghub.com">WebHostingHub</a> for this! | |
| 467 | -* 'Double Click' menu bug fixed | |
| 468 | -* Various bug fixes | |
| 469 | -* Added Choice to Auto Expand Parent Links | |
| 470 | -* Added Choice to Ignore Clicks on Ancestor Links | |
| 471 | -* Added Choice to Close Menu Automatically on Page Clicks | |
| 472 | -* Added Top and Bottom Slide Options | |
| 473 | -* Added Option to set a Maximum Width for the menu | |
| 474 | -* Added Choice of Positioning of Search Box | |
| 475 | -* Added Choice to Specify Title Menu Link | |
| 476 | -* Added Choice to Specify Title Menu Link Location | |
| 477 | -* Added Ability to add custom HTML snippet inside the menu | |
| 478 | -* Added Choice of location for custom HTML snippet inside the menu | |
| 479 | -* Detect if WP Login bar is active and adjust accordingly | |
| 480 | - | |
| 481 | -= 1.9 (5th Apr 2014) = | |
| 482 | - | |
| 483 | -* Changed where custom CSS/JS files are stored. If you have issues when upgrading, please just click "Update Options" from admin and this should return back to normal. | |
| 484 | -* Added option to include scripts in footer | |
| 485 | -* Added ability to upload custom menu button image to replace the 3 lines | |
| 486 | -* Added ability to close menu on each link click (good for single page sites) | |
| 487 | -* Added ability to minify output (saving 50% on file size) | |
| 488 | -* Remove title section if title and image are empty | |
| 489 | -* Added ability to change 3 lines to an x when clicked | |
| 490 | -* Added ability to set the minimum width of the menu | |
| 491 | -* Added Croatian Translation - Massive thanks to <a href="https://www.facebook.com/pages/Neverone-design/490262371018076">Neverone Design</a> for this! | |
| 492 | - | |
| 493 | -= 1.8 (26th Mar 2014) = | |
| 494 | - | |
| 495 | -* Added option to include styles/scripts externally/internally | |
| 496 | -* Added WPML Support | |
| 497 | -* Added internationalisation functionality, awaiting translations | |
| 498 | -* Added ability to choose which side the menu slides in from | |
| 499 | -* Minor Code Improvements | |
| 500 | - | |
| 501 | -= 1.7 (13th Mar 2014) = | |
| 502 | - | |
| 503 | -* Ability to auto expand/hide sub-menus | |
| 504 | -* Inclusion/Exclusion of Search Box | |
| 505 | -* Transition speed | |
| 506 | -* Slide Animation Speed | |
| 507 | -* Menu Link Heights | |
| 508 | -* Text Alignment | |
| 509 | -* Removed potential jQuery conflicts | |
| 510 | -* Minor Code Improvements | |
| 511 | - | |
| 512 | -= 1.6 (6th Mar 2014) = | |
| 513 | - | |
| 514 | -* Added Animation Options Section | |
| 515 | -* Added Animation Speed Customisation Option | |
| 516 | -* Added Choice Of Slide Animation (Overlay or Push) | |
| 517 | -* Added Menu Title Background Colour Customisation Option | |
| 518 | -* Added Menu Title Font Size Customisation Option | |
| 519 | -* Added Click Menu Title Font Size Customisation Option | |
| 520 | -* Added Menu Links Font Size Customisation Option | |
| 521 | -* Removed Image Size Restriction | |
| 522 | -* Minor Code Improvements | |
| 523 | - | |
| 524 | -= 1.5 (4th Mar 2014) = | |
| 525 | - | |
| 526 | -* Added Menu Title Colour Customisation Option | |
| 527 | -* Added Menu Title Hover Colour Customisation Option | |
| 528 | -* Added Menu Text Colour Customisation Option | |
| 529 | -* Added Menu Text Hover Colour Customisation Option | |
| 530 | -* Added Menu Background Colour Customisation Option | |
| 531 | -* Added Menu Link Background Hover Colour Customisation Option | |
| 532 | -* Minor Code Improvements | |
| 533 | - | |
| 534 | -= 1.4 (2nd Mar 2014) = | |
| 535 | - | |
| 536 | -* Improved menu sliding animation. | |
| 537 | -* Fixed bug where the menu wouldn't retract on re-size. | |
| 538 | -* Removed the use of namespaces to support pre PHP 5.3 systems. | |
| 539 | - | |
| 540 | -= 1.3 (1st Mar 2014) = | |
| 541 | - | |
| 542 | -* Added ability to upload image for menu title. | |
| 543 | -* Added ability to switch between fixed and non-fixed positioning. | |
| 544 | -* Added ability to change menu font. | |
| 545 | -* Minor updates. | |
| 546 | - | |
| 547 | -= 1.2 (28th Feb 2014) = | |
| 548 | - | |
| 549 | -* Added support to include all site menus. | |
| 550 | - | |
| 551 | -= 1.1 (25th Feb 2014) = | |
| 552 | - | |
| 553 | -* Added transparent menu background option. | |
| 554 | - | |
| 555 | -= 1.0 (22nd Feb 2014) = | |
| 556 | - | |
| 557 | -* Initial Version Released. | |
| 558 | - | |
| 559 | 195 | == Upgrade Notice == |
| 560 | 196 | |
| 561 | -= 2.8.9 = | |
| 562 | -Requires PHP 5.4 - DO NOT upgrade if you do not have this installed. | |
| 563 | - | |
| 564 | -= 2.8.8 = | |
| 565 | -Requires PHP 5.4 - DO NOT upgrade if you do not have this installed. | |
| 197 | += 4.7.4 = | |
| 198 | +Menu markup changed for accessibility: the submenu toggle is now a button beside the link, and the menu is wrapped in a nav element. Custom CSS targeting `.rmp-menu-item-link .rmp-menu-subarrow` should target `.rmp-menu-subarrow`. Sub-items of a hidden menu item are now hidden too. | |
