Shortcodes_Ultimate_Shortcodes

The shortcodes-ultimate Shortcodes Ultimate Shortcodes class.

Published Date - February 15, 2021

Defined

The class is defined in the following location(s).

shortcodes-ultimate/includes/class-shortcodes-ultimate-shortcodes.php

class Shortcodes_Ultimate_Shortcodes {

	/**
	 * The collection of available shortcodes.
	 *
	 * @since  5.0.5
	 * @var array
	 */
	private static $shortcodes = array();

	/**
	 * Get all shortcodes.
	 *
	 * @since  5.0.5
	 * @return array The collection of available shortcodes.
	 */
	public static function get_all() {

		$shortcodes = apply_filters( 'su/data/shortcodes', self::$shortcodes );
		$shortcodes = self::add_ids( $shortcodes );

		return $shortcodes;

	}

	/**
	 * Get specific shortcode by ID.
	 *
	 * @since  5.0.5
	 * @param string  $id The ID (without prefix) of shortcode.
	 * @return array|boolean   Shortcode data if found, False otherwise.
	 */
	public static function get( $id ) {

		$shortcodes = self::get_all();

		return isset( $shortcodes[ $id ] )
			? $shortcodes[ $id ]
			: false;

	}

	/**
	 * Add a shortcode.
	 *
	 * @since  5.0.5
	 * @param array   $data    New shortcode data.
	 * @param boolean $replace Replace existing shortcode or not.
	 */
	public static function add( $data = array(), $replace = true ) {

		if ( ! isset( $data['id'], $data['callback'] ) ) {

			trigger_error( 'Shortcode was not added. Missing required params (ID, callback).' );

			return;

		}

		if ( ! $replace && self::get( $data['id'] ) ) {
			return;
		}

		self::$shortcodes[ $data['id'] ] = $data;

	}

	/**
	 * Remove a shortcode.
	 *
	 * @since  5.0.5
	 * @param string  $id Shortcode ID to remove.
	 */
	public static function remove( $id ) {

		if ( isset( self::$shortcodes[ $id ] ) ) {
			unset( self::$shortcodes[ $id ] );
		}

	}

	/**
	 * Register all available shortcodes.
	 *
	 * @since  5.0.5
	 */
	public static function register() {

		$shortcodes = self::get_all();
		$prefix = su_get_shortcode_prefix();

		foreach ( $shortcodes as $id => $shortcode ) {

			if ( isset( $shortcode['callback'] ) && is_callable( $shortcode['callback'] ) ) {
				$callback = $shortcode['callback'];
			}

			elseif ( isset( $shortcode['function'] ) && is_callable( $shortcode['function'] ) ) {
				$callback = $shortcode['function'];
			}

			else {
				continue;
			}

			add_shortcode( $prefix . $id, $callback );

		}

	}

	public static function add_ids( $shortcodes ) {

		foreach ( $shortcodes as $id => $shortcode ) {
			$shortcodes[ $id ] = array_merge( array( 'id' => $id ), (array) $shortcode );
		}

		return $shortcodes;

	}

}