You are here

public static function Term::baseFieldDefinitions in Drupal 8

Same name and namespace in other branches
  1. 9 core/modules/taxonomy/src/Entity/Term.php \Drupal\taxonomy\Entity\Term::baseFieldDefinitions()
  2. 10 core/modules/taxonomy/src/Entity/Term.php \Drupal\taxonomy\Entity\Term::baseFieldDefinitions()

Provides base field definitions for an entity type.

Implementations typically use the class \Drupal\Core\Field\BaseFieldDefinition for creating the field definitions; for example a 'name' field could be defined as the following:

$fields['name'] = BaseFieldDefinition::create('string')
  ->setLabel(t('Name'));

By definition, base fields are fields that exist for every bundle. To provide definitions for fields that should only exist on some bundles, use \Drupal\Core\Entity\FieldableEntityInterface::bundleFieldDefinitions().

The definitions returned by this function can be overridden for all bundles by hook_entity_base_field_info_alter() or overridden on a per-bundle basis via 'base_field_override' configuration entities.

Parameters

\Drupal\Core\Entity\EntityTypeInterface $entity_type: The entity type definition. Useful when a single class is used for multiple, possibly dynamic entity types.

Return value

\Drupal\Core\Field\FieldDefinitionInterface[] An array of base field definitions for the entity type, keyed by field name.

Overrides EditorialContentEntityBase::baseFieldDefinitions

See also

\Drupal\Core\Entity\EntityFieldManagerInterface::getFieldDefinitions()

\Drupal\Core\Entity\FieldableEntityInterface::bundleFieldDefinitions()

File

core/modules/taxonomy/src/Entity/Term.php, line 125

Class

Term
Defines the taxonomy term entity.

Namespace

Drupal\taxonomy\Entity

Code

public static function baseFieldDefinitions(EntityTypeInterface $entity_type) {

  /** @var \Drupal\Core\Field\BaseFieldDefinition[] $fields */
  $fields = parent::baseFieldDefinitions($entity_type);

  // @todo Remove the usage of StatusItem in
  //   https://www.drupal.org/project/drupal/issues/2936864.
  $fields['status']
    ->getItemDefinition()
    ->setClass(StatusItem::class);
  $fields['tid']
    ->setLabel(t('Term ID'))
    ->setDescription(t('The term ID.'));
  $fields['uuid']
    ->setDescription(t('The term UUID.'));
  $fields['status']
    ->setDisplayOptions('form', [
    'type' => 'boolean_checkbox',
    'settings' => [
      'display_label' => TRUE,
    ],
    'weight' => 100,
  ])
    ->setDisplayConfigurable('form', TRUE);
  $fields['vid']
    ->setLabel(t('Vocabulary'))
    ->setDescription(t('The vocabulary to which the term is assigned.'));
  $fields['langcode']
    ->setDescription(t('The term language code.'));
  $fields['name'] = BaseFieldDefinition::create('string')
    ->setLabel(t('Name'))
    ->setTranslatable(TRUE)
    ->setRevisionable(TRUE)
    ->setRequired(TRUE)
    ->setSetting('max_length', 255)
    ->setDisplayOptions('view', [
    'label' => 'hidden',
    'type' => 'string',
    'weight' => -5,
  ])
    ->setDisplayOptions('form', [
    'type' => 'string_textfield',
    'weight' => -5,
  ])
    ->setDisplayConfigurable('form', TRUE);
  $fields['description'] = BaseFieldDefinition::create('text_long')
    ->setLabel(t('Description'))
    ->setTranslatable(TRUE)
    ->setRevisionable(TRUE)
    ->setDisplayOptions('view', [
    'label' => 'hidden',
    'type' => 'text_default',
    'weight' => 0,
  ])
    ->setDisplayConfigurable('view', TRUE)
    ->setDisplayOptions('form', [
    'type' => 'text_textfield',
    'weight' => 0,
  ])
    ->setDisplayConfigurable('form', TRUE);
  $fields['weight'] = BaseFieldDefinition::create('integer')
    ->setLabel(t('Weight'))
    ->setDescription(t('The weight of this term in relation to other terms.'))
    ->setDefaultValue(0);
  $fields['parent'] = BaseFieldDefinition::create('entity_reference')
    ->setLabel(t('Term Parents'))
    ->setDescription(t('The parents of this term.'))
    ->setSetting('target_type', 'taxonomy_term')
    ->setCardinality(BaseFieldDefinition::CARDINALITY_UNLIMITED);
  $fields['changed'] = BaseFieldDefinition::create('changed')
    ->setLabel(t('Changed'))
    ->setDescription(t('The time that the term was last edited.'))
    ->setTranslatable(TRUE)
    ->setRevisionable(TRUE);

  // @todo Keep this field hidden until we have a revision UI for terms.
  // @see https://www.drupal.org/project/drupal/issues/2936995
  $fields['revision_log_message']
    ->setDisplayOptions('form', [
    'region' => 'hidden',
  ]);
  return $fields;
}