mirror of
https://github.com/colymba/GridFieldBulkEditingTools.git
synced 2024-10-22 11:05:57 +02:00
64 lines
2.6 KiB
Markdown
64 lines
2.6 KiB
Markdown
# GridField Bulk Editing Tools
|
|
|
|
:warning: I haven't been able to give as much love as I would like to these repos as they deserve. If you have time and are interested to help maintain them, give me a shout. :rotating_light:
|
|
|
|
[](https://github.com/colymba/GridFieldBulkEditingTools/releases)
|
|
[](https://github.com/colymba/GridFieldBulkEditingTools/tree/master)
|
|
[](#license-and-copyright)
|
|
|
|
Set of SilverStripe CMS GridField components to facilitate bulk file upload & record editing.
|
|
|
|
## Components:
|
|
* [Bulk Upload](#bulk-upload): Upload multiple images or files at once into DataObjects
|
|
* [Bulk Manager](#bulk-manager): Delete, Unlink, Edit (and more) multiple records at once
|
|
|
|
## Installation
|
|
|
|
```sh
|
|
composer require colymba/gridfield-bulk-editing-tools
|
|
```
|
|
|
|
## Bulk Upload
|
|
Upload multiple images or files at once into DataObjects. Perfect for galleries and the like.
|
|
|
|
```php
|
|
$config->addComponent(new \Colymba\BulkUpload\BulkUploader());
|
|
```
|
|
|
|
### Versioned
|
|
By default `BulkUploader` will write to the current stage (most likely Draft). To auto publish your `DataObject`, use the following param or config:
|
|
```php
|
|
$config->addComponent(new \Colymba\BulkUpload\BulkUploader(null, null, true));
|
|
```
|
|
OR
|
|
```php
|
|
$config->getComponentByType('Colymba\\BulkUpload\\BulkUploader')->setAutoPublishDataObject(true);
|
|
```
|
|
|
|
Your `DataObject` should `own` the `Image`/`File` relation so it is published at the same time: [See SilverStripe DataObject ownership DOC](https://github.com/silverstripe/silverstripe-framework/blob/4.0/docs/en/02_Developer_Guides/00_Model/10_Versioning.md#dataobject-ownership)
|
|
|
|
See [BULK_UPLOAD.md](docs/en/BULK_UPLOAD.md) for detailed configuration.
|
|
|
|
## Bulk Manager
|
|
Perform actions on multiple records straight from the GridField
|
|
|
|
```php
|
|
$config->addComponent(new \Colymba\BulkManager\BulkManager());
|
|
```
|
|
|
|
See [BULK_MANAGER.md](docs/en//BULK_MANAGER.md) for detailed configuration.
|
|
|
|
## Tooling
|
|
* `npm run watch` for development
|
|
* `npm run dist` before pushing to the repo
|
|
|
|
## Translations
|
|
|
|
Translations of the natural language strings are managed through a third party translation interface, transifex.com.
|
|
|
|
Please use https://www.transifex.com/silverstripe/silverstripe-gridfield-bulk-editing-tools to contribute translations, rather than sending pull requests with YAML/JS files.
|
|
|
|
## License and Copyright
|
|
|
|
[BSD 3-clause license](LICENSE)
|