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.
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.
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).
Install IEF Table View Mode for more control over the display of fields in the widget. Without the module a node, for example, will only display the node ID.
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 entity form'] = array(
'controller' => 'CommerceLineItemInlineEntityFormController',
);
The controller needs to extend EntityInlineEntityFormController and at least
override entityForm() to provide a functioning entity form.
To submit bug reports and feature suggestions, or to track changes: https://github.com/backdrop-contrib/inline_entity_form/issues
- Herb v/d Dool
- Seeking co-maintainers.
- Ported to Backdrop by Herb v/d Dool and Docwilmot.
- Originally developed for Backdrop by geek-merlin, joachim, oknate, kaythay and jsacksick.
This project is GPL v2 software. See the LICENSE.txt file in this directory for complete text.