*/ final class Menu_Icons_Front_End { /** * Icon types * * @since 0.9.0 * @access protected * @var array */ protected static $icon_types = array(); /** * Default icon style * * @since 0.9.0 * @access protected * @var array */ protected static $default_style = array( 'font_size' => array( 'property' => 'font-size', 'value' => '1.2', 'unit' => 'em', ), 'vertical_align' => array( 'property' => 'vertical-align', 'value' => 'middle', 'unit' => null, ), 'svg_width' => array( 'property' => 'width', 'value' => '1', 'unit' => 'em', ), ); /** * Hidden label class * * @since 0.9.0 * @access protected * @var string */ protected static $hidden_label_class = 'visuallyhidden'; /** * Add hooks for front-end functionalities * * @since 0.9.0 */ public static function init() { $active_types = Menu_Icons_Settings::get( 'global', 'icon_types' ); if ( empty( $active_types ) ) { return; } foreach ( Menu_Icons::get( 'types' ) as $type ) { if ( in_array( $type->id, $active_types, true ) ) { self::$icon_types[ $type->id ] = $type; } } /** * Allow themes/plugins to override the hidden label class * * @since 0.8.0 * @param string $hidden_label_class Hidden label class. * @return string */ self::$hidden_label_class = apply_filters( 'menu_icons_hidden_label_class', self::$hidden_label_class ); /** * Allow themes/plugins to override default inline style * * @since 0.9.0 * @param array $default_style Default inline style. * @return array */ self::$default_style = apply_filters( 'menu_icons_default_style', self::$default_style ); add_action( 'wp_enqueue_scripts', array( __CLASS__, '_enqueue_styles' ), 7 ); add_filter( 'wp_nav_menu_args', array( __CLASS__, '_add_menu_item_title_filter' ) ); add_filter( 'wp_nav_menu', array( __CLASS__, '_remove_menu_item_title_filter' ) ); } /** * Get nav menu ID based on arguments passed to wp_nav_menu() * * @since 0.3.0 * @param array $args wp_nav_menu() Arguments * @return mixed Nav menu ID or FALSE on failure */ public static function get_nav_menu_id( $args ) { $args = (object) $args; $menu = wp_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 = wp_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 = wp_get_nav_menus(); foreach ( $menus as $menu_maybe ) { if ( $menu_items = wp_get_nav_menu_items( $menu_maybe->term_id, array( 'update_post_term_cache' => false ) ) ) { $menu = $menu_maybe; break; } } } if ( is_object( $menu ) && ! is_wp_error( $menu ) ) { return $menu->term_id; } else { return false; } } /** * Enqueue stylesheets * * @since 0.1.0 * @wp_hook action wp_enqueue_scripts * @link http://codex.wordpress.org/Plugin_API/Action_Reference/wp_enqueue_scripts */ public static function _enqueue_styles() { foreach ( self::$icon_types as $type ) { if ( wp_style_is( $type->stylesheet_id, 'registered' ) ) { wp_enqueue_style( $type->stylesheet_id ); } } /** * Allow plugins/themes to override the extra stylesheet location * * @since 0.9.0 * @param string $extra_stylesheet_uri Extra stylesheet URI. */ $extra_stylesheet_uri = apply_filters( 'menu_icons_extra_stylesheet_uri', sprintf( '%scss/extra%s.css', Menu_Icons::get( 'url' ), kucrut_get_script_suffix() ) ); wp_enqueue_style( 'menu-icons-extra', $extra_stylesheet_uri, false, Menu_Icons::VERSION ); } /** * Add filter to 'the_title' hook * * We need to filter the menu item title but **not** regular post titles. * Thus, we're adding the filter when `wp_nav_menu()` is called. * * @since 0.1.0 * @wp_hook filter wp_nav_menu_args * @param array $args Not used. * * @return array */ public static function _add_menu_item_title_filter( $args ) { add_filter( 'the_title', array( __CLASS__, '_add_icon' ), 999, 2 ); return $args; } /** * Remove filter from 'the_title' hook * * Because we don't want to filter post titles, we need to remove our * filter when `wp_nav_menu()` exits. * * @since 0.1.0 * @wp_hook filter wp_nav_menu * @param array $nav_menu Not used. * @return array */ public static function _remove_menu_item_title_filter( $nav_menu ) { remove_filter( 'the_title', array( __CLASS__, '_add_icon' ), 999, 2 ); return $nav_menu; } /** * Add icon to menu item title * * @since 0.1.0 * @since 0.9.0 Renamed the method to `add_icon()`. * @wp_hook filter the_title * @param string $title Menu item title. * @param int $id Menu item ID. * * @return string */ public static function _add_icon( $title, $id ) { $meta = Menu_Icons_Meta::get( $id ); $icon = self::get_icon( $meta ); if ( empty( $icon ) ) { return $title; } $title_class = ! empty( $meta['hide_label'] ) ? self::$hidden_label_class : ''; $title_wrapped = sprintf( '%s', ( ! empty( $title_class ) ) ? sprintf( ' class="%s"', esc_attr( $title_class ) ) : '', $title ); if ( 'after' === $meta['position'] ) { $title_with_icon = "{$title_wrapped}{$icon}"; } else { $title_with_icon = "{$icon}{$title_wrapped}"; } /** * Allow plugins/themes to override menu item markup * * @since 0.8.0 * * @param string $title_with_icon Menu item markup after the icon is added. * @param integer $id Menu item ID. * @param array $meta Menu item metadata values. * @param string $title Original menu item title. * * @return string */ $title_with_icon = apply_filters( 'menu_icons_item_title', $title_with_icon, $id, $meta, $title ); return $title_with_icon; } /** * Get icon * * @since 0.9.0 * @param array $meta Menu item meta value. * @return string */ public static function get_icon( $meta ) { $icon = ''; // Icon type is not set. if ( empty( $meta['type'] ) ) { return $icon; } // Icon is not set. if ( empty( $meta['icon'] ) ) { return $icon; } // Icon type is not registered/enabled. if ( ! isset( self::$icon_types[ $meta['type'] ] ) ) { return $icon; } $type = self::$icon_types[ $meta['type'] ]; $callbacks = array( array( $type, 'get_icon' ), array( __CLASS__, "get_{$type->id}_icon" ), array( __CLASS__, "get_{$type->template_id}_icon" ), ); foreach ( $callbacks as $callback ) { if ( is_callable( $callback ) ) { $icon = call_user_func( $callback, $meta ); break; } } return $icon; } /** * Get icon style * * @since 0.9.0 * @param array $meta Menu item meta value. * @param array $keys Style properties. * @param bool $as_attribute Optional. Whether to output the style as HTML attribute or value only. * Defaults to TRUE. * @return string */ public static function get_icon_style( $meta, $keys, $as_attribute = true ) { $style_a = array(); $style_s = ''; foreach ( $keys as $key ) { if ( ! isset( self::$default_style[ $key ] ) ) { continue; } $rule = self::$default_style[ $key ]; if ( ! isset( $meta[ $key ] ) || $meta[ $key ] === $rule['value'] ) { continue; } $value = $meta[ $key ]; if ( ! empty( $rule['unit'] ) ) { $value .= $rule['unit']; } $style_a[ $rule['property'] ] = $value; } if ( empty( $style_a ) ) { return $style_s; } foreach ( $style_a as $key => $value ) { $style_s .= "{$key}:{$value};"; } $style_s = esc_attr( $style_s ); if ( $as_attribute ) { $style_s = sprintf( ' style="%s"', $style_s ); } return $style_s; } /** * Get icon classes * * @since 0.9.0 * @param array $meta Menu item meta value. * @param string $output Whether to output the classes as string or array. Defaults to string. * @return string|array */ public static function get_icon_classes( $meta, $output = 'string' ) { $classes = array( '_mi' ); if ( empty( $meta['hide_label'] ) ) { $classes[] = "_{$meta['position']}"; } if ( 'string' === $output ) { $classes = implode( ' ', $classes ); } return $classes; } /** * Get font icon * * @since 0.9.0 * @param array $meta Menu item meta value. * @return string */ public static function get_font_icon( $meta ) { $classes = sprintf( '%s %s %s', self::get_icon_classes( $meta ), $meta['type'], $meta['icon'] ); $style = self::get_icon_style( $meta, array( 'font_size', 'vertical_align' ) ); return sprintf( '', esc_attr( $classes ), $style ); } /** * Get image icon * * @since 0.9.0 * @param array $meta Menu item meta value. * @return string */ public static function get_image_icon( $meta ) { $args = array( 'class' => sprintf( '%s _image', self::get_icon_classes( $meta ) ), 'aria-hidden' => 'true', ); $style = self::get_icon_style( $meta, array( 'vertical_align' ), false ); if ( ! empty( $style ) ) { $args['style'] = $style; } return wp_get_attachment_image( $meta['icon'], $meta['image_size'], false, $args ); } /** * Get SVG icon * * @since 0.9.0 * @param array $meta Menu item meta value. * @return string */ public static function get_svg_icon( $meta ) { $classes = sprintf( '%s _svg', self::get_icon_classes( $meta ) ); $style = self::get_icon_style( $meta, array( 'svg_width', 'vertical_align' ) ); return sprintf( '', esc_url( wp_get_attachment_url( $meta['icon'] ) ), esc_attr( $classes ), $style ); } }