interface UltimenuToolInterface in Ultimenu 8.2

Interface for Ultimenu tools.

Hierarchy

• interface \Drupal\ultimenu\UltimenuToolInterface

File

src/UltimenuToolInterface.php, line 8

Namespace

Drupal\ultimenu

interface UltimenuToolInterface {

  /**
   * Defines constant maz length for the region key.
   */
  const MAX_LENGTH = 28;

  /**
   * Gets the shortened hash of a menu item key.
   *
   * @param string $key
   *   The menu item key.
   *
   * @return string
   *   The shortened hash.
   */
  public function getShortenedHash($key);

  /**
   * Gets the shortened UUID.
   *
   * @param string $key
   *   The menu item key with UUID.
   *
   * @return string
   *   The shortened UUID.
   */
  public function getShortenedUuid($key);

  /**
   * Simplify menu names or menu item titles for region key.
   *
   * If region key is to use menu item title:
   * Region key: ultimenu_LOOOOOOOOOOOONGMENUNAME_LOOOOOOOOOOOOOOOOOONGMENUITEM.
   * If region key is to use unfriendly key UUID, we'll only care for menu name.
   * Region key: ultimenu_LOOOOOOOOOOOOOONGMENUNAME_1c2d3e4.
   *
   * @param string $string
   *   The Menu name or menu item title.
   * @param int $max_length
   *   The amount of characters to truncate.
   *
   * @return string
   *   The truncated menu properties ready to use for region key.
   */
  public function truncateRegionKey($string, $max_length = self::MAX_LENGTH);

  /**
   * Gets the region key.
   *
   * @param object $link
   *   The menu item link object.
   * @param int $max_length
   *   The amount of characters to truncate.
   *
   * @return string
   *   The region key name based on shortened UUID, or menu item title.
   */
  public function getRegionKey($link, $max_length = self::MAX_LENGTH);

  /**
   * Returns the default theme Ultimenu regions from theme .info.yml.
   *
   * @param array $ultimenu_regions
   *   The ultimenu theme regions.
   *
   * @return array
   *   The Ultimenu regions.
   */
  public function parseThemeInfo(array $ultimenu_regions = []);

}

Members

Name	Modifiers	Type	Description	Overrides
UltimenuToolInterface::getRegionKey	public	function	Gets the region key.	1
UltimenuToolInterface::getShortenedHash	public	function	Gets the shortened hash of a menu item key.	1
UltimenuToolInterface::getShortenedUuid	public	function	Gets the shortened UUID.	1
UltimenuToolInterface::MAX_LENGTH		constant	Defines constant maz length for the region key.
UltimenuToolInterface::parseThemeInfo	public	function	Returns the default theme Ultimenu regions from theme .info.yml.	1
UltimenuToolInterface::truncateRegionKey	public	function	Simplify menu names or menu item titles for region key.	1