LittleDemon WebShell

<?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' );