mirror of
https://github.com/colymba/GridFieldBulkEditingTools.git
synced 2024-10-22 11:05:57 +02:00
Updating readme
This commit is contained in:
parent
51b9518492
commit
1460009272
33
README.md
33
README.md
@ -1,7 +1,34 @@
|
||||
GridFieldBulkImageUpload
|
||||
========================
|
||||
|
||||
SilverStripe 3 GridField component for uploading images in bulk into the managed DataObject relation with option to edit fields on the fly.
|
||||
Useful when GridField is used to manage a collection of DataObject that contain and Image (the image might be the main object the DataObject).
|
||||
SilverStripe 3 GridField component for uploading images in bulk into the managed DataObject relation, with option to edit fields on the fly.
|
||||
This component is built around the CMSFileAddController editForm, it overrides and adds some behaviors, templates and styles.
|
||||
|
||||
This component is built around the CMSFileAddController editForm, it overwrides and adds some behaviors, templates and styles.
|
||||
## Requirments
|
||||
* SilverStripe 3.0
|
||||
|
||||
## Installation
|
||||
* Download and copy module in SilverStripe root directory under 'GridFieldBulkImageUpload'
|
||||
* Run dev/build?flush=all to regenerate the manifest
|
||||
* run ?flush=all in CMS to force the templates to regenerate
|
||||
|
||||
## Usage 1
|
||||
Simplest usage, add the component to your GridField as below. The component will find the first Image has_one relation on the managed object and it's editable db fields
|
||||
|
||||
:::php
|
||||
$config->addComponent(new GridFieldBulkImageUpload());
|
||||
|
||||
## Usage 2
|
||||
Same as 1 but you can specify which Image field to use and which fields are editable
|
||||
$imageField: The name of the image field to use (should have 'ID' at the end: If your relation is set has 'MyImage' => 'Image', the parameter should be 'MyImageID')
|
||||
$editableFields: An array of db fields name that will be editable like array('myTextField', 'myVarcharField', 'myEnumField')
|
||||
|
||||
:::php
|
||||
$config->addComponent(new GridFieldBulkImageUpload( $imageField, $editableFields ));
|
||||
|
||||
## Notes
|
||||
* The HTML form fields for each editable fields are taken from the DataObject's getCMSFields() method
|
||||
* Only (HTML)Text/Varchar and Enum fields are picked up by the automatic config
|
||||
|
||||
## TODO
|
||||
* Add option to specify upload folder
|
Loading…
Reference in New Issue
Block a user