WordPress.org

Plugin Directory

Black Studio Touch Dropdown Menu

Add support for navigation dropdown menus on mobile / touch devices.

How to customize the plugin's behavior

By default the plugin applies its behavior to all hyperlinks that are direct children of nested unordered list. This is corresponding to the following jQuery selector: li:has(ul) > a, which is very generic and should fit with almost every theme. In some case the use of this generic selector may cause unexpected behaviors on nested unordered lists that are not navigation menus and do not have any dropdown effect applied. To workaround this, the plugin provides the filter black_studio_touch_dropdown_menu_selector, that allows advanced users to customize the selector to use.

Example (based on Twenty Eleven theme markup):

add_filter( 'black_studio_touch_dropdown_menu_selector', 'my_custom_selector' );
function my_custom_selector( $selector ) {
    return 'nav li:has(ul) > a';
}

Forcing plugin's behavior on iOS

The plugin behavior is intentionally disabled on Apple devices with iOS version 5 or later, as it should be provided natively by the devices. Anyway, if you want to force the application even on these devices, there's a filter hook for that. You may use the following snippet:

add_filter( 'black_studio_touch_dropdown_menu_force_ios5', 'my_force_ios5' );
function my_force_ios5( $force ) {
    return true;
}

Troubleshooting

If you think the plugin doesn't work as expected. please post a message in the Support forum, providing the following information:

  • Description of the problem and steps to reproduce it
  • Error messages if any (especially in the browser javascript console)
  • Browser / OS / Device in use
  • WordPress version in use
  • WordPress theme in use
  • List of other WordPress plugins installed

Requires: 3.0 or higher
Compatible up to: 4.4.4
Last Updated: 8 months ago
Active Installs: 5,000+

Ratings

4.3 out of 5 stars

Support

Got something to say? Need help?

Compatibility

+
=
Not enough data

0 people say it works.
0 people say it's broken.

100,2,2
100,1,1
100,1,1
100,1,1
100,2,2