Download the PHP package silverstripe/multivaluefield without Composer
On this page you can find all versions of the php package silverstripe/multivaluefield. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download silverstripe/multivaluefield
More information about silverstripe/multivaluefield
Files in silverstripe/multivaluefield
Package multivaluefield
Short Description A DB field + form fields for storing multiple values in a single property (serialized).
License BSD-3-Clause
Informations about the package multivaluefield
Silverstripe MultiValueField module
Notes:
- 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
- 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.
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.
Version info
This version of MultiValueField supports Silverstripe 4.0.0
Older versions of Silverstripe are supported on minor version branches below
Installation
Basic Usage
As with all DB fields
To make use of the field on the frontend, you can loop over the Items property
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.
Note that to have the $Key
value available as something other than an integer, use the KeyValueField
field type to populate the field.
You can set the key and value placeholder values of the KeyValueField in your field like this:
Maintainer Contacts
- Marcus Nyeholt [email protected]
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.
Please use https://www.transifex.com/projects/p/silverstripe-multivaluefield to contribute translations, rather than sending pull requests with YAML files.
License
This module is licensed under the BSD license at http://silverstripe.org/BSD-license