restruct / silverstripe-quickaddnew

3.0.2 2026-09-23 16:08 UTC

Requires

• php: ^8.3
• silverstripe/framework: ^6
• silverstripe/vendor-plugin: ^3

Requires (Dev)

• silverstripe/recipe-testing: ^4
• squizlabs/php_codesniffer: ^3.5

Replaces

• sheadawson/quickaddnew: *
• silverstripe/quickaddnew: *

BSD-3-Clause

• Shea Dawson
• LeKoala

Published on Packagist.org on 2026-09-23 16:08 UTC

README

Maintained by Restruct. If this module saves you time, you can support ongoing maintenance.

What is it?

A decorator for form fields that manage object relationships, to allow adding a new object on the fly through a dialog window. It can handle has_one, has_many or many_many relationships. At the moment it has been tested / works on DropdownField, ListboxField and CheckboxSetField. It works both in the CMS and in the frontend. For frontend, Select2Field or MultiSelect2Field are recommended.

Requirements

Versions

Release	Branch	Silverstripe	PHP
^3	main	6	8.3+
^2	v2	4 / 5	7.4+

composer.json on each branch is the source of truth. The v2 line gets security and bug fixes until Silverstripe 5 reaches end of life in April 2027.

Upgrading from 2.x? See UPGRADING.md - there is one breaking change, the extension class is now namespaced.

Usage

Firstly, when creating the form field, we need to create a closure that returns the source array to populate the field's options. We do this because later on, when the field is refreshed with the newly created Object ID as it's value, we need to use this function Again to get up to date data for the source.

$source = function(){
    return MyObject::get()->map()->toArray();
};

Then we can create the form field, calling the closure as the source argument

$field = DropdownField::create('MyObjectID', 'My Object', $source());

Next, we can tell the field to use and configure quickaddnew. The first parameter is the class name of the object that will be created. The second is the $source closure Note: See QuickAddNewExtension::useAddNew() for the list of configurations parameters available. These allow you to customise the fields and required fields (for validation) for the dialog. By default the object class's getAddNewFields() or getCMSFields() methods are used

$field->useAddNew('MyObject', $source);

Add the field to your FieldList

$fields->addFieldToTab('Root.Main', $field);