@aaron_lejeune/strapi-provider-upload-uploadcare
v1.2.2
Published
Upload provider for Strapi using UploadCare
Downloads
15
Maintainers
aaron_lejeuneReadme
@aaron_lejeune/strapi-provider-upload-uploadcare
Installation
# using yarn
yarn add @aaron_lejeune/strapi-provider-upload-uploadcare
# using npm
npm install @aaron_lejeune/strapi-provider-upload-uploadcare --saveConfiguration
providerdefines the name of the providerproviderOptionsis passed down during the construction of the provider.actionOptionsis passed directly to each method respectively allowing for custom options. You can find the complete list of upload/ uploadStream options and delete options
See the documentation about using a provider for information on installing and using a provider. To understand how environment variables are used in Strapi, please refer to the documentation about environment variables.
Your configuration is passed down to the uploadcare configuration. (e.g: UploadClient({})). You can see the complete list of options here
See the using a provider documentation for information on installing and using a provider. And see the environment variables for setting and using environment variables in your configs.
Provider Configuration
./config/plugins.js
module.exports = ({ env }) => ({
// ...
upload: {
config: {
provider: '@aaron_lejeune/strapi-provider-upload-uploadcare',
providerOptions: {
public_key: env('UPLOADCARE_PUBLIC_KEY'),
secret_key: env('UPLOADCARE_SECRET_KEY'),
base_cdn: env('UPLOADCARE_BASE_CDN'),
},
},
},
// ...
});https://github.com/uploadcare/uploadcare-upload-client#settings
public_key: string
The main use of a public_key is to identify a target project for your uploads. It is required when using Upload API.
base_cdn: string
Defines your schema and CDN domain. Can be changed to one of the predefined values (https://ucarecdn.com/) or your custom CNAME.
Defaults to https://ucarecdn.com/.
BONUS: Turn off Strapi's "Responsive friendly upload"
Because Uploadcare is already handling responsive uploads, file optimisation, ... we dont need Strapi to be uploading the file in different sizes. This will just fill the UploadCare CDN with images/versions we're never going to use.
To turn off this feature, go to your Strapi admin panel -> Settings -> Media Library:
- Responsive friendly upload:
False - Size optimization:
False - Auto orientation:
False
Security Middleware Configuration
Due to the default settings in the Strapi Security Middleware you will need to modify the contentSecurityPolicy settings to properly see thumbnail previews in the Media Library. You should replace strapi::security string with the object bellow instead as explained in the middleware configuration documentation.
./config/middlewares.js
module.exports = [
// ...
{
name: 'strapi::security',
config: {
contentSecurityPolicy: {
useDefaults: true,
directives: {
'connect-src': ["'self'", 'https:'],
'img-src': ["
'self'",
'data:',
'blob:',
'market-assets.strapi.io',
'ucarecdn.com', //uploadcare
'-- your custom base_cdn', //custom base_cdn
// ...
],
'media-src': ["
'self'",
'data:',
'blob:',
'market-assets.strapi.io',
'ucarecdn.com', //uploadcare
'-- your custom base_cdn', //custom base_cdn
// ...
],
upgradeInsecureRequests: null,
},
},
},
},
// ...
];