WordPress Responsive Menu Plugin


=== Responsive Menu ===
Contributors: ResponsiveMenu, peterfeatherstone
Donate link: https://responsive.menu/donate
Tags: responsive, menu, responsive menu, mobile menu, wordpress responsive menu, wp responsive menu, tablet menu, mobile, tablet, 3 lines, 3 line, three line, three lines
Requires at least: 3.5.0
Tested up to: 4.7.2
Stable tag: 3.0.18
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Highly customisable Responsive Menu plugin with 150+ options. No coding knowledge needed to design it exactly as you want.

== Description ==
<br /><br />
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.
<br /><br />
**See it in action:**
<br /><br />
<a href="https://responsive.menu">https://responsive.menu</a>
<br /><br />
<a href="https://demo.responsive.menu">https://demo.responsive.menu</a>
<br /><br />
<br /><br />
PHP 5.4+
<br /><br />
**Fully documented:**
<br /><br />
<a href="https://responsive.menu/docs/">https://responsive.menu/docs/</a>
<br /><br />
**Fully unit tested:**
<br /><br />
100% unit test coverage with tests included in the plugin so you can run them yourself for peace of mind
<br /><br />
**Basic Functionality:**
<li>Change every colour</li>
<li>Set the fonts, font sizes and text alignment you want to use</li>
<li>Set which side and where you want the button to show</li>
<li>Set which side the menu appears from (left, right, top or bottom)</li>
<li>Use background image for the menu</li>
<li>Choice of menu animations (slide over the top or push the content)</li>
<li>Choice of which Menu to use</li>
<li>Choice of screen size at which the menu will be shown</li>
<li>Choice of CSS elements to hide when menu is showing</li>
<li>Choice of Sub-menu depth to display down to</li>
<li>Choice of Animation Types & Speeds for the Menu & Button</li>
<li>Integrated search (fully customisable)</li>
<li>Ability to disable and re-order the different components</li>
<li>Ability to fix the button to the top or to let it scroll with the page</li>
<li>Ability to upload logos, sub-arrow images etc.</li>
<li>Ability to include Scripts externally, minified and in footer</li>
<li>Ability to import and export options in a click of a button</li>
<li>Ability to add custom HTML components</li>
<li>Ability to choose custom menu triggers</li>
<li>WPML/Polylang Support</li>
<li>RTL Support</li>
<li>Plus much, much more!</li>

**Advanced & Pro Functionality:**
<li>Preview your changes before implementing</li>
<li>Animate the menu items when menu is opened</li>
<li>FontIcon Support for individual menu items</li>
<li>15 button animation effects</li>
<li>Colour opacity for all colours</li>
<li>Custom overlay colour and opacity</li>
<li>Integrated header bar</li>
<li>Let the plugin provide and style your main menu as well as hamburger menu</li>

For more reasons to go Pro, please visit <a target="_blank" href="https://responsive.menu/why-go-pro/">this page</a>.

[youtube https://www.youtube.com/watch?v=aj6ba0tGKPg]

== Installation ==

1. Upload `responsive-menu` to the `/wp-content/plugins/` directory
2. Activate the plugin through the `Plugins` menu in WordPress
3. Set your options from the Responsive Menu admin area


1. Login to your WordPress admin area
2. Search for `Responsive Menu`
3. Click install `Responsive Menu`
4. Activate through the `Plugins` menu in WordPress or when asked during installation
5. Set your options from the Responsive Menu admin area

== Frequently Asked Questions ==

1. Why do I get the error `Parse error: syntax error, unexpected '[' in /home/..../wp-content/plugins/responsive-menu/src/app/Routing/WpRouting.php on line 19`?

This is due to your PHP version not being high enough, you need at least PHP 5.4 for the plugin to work.

2. I am getting a message similar to `Fatal error: Uncaught exception 'Exception' with message 'parse error: failed at $hamburger-layer-color: ;`, why?

All you need to do is login to your WordPress admin, go to my plugin page and hit 'Update Options' to fix this.

To view our whole FAQ, please go to https://responsive.menu/faq/

== Screenshots ==

1. Animated Screencast

2. Example Front End Menu Button

3. Front End Expanded Menu with Background Image

4. Alternative Example Front End Expanded Menu with Background Image

5. Alternative Example Front End Expanded Menu with Background Image

6. Alternative Example Front End Expanded Menu with Background Image

7. Fully customisable Admin Screen

== Changelog ==

= 3.0.19 (3rd February 2017) =
* **Requires PHP 5.4**
* Minor improvements to admin styles

= 3.0.18 (2nd February 2017) =
* **Requires PHP 5.4**
* Improved border sizes for sub-menus
* Improved "Back to" text on beta slider menu functionality

= 3.0.17 (26th November 2016) =
* **Requires PHP 5.4**
* Fixed bug that stripped slashes from text inputs in admin screen
* Fixed junk pixel residue left behind on screen on menu close issue
* Fixed hiding of menu items in slide animation beta
* Fixed "Back to %previous_category_name%" text check on slide animation beta
* Bug fixes

= 3.0.16 (21st October 2016) =
* **Requires PHP 5.4**
* Added functionality for admin to remember last saved tab
* Improved local scope of self = this variable in JavaScript
* Improved slide across animation option (Pro only)

= 3.0.15 (11th October 2016) =
* **Requires PHP 5.4**
* Added border size option
* Made submenu active colours free
* Improved FontAwesome Icon check (Pro only)
* Added sizing unit options (Pro only)
* Bug fixes

= 3.0.14 (4th October 2016) =
* **Requires PHP 5.4**
* Improved PHP check on pre 5.3 systems
* Improved width of first and last menu item borders
* Added animation of menu items when menu opened (Pro only)
* Added slide effect animation option instead of standard dropdown (Pro only)
* Removed button from header bar to aid with z-indexing (Pro only)
* Bug fixes

= 3.0.13 (22nd September 2016) =
* **Requires PHP 5.4**
* Made menu background image option free (feeling generous today!)

= 3.0.12 (22nd September 2016) =
* **Requires PHP 5.4**
* Fixed close menu on link click bug with single header (Pro only)
* Fixed conflict bug with "close on link clicks" and "disable parent click" options
* Added header bar title link to WPML/Polylang
* Added alt tag option for every image
* Link target now taken into account with "Close Menu on Link Clicks"

= 3.0.11 (29th August 2016) =
* **Requires PHP 5.4**
* Fixed export options bug (Pro only)
* Fixed shortcode attributes bug

= 3.0.10 (27th August 2016) =
* **Requires PHP 5.4**
* Improved RTL support
* Additional Content added to WPML/Polylang
* Added sub-arrow active colours - Pro only
* Added sub-arrow positioning side option
* Allow 0 values to be entered
* Switched sub-menu padding round if right text-alignment used
* Added item link colours to transition list
* Minor bug fixes

= 3.0.9 (4th August 2016) =
* **Requires PHP 5.4**
* Added current item border colour option
* Added current item border hover colour option
* Apply title link to title image
* Fixed transition bug with iPhone Safari iOS on links
* Fixed Import option bug
* Import native jquery-ui-core instead of externally
* Minor bug fixes

= 3.0.8 (25th July 2016) =
* **Requires PHP 5.4**
* Added placeholder search text colour option
* Improved update process (no longer need to login to admin to trigger)
* Bug fixes

= 3.0.7 (22nd July 2016) =
* **Requires PHP 5.4**
* Added preview option - Pro only
* Added search box text colour option
* Added search box background colour option
* Added search box border colour option
* Fixed header bar bug with disabled scrolling - PRO
* Fixed smooth scrolling issue on iOS with disabled scrolling - PRO
* Added string translation to Search text

= 3.0.6 (13th July 2016) =
* **Requires PHP 5.4**
* Improved Database Migration Scripts
* Changed sub-arrows to only show border on left edge
* Improved button title text spacing
* Improved PHP version checking process

= 3.0.5 (13th July 2016) =
* **Requires PHP 5.4**
* Fixed bug with push animation
* Improved PHP version check functionality
* Fixed issue where custom menu classes weren't being added

= 3.0.4 (9th July 2016) =
* **Requires PHP 5.4**
* Fixed bug with overwriting values with shortcode

= 3.0.3 (9th July 2016) =
* **Requires PHP 5.4**
* Fixed bug with custom trigger
* Updated Polylang Support
* Removed extend() function from Pimple Container as it was throwing security notices in VaultPress - thanks to Brin @ WinningWp.com

= 3.0.2 (8th July 2016) =
* **Requires PHP 5.4**
* Fixed issue with close on link click option
* Improved database migration scripts
* Updated default button size
* Improved License Checks (Pro)
* Removed tab memory (too resource intensive)
* Fixed Query Monitor "IF" error - thanks to KTS915
* Bug fixes

= 3.0.1 (7th July 2016) =
* **Requires PHP 5.4**
* Initial Bug Fixes
* Catch non-updated option errors
* Those using under PHP 5.4 will not crash their site but deactivate
* License Key Checking Fixed (Pro)

= 3.0.0 (5th July 2016) =
* **Requires PHP 5.4** - Please ensure you have it installed to work
* Version 3 released!
* Please login to your admin and hit 'Update Options' upon installing on all sites
* Awesome FontIcon integration
* Much Smoother Animations
* Button Animations
* And much, much more
* Many bug fixes
* Completely re-written from the ground up

= 2.8.9 (17th June 2016) =
* Last Version 2 release with beta notice

= 2.8.8 (12th May 2016) =
* Added class to body when menu is opened

= 2.8.7 =
* Added absolute paths to file inclusions
* Added ability to set menu title text location (top, bottom, left, right)
* Added ability to set menu title text line height (useful for above)
* Fixed width on custom menu images for consistency

= 2.8.6 (28th January 2016) =
* Added Menu Title Link to WPML
* Fixed issue with fixed menu widths and push animation

= 2.8.5 (11th Sept 2015) =
* Fixed menu not opening on first click bug
* Added empty check to additional html content

= 2.8.4 (19th Aug 2015) =
* Fixed middle mouse scroll button bug

= 2.8.3 (13th Aug 2015) =
* Fixed bug with accordion sub arrows not re-setting correctly

= 2.8.2 (13th Aug 2015) =
* Fixed bug with push animation from right side

= 2.8.1 (27th July 2015) =
* Import/Export issue with geometric shapes fixed
* Default export.xml file added
* Other bugfixes

= 2.8 (26th July 2015) =
* Launched Pro Version 1.0 with:
	- Ability to use as the only menu on the site (responsive and desktop)
	- Option to only show on mobile using wp_is_mobile()
	- Various colour themes
	- Header bar creator
	- Menu Auto-Height option
	- Background scrolling disabled option
* Added "Reset to default" option
* Removed Metatag check
* Improved transient caching
* Bugfixes

= 2.7 (14th June 2015) =
* Added Navigation Tabs for Admin Pages -thanks to mkdgs for this!
* Bugfixes

= 2.6 (26th May 2015) =
* Added Theme Location options - useful for Polylang - Thanks to mkdgs for this
* Fixed Issue with Auto-Expanding Links
* Fixed Issue with Data Folders Incorrect Location

= 2.5 (20th May 2015) =
* Fixed issue with duplicate sub menu arrows
* Added option to set if menu is shown on left or right
* Fixed issue with custom sub menu classes
* Button now compatible with Apple Voiceover
* Changed "X" close icon to the math symbol "x" - Thanks to patlog for the idea!
* Added many more shortcode options as below:

    - "title"
    - "title_link"
    - "title_open"
    - "title_img"
    - "html"
    - "html_loc"
    - "search_loc"
    - "btn_img"
    - "btn_img_clicked"
    - "btn_title"

= 2.4 (18th Feb 2015) =

* Added option to turn transient caching off as it causes issues with active link colours etc.
* Made Menu clear the transient caches and rebuild menu on Menu/Page/Post updates.

= 2.3 (16th Feb 2015) =

* Added ability to set custom click menu trigger
* Added ability to set custom walker function - Thanks to Mickael Desgranges for this
* Added option to push menu button with animation
* Added option to change Current Page background hover colour
* Added option to change Current Page Link hover colour
* Fixed issue with accordion menu not retracting
* Enabled 0 values for animation speed to in affect remove animation
* Added easy view of Shortcode options in admin
* Added ability to place shortcodes in extra html content - Thanks to Mickael Desgranges for this
* Leveraged WordPress persistent transient caching to significantly increase load speed

= 2.2 (29th Oct 2014) =

* Added Ability to Export Options
* Added Ability to Import Options
* Added option to change 3 lines width
* Added option to change 3 lines height
* Added option to change 3 lines margin
* Added option to change sub arrows using HTML shape or Image
* Added option to change the click menu image once clicked
* Sub Menu Animation added to improve smoothness
* Accordion sub menu animation option
* Added shortcode option to change menu (use "RM" argument) eg. [responsive-menu RM="footer-menu"]
* Minor bug fixes

= 2.1 (17th Aug 2014) =

* Basic shortcode support added - To use, tick the option in the admin and use the shortcode [responsive-menu]
* Multiple bug fixes

= 2.0 (13th Aug 2014) =


* Complete overhaul of the codebase
* Increased menu depth to 5
* Added Spanish Translation - Massive thanks to Andrew @ <a href="http://www.webhostinghub.com">WebHostingHub</a> for this!
* 'Double Click' menu bug fixed
* Various bug fixes
* Added Choice to Auto Expand Parent Links
* Added Choice to Ignore Clicks on Ancestor Links
* Added Choice to Close Menu Automatically on Page Clicks
* Added Top and Bottom Slide Options
* Added Option to set a Maximum Width for the menu
* Added Choice of Positioning of Search Box
* Added Choice to Specify Title Menu Link
* Added Choice to Specify Title Menu Link Location
* Added Ability to add custom HTML snippet inside the menu
* Added Choice of location for custom HTML snippet inside the menu
* Detect if WP Login bar is active and adjust accordingly

= 1.9 (5th Apr 2014) =

* 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.
* Added option to include scripts in footer
* Added ability to upload custom menu button image to replace the 3 lines
* Added ability to close menu on each link click (good for single page sites)
* Added ability to minify output (saving 50% on file size)
* Remove title section if title and image are empty
* Added ability to change 3 lines to an x when clicked
* Added ability to set the minimum width of the menu
* Added Croatian Translation - Massive thanks to <a href="https://www.facebook.com/pages/Neverone-design/490262371018076">Neverone Design</a> for this!

= 1.8 (26th Mar 2014) =

* Added option to include styles/scripts externally/internally
* Added WPML Support
* Added internationalisation functionality, awaiting translations
* Added ability to choose which side the menu slides in from
* Minor Code Improvements

= 1.7 (13th Mar 2014) =

* Ability to auto expand/hide sub-menus
* Inclusion/Exclusion of Search Box
* Transition speed
* Slide Animation Speed
* Menu Link Heights
* Text Alignment
* Removed potential jQuery conflicts
* Minor Code Improvements

= 1.6 (6th Mar 2014) =

* Added Animation Options Section
* Added Animation Speed Customisation Option
* Added Choice Of Slide Animation (Overlay or Push)
* Added Menu Title Background Colour Customisation Option
* Added Menu Title Font Size Customisation Option
* Added Click Menu Title Font Size Customisation Option
* Added Menu Links Font Size Customisation Option
* Removed Image Size Restriction
* Minor Code Improvements

= 1.5 (4th Mar 2014) =

* Added Menu Title Colour Customisation Option
* Added Menu Title Hover Colour Customisation Option
* Added Menu Text Colour Customisation Option
* Added Menu Text Hover Colour Customisation Option
* Added Menu Background Colour Customisation Option
* Added Menu Link Background Hover Colour Customisation Option
* Minor Code Improvements

= 1.4 (2nd Mar 2014) =

* Improved menu sliding animation.
* Fixed bug where the menu wouldn't retract on re-size.
* Removed the use of namespaces to support pre PHP 5.3 systems.

= 1.3 (1st Mar 2014) =

* Added ability to upload image for menu title.
* Added ability to switch between fixed and non-fixed positioning.
* Added ability to change menu font.
* Minor updates.

= 1.2 (28th Feb 2014) =

* Added support to include all site menus.

= 1.1 (25th Feb 2014) =

* Added transparent menu background option.

= 1.0 (22nd Feb 2014) =

* Initial Version Released.

== Upgrade Notice ==

= 2.8.9 =
Requires PHP 5.4  - DO NOT upgrade if you do not have this installed.

= 2.8.8 =
Requires PHP 5.4  - DO NOT upgrade if you do not have this installed.