Vocabulary.php

Same filename in this branch
  1. 8.9.x core/modules/taxonomy/src/Plugin/migrate/source/d6/Vocabulary.php
  2. 8.9.x core/modules/taxonomy/src/Plugin/migrate/source/d7/Vocabulary.php
Same filename in other branches
  1. 9 core/modules/taxonomy/src/Entity/Vocabulary.php
  2. 9 core/modules/taxonomy/src/Plugin/migrate/source/d6/Vocabulary.php
  3. 9 core/modules/taxonomy/src/Plugin/migrate/source/d7/Vocabulary.php
  4. 10 core/modules/taxonomy/src/Entity/Vocabulary.php
  5. 10 core/modules/taxonomy/src/Plugin/migrate/source/d6/Vocabulary.php
  6. 10 core/modules/taxonomy/src/Plugin/migrate/source/d7/Vocabulary.php
  7. 11.x core/modules/taxonomy/src/Entity/Vocabulary.php
  8. 11.x core/modules/taxonomy/src/Plugin/migrate/source/d6/Vocabulary.php
  9. 11.x core/modules/taxonomy/src/Plugin/migrate/source/d7/Vocabulary.php

Namespace

Drupal\taxonomy\Entity

File

core/modules/taxonomy/src/Entity/Vocabulary.php

View source
<?php

namespace Drupal\taxonomy\Entity;

use Drupal\Core\Config\Entity\ConfigEntityBundleBase;
use Drupal\Core\Entity\EntityStorageInterface;
use Drupal\taxonomy\VocabularyInterface;

/**
 * Defines the taxonomy vocabulary entity.
 *
 * @ConfigEntityType(
 *   id = "taxonomy_vocabulary",
 *   label = @Translation("Taxonomy vocabulary"),
 *   label_singular = @Translation("vocabulary"),
 *   label_plural = @Translation("vocabularies"),
 *   label_collection = @Translation("Taxonomy"),
 *   label_count = @PluralTranslation(
 *     singular = "@count vocabulary",
 *     plural = "@count vocabularies"
 *   ),
 *   handlers = {
 *     "storage" = "Drupal\taxonomy\VocabularyStorage",
 *     "list_builder" = "Drupal\taxonomy\VocabularyListBuilder",
 *     "access" = "Drupal\taxonomy\VocabularyAccessControlHandler",
 *     "form" = {
 *       "default" = "Drupal\taxonomy\VocabularyForm",
 *       "reset" = "Drupal\taxonomy\Form\VocabularyResetForm",
 *       "delete" = "Drupal\taxonomy\Form\VocabularyDeleteForm",
 *       "overview" = "Drupal\taxonomy\Form\OverviewTerms"
 *     },
 *     "route_provider" = {
 *       "html" = "Drupal\taxonomy\Entity\Routing\VocabularyRouteProvider",
 *     }
 *   },
 *   admin_permission = "administer taxonomy",
 *   config_prefix = "vocabulary",
 *   bundle_of = "taxonomy_term",
 *   entity_keys = {
 *     "id" = "vid",
 *     "label" = "name",
 *     "weight" = "weight"
 *   },
 *   links = {
 *     "add-form" = "/admin/structure/taxonomy/add",
 *     "delete-form" = "/admin/structure/taxonomy/manage/{taxonomy_vocabulary}/delete",
 *     "reset-form" = "/admin/structure/taxonomy/manage/{taxonomy_vocabulary}/reset",
 *     "overview-form" = "/admin/structure/taxonomy/manage/{taxonomy_vocabulary}/overview",
 *     "edit-form" = "/admin/structure/taxonomy/manage/{taxonomy_vocabulary}",
 *     "collection" = "/admin/structure/taxonomy",
 *   },
 *   config_export = {
 *     "name",
 *     "vid",
 *     "description",
 *     "weight",
 *   }
 * )
 */
class Vocabulary extends ConfigEntityBundleBase implements VocabularyInterface {
    
    /**
     * The taxonomy vocabulary ID.
     *
     * @var string
     */
    protected $vid;
    
    /**
     * Name of the vocabulary.
     *
     * @var string
     */
    protected $name;
    
    /**
     * Description of the vocabulary.
     *
     * @var string
     */
    protected $description;
    
    /**
     * The weight of this vocabulary in relation to other vocabularies.
     *
     * @var int
     */
    protected $weight = 0;
    
    /**
     * {@inheritdoc}
     */
    public function getHierarchy() {
        @trigger_error('\\Drupal\\taxonomy\\VocabularyInterface::getHierarchy() is deprecated in Drupal 8.7.x and will be removed before Drupal 9.0.x. Use \\Drupal\\taxonomy\\TermStorage::getVocabularyHierarchyType() instead.', E_USER_DEPRECATED);
        return $this->entityTypeManager()
            ->getStorage('taxonomy_term')
            ->getVocabularyHierarchyType($this->id());
    }
    
    /**
     * {@inheritdoc}
     */
    public function setHierarchy($hierarchy) {
        @trigger_error('\\Drupal\\taxonomy\\VocabularyInterface::setHierarchy() is deprecated in Drupal 8.7.x and will be removed before Drupal 9.0.x. Reset the cache of the taxonomy_term storage controller instead.', E_USER_DEPRECATED);
        $this->entityTypeManager()
            ->getStorage('taxonomy_term')
            ->resetCache();
        return $this;
    }
    
    /**
     * {@inheritdoc}
     */
    public function id() {
        return $this->vid;
    }
    
    /**
     * {@inheritdoc}
     */
    public function getDescription() {
        return $this->description;
    }
    
    /**
     * {@inheritdoc}
     */
    public static function preDelete(EntityStorageInterface $storage, array $entities) {
        parent::preDelete($storage, $entities);
        // Only load terms without a parent, child terms will get deleted too.
        $term_storage = \Drupal::entityTypeManager()->getStorage('taxonomy_term');
        $terms = $term_storage->loadMultiple($storage->getToplevelTids(array_keys($entities)));
        $term_storage->delete($terms);
    }
    
    /**
     * {@inheritdoc}
     */
    public static function postDelete(EntityStorageInterface $storage, array $entities) {
        parent::postDelete($storage, $entities);
        // Reset caches.
        $storage->resetCache(array_keys($entities));
        if (reset($entities)->isSyncing()) {
            return;
        }
        $vocabularies = [];
        foreach ($entities as $vocabulary) {
            $vocabularies[$vocabulary->id()] = $vocabulary->id();
        }
        // Load all Taxonomy module fields and delete those which use only this
        // vocabulary.
        $field_storages = \Drupal::entityTypeManager()->getStorage('field_storage_config')
            ->loadByProperties([
            'module' => 'taxonomy',
        ]);
        foreach ($field_storages as $field_storage) {
            $modified_storage = FALSE;
            // Term reference fields may reference terms from more than one
            // vocabulary.
            foreach ($field_storage->getSetting('allowed_values') as $key => $allowed_value) {
                if (isset($vocabularies[$allowed_value['vocabulary']])) {
                    $allowed_values = $field_storage->getSetting('allowed_values');
                    unset($allowed_values[$key]);
                    $field_storage->setSetting('allowed_values', $allowed_values);
                    $modified_storage = TRUE;
                }
            }
            if ($modified_storage) {
                $allowed_values = $field_storage->getSetting('allowed_values');
                if (empty($allowed_values)) {
                    $field_storage->delete();
                }
                else {
                    // Update the field definition with the new allowed values.
                    $field_storage->save();
                }
            }
        }
    }

}

Classes

Title Deprecated Summary
Vocabulary Defines the taxonomy vocabulary entity.

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.