/**
* @param array $instance
*/
public function form($instance)
{
$title = isset($instance['title']) ? $instance['title'] : '';
$nav_menu = isset($instance['nav_menu']) ? $instance['nav_menu'] : '';
// Get menus
$menus = hq_get_nav_menus();
// If no menus exists, direct the user to go and create some.
?>
<p class="nav-menu-widget-no-menus-message" <?php
if (!empty($menus)) {
echo ' style="display:none" ';
}
?>
>
<?php
if (isset($GLOBALS['hq_customize']) && $GLOBALS['hq_customize'] instanceof HQ_Customize_Manager) {
$url = 'javascript: hq.customize.panel( "nav_menus" ).focus();';
} else {
$url = admin_url('nav-menus.php');
}
?>
<?php
echo sprintf(__('No menus have been created yet. <a href="%s">Create some</a>.'), esc_attr($url));
?>
</p>
<div class="nav-menu-widget-form-controls" <?php
if (empty($menus)) {
echo ' style="display:none" ';
}
?>
>
<p>
<label for="<?php
echo $this->get_field_id('title');
?>
"><?php
_e('Title:');
?>
</label>
<input type="text" class="widefat" id="<?php
echo $this->get_field_id('title');
?>
" name="<?php
echo $this->get_field_name('title');
?>
" value="<?php
echo esc_attr($title);
?>
"/>
</p>
<p>
<label for="<?php
echo $this->get_field_id('nav_menu');
?>
"><?php
_e('Select Menu:');
?>
</label>
<select id="<?php
echo $this->get_field_id('nav_menu');
?>
" name="<?php
echo $this->get_field_name('nav_menu');
?>
">
<option value="0"><?php
_e('— Select —');
?>
</option>
<?php
foreach ($menus as $menu) {
?>
<option value="<?php
echo esc_attr($menu->term_id);
?>
" <?php
selected($nav_menu, $menu->term_id);
?>
>
<?php
echo esc_html($menu->name);
?>
</option>
<?php
}
?>
</select>
</p>
</div>
<?php
}
/**
* Displays a navigation menu.
*
* @since 0.0.1
*
* @staticvar array $menu_id_slugs
*
* @param array $args {
* Optional. Array of nav menu arguments.
*
* @type string $menu Desired menu. Accepts (matching in order) id, slug, name. Default empty.
* @type string $menu_class CSS class to use for the ul element which forms the menu. Default 'menu'.
* @type string $menu_id The ID that is applied to the ul element which forms the menu.
* Default is the menu slug, incremented.
* @type string $container Whether to wrap the ul, and what to wrap it with. Default 'div'.
* @type string $container_class Class that is applied to the container. Default 'menu-{menu slug}-container'.
* @type string $container_id The ID that is applied to the container. Default empty.
* @type callback|bool $fallback_cb If the menu doesn't exists, a callback function will fire.
* Default is 'hq_page_menu'. Set to false for no fallback.
* @type string $before Text before the link text. Default empty.
* @type string $after Text after the link text. Default empty.
* @type string $link_before Text before the link. Default empty.
* @type string $link_after Text after the link. Default empty.
* @type bool $echo Whether to echo the menu or return it. Default true.
* @type int $depth How many levels of the hierarchy are to be included. 0 means all. Default 0.
* @type object $walker Instance of a custom walker class. Default empty.
* @type string $theme_location Theme location to be used. Must be registered with register_nav_menu()
* in order to be selectable by the user.
* @type string $items_wrap How the list items should be wrapped. Default is a ul with an id and class.
* Uses printf() format with numbered placeholders.
* }
* @return object|false|void Menu output if $echo is false, false if there are no items or no menu was found.
*/
function hq_nav_menu($args = array())
{
static $menu_id_slugs = array();
$defaults = array('menu' => '', 'container' => 'div', 'container_class' => '', 'container_id' => '', 'menu_class' => 'menu', 'menu_id' => '', 'echo' => true, 'fallback_cb' => 'hq_page_menu', 'before' => '', 'after' => '', 'link_before' => '', 'link_after' => '', 'items_wrap' => '<ul id="%1$s" class="%2$s">%3$s</ul>', 'depth' => 0, 'walker' => '', 'theme_location' => '');
$args = hq_parse_args($args, $defaults);
/**
* Filter the arguments used to display a navigation menu.
*
* @since 0.0.1
*
* @see hq_nav_menu()
*
* @param array $args Array of hq_nav_menu() arguments.
*/
$args = apply_filters('hq_nav_menu_args', $args);
$args = (object) $args;
/**
* Filter whether to short-circuit the hq_nav_menu() output.
*
* Returning a non-null value to the filter will short-circuit
* hq_nav_menu(), echoing that value if $args->echo is true,
* returning that value otherwise.
*
* @since 0.0.1
*
* @see hq_nav_menu()
*
* @param string|null $output Nav menu output to short-circuit with. Default null.
* @param object $args An object containing hq_nav_menu() arguments.
*/
$nav_menu = apply_filters('pre_hq_nav_menu', null, $args);
if (null !== $nav_menu) {
if ($args->echo) {
echo $nav_menu;
return;
}
return $nav_menu;
}
// Get the nav menu based on the requested menu
$menu = hq_get_nav_menu_object($args->menu);
// Get the nav menu based on the theme_location
if (!$menu && $args->theme_location && ($locations = get_nav_menu_locations()) && isset($locations[$args->theme_location])) {
$menu = hq_get_nav_menu_object($locations[$args->theme_location]);
}
// get the first menu that has items if we still can't find a menu
if (!$menu && !$args->theme_location) {
$menus = hq_get_nav_menus();
foreach ($menus as $menu_maybe) {
if ($menu_items = hq_get_nav_menu_items($menu_maybe->term_id, array('update_post_term_cache' => false))) {
$menu = $menu_maybe;
break;
}
}
}
if (empty($args->menu)) {
$args->menu = $menu;
}
// If the menu exists, get its items.
if ($menu && !is_hq_error($menu) && !isset($menu_items)) {
$menu_items = hq_get_nav_menu_items($menu->term_id, array('update_post_term_cache' => false));
}
/*
* If no menu was found:
* - Fall back (if one was specified), or bail.
*
* If no menu items were found:
* - Fall back, but only if no theme location was specified.
* - Otherwise, bail.
*/
if ((!$menu || is_hq_error($menu) || isset($menu_items) && empty($menu_items) && !$args->theme_location) && isset($args->fallback_cb) && $args->fallback_cb && is_callable($args->fallback_cb)) {
return call_user_func($args->fallback_cb, (array) $args);
}
if (!$menu || is_hq_error($menu)) {
return false;
}
$nav_menu = $items = '';
$show_container = false;
if ($args->container) {
/**
* Filter the list of HTML tags that are valid for use as menu containers.
*
* @since 0.0.1
*
* @param array $tags The acceptable HTML tags for use as menu containers.
* Default is array containing 'div' and 'nav'.
*/
$allowed_tags = apply_filters('hq_nav_menu_container_allowedtags', array('div', 'nav'));
if (in_array($args->container, $allowed_tags)) {
$show_container = true;
$class = $args->container_class ? ' class="' . esc_attr($args->container_class) . '"' : ' class="menu-' . $menu->slug . '-container"';
$id = $args->container_id ? ' id="' . esc_attr($args->container_id) . '"' : '';
$nav_menu .= '<' . $args->container . $id . $class . '>';
}
}
// Set up the $menu_item variables
_hq_menu_item_classes_by_context($menu_items);
$sorted_menu_items = $menu_items_with_children = array();
foreach ((array) $menu_items as $menu_item) {
$sorted_menu_items[$menu_item->menu_order] = $menu_item;
if ($menu_item->menu_item_parent) {
$menu_items_with_children[$menu_item->menu_item_parent] = true;
}
}
// Add the menu-item-has-children class where applicable
if ($menu_items_with_children) {
foreach ($sorted_menu_items as &$menu_item) {
if (isset($menu_items_with_children[$menu_item->ID])) {
$menu_item->classes[] = 'menu-item-has-children';
}
}
}
unset($menu_items, $menu_item);
/**
* Filter the sorted list of menu item objects before generating the menu's HTML.
*
* @since 0.0.1
*
* @param array $sorted_menu_items The menu items, sorted by each menu item's menu order.
* @param object $args An object containing hq_nav_menu() arguments.
*/
$sorted_menu_items = apply_filters('hq_nav_menu_objects', $sorted_menu_items, $args);
$items .= walk_nav_menu_tree($sorted_menu_items, $args->depth, $args);
unset($sorted_menu_items);
// Attributes
if (!empty($args->menu_id)) {
$wrap_id = $args->menu_id;
} else {
$wrap_id = 'menu-' . $menu->slug;
while (in_array($wrap_id, $menu_id_slugs)) {
if (preg_match('#-(\\d+)$#', $wrap_id, $matches)) {
$wrap_id = preg_replace('#-(\\d+)$#', '-' . ++$matches[1], $wrap_id);
} else {
$wrap_id = $wrap_id . '-1';
}
}
}
$menu_id_slugs[] = $wrap_id;
$wrap_class = $args->menu_class ? $args->menu_class : '';
/**
* Filter the HTML list content for navigation menus.
*
* @since 0.0.1
*
* @see hq_nav_menu()
*
* @param string $items The HTML list content for the menu items.
* @param object $args An object containing hq_nav_menu() arguments.
*/
$items = apply_filters('hq_nav_menu_items', $items, $args);
/**
* Filter the HTML list content for a specific navigation menu.
*
* @since 0.0.1
*
* @see hq_nav_menu()
*
* @param string $items The HTML list content for the menu items.
* @param object $args An object containing hq_nav_menu() arguments.
*/
$items = apply_filters("hq_nav_menu_{$menu->slug}_items", $items, $args);
// Don't print any markup if there are no items at this point.
if (empty($items)) {
return false;
}
$nav_menu .= sprintf($args->items_wrap, esc_attr($wrap_id), esc_attr($wrap_class), $items);
unset($items);
if ($show_container) {
$nav_menu .= '</' . $args->container . '>';
}
/**
* Filter the HTML content for navigation menus.
*
* @since 0.0.1
*
* @see hq_nav_menu()
*
* @param string $nav_menu The HTML content for the navigation menu.
* @param object $args An object containing hq_nav_menu() arguments.
*/
$nav_menu = apply_filters('hq_nav_menu', $nav_menu, $args);
if ($args->echo) {
echo $nav_menu;
} else {
return $nav_menu;
}
}
