laipower/wp-content/plugins/menu-icons/includes/front.php
2020-04-07 13:03:04 +00:00

431 lines
10 KiB
PHP

<?php
/**
* Front end functionalities
*
* @package Menu_Icons
* @author Dzikri Aziz <kvcrvt@gmail.com>
*/
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(
'<span%s>%s</span>',
( ! 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( '<i class="%s" aria-hidden="true"%s></i>', 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(
'<img src="%s" class="%s" aria-hidden="true"%s />',
esc_url( wp_get_attachment_url( $meta['icon'] ) ),
esc_attr( $classes ),
$style
);
}
}