ckeditor5-google-do/README.md

Google Cloud and DigitalOcean Spaces upload plugin for ckeditor5

## File Upload to Google Cloud Storage or DigitalOcean Spaces Plugin for CKEditor5

This is a fork of https://github.com/mjadobson/ckeditor5-sss-upload, that substitutes amazon s3 upload support for Google Cloud Storage and DigitalOcean Spaces.

### Build Integration

https://docs.ckeditor.com/ckeditor5/latest/builds/guides/development/custom-builds.html

`npm install ckeditor5-google-do`

Add this plugin and remove the ckfinder and easyimage plugins

```javascript
// build-config.js

module.exports = {
  // ...

  plugins: [
    '@ckeditor/ckeditor5-essentials/src/essentials',
    // ...

    //'@ckeditor/ckeditor5-adapter-ckfinder/src/uploadadapter',
    //'@ckeditor/ckeditor5-easy-image/src/easyimage',

    'ckeditor5-google-go/src/upload'

    // ...
  ],

  // ...

  config: {
    toolbar: {
      items: [
        'headings',
        'bold',
        'italic',
        'imageUpload',
        'link',
        'bulletedList',
        'numberedList',
        'blockQuote',
        'undo',
        'redo'
      ]
    }
    // ...
  }
};
```

### Configuration

```javascript
ClassicEditor.create(document.querySelector('#editor'), {
  uploadGoogleDO: {
    policyUrl: 'http://127.0.0.1/my-upload-endpoint'
  }
});
```

### Backend

The endpoint will receive a filename and filetype as query parameters, and will need to respond with a presigned url, acl, and completed upload url in JSON format.

```json
{
  "endpoint_url": " ... ",
  "location": "https://url_of_completed_upload",
  "acl": " ... "
}
```

### Backend Setup

- Guide with an example for [setting up Google Cloud Storage](https://github.com/hutchgrant/ckeditor5-google-do/blob/master/docs/readme-google-cloud-storage.md).
- Guide with an example for [setting up DigitalOcean Spaces](https://github.com/hutchgrant/ckeditor5-google-do/blob/master/docs/readme-digital-ocean-spaces.md).
- Guide for [configuring ckeditor5-google-do to utilize dynamic serving URLs](https://github.com/hutchgrant/ckeditor5-google-do/blob/master/docs/readme-google-appengine.md) from Google App Engine API