class TaxonomyMenu in Zircon Profile 8
Same name in this branch
- 8 modules/taxonomy_menu/src/Controller/TaxonomyMenu.php \Drupal\taxonomy_menu\Controller\TaxonomyMenu
- 8 modules/taxonomy_menu/src/Entity/TaxonomyMenu.php \Drupal\taxonomy_menu\Entity\TaxonomyMenu
Same name and namespace in other branches
- 8.0 modules/taxonomy_menu/src/Entity/TaxonomyMenu.php \Drupal\taxonomy_menu\Entity\TaxonomyMenu
Defines the TaxonomyMenu entity.
Plugin annotation
@ConfigEntityType(
id = "taxonomy_menu",
label = @Translation("TaxonomyMenu"),
handlers = {
"list_builder" = "Drupal\taxonomy_menu\Controller\TaxonomyMenuListBuilder",
"form" = {
"add" = "Drupal\taxonomy_menu\Form\TaxonomyMenuForm",
"edit" = "Drupal\taxonomy_menu\Form\TaxonomyMenuForm",
"delete" = "Drupal\taxonomy_menu\Form\TaxonomyMenuDeleteForm"
}
},
config_prefix = "taxonomy_menu",
admin_permission = "administer site configuration",
entity_keys = {
"id" = "id",
"label" = "label",
"uuid" = "uuid"
},
links = {
"edit-form" = "/admin/config/system/taxonomy_menu/{taxonomy_menu}",
"delete-form" = "/admin/config/system/taxonomy_menu/{taxonomy_menu}/delete",
"collection" = "/admin/config/system/taxonomy_menu"
}
)
Hierarchy
- class \Drupal\Core\Entity\Entity implements EntityInterface uses RefinableCacheableDependencyTrait, DependencySerializationTrait
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses PluginDependencyTrait
- class \Drupal\taxonomy_menu\Entity\TaxonomyMenu implements TaxonomyMenuInterface
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements ConfigEntityInterface uses PluginDependencyTrait
Expanded class hierarchy of TaxonomyMenu
File
- modules/
taxonomy_menu/ src/ Entity/ TaxonomyMenu.php, line 44 - Contains Drupal\taxonomy_menu\Entity\TaxonomyMenu.
Namespace
Drupal\taxonomy_menu\EntityView source
class TaxonomyMenu extends ConfigEntityBase implements TaxonomyMenuInterface {
/**
* The TaxonomyMenu ID.
*
* @var string
*/
protected $id;
/**
* The TaxonomyMenu label.
*
* @var string
*/
protected $label;
/**
* The taxonomy vocabulary.
*
* @var string
* The machine name of the vocabulary this entity represents.
*/
protected $vocabulary;
/**
* The menu to embed the vocabulary.
*
* @var string
* The machine name of the menu entity.
*/
protected $menu;
/**
* {@inheritdoc}
*/
public function getVocabulary() {
return $this->vocabulary;
}
/**
* {@inheritdoc}
*/
public function getMenu() {
return $this->menu;
}
/**
* {@inheritdoc}
*/
public function preSave(EntityStorageInterface $storage) {
parent::preSave($storage);
if (!$this
->isNew()) {
foreach (array_keys($this
->getLinks([], TRUE)) as $link_key) {
$this
->getMenuLinkManager()
->removeDefinition($link_key, FALSE);
}
}
}
/**
* {@inheritdoc}
*/
public function save() {
// Make sure we don't have any save exceptions before building menu
// definitions.
$return = parent::save();
foreach ($this
->getLinks([], TRUE) as $link_key => $link_def) {
$this
->getMenuLinkManager()
->addDefinition($link_key, $link_def);
}
return $return;
}
/**
* {@inheritdoc}
*/
public function delete() {
foreach (array_keys($this
->getLinks([], TRUE)) as $link_key) {
$this
->getMenuLinkManager()
->removeDefinition($link_key, FALSE);
}
parent::delete();
}
/**
* {@inheritdoc}
*/
public function getLinks($base_plugin_definition = [], $include_base_plugin_id = FALSE) {
/** @var $termStorage \Drupal\taxonomy\TermStorageInterface */
$termStorage = $this
->entityManager()
->getStorage('taxonomy_term');
// Load taxonomy terms for tax menu vocab.
$terms = $termStorage
->loadTree($this
->getVocabulary());
$links = [];
// Create menu links for each term in the vocabulary.
foreach ($terms as $term) {
if (!$term instanceof \Drupal\taxonomy\TermInterface) {
$term = Term::load($term->tid);
}
$mlid = $this
->buildMenuPluginId($term, $include_base_plugin_id);
$links[$mlid] = $this
->buildMenuDefinition($term, $base_plugin_definition);
}
return $links;
}
/**
* @return \Drupal\Core\Menu\MenuLinkManagerInterface
*/
protected function getMenuLinkManager() {
return \Drupal::service('plugin.manager.menu.link');
}
/**
* Generates a menu link id for the taxonomy term.
*
* @param \Drupal\taxonomy\TermInterface $term
*
* @return string
*/
protected function buildMenuPluginId(TermInterface $term, $include_base_plugin_id = TRUE) {
$plugin_id = '';
if ($include_base_plugin_id) {
$plugin_id .= 'taxonomy_menu.menu_link:';
}
$plugin_id .= 'taxonomy_menu.menu_link.' . $this
->id() . '.' . $term
->id();
return $plugin_id;
}
/**
* Generate a menu link plugin definition for a taxonomy term.
*
* @param \Drupal\taxonomy\TermInterface $term
* The taxonomy term for which to build a menu link render array.
* @param $base_plugin_definition
* The base plugin definition to merge the link with.
*
* @return array
*/
protected function buildMenuDefinition(TermInterface $term, $base_plugin_definition) {
$term_id = $term
->id();
$term_url = $term
->urlInfo();
$taxonomy_menu_id = $this
->id();
$menu_id = $this
->getMenu();
// Determine parent link.
// TODO: Evaluate use case of multiple parents (should we make many menu items?)
$menu_parent_id = NULL;
/** @var $termStorage \Drupal\taxonomy\TermStorageInterface */
$termStorage = $this
->entityManager()
->getStorage('taxonomy_term');
$parents = $termStorage
->loadParents($term_id);
$parents = array_values($parents);
if (is_array($parents) && count($parents) && !is_null($parents[0]) && $parents[0] != '0') {
$menu_parent_id = $this
->buildMenuPluginId($parents[0]);
}
// TODO: Consider implementing a forced weight based on taxonomy tree.
// Generate link.
$arguments = [
'taxonomy_term' => $term_id,
];
$link = $base_plugin_definition;
$link += array(
'id' => $this
->buildMenuPluginId($term),
'title' => $term
->label(),
'description' => $term
->getDescription(),
'menu_name' => $menu_id,
'metadata' => array(
'taxonomy_menu_id' => $taxonomy_menu_id,
'taxonomy_term_id' => $term_id,
),
'route_name' => $term_url
->getRouteName(),
'route_parameters' => $term_url
->getRouteParameters(),
'load arguments' => $arguments,
'parent' => $menu_parent_id,
'provider' => 'taxonomy_menu',
'class' => 'Drupal\\taxonomy_menu\\Plugin\\Menu\\TaxonomyMenuMenuLink',
);
return $link;
}
}
Members
Name | Modifiers | Type | Description | Overrides |
---|---|---|---|---|
ConfigEntityBase:: |
private | property | Whether the config is being created, updated or deleted through the import process. | |
ConfigEntityBase:: |
private | property | Whether the config is being deleted by the uninstall process. | |
ConfigEntityBase:: |
protected | property | The language code of the entity's default language. | |
ConfigEntityBase:: |
protected | property | The original ID of the configuration entity. | |
ConfigEntityBase:: |
protected | property | The name of the property that is used to store plugin configuration. | |
ConfigEntityBase:: |
protected | property | The enabled/disabled status of the configuration entity. | 2 |
ConfigEntityBase:: |
protected | property | Third party entity settings. | |
ConfigEntityBase:: |
protected | property | Trust supplied data and not use configuration schema on save. | |
ConfigEntityBase:: |
protected | property | The UUID for this entity. | |
ConfigEntityBase:: |
protected | function | Overrides \Drupal\Core\Entity\DependencyTrait:addDependency(). | |
ConfigEntityBase:: |
public | function |
Calculates dependencies and stores them in the dependency property. Overrides ConfigEntityInterface:: |
12 |
ConfigEntityBase:: |
public | function |
Creates a duplicate of the entity. Overrides Entity:: |
1 |
ConfigEntityBase:: |
public | function |
Disables the configuration entity. Overrides ConfigEntityInterface:: |
1 |
ConfigEntityBase:: |
public | function |
Enables the configuration entity. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Returns the value of a property. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Returns the cache tags that should be used to invalidate caches. Overrides Entity:: |
1 |
ConfigEntityBase:: |
public | function |
Gets the configuration dependency name. Overrides Entity:: |
|
ConfigEntityBase:: |
protected static | function | Gets the configuration manager. | |
ConfigEntityBase:: |
public | function |
Gets the configuration target identifier for the entity. Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Gets the configuration dependencies. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the original ID. Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Gets the list of third parties that store information. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets all third-party settings of a given module. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
protected | function | Gets the typed config manager. | |
ConfigEntityBase:: |
public | function |
Gets whether on not the data is trusted. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
protected static | function |
Override to never invalidate the individual entities' cache tags; the
config system already invalidates them. Overrides Entity:: |
|
ConfigEntityBase:: |
protected | function |
Override to never invalidate the entity's cache tag; the config system
already invalidates it. Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Checks whether this entity is installable. Overrides ConfigEntityInterface:: |
2 |
ConfigEntityBase:: |
public | function |
Overrides Entity::isNew(). Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Returns whether this entity is being changed as part of an import process. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Returns whether this entity is being changed during the uninstall process. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Deprecated way of generating a link to the entity. See toLink(). Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Informs the entity that entities it depends on will be deleted. Overrides ConfigEntityInterface:: |
4 |
ConfigEntityBase:: |
public static | function |
Acts on entities before they are deleted and before hooks are invoked. Overrides Entity:: |
7 |
ConfigEntityBase:: |
public | function |
Sets the value of a property. Overrides ConfigEntityInterface:: |
1 |
ConfigEntityBase:: |
public | function |
Sets the original ID. Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Sets the status of the configuration entity. Overrides ConfigEntityInterface:: |
1 |
ConfigEntityBase:: |
public | function |
Sets the status of the isSyncing flag. Overrides ConfigEntityInterface:: |
|
ConfigEntityBase:: |
public | function |
Sets the value of a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function | ||
ConfigEntityBase:: |
public static | function | Helper callback for uasort() to sort configuration entities by weight and label. | 6 |
ConfigEntityBase:: |
public | function |
Returns whether the configuration entity is enabled. Overrides ConfigEntityInterface:: |
2 |
ConfigEntityBase:: |
public | function |
Gets an array of all property values. Overrides Entity:: |
2 |
ConfigEntityBase:: |
public | function |
Gets the URL object for the entity. Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Sets that the data should be trusted. Overrides ConfigEntityInterface:: |
1 |
ConfigEntityBase:: |
public | function |
Unsets a third-party setting. Overrides ThirdPartySettingsInterface:: |
|
ConfigEntityBase:: |
public | function |
Gets the public URL for this entity. Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Gets the URL object for the entity. Overrides Entity:: |
|
ConfigEntityBase:: |
public | function |
Constructs an Entity object. Overrides Entity:: |
10 |
DependencySerializationTrait:: |
protected | property | An array of service IDs keyed by property name used for serialization. | |
DependencySerializationTrait:: |
public | function | Aliased as: traitSleep | 1 |
DependencySerializationTrait:: |
public | function | 2 | |
DependencyTrait:: |
protected | property | The object's dependencies. | 1 |
DependencyTrait:: |
protected | function | Adds multiple dependencies. | |
DependencyTrait:: |
protected | function | Adds a dependency. Aliased as: addDependencyTrait | |
Entity:: |
protected | property | Boolean indicating whether the entity should be forced to be new. | |
Entity:: |
protected | property | The entity type. | |
Entity:: |
protected | property | A typed data object wrapping this entity. | |
Entity:: |
public | function |
Checks data value access. Overrides AccessibleInterface:: |
1 |
Entity:: |
public | function |
Gets the bundle of the entity. Overrides EntityInterface:: |
1 |
Entity:: |
public static | function |
Overrides EntityInterface:: |
|
Entity:: |
public | function |
Enforces an entity to be new. Overrides EntityInterface:: |
|
Entity:: |
protected | function | Gets the entity manager. | |
Entity:: |
protected | function | Gets the entity type manager. | |
Entity:: |
public | function |
The cache contexts associated with this object. Overrides RefinableCacheableDependencyTrait:: |
|
Entity:: |
public | function |
The maximum age for which this object may be cached. Overrides RefinableCacheableDependencyTrait:: |
|
Entity:: |
public | function |
The cache tags associated with this object. Overrides RefinableCacheableDependencyTrait:: |
|
Entity:: |
public | function |
Gets the key that is used to store configuration dependencies. Overrides EntityInterface:: |
|
Entity:: |
public | function |
Gets the entity type definition. Overrides EntityInterface:: |
|
Entity:: |
public | function |
Gets the ID of the type of the entity. Overrides EntityInterface:: |
|
Entity:: |
public | function |
Gets a typed data object for this entity object. Overrides EntityInterface:: |
|
Entity:: |
public | function |
Indicates if a link template exists for a given key. Overrides EntityInterface:: |
|
Entity:: |
public | function |
Gets the identifier. Overrides EntityInterface:: |
11 |
Entity:: |
public | function |
Gets the label of the entity. Overrides EntityInterface:: |
5 |
Entity:: |
public | function |
Gets the language of the entity. Overrides EntityInterface:: |
1 |
Entity:: |
protected | function | Gets the language manager. | |
Entity:: |
protected | function | Gets an array link templates. | 1 |
Entity:: |
public static | function |
Overrides EntityInterface:: |
|
Entity:: |
public static | function |
Overrides EntityInterface:: |
|
Entity:: |
public | function |
Acts on an entity after it is created but before hooks are invoked. Overrides EntityInterface:: |
4 |
Entity:: |
public static | function |
Acts on deleted entities before the delete hook is invoked. Overrides EntityInterface:: |
14 |
Entity:: |
public static | function |
Acts on loaded entities. Overrides EntityInterface:: |
2 |
Entity:: |
public | function |
Acts on a saved entity before the insert or update hook is invoked. Overrides EntityInterface:: |
20 |
Entity:: |
public static | function |
Changes the values of an entity before it is created. Overrides EntityInterface:: |
6 |
Entity:: |
public | function |
Gets a list of entities referenced by this entity. Overrides EntityInterface:: |
1 |
Entity:: |
public | function |
Generates the HTML for a link to this entity. Overrides EntityInterface:: |
|
Entity:: |
public | function |
Returns a list of URI relationships supported by this entity. Overrides EntityInterface:: |
|
Entity:: |
protected | function | Gets an array of placeholders for this entity. | 1 |
Entity:: |
public | function |
Gets the entity UUID (Universally Unique Identifier). Overrides EntityInterface:: |
1 |
Entity:: |
protected | function | Gets the UUID generator. | |
Entity:: |
public | function | 5 | |
PluginDependencyTrait:: |
protected | function | Calculates and adds dependencies of a specific plugin instance. | 1 |
RefinableCacheableDependencyTrait:: |
protected | property | Cache contexts. | |
RefinableCacheableDependencyTrait:: |
protected | property | Cache max-age. | |
RefinableCacheableDependencyTrait:: |
protected | property | Cache tags. | |
RefinableCacheableDependencyTrait:: |
public | function | 1 | |
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
RefinableCacheableDependencyTrait:: |
public | function | ||
TaxonomyMenu:: |
protected | property | The TaxonomyMenu ID. | |
TaxonomyMenu:: |
protected | property | The TaxonomyMenu label. | |
TaxonomyMenu:: |
protected | property | The menu to embed the vocabulary. | |
TaxonomyMenu:: |
protected | property | The taxonomy vocabulary. | |
TaxonomyMenu:: |
protected | function | Generate a menu link plugin definition for a taxonomy term. | |
TaxonomyMenu:: |
protected | function | Generates a menu link id for the taxonomy term. | |
TaxonomyMenu:: |
public | function |
Deletes an entity permanently. Overrides Entity:: |
|
TaxonomyMenu:: |
public | function |
Get menu link plugin definitions Overrides TaxonomyMenuInterface:: |
|
TaxonomyMenu:: |
public | function |
Overrides TaxonomyMenuInterface:: |
|
TaxonomyMenu:: |
protected | function | ||
TaxonomyMenu:: |
public | function |
Overrides TaxonomyMenuInterface:: |
|
TaxonomyMenu:: |
public | function |
Acts on an entity before the presave hook is invoked. Overrides ConfigEntityBase:: |
|
TaxonomyMenu:: |
public | function |
Saves an entity permanently. Overrides ConfigEntityBase:: |