3 namespace Drupal\{{ machine_name }}\Plugin\Field\FieldType;
5 use Drupal\Component\Utility\Random;
6 use Drupal\Core\Field\FieldDefinitionInterface;
7 use Drupal\Core\Field\FieldItemBase;
8 use Drupal\Core\Field\FieldStorageDefinitionInterface;
9 use Drupal\Core\Form\FormStateInterface;
10 use Drupal\Core\TypedData\DataDefinition;
13 * Defines the '{{ plugin_id }}' field type.
16 * id = "{{ plugin_id }}",
17 * label = @Translation("{{ plugin_label }}"),
18 * category = @Translation("General"),
19 * default_widget = "string_textfield",
20 * default_formatter = "string"
24 * If you are implementing a single value field type you may want to inherit
25 * this class form some of the field type classes provided by Drupal core.
26 * Check out /core/lib/Drupal/Core/Field/Plugin/Field/FieldType directory for
27 * list of available field type implementations.
29 class {{ class }} extends FieldItemBase {
34 public static function defaultStorageSettings() {
35 $settings = ['foo' => 123];
36 return $settings + parent::defaultStorageSettings();
42 public function storageSettingsForm(array &$form, FormStateInterface $form_state, $has_data) {
43 $settings = $this->getSettings();
47 '#title' => $this->t('Foo'),
48 '#default_value' => $settings['foo'],
49 '#disabled' => $has_data,
58 public static function defaultFieldSettings() {
59 $settings = ['bar' => 'Bla bla bla'];
60 return $settings + parent::defaultFieldSettings();
66 public function fieldSettingsForm(array $form, FormStateInterface $form_state) {
67 $settings = $this->getSettings();
70 '#type' => 'textfield',
72 '#default_value' => $settings['bar'],
81 public function isEmpty() {
82 $value = $this->get('value')->getValue();
83 return $value === NULL || $value === '';
89 public static function propertyDefinitions(FieldStorageDefinitionInterface $field_definition) {
92 // See /core/lib/Drupal/Core/TypedData/Plugin/DataType directory for
93 // available data types.
94 $properties['value'] = DataDefinition::create('string')
95 ->setLabel(t('Text value'))
104 public function getConstraints() {
105 $constraints = parent::getConstraints();
107 $constraint_manager = \Drupal::typedDataManager()->getValidationConstraintManager();
109 // @DCG Suppose our value must not be longer than 10 characters.
110 $options['value']['Length']['max'] = 10;
113 // See /core/lib/Drupal/Core/Validation/Plugin/Validation/Constraint
114 // directory for available constraints.
115 $constraints[] = $constraint_manager->create('ComplexData', $options);
122 public static function schema(FieldStorageDefinitionInterface $field_definition) {
128 'description' => 'Column description.',
134 'columns' => $columns,
135 // @DCG Add indexes here if needed.
144 public static function generateSampleValue(FieldDefinitionInterface $field_definition) {
145 $random = new Random();
146 $values['value'] = $random->word(mt_rand(1, 50));