/**
* Apply mega menu walker for main theme menu
*
* @since 1.0.0
*
* @param array $args default nav menu args
* @return array modified args with mega menu walker
*/
public function add_walker_to_nav_menu($args)
{
$mega_menu_location = cherry_mega_menu_get_option('mega-menu-location', 'primary');
if (!isset($args['theme_location']) || $mega_menu_location != $args['theme_location']) {
return $args;
}
$event = cherry_mega_menu_get_option('mega-menu-event', 'hover');
$effect = cherry_mega_menu_get_option('mega-menu-effect', 'slide-top');
$direction = cherry_mega_menu_get_option('mega-menu-direction', apply_filters('cherry_mega_menu_default_direction', 'horizontal', $args));
$parent_selector = cherry_mega_menu_get_option('mega-menu-parent-container', '.cherry-mega-menu');
$mobile_trigger = cherry_mega_menu_get_option('mega-menu-mobile-trigger', 767);
global $cherry_mega_menu_total_columns;
$wrapper_atts = array('id' => '%1$s', 'class' => '%2$s cherry-mega-no-js cherry-mega-menu mega-menu-direction-' . $direction . ' total-columns-' . $cherry_mega_menu_total_columns, 'data-event' => $event, 'data-effect' => $effect, 'data-direction' => $direction, 'data-mobile-trigger' => $mobile_trigger, 'data-parent-selector' => $parent_selector);
/**
* Filter megamenu wrapper attributes
*
* @since 1.0.0
*
* @var array filtered attributes
* @param array $wrapper_atts default attributes
* @param array $args default nav menu arguments
*/
$wrapper_atts = apply_filters('cherry_mega_menu_wrapper_atts', $wrapper_atts, $args);
$atts = cherry_mega_menu_parse_atts($wrapper_atts);
$new_args = array('container' => 'ul', 'menu_class' => 'menu-items', 'items_wrap' => '<ul' . $atts . '>%3$s</ul>', 'walker' => new cherry_mega_menu_walker());
$args = wp_parse_args($new_args, $args);
return $args;
}
/**
* Start the element output.
*
* @see Walker::start_el()
*
* @since 1.0.0
*
* @param string $output Passed by reference. Used to append additional content.
* @param object $item Menu item data object.
* @param int $depth Depth of menu item. Used for padding.
* @param array $args An array of arguments. @see wp_nav_menu()
* @param int $id Current item ID.
*/
public function start_el(&$output, $item, $depth = 0, $args = array(), $id = 0)
{
$indent = $depth ? str_repeat("\t", $depth) : '';
$mega_settings = isset($item->megamenu_settings) ? $item->megamenu_settings : array();
if (!isset($item->description)) {
$item->description = false;
}
$mega_settings = wp_parse_args($mega_settings, array('align' => 'top-left', 'type' => '', 'item-hide-text' => '', 'item-hide-arrow' => '', 'item-icon' => '', 'item-arrow' => '', 'sub-items-to-cols' => '', 'sub-cols-num' => '4', 'item-submenu-position' => 'fullwidth', 'item-width-fullscreen' => '100%', 'item-width-desktop' => '100%', 'item-width-tablet' => '100%', 'item-hide-mobile' => ''));
if (0 === $depth && 'sub-items-to-cols' == $mega_settings['sub-items-to-cols']) {
$this->child_columns = $mega_settings['sub-cols-num'];
} elseif (0 === $depth && 'sub-items-to-cols' != $mega_settings['sub-items-to-cols']) {
$this->child_columns = '';
}
$classes = empty($item->classes) ? array() : (array) $item->classes;
$classes[] = 'menu-item-' . $item->ID;
if ($depth == 0) {
$classes[] = 'cherry-mega-menu-top-item';
$classes[] = 'item-submenu-position-' . $mega_settings['item-submenu-position'];
} else {
$classes[] = 'cherry-mega-menu-sub-item';
}
if ($this->has_children) {
$classes[] = 'cherry-mega-menu-has-children';
}
if ($depth == 0 && 'megamenu' == $mega_settings['type'] && $this->has_children) {
$classes[] = 'item-type-megamenu';
$this->is_mega_sub = true;
}
if ('megamenu' != $mega_settings['type'] && $this->has_children) {
$classes[] = 'item-type-standard';
$this->is_mega_sub = false;
}
if (isset($mega_settings['align']) && $mega_settings['align'] != 'left' && $depth == 0) {
$classes[] = 'item-align-' . $mega_settings['align'];
}
if ($depth > 0) {
$classes[] = 'item-nested-sub';
$classes[] = 'item-nested-sub-' . $depth;
}
if (1 === $depth && $this->child_columns) {
$classes[] = 'menu-columns-' . round(12 / $this->child_columns, 0);
$classes[] = 'sub-column-title';
}
if (1 < $depth && $this->child_columns) {
$classes[] = 'sub-column-item';
}
if (isset($item->type) && 'widget' == $item->type) {
$classes[] = 'menu-item-widget';
} else {
$classes[] = 'menu-item-standard';
}
if (in_array('current_page_item', $classes) || in_array('current-menu-item', $classes)) {
wp_cache_set('cherry_menu_has_active', 'has', 'cherry');
}
/**
* Default WP filter
*
* Filter the CSS class(es) applied to a menu item's list item element.
*
* @since 3.0.0
* @since 4.1.0 The `$depth` parameter was added.
*
* @param array $classes The CSS classes that are applied to the menu item's `<li>` element.
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$class_names = join(' ', apply_filters('nav_menu_css_class', array_filter($classes), $item, $args, $depth));
$class_names = $class_names ? ' class="' . esc_attr($class_names) . '"' : '';
/**
* Default WP filter
*
* Filter the ID applied to a menu item's list item element.
*
* @since 3.0.1
* @since 4.1.0 The `$depth` parameter was added.
*
* @param string $menu_id The ID that is applied to the menu item's `<li>` element.
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$id = apply_filters('nav_menu_item_id', 'menu-item-' . $item->ID, $item, $args, $depth);
$id = $id ? ' id="' . esc_attr($id) . '"' : '';
$meta_atts = '';
$hr_position = !in_array($mega_settings['item-submenu-position'], array('vertical-full', 'vertical-parent')) ? $mega_settings['item-submenu-position'] : 'fullwidth';
$vr_position = in_array($mega_settings['item-submenu-position'], array('vertical-full', 'vertical-parent')) ? $mega_settings['item-submenu-position'] : 'vertical-parent';
if ($depth == 0 && $this->has_children && 'megamenu' == $mega_settings['type']) {
$meta_atts = array('data-width-fullscreen' => cherry_mega_menu_sanitize_width($mega_settings['item-width-fullscreen']), 'data-width-desktop' => cherry_mega_menu_sanitize_width($mega_settings['item-width-desktop']), 'data-width-tablet' => cherry_mega_menu_sanitize_width($mega_settings['item-width-tablet']), 'data-hide-mobile' => $mega_settings['item-hide-mobile'], 'data-sub-hr-position' => $hr_position, 'data-sub-vr-position' => $vr_position, 'data-sub-type' => $mega_settings['type']);
} elseif ($depth == 0 && $this->has_children && 'megamenu' != $mega_settings['type']) {
$meta_atts = array('data-hide-mobile' => $mega_settings['item-hide-mobile'], 'data-sub-hr-position' => $hr_position, 'data-sub-vr-position' => $vr_position, 'data-sub-type' => 'standard');
}
/**
* Filter additional attributes for mega menu item
*
* @since 1.0.0
*
* @param array $meta_atts default attributes
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$meta_atts = apply_filters('cherry_mega_menu_additional_item_attributes', $meta_atts, $item, $args, $depth);
$meta_atts = cherry_mega_menu_parse_atts($meta_atts);
$output .= $indent . '<li' . $id . $class_names . $meta_atts . '>';
// output the widgets
if ($item->content) {
$item_output = $item->content;
/**
* Default WP filter
*
* Filter a menu item's starting output.
*
* The menu item's starting output only includes `$args->before`, the opening `<a>`,
* the menu item's title, the closing `</a>`, and `$args->after`. Currently, there is
* no filter for modifying the opening and closing `<li>` for a menu item.
*
* @since 3.0.0
*
* @param string $item_output The menu item's starting HTML output.
* @param object $item Menu item data object.
* @param int $depth Depth of menu item. Used for padding.
* @param array $args An array of {@see wp_nav_menu()} arguments.
*/
$output .= apply_filters('walker_nav_menu_start_el', $item_output, $item, $depth, $args);
return;
}
/** This filter is documented in wp-includes/post-template.php */
$link_title = apply_filters('the_title', $item->title, $item->ID);
$atts = array();
$atts['title'] = !empty($item->attr_title) ? $item->attr_title : '';
$atts['target'] = !empty($item->target) ? $item->target : '';
$atts['rel'] = !empty($item->xfn) ? $item->xfn : '';
$atts['href'] = !empty($item->url) ? $item->url : '';
$atts['data-title'] = $link_title;
/**
* Default WP filter
*
* Filter the HTML attributes applied to a menu item's anchor element.
*
* @since 3.6.0
* @since 4.1.0 The `$depth` parameter was added.
*
* @param array $atts {
* The HTML attributes applied to the menu item's `<a>` element, empty strings are ignored.
*
* @type string $title Title attribute.
* @type string $target Target attribute.
* @type string $rel The rel attribute.
* @type string $href The href attribute.
* }
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$atts = apply_filters('nav_menu_link_attributes', $atts, $item, $args, $depth);
$attributes = '';
foreach ($atts as $attr => $value) {
if (!empty($value)) {
$value = 'href' === $attr ? esc_url($value) : esc_attr($value);
$attributes .= ' ' . $attr . '="' . $value . '"';
}
}
$item_output = $args->before;
$item_output .= '<a' . $attributes . '>';
$link_before = $args->link_before;
if ($mega_settings['item-icon']) {
/**
* Filter menu item icon HTML format
*
* @since 1.0.0
*
* @param string default FontAwesome icon format
*/
$icon_format = apply_filters('cherry_mega_menu_icon_format', '<i class="fa %1$s mega-menu-icon"></i>');
$link_before .= sprintf($icon_format, esc_attr($mega_settings['item-icon']));
}
/**
* Filter HTML outputed before link text. By default appends menu icon, if exist
*
* @since 1.0.0
*
* @param string $link_before default HTML markup before link text
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$item_output .= apply_filters('cherry_mega_menu_before_link_text', $link_before, $item, $args, $depth);
if (!$mega_settings['item-hide-text']) {
$item_output .= $link_title;
}
$link_after = $args->link_after;
if ($mega_settings['item-arrow'] && $this->has_children && !$mega_settings['item-hide-arrow']) {
/**
* Filter menu item arrow HTML format
*
* @since 1.0.0
*
* @param string default FontAwesome icon format
*/
$icon_format = apply_filters('cherry_mega_menu_arrow_format', '<i class="fa %1$s mega-menu-arrow %2$s"></i>');
$arrow_level = $depth > 0 ? 'sub-arrow' : 'top-level-arrow';
$link_after = sprintf($icon_format, esc_attr($mega_settings['item-arrow']), $arrow_level) . $link_after;
} elseif ($this->has_children && $depth == 0 && !$mega_settings['item-hide-arrow']) {
/**
* Filter default submenu arrow indicator for top level item
*
* @since 1.0.0
*
* @param string Default arrow HTML
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$default_arrow = apply_filters('cherry_mega_menu_default_arrow_top_level', '<i class="fa fa-angle-down mega-menu-arrow top-level-arrow"></i>', $item, $args, $depth);
$link_after = $default_arrow . $link_after;
} elseif ($this->has_children && $depth > 0 && !$mega_settings['item-hide-arrow']) {
/**
* Filter default submenu arrow indicator for nested level item
*
* @since 1.0.0
*
* @param string Default arrow HTML
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$default_arrow = apply_filters('cherry_mega_menu_default_arrow_nested_level', '<i class="fa fa-angle-right mega-menu-arrow sub-arrow"></i>', $item, $args, $depth);
$link_after = $default_arrow . $link_after;
}
/**
* Filter HTML outputed before link text. By default appends menu icon, if exist
*
* @since 1.0.0
*
* @param string $link_after default HTML markup after link text
* @param object $item The current menu item.
* @param array $args An array of {@see wp_nav_menu()} arguments.
* @param int $depth Depth of menu item. Used for padding.
*/
$item_output .= apply_filters('cherry_mega_menu_after_link_text', $link_after, $item, $args, $depth);
$item_output .= '</a>';
$item_output .= $args->after;
/**
* Default WP filter
*
* Filter a menu item's starting output.
*
* The menu item's starting output only includes `$args->before`, the opening `<a>`,
* the menu item's title, the closing `</a>`, and `$args->after`. Currently, there is
* no filter for modifying the opening and closing `<li>` for a menu item.
*
* @since 3.0.0
*
* @param string $item_output The menu item's starting HTML output.
* @param object $item Menu item data object.
* @param int $depth Depth of menu item. Used for padding.
* @param array $args An array of {@see wp_nav_menu()} arguments.
*/
$output .= apply_filters('walker_nav_menu_start_el', $item_output, $item, $depth, $args);
}
