2021-02-16 18:30:21 +00:00
|
|
|
The StoreRemoteMedia plugin downloads remotely attached files to local server.
|
|
|
|
|
|
|
|
|
|
IMPORTANT: If using both Embed and StoreRemoteMedia plugins, Embed should be added first.
|
|
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
============
|
|
|
|
|
add `addPlugin('StoreRemoteMedia');`
|
|
|
|
|
to the bottom of your config.php
|
|
|
|
|
|
|
|
|
|
Settings
|
|
|
|
|
========
|
2021-02-19 12:10:37 +00:00
|
|
|
* `domain_whitelist`: Array of regular expressions. Always escape your dots and end your strings.
|
|
|
|
|
* `check_whitelist`: Whether to check the domain_whitelist.
|
2021-02-16 18:30:21 +00:00
|
|
|
|
|
|
|
|
When check_whitelist is set, only images from URLs matching a regex in the
|
2021-02-19 12:10:37 +00:00
|
|
|
domain_whitelist array are accepted for local storage.
|
|
|
|
|
|
|
|
|
|
* `thumbnail_width`: Maximum width of the thumbnail in pixels. Defaults to global `[thumbnail][width]`.
|
|
|
|
|
* `thumbnail_height`: Maximum height of the thumbnail in pixels. Defaults to global `[thumbnail][height]`.
|
2021-02-21 10:35:02 +00:00
|
|
|
* `crop`: Crop to the size (not preserving aspect ratio). Defaults to global `[thumbnail][crop]`.
|
2021-02-19 12:10:37 +00:00
|
|
|
* `max_size`: Max media size. Anything bigger than this is rejected. Defaults to global `[attachments][file_quota]`.
|
2021-02-21 10:35:02 +00:00
|
|
|
* `store_original`: Whether to maintain a copy of the original media or only a thumbnail of it. Defaults to false.
|
2021-02-16 18:30:21 +00:00
|
|
|
|
|
|
|
|
Example
|
|
|
|
|
=======
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
addPlugin('StoreRemoteMedia', [
|
|
|
|
|
'domain_whitelist' => [
|
|
|
|
|
'^i\d*\.ytimg\.com$' => 'YouTube',
|
|
|
|
|
'^i\d*\.vimeocdn\.com$' => 'Vimeo'
|
|
|
|
|
],
|
|
|
|
|
'check_whitelist' => true,
|
|
|
|
|
]);
|
|
|
|
|
```
|
