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