# My Bootstrap Menu
Contributors: codetoolbox, Michael Carder
Author URI: http://www.michaelcarder.com
Plugin URI: http://www.codetoolbox.net/wordpress/wordpress-plugins/my-bootstrap-menu/
Tags: bootstrap, navbar, nav-menu, menu, submenu, drop-down submenu, responsive, mobile, menu walker, button, tabs, pills, alignment, inverse, logo, title, login, register, image select, my plugin settings
Requires at least: 4.0
Tested up to: 4.2.2
Stable tag: 1.0.2
Header tagline: Customizable plugin that applies the Bootstrap formatting classes to any Wordpress Navigation Menu
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

## Description 
My Boostrap Menu is a fully customizable plugin that applies the Bootstrap formatting classes to any Wordpress Navigation Menu. [Bootstrap](http://getbootstrap.com/components/#navbar) provides responsive menus for phones, tablets and desktops.

The plugin allows the user to select a menu by name, or by selecting your theme's menu location. This gives extreme flexibility for theme developers, allowing multiple menus to be formatted as bootstrap menus- e.g. one fixed at the top and another at the bottom of the screen!

Works with all levels of Sub-menus! These were removed from Bootstrap in version 3, however we have included the original styles and each level will be correctly styled.

'My Boostrap Menu' is built on the ['My Plugin Settings'](http://www.codetoolbox.net/wordpress/wordpress-plugins/my-plugin-settings/) framework which creates simple and intuitive user interfaces for input forms; including media dialogues and the popup selection of [Bootstrap Glyphicons](http://glyphicons.com/).

More information here: [My Bootstrap Menu](http://www.codetoolbox.net/wordpress/wordpress-plugins/my-bootstrap-menu/)

## Features 
Fully customizable labels, logos, icons, formatting and alignment make this the most user and developer friendly menu tool. Additional styles have been included to tweak basic formatting issues when using Bootstrap navbars with Wordpress. Each Menu can be Bootstrapped and configured with settings:
* Choose your menu type
    * Navbar
    * Tabs
    * Pills
    * Buttons
    * Button Group
* Select a menu location
    * Fixed to the top of the screen
    * Fixed to the bottom
    * Static Top
* Choose to display:
    * Title
    * Logo
    * Login, Register
    * Search
* Upload a custom Logo
    * Optional logo for the Mobile version
* Custom Search box
    * Select a Glyhpicon, button type and labels
    * Choose default text for the search input box
* Custom Login and Register buttons
    * Select Glyphicons and label text
* Formatting
    * Align any menu elements to the left or right!
    * Customize the button menu style
    * Customize Sub-menu dropdowns and links
* Advanced Options!
    * Optional container classes
    * Include Wordpress default classes or not
    * Optional fixes for fixed top menus
* All files included
    * Select whether to load the included versions of Boostrap and custom css.

## Installation 

**Requires PHP 5.3+**

My Bootstrap Menu can be installed in a few easy steps:

#### Either:

1. Search for the 'My Bootstrap Menu' plugin via Wordpress Admin > Plugins > Add New
2. Install with the 'Install Now' button

#### Or:

1. Unzip "My Bootstrap Menu" and put all files into a folder like "/wp-content/plugins/my-bootstrap-menu/"
2. Activate the plugin through the 'Plugins' menu in WordPress

#### Then...

3. Inside Wordpress admin, go to Appearance > My Bootstrap Menu
4. Select which menu or location to Bootstrap and select the checkbox: 'Bootstrap this menu'
5. Configure any other setttings
6. Save and go to your site to see your new Menu!

## Frequently Asked Questions 
### Where can I find the settings for each menu? 
All settings are managed in Wordpres Admin > Appearance > My Bootstrap Menu

### Why isn't my menu being bootstrapped? 
There are a couple of things to make sure of:
1. The checkbox 'Bootstrap this menu' is checked
2. The settings are saved
3. You are either loading the plugin's version of Bootstrap, or you have one loaded with your theme
4. The menu is being called by name correctly
5. The theme location is being called correctly in your theme files

### Does this plugin work with newest WP version 
Yes, this plugin works fine with WordPress 4.2.2

## Screenshots 
1. The main settings page, showing the list of menus and the main tabs
2. A standard Bootstrap Nav Menu, with logo and multi-tiered sub-menus
3. Inverse Pills menu
4. Button Menu aligned right, and different glyphicons for search and logout
5. Mobile enabled responsive menu, features vertical button stacking.
6. Glyphicon Selection for Search, Login, Logout, and Register buttons
7. Select a logo to display on your menu

## Changelog 
###  1.0.2
Enhanced functionality for setting Main Menu Items as links when they have child/submenu items.
This will change the behaviour when selecting 'Submenu headings are links' so that submenus appear on mouse-over and menu items open on click.
(Thanks to David Woodward for highlighting this)
###  1.0.1 
Minor fixes for unique menu id, to remove non alpha-numeric characters.
### 1.0 
 First release!

## Upgrade Notice
###  1.0.2
Enhanced functionality for setting Main Menu Items as links when they have child/submenu items.
This will change the behaviour when selecting 'Submenu headings are links' so that submenus appear on mouse-over and menu items open on click.


## About us 
This plugin has been developed by [Michael Carder Ltd](http://www.michaelcarder.com/). It is is built on the ['My Plugin Settings'](http://www.codetoolbox.net/wordpress/wordpress-plugins/my-plugin-settings/) framework which creates simple and intuitive user interfaces for input forms; including media dialogues and the popup selection of [Bootstrap Glyphicons](http://glyphicons.com/).

Contact us for more information.