forked from a64f7bb4-7358-4778-9fbe-3b882c34cc1d/v1
41 lines
1.8 KiB
Plaintext
41 lines
1.8 KiB
Plaintext
Provides a widget for inline management (creation, modification, removal) of referenced entities.
|
|
The primary use case is the parent -> children one (product display -> products, order -> line items, etc.),
|
|
where the child entities are never managed outside the parent form.
|
|
Existing entities can also be referenced.
|
|
|
|
Supports commerce_product_reference, commerce_line_item_reference and entityreference fields.
|
|
Requires integration code to be provided for each entity type that can be referenced.
|
|
Supports the commerce_product (including Commerce AutoSKU integraton),
|
|
commerce_line_item, node, taxonomy_term entity types out of the box.
|
|
|
|
Getting started
|
|
---------------
|
|
Edit the reference field for which you want to use this module
|
|
(for example, the Product field on a product display node, or the Line Items
|
|
one on commerce_order) and select one of the "Inline entity form" widgets.
|
|
|
|
Widgets
|
|
-------
|
|
Two widgets are provided:
|
|
- "Inline entity form - Single value" - Shows the inline form in a fieldset
|
|
on the parent entity form. No additional action buttons are added.
|
|
This widget assumes that it is operating on a single-value required reference
|
|
field with one selected bundle.
|
|
|
|
- "Inline entity form - Multiple values" - Shows an advanced widget
|
|
for inline management of entities.
|
|
Has optimal UX when there's only one bundle selected (this is the
|
|
"Product types that can be referenced" setting on product reference fields).
|
|
|
|
Integrating with Inline Entity Form
|
|
-----------------------------------
|
|
An entity type can add support for this module by declaring the
|
|
inline entity form controller class in its entity info:
|
|
|
|
$entity_info['commerce_line_item']['inline_form'] = [
|
|
'controller' => 'CommerceLineItemInlineEntityFormController',
|
|
];
|
|
|
|
The controller needs to extend EntityInlineEntityFormController and at least
|
|
override entityForm() to provide a functioning entity form.
|