MAINHACK

Viewing / Editing File: class-svg.php

<?php
/**
 * SVG Class
 *
 * @package    Auberge
 * @copyright  WebMan Design, Oliver Juhas
 *
 * @since    2.5.0
 * @version  2.5.4
 *
 * Contents:
 *
 *   0) Init
 *  10) Include SVG images
 *  20) Return SVG markup
 * 100) Helpers
 */
class Auberge_SVG {

/**
	 * 0) Init
	 */

private static $instance;

/**
		 * Constructor
		 *
		 * @since    2.5.0
		 * @version  2.5.4
		 */
		private function __construct() {

// Processing

// Hooks

// Actions

add_action( 'wp_footer', __CLASS__ . '::include_files', 9999 );

} // /__construct

/**
		 * Initialization (get instance)
		 *
		 * @since    2.5.0
		 * @version  2.5.0
		 */
		public static function init() {

// Processing

if ( null === self::$instance ) {
					self::$instance = new self;
				}

// Output

return self::$instance;

} // /init

/**
	 * 10) Include SVG images
	 */

/**
		 * Add SVG images to the footer.
		 *
		 * @since    2.5.0
		 * @version  2.5.4
		 */
		public static function include_files() {

// Output

// Social icons SVG sprite.

if ( has_nav_menu( 'social' ) ) {
						$svg_icons = get_theme_file_path( 'assets/images/svg/social-icons.svg' );
						if ( file_exists( $svg_icons ) ) {
							require_once $svg_icons;
						}
					}

} // /include_files

/**
	 * 20) Return SVG markup
	 */

/**
		 * Get SVG icon by reference from SVG sprite.
		 *
		 * @since    2.5.0
		 * @version  2.5.4
		 *
		 * @param array $args {
		 *   Parameters needed to display an SVG.
		 *
		 *   @type string  $icon      Required SVG icon filename.
		 *   @type string  $title     Optional SVG title.
		 *   @type string  $desc      Optional SVG description.
		 *   @type string  $class     Optional SVG class.
		 *   @type string  $base      Optional SVG ID base.
		 *   @type boolean $fallback  Output an SVG fallback markup?
		 * }
		 */
		public static function get( $args = array() ) {

// Requirements check

if (
					empty( $args )
					|| false === array_key_exists( 'icon', $args )
				) {
					return;
				}

// Variables

$output = array();

$args = wp_parse_args( $args, array(
					'icon'     => '',
					'title'    => '',
					'desc'     => '',
					'class'    => 'svgicon',
					'base'     => 'icon',
					'fallback' => false,
				) );

$args = (array) apply_filters( 'wmhook_auberge_svg_get_args', $args );

$aria_hidden     = ' aria-hidden="true"';
				$aria_labelledby = '';

/**
				 * This theme doesn't use the SVG title or description attributes; non-decorative icons are described with .screen-reader-text.
				 *
				 * However, child themes can use the title and description to add information to non-decorative SVG icons to improve accessibility.
				 *
				 * Example 1 with title: <?php echo Auberge_SVG::get( array( 'icon' => 'arrow-right', 'title' => __( 'This is the title', 'textdomain' ) ) ); ?>
				 *
				 * Example 2 with title and description: <?php echo Auberge_SVG::get( array( 'icon' => 'arrow-right', 'title' => __( 'This is the title', 'textdomain' ), 'desc' => __( 'This is the description', 'textdomain' ) ) ); ?>
				 *
				 * See https://www.paciellogroup.com/blog/2013/12/using-aria-enhance-svg-accessibility/.
				 */
				if ( $args['title'] ) {

$aria_hidden     = '';
					$unique_id       = uniqid();
					$aria_labelledby = ' aria-labelledby="title-' . $unique_id . '"';

if ( $args['desc'] ) {
						$aria_labelledby = ' aria-labelledby="title-' . $unique_id . ' desc-' . $unique_id . '"';
					}

}

// Processing

$output[10] = '<svg class="' . esc_attr( $args['class'] ) . ' ' . esc_attr( $args['base'] ) . '-' . esc_attr( $args['icon'] ) . '"' . $aria_hidden . $aria_labelledby . ' role="img">';

if ( $args['title'] ) {

$output[15] = '<title id="title-' . $unique_id . '">' . esc_html( $args['title'] ) . '</title>';

if ( $args['desc'] ) {
						$output[16] = '<desc id="desc-' . $unique_id . '">' . esc_html( $args['desc'] ) . '</desc>';
					}

}

/**
				 * Display the icon.
				 *
				 * The whitespace around `<use>` is intentional - it is a work around to a keyboard navigation bug in Safari 10.
				 *
				 * See https://core.trac.wordpress.org/ticket/38387.
				 * See https://developer.mozilla.org/en-US/docs/Web/SVG/Attribute/xlink:href.
				 */
				$output[20] = ' <use href="#' . esc_attr( $args['base'] ) . '-' . esc_html( $args['icon'] ) . '" xlink:href="#' . esc_attr( $args['base'] ) . '-' . esc_html( $args['icon'] ) . '"></use> ';

// Add some markup to use as a fallback for browsers that do not support SVGs

if ( $args['fallback'] ) {
						$output[25] = '<span class="svg-fallback ' . esc_attr( $args['base'] ) . '-' . esc_attr( $args['icon'] ) . '"></span>';
					}

$output[30] = '</svg>';

$output = (array) apply_filters( 'wmhook_auberge_svg_get_output', $output, $args );

ksort( $output );

// Output

return implode( '', $output );

} // /get

/**
	 * 100) Helpers
	 */

/**
		 * Get social links icons setup array.
		 *
		 * Array key = a part of link URL.
		 * Array value = a part SVG symbol ID.
		 *
		 * @since    2.5.0
		 * @version  2.5.0
		 */
		public static function get_social_icons() {

// Output

return (array) apply_filters( 'wmhook_auberge_svg_get_social_icons', array() );

} // /get_social_icons

} // /Auberge_SVG

add_action( 'after_setup_theme', 'Auberge_SVG::init' );

Cancel / Back

[ MAINHACK ]

Viewing / Editing File: class-svg.php

Server Info

System Features

User Info