=== Menu Image, Icons made easy ===
Contributors: takanakui, freemius
Tags: menu, navigation, image, icons, nav menu
Donate link: https://www.buymeacoffee.com/ruiguerreiro
Requires at least: 4.4.0
Tested up to: 5.2
Stable tag: 2.9.3
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Adds an image or icon in the menu items. You can choose the position of the image (after, before, above, below) or even hide the menu item title.


== Description ==

Easily add an image or icon in a menu item. Creating a better website menu.
Control the position of the image or icon and also it's size.

With Menu Image plugin you can do more, check some of the features:


- Hide Title.
- Add Image / Icon on the Left of the menu item title.
- Add Image / Icon on the Right of the menu item title.
- Add Image / Icon on the Above of the menu item title.
- Add Image / Icon on the Below of the menu item title.
- Switch images / icons on mouse over the menu item.

It's compatible with WPML and no coding knowledge is required.

= Related Plugins =
* [Mobile Menu](https://www.wpmobilemenu.com/?utm_source=wordpressorg&utm_medium=menu-image&utm_campaign=plugin-description): WP Mobile Menu is the best WordPress responsive mobile menu. Provide to your mobile visitor an easy access to your site content using any device smartphone/tablet/desktop.


###I need help or I have a doubt, check our Support
* Great Support, our free support is above the average.

 <a target="_blank" href="https://wordpress.org/support/plugin/menu-image">Menu Image Support</a>

Bug reports for Menu Image are [welcomed on GitHub](https://github.com/ruiguerreiro79/menu-image). Please note GitHub is not a support forum, and issues that aren’t properly qualified as bugs will be closed.


== Installation ==

1. Upload `menu-image` to the `/wp-content/plugins/` directory
2. Activate the plugin through the 'Plugins' menu in WordPress
3. Go to `/wp-admin/nav-menus.php`
4. Edit exist menu item or add new menu item and just upload image than click `Save Menu`
5. See your menu on site
6. (WMPL users only) Goto WPML > WP Menus Sync and click to `Sync`

== Frequently Asked Questions ==

= How to add custom attributes to menu item link (useful for integration with dropdown menus) =

Use core `nav_menu_link_attributes` and `nav_menu_item_title` filters.

= How to wrap menu link text in `span` html element =

Menu link text is already wrapped in `span.menu-image-title`.

= How to add another size for the image? =

To add a new size (or remove an old one) add a function to the `menu_image_default_sizes` filter. For example

`
<?php
add_filter( 'menu_image_default_sizes', function($sizes) {

  // remove the default 36x36 size
  unset($sizes['menu-36x36']);

  // add a new size
  $sizes['menu-50x50'] = array(50,50);

  // return $sizes (required)
  return $sizes;

});
?>
`

= How to make hovered image visible on current page of menu item? =

Add this link to style.css
`
.menu-item.current-menu-item > a.menu-image-hovered img.hovered-image {
  opacity: 1;
}
`

= If you have problem with srcset image problem on Wordpress version >= 4.4 and Azure hosting =

If you srcset property look like this:
`<img width="36" height="36" src="http://static.mywebsite.com/website/myaction_express_menu_icon-36x36.png" class="attachment-menu-36x36 size-menu-36x36" alt="myaction_express_menu_icon" srcset="http://www.mywebsite.com/wp-content/uploads/D:homesitewwwroot/wp-content/uploads/myaction_express_menu_icon-50x50.png 50w, http://www.mywebsite.com/wp-content/uploads/D:homesitewwwroot/wp-content/uploads/myaction_express_menu_icon-75x75.png 75w, http://www.mywebsite.com/wp-content/uploads/D:homesitewwwroot/wp-content/uploads/myaction_express_menu_icon-24x24.png 24w, http://www.mywebsite.com/wp-content/uploads/D:homesitewwwroot/wp-content/uploads/myaction_express_menu_icon-36x36.png 36w, http://www.mywebsite.com/wp-content/uploads/D:homesitewwwroot/wp-content/uploads/myaction_express_menu_icon-48x48.png 48w, http://www.mywebsite.com/wp-content/uploads/D:homesitewwwroot/wp-content/uploads/myaction_express_menu_icon.png 80w" sizes="(max-width: 36px) 100vw, 36px">`
Then you can disable srcset (add it to your function.php):
`
/**
 * Fix for broken images on azure & wordpress 4.4
 * @see https://wordpress.org/support/topic/wordpress-adding-absolute-paths
 */
add_filter( 'wp_calculate_image_srcset', '__return_false' );
`

== Screenshots ==

1. Admin screen
2. Menu preview in standard twenty-thirteen theme

== Changelog ==

### 2.9.5 ###
* Fix - Remove unnecessary filter.
* Fix - Adjust the CSS for title below.

### 2.9.4 ###
* Fix - Bug of the duplicated images.

### 2.9.3 ###
* New - Add compatibility with Max Megamenu.
* New - Add new filter to change the markup of the image
* Fix - Lower the Menu Image options to be below the WordPress Settings.
* Fix - Update Mobile Menu Link.
* Fix - Relocate CSS and JS resources.

### 2.9.2 ###
* New - Include Freemius framework.
* New - Settings panel.
* New - Option to enable/disable image on hover.
* New - Options to change the custom image sizes.


### 2.9.1 ###
* Fix previous broken update. Sorry for that, everyone is mistake.
* Remove images srcset and sizes attributes.
* Add autotests on for images view.

### 2.9.0 ###
* Update admin part copy regarding to new wp version.
* Fix support url.
* Fix php warning.

= 2.8.0 =
* Use core `nav_menu_link_attributes`, `nav_menu_item_title` filters to add image and class instead of `walker_nav_menu_start_el` filter.
* Drop support of core version < 4.4.0.

= 2.7.0 =
* Remove notification plugin. It was not a good idea btw.

= 2.6.9 =
* Revert back php <=5.2 support, https://wordpress.org/support/topic/upgrade-to-wp-453-and-268-and-got-this-error. Reported by @itmnetcom and @cjg79

= 2.6.8 =
* Fix `wp_nav_menu_item_custom_fields` filter usage https://wordpress.org/support/topic/blocked-on-36x36-image. Reported by @vladimir-slonska
* Fix php warning in notifier component https://wordpress.org/support/topic/invalid-argument-supplied-for-foreach-in-4. Reported by @susanmarshallva

= 2.6.7 =
* Add `menu_image_link_attributes` filter, fix bug with menu dropdown in Flatsome theme https://wordpress.org/support/topic/bug-image-menu-dropdown. Reported by @apardo

= 2.6.6 =
* Fix various php errors.

= 2.6.5 =
* Add notification plugin.

= 2.6.4 =
* Fixing a clearing bug for WordPress 4.5+. Thanx @kau-boy

= 2.6.3 =
* Fix php warning 'Invalid Argument foreach()' https://wordpress.org/support/topic/invalid-argument-foreach-in-menu-imagephp-line-126. Thanx @majancart

= 2.6.2 =
* Update FAQ to dial with srcset and Azure hosting https://wordpress.org/support/topic/wordpress-adding-absolute-paths. Thanx @GeertvanHorrik

= 2.6.1 =
* Fix php warning https://wordpress.org/support/topic/bug-fix-error-in-the-file-menu-imagephp

= 2.6 =
* Fix bug on attachment page.
* Add french translation. Thanx @CreativeJuiz

= 2.5 =
* Add above and below title. Thanx @alhoseany
* Add original image size. Thanx @alhoseany
* Fix the loss of choices on size and title when updating image by ajax. Thanx @alhoseany
* Fix hidden title on responsive select menu.

= 2.4 =
* Fix compatibility with some modules and themes to according to [this topic](http://shazdeh.me/2014/06/25/custom-fields-nav-menu-items/)
* Fix Jetpack Phonon frontend bug

= 2.3 =
* WPML menus sync support. Thanx @pabois for [feature request](http://wordpress.org/support/topic/very-good-wpml-compliant)

= 2.2 =
* Added grunt-wp-readme-to-markdown npm package for converting readme to markdown for github users.

= 2.1 =
* Fix [set-image-button-not-working](http://wordpress.org/support/topic/set-image-button-not-working)
* Fix [vertical-align-when-using-mouseover-image](ttp://wordpress.org/support/topic/vertical-align-when-using-mouseover-image)

= 2.0 =
* Added support of media uploader.
* Fixed php strict warnings.
* Added .ico image support, thanks to [ivol84](https://github.com/ivol84)

= 1.3 =
* Added ability to set title position, an example: before, after image or hide

= 1.2 =
* Fix styles for hovered image

= 1.1 =
* Added style file with vertical align of menu image item by default
* Added ability to upload image that which will be replaced on hover
* Added default image sizes for menu items: 24x24, 36x36 and 48x48

== Upgrade Notice ==

= 2.5 =
Now you can set link title below and above image, thanx @alhoseany.

= 2.4 =
If your are using Jetpack Phonon module now menu icons will be look good.

= 2.3 =
If your are using WPML plugin, now when you sync menus, images will synced too.

= 2.0 =
WARNING! You need to re-select the images! Now, with media uploader support, it's easy peasy.
Media uploader support. Upload once, use many times!

= 1.2 =
Now you can change title text position

= 1.1 =
Now you can upload image that replaced default on mouse hover
