verdecircle/strapi-provider-upload-cloudinary-folderoptions

an extension of the strapi-provider-upload-cloudinary that allows for a default_folder option in the config as well as using the file name to define folder structure.

strapi-provider-upload-cloudinary-folderoptions

This is an extended version of strapi-provider-upload-cloudinary

Configurations

Your configuration is passed down to the cloudinary configuration. (e.g: cloudinary.config(config)). 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.

Example default_folder option has been added to the config to allow for uploading to a specific cloudinary folder by default. The file name can also be used to specify a folder structure that remains under the default_folder option or overrides the default_folder options.

For example:

• example_app.png could be uploaded to /[default_folder]/logos/apps cloudinary folder by having a default_folder option set and changing the file name to logos/apps/example_app.png

• If you want to override the default_folder options at the time of upload, change the file name to /logos/apps/example_app.png. This would upload the file under a cloudinary folder structure of /logos/apps instead of /[default_folder]/logos/apps

While Cloudinary can handle all the image size/cropping/quality/etc for you so that you don't have to turn on the "Enable responsive friendly upload" on Strapi, this will also take into consideration the different default sizing Strapi performs and place them in subfolder accordingly (e.g. thumbnail, small, medium, large)

Starting Cloudinary

Upload files to root by adding /logos/apps/ to the file name

And the result is... New Folder in Cloudinary root

Files in directory structure specified ^^^ In this case, we have "Enable responsive friendly upload" set to on in Strapi>Settings>Media Library

Upload files using the default_folder option AND even adding your own folder structure

And the result is... default_folder (which is set in .env file) created on cloudinary root with file specific sub folders as well

Upload to default_folder only

Files placed in root of default_folder on Cloudinary

./config/plugins.js

module.exports = ({ env }) => ({
  // ...
  upload: {
    provider: 'cloudinary-folderoptions',
    providerOptions: {
      cloud_name: env('CLOUDINARY_NAME'),
      api_key: env('CLOUDINARY_KEY'),
      api_secret: env('CLOUDINARY_SECRET'),
      default_folder: env('CLOUDINARY_DEFAULT_FOLDER'),
    },
  },
  // ...
});

Resources

• License

Links

• Strapi website
• Strapi community on Slack
• Strapi news on Twitter

strapi-provider-upload-cloudinary-folderoptions's Issues

why a distinct repository ?

Hi !

Thank you for your work !

I was wondering, why a single feature would need a distinct project ?

Using the main package (strapi-provider-upload-cloudinary) like so does exactly the same thing, is additional value to using this package ?

module.exports = ({ env }) => ({
  upload: {
    provider: 'cloudinary',
    providerOptions: {
      cloud_name: env('CLOUDINARY_NAME'),
      api_key: env('CLOUDINARY_KEY'),
      api_secret: env('CLOUDINARY_SECRET'),
    },
    actionOptions: {
      upload: {
        folder: env('NODE_ENV'),
      },
      delete: {},
    },
  },
});

Cheers

support for eager async preview urls (big videos)

Hi awesome tool! i love it. realized for large videos preview url gif you try to generate gets 400'd due to automatic on the fly generation only works for file sizes 40mb and below. need to supply eager_async: true, so adding this slight change to your code would support it:

In the code put

if (image.resource_type === 'video') {
  if (image.eager?.length) {
    file.previewUrl = image.eager[0].secure_url;
  } else {
    file.previewUrl = cloudinary.url(`${image.public_id}.gif`, {
      video_sampling: 6,
      delay: 200,
      width: 250,
      crop: 'scale',
      resource_type: 'video',
    });
  }
}

example setting:

    actionOptions: {
          upload: {
            eager: [
              { video_sampling: 6,
                delay: 200,
                width: 250,
                crop: 'scale',
                resource_type: 'video',
                fetch_format: 'gif',
                format: 'gif',
              }
            ],
            eager_async: true,
          },
        }
      },
      ```