History

Diogo Peralta Cordeiro d47bb3736e [Media] Document recently added settings and add some more Fix some buggy ones, especially Embed crop		2021-02-21 16:03:46 +00:00
..
locale	[VersionBump] 2.0.0alpha0	2020-08-04 05:31:44 +01:00
scripts	[DATABASE] Fix use of ORDER BY with DISTINCT	2020-08-27 11:15:39 +03:00
README.md	[Media] Document recently added settings and add some more	2021-02-21 16:03:46 +00:00
StoreRemoteMediaPlugin.php	[Media] Document recently added settings and add some more	2021-02-21 16:03:46 +00:00

README.md

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

domain_whitelist: Array of regular expressions. Always escape your dots and end your strings.
check_whitelist: Whether to check the domain_whitelist.

When check_whitelist is set, only images from URLs matching a regex in the 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].
crop: Crop to the thumbnail size and don't preserve the original file. Defaults to false.
max_size: Max media size. Anything bigger than this is rejected. Defaults to global [attachments][file_quota].

Example

addPlugin('StoreRemoteMedia', [
    'domain_whitelist' => [
        '^i\d*\.ytimg\.com$' => 'YouTube',
        '^i\d*\.vimeocdn\.com$' => 'Vimeo'
    ],
    'check_whitelist' => true,
]);