class ConfigEntityBundleBase
Same name and namespace in other branches
- 11.x core/lib/Drupal/Core/Config/Entity/ConfigEntityBundleBase.php \Drupal\Core\Config\Entity\ConfigEntityBundleBase
- 10 core/lib/Drupal/Core/Config/Entity/ConfigEntityBundleBase.php \Drupal\Core\Config\Entity\ConfigEntityBundleBase
- 8.9.x core/lib/Drupal/Core/Config/Entity/ConfigEntityBundleBase.php \Drupal\Core\Config\Entity\ConfigEntityBundleBase
A base class for config entity types that act as bundles.
Entity types that want to use this base class must use bundle_of in their annotation to specify for which entity type they are providing bundles for.
Hierarchy
- class \Drupal\Core\Entity\EntityBase implements \Drupal\Core\Entity\EntityInterface uses \Drupal\Core\Cache\RefinableCacheableDependencyTrait, \Drupal\Core\DependencyInjection\DependencySerializationTrait
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements \Drupal\Core\Config\Entity\ConfigEntityInterface uses \Drupal\Core\Plugin\PluginDependencyTrait, \Drupal\Core\Entity\SynchronizableEntityTrait extends \Drupal\Core\Entity\EntityBase
- class \Drupal\Core\Config\Entity\ConfigEntityBundleBase extends \Drupal\Core\Config\Entity\ConfigEntityBase
- class \Drupal\Core\Config\Entity\ConfigEntityBase implements \Drupal\Core\Config\Entity\ConfigEntityInterface uses \Drupal\Core\Plugin\PluginDependencyTrait, \Drupal\Core\Entity\SynchronizableEntityTrait extends \Drupal\Core\Entity\EntityBase
Expanded class hierarchy of ConfigEntityBundleBase
9 files declare their use of ConfigEntityBundleBase
- BlockContentType.php in core/
modules/ block_content/ src/ Entity/ BlockContentType.php - CommentType.php in core/
modules/ comment/ src/ Entity/ CommentType.php - ContactForm.php in core/
modules/ contact/ src/ Entity/ ContactForm.php - EntityTestBundle.php in core/
modules/ system/ tests/ modules/ entity_test/ src/ Entity/ EntityTestBundle.php - EntityTestMulBundle.php in core/
modules/ system/ tests/ modules/ entity_test/ src/ Entity/ EntityTestMulBundle.php
File
-
core/
lib/ Drupal/ Core/ Config/ Entity/ ConfigEntityBundleBase.php, line 14
Namespace
Drupal\Core\Config\EntityView source
abstract class ConfigEntityBundleBase extends ConfigEntityBase {
/**
* Deletes display if a bundle is deleted.
*/
protected function deleteDisplays() {
// Remove entity displays of the deleted bundle.
if ($displays = $this->loadDisplays('entity_view_display')) {
$storage = $this->entityTypeManager()
->getStorage('entity_view_display');
$storage->delete($displays);
}
// Remove entity form displays of the deleted bundle.
if ($displays = $this->loadDisplays('entity_form_display')) {
$storage = $this->entityTypeManager()
->getStorage('entity_form_display');
$storage->delete($displays);
}
}
/**
* {@inheritdoc}
*/
public function postSave(EntityStorageInterface $storage, $update = TRUE) {
parent::postSave($storage, $update);
$entity_type_manager = $this->entityTypeManager();
$bundle_of = $this->getEntityType()
->getBundleOf();
if (!$update) {
\Drupal::service('entity_bundle.listener')->onBundleCreate($this->id(), $bundle_of);
}
else {
// Invalidate the render cache of entities for which this entity
// is a bundle.
if ($entity_type_manager->hasHandler($bundle_of, 'view_builder')) {
$entity_type_manager->getViewBuilder($bundle_of)
->resetCache();
}
// Entity bundle field definitions may depend on bundle settings.
\Drupal::service('entity_field.manager')->clearCachedFieldDefinitions();
$this->entityTypeBundleInfo()
->clearCachedBundles();
}
}
/**
* {@inheritdoc}
*/
public static function postDelete(EntityStorageInterface $storage, array $entities) {
parent::postDelete($storage, $entities);
foreach ($entities as $entity) {
$entity->deleteDisplays();
\Drupal::service('entity_bundle.listener')->onBundleDelete($entity->id(), $entity->getEntityType()
->getBundleOf());
}
}
/**
* Acts on an entity before the presave hook is invoked.
*
* Used before the entity is saved and before invoking the presave hook.
*
* Ensure that config entities which are bundles of other entities cannot have
* their ID changed.
*
* @param \Drupal\Core\Entity\EntityStorageInterface $storage
* The entity storage object.
*
* @throws \Drupal\Core\Config\ConfigNameException
* Thrown when attempting to rename a bundle entity.
*/
public function preSave(EntityStorageInterface $storage) {
parent::preSave($storage);
// Only handle renames, not creations.
if (!$this->isNew() && $this->getOriginalId() !== $this->id()) {
$bundle_type = $this->getEntityType();
$bundle_of = $bundle_type->getBundleOf();
if (!empty($bundle_of)) {
throw new ConfigNameException("The machine name of the '{$bundle_type->getLabel()}' bundle cannot be changed.");
}
}
}
/**
* Returns view or form displays for this bundle.
*
* @param string $entity_type_id
* The entity type ID of the display type to load.
*
* @return \Drupal\Core\Entity\Display\EntityDisplayInterface[]
* A list of matching displays.
*/
protected function loadDisplays($entity_type_id) {
$ids = \Drupal::entityQuery($entity_type_id)->condition('id', $this->getEntityType()
->getBundleOf() . '.' . $this->getOriginalId() . '.', 'STARTS_WITH')
->execute();
if ($ids) {
$storage = $this->entityTypeManager()
->getStorage($entity_type_id);
return $storage->loadMultiple($ids);
}
return [];
}
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.