Cloudinary image handling & upload field for SilverStripe

Installs: 1 092

Dependents: 0

Suggesters: 0

Security: 0

Stars: 1

Watchers: 4

Forks: 5

Open Issues: 0


2.0.0 2023-09-16 00:00 UTC


SilverStripe Cloudinary image uploader

Adds a Level51\Cloudinary\Image data object and an appropriate uploader using Cloudinary's javascript upload widget.


composer require level51/silverstripe-cloudinary
Module Version Silverstripe Version PHP Version
2.x 5.x >=8
1.x 4.x >=7
0.x 3.x >=5.6,<7.2


You have to define some mandatory configuration to get started:

  cloud_name: String, mandatory
  api_key: String, mandatory
  api_secret: String, mandatory
  upload_preset: String, mandatory if unsigned, optional if signed
  # https://cloudinary.com/documentation/upload_widget#look_and_feel_customization
  theme: default 'white', 
  # https://cloudinary.com/documentation/upload_widget#signed_uploads
  use_signed: true
  # https://cloudinary.com/documentation/admin_api#delete_all_or_selected_resources
  image_type: 'private'
  # Whether to show/hide the remove button
  show_remove: false
  # Whether to append the g_custom option or not
  use_custom_gravity: true
  # Allowed file extensions, optional, defaults to ['png', 'gif', 'jpeg']
  # Note that the extensions can also be limited per instance using `setAllowedExtensions`
  allowed_extensions: ['png', 'gif', 'jpeg']


private static $has_one = [
    'Image' => \Level51\Cloudinary\Image::class

private static $has_many = [
    'Images' => Image::class

public function getCMSFields() {
	$fields = parent::getCMSFields();
			\Level51\Cloudinary\UploadField::create('Image', $this->fieldLabel('Image')),
				// ->setRatio(16 / 9)
				// ->disableCropping()
				// ->setFolderName('path/to/destination')
				// ->setAllowedExtensions(['jpg'])
			\Level51\Cloudinary\MultiUploadField::create('Images', $this->fieldLabel('Images'))
				// ->setAllowedMaxFileNumber(5)
	return $fields;
// In templates

// With transormations

// With effect filters

Checkout the available transformations and effects in the \Level51\Cloudinary\Image class.


  • UploadField using the javascript upload widget - so direct uploads to Cloudinary
  • Store the relevant information in a Level51\Cloudinary\Image object


If you need any further fields just extend the Level51\Cloudinary\Image class with a data extension. To inject information returned by Cloudinary during the upload create another extension for the Level51\Cloudinary\UploadController and use one of the two extensions hooks onBeforeImageCreated or onAfterImageCreated. Both get passed the image object, either before or after the first write.