silverstripe/multivaluefield

A DB field + form fields for storing multiple values in a single property (serialized).

SilverStripe MultiValueField module

, _(*1)

Notes:, _(*2)

• The SilverStripe 2.4 compatible version of the module is still available in the ss24 branch
• The SilverStripe 3.x compatible versions are still available in the 2.x branches. (see version info)

A database field type that allows the storage of multiple discrete values in a single database field. This also provides form fields for entering multiple values in a simple manner, _(*3)

• MultiValueTextField - displays a text field. When data is entered, another text field is displayed directly beneath. Subsequent data entry triggers more text fields to appear
• MultiValueDropdownField - displays a dropdown field. When a value is selected another dropdown field is displayed.

Within templates, the field can be iterated over as per a data object set. The property $Value is available as a Varchar type, and other typical properties such as $FirstLast etc are inherited from ViewableData., _(*4)

Data is stored in the database in a serialized PHP format. While this is not ideal for searching purposes, some external indexing engines (eg the Solr module) are aware of the field type and will index accordingly., _(*5)

Version info

This version of MultiValueField supports SilverStripe 4.0.0, _(*6)

Older versions of SilverStripe are supported on minor version branches below, _(*7)

• SilverStripe 3.1+ compatible version

Installation

composer require symbiote/silverstripe-multivaluefield

Basic Usage

As with all DB fields, _(*8)

private static $db = array(
    'Keywords'  => 'MultiValueField',
);

To make use of the field on the frontend, you can loop over the Items property, _(*9)

<% loop $Keywords.Items %>
    <p>$Key $Value</p>
<% end_loop %>

In this case, $Value is a Varchar object, so you can call all relevant string field methods on it, such as $Value.Raw, $Value.LimitWordCount etc etc., _(*10)

Note that to have the $Key value available as something other than an integer, use the KeyValueField field type to populate the field., _(*11)

Maintainer Contacts

• Marcus Nyeholt marcus@symbiote.com.au

Requirements

• SilverStripe 4.0

Contributing

Thanks

• Ingo's initial work to getting this SS4 ready
• muskie9's work on updating UI fields

Translations

Translations of the natural language strings are managed through a third party translation interface, transifex.com. Newly added strings will be periodically uploaded there for translation, and any new translations will be merged back to the project source code., _(*12)

Please use https://www.transifex.com/projects/p/silverstripe-multivaluefield to contribute translations, rather than sending pull requests with YAML files., _(*13)

License

This module is licensed under the BSD license at http://silverstripe.org/BSD-license, _(*14)

Project Links

• GitHub Project Page
• Issue Tracker