Updating readme

This commit is contained in:
colymba 2012-07-18 02:27:28 +03:00
parent 51b9518492
commit 1460009272
1 changed files with 30 additions and 3 deletions

View File

@ -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