interface UltimenuManagerInterface in Ultimenu 8.2

Interface for Ultimenu manager.

Hierarchy

• interface \Drupal\ultimenu\UltimenuManagerInterface

4 files declare their use of UltimenuManagerInterface

UltimenuBlock.php in src/Plugin/Derivative/UltimenuBlock.php

UltimenuBlock.php in src/Plugin/Block/UltimenuBlock.php

UltimenuController.php in src/Controller/UltimenuController.php

UltimenuSettingsForm.php in src/Form/UltimenuSettingsForm.php

File

src/UltimenuManagerInterface.php, line 10

Namespace

Drupal\ultimenu

interface UltimenuManagerInterface {

  /**
   * Returns the module handler.
   *
   * @var \Drupal\Core\Extension\ModuleHandlerInterface
   */
  public function getModuleHandler();

  /**
   * Returns the available menus, excluding some admin menus.
   *
   * @return array
   *   The menus.
   */
  public function getMenus();

  /**
   * Returns the contents using theme_ultimenu().
   *
   * @param array $build
   *   The array containing: config.
   *
   * @return array
   *   The alterable and renderable array of Ultimenu items.
   */
  public function build(array $build = []);

  /**
   * Returns array of needed assets suitable for #attached property.
   *
   * @param array $config
   *   The config which determine what library to attach.
   *
   * @return array
   *   The supported libraries.
   */
  public function attach(array $config = []);

  /**
   * Build the menu to contain Ultimenu regions.
   *
   * Helper function for ::build().
   *
   * @param array $config
   *   The config available for the menu tree.
   * @param \Drupal\Core\Cache\CacheableMetadata &$tree_access_cacheability
   *   Internal use only. The aggregated cacheability metadata for the access
   *   results across the entire tree. Used when rendering the root level.
   * @param \Drupal\Core\Cache\CacheableMetadata &$tree_link_cacheability
   *   Internal use only. The aggregated cacheability metadata for the menu
   *   links across the entire tree. Used when rendering the root level.
   *
   * @return array
   *   The value to use for the #items property of a renderable menu.
   *
   * @throws \DomainException
   */
  public function buildMenuTree(array $config, CacheableMetadata &$tree_access_cacheability, CacheableMetadata &$tree_link_cacheability);

  /**
   * Build the Ultimenu item.
   *
   * @param object $data
   *   The data containing menu item.
   * @param array $active_trails
   *   The menu item active trail ids.
   * @param array $config
   *   The config available for the menu item.
   *
   * @return array
   *   An array of the ultimenu item.
   */
  public function buildMenuItem($data, array $active_trails, array $config);

  /**
   * Returns the Ultimenu blocks.
   *
   * @return array
   *   The blocks.
   */
  public function getUltimenuBlocks();

  /**
   * The array of available Ultimenu regions based on enabled menu items.
   *
   * @return array
   *   An array of regions definition dependent on available menu items.
   */
  public function getRegions();

  /**
   * Returns the array of enabled Ultimenu regions based on enabled settings.
   *
   * @return array
   *   An array of enabled regions definition based on enabled menu items.
   */
  public function getEnabledRegions();

  /**
   * A helper function to generate a list of blocks from a specified region.
   *
   * @param string $region
   *   The string identifier for a Ultimenu region. e.g. "ultimenu_main_about".
   * @param array $config
   *   The config available for the menu tree.
   *
   * @return array
   *   The renderable array of blocks within the region.
   */
  public function getBlocksByRegion($region, array $config);

  /**
   * Returns the renderable array region data.
   *
   * @param string $region
   *   The string identifier for a Ultimenu region. e.g. "ultimenu_main_about".
   * @param array $config
   *   The config available for the menu tree.
   *
   * @return array
   *   The region data.
   */
  public function buildFlyout($region, array $config);

  /**
   * Returns unwanted Ultimenu regions for removal from theme .info.yml.
   *
   * When a menu item disabled or deleted, relevant dynamic Ultimenu regions
   * removed from the system, but theme .info.yml has a copy stored there.
   * System will always keep and display the unwanted.
   * Either manual deletion from .info.yml, or a force removal if so configured.
   *
   * @return array|bool
   *   The array of unwanted Ultimenu regions from theme .info.yml, or FALSE.
   */
  public function removeRegions();

}

Members

Name	Modifiers	Type	Description	Overrides
UltimenuManagerInterface::attach	public	function	Returns array of needed assets suitable for #attached property.	1
UltimenuManagerInterface::build	public	function	Returns the contents using theme_ultimenu().	1
UltimenuManagerInterface::buildFlyout	public	function	Returns the renderable array region data.	1
UltimenuManagerInterface::buildMenuItem	public	function	Build the Ultimenu item.	1
UltimenuManagerInterface::buildMenuTree	public	function	Build the menu to contain Ultimenu regions.	1
UltimenuManagerInterface::getBlocksByRegion	public	function	A helper function to generate a list of blocks from a specified region.	1
UltimenuManagerInterface::getEnabledRegions	public	function	Returns the array of enabled Ultimenu regions based on enabled settings.	1
UltimenuManagerInterface::getMenus	public	function	Returns the available menus, excluding some admin menus.	1
UltimenuManagerInterface::getModuleHandler	public	function	Returns the module handler.	1
UltimenuManagerInterface::getRegions	public	function	The array of available Ultimenu regions based on enabled menu items.	1
UltimenuManagerInterface::getUltimenuBlocks	public	function	Returns the Ultimenu blocks.	1
UltimenuManagerInterface::removeRegions	public	function	Returns unwanted Ultimenu regions for removal from theme .info.yml.	1