Extra Field Configuration
This module allows you to manage the placement of "extra fields" through configuration instead of in code. It also lets you use the same extra field multiple times on an entity without needing to define it separately in code.
This module provides a configuration layer for Extra Field to allow developers to manage the placement of extra fields via configuration rather than in annotation properties. The module also allows for the usage of multiple instances of the same extra field plugin on an entity, without having to define multiple instances of the plugin in code.
Instructions
Requirements
Installation
- Add the module to your project with
composer require drupal/extra_field_configurationor manually download the source and place it inmodules/contrib. - Enable the module.
Configuration
Create extra field instances from extra field plugins and manage entity assignments at /admin/structure/extra-field.
Plugin Changes
To enable an extra field plugin to be configured by this module, the deriver property must be present on the annotation. It is also recommended to omit bundles property, to ensure the extra field is not managed in two different ways.
A complete Extra Field Configuration plugin annotation would look like:
* @ExtraFieldDisplay( * id = "plugin_id", * label = @Translation("Field name"), * deriver = "Drupal\extra_field_configuration\Plugin\Derivative\ExtraFieldConfigurationDeriver", * weight = 10, * visible = false, * )
The class definitions of the extra field plugins remains unchanged with this module, and Extra Field Plus plugins can also be used. The location of plugins class files also remains the same.
Printing in Templates
Field names for printing in templates can be found on the admin screen at /admin/structure/extra-field. The field name is generated from the machine name defined when creating the extra field instance.
Examples
The included extra_field_configuration_examples module provides example extra field plugins in both simple and formatted flavors.