Skip to content

v1.0.1 - Enhanced Upload Flow with Custom Payloads and Widget Options

Latest

Choose a tag to compare

@bgillieron bgillieron released this 24 Jul 07:03

πŸš€ Yii2Cloudinary v1.0.1

This release introduces several powerful improvements to the upload flow, metadata persistence, and UI behavior. It's fully backward-compatible and focused on enabling more dynamic media handling in real-world projects.


✨ Highlights

  • βœ… Support for passing custom metadata (customPayload) through the upload process
  • βœ… Upload Widget now supports reloadAfterClose and passes payload to backend
  • βœ… Enhanced relation handling via updated relationSaverMap signature
  • βœ… Improved error logging and handling across upload flow
  • βœ… Translatable alt/title support using getTranslation()
  • βœ… Updated documentation and database schema for multilingual metadata

πŸ”§ Added

  • customPayload option on both upload() and uploadWidget() methods
  • reloadAfterClose flag to trigger a page reload after widget closes
  • CloudinaryMedia::getTranslation($attribute, $lang = null) helper method

🧱 Changed

  • cloudinary_media_desc.title: increased to 255 characters
  • cloudinary_media_desc.description: changed to TEXT
  • Improved logging around Cloudinary uploads, DB persistence, and relation resolution
  • Widget JS now injects the full payload into the upload handler call

πŸ“š Docs Updated

  • README.md: usage examples, widget payload options, relation handling
  • render-responsive-image.md: tips for localized alt text
  • upload-widget-localization.md: clarified override behavior + extra widget options
  • cloudinary-media-migrations.md: updated schema for multilingual fields

πŸ§ͺ Migration

If you've already applied the migration file, you may need to manually alter your table:

ALTER TABLE cloudinary_media_desc 
  MODIFY title VARCHAR(255), 
  MODIFY description TEXT;

🧾 Composer

composer require bgillieron/yii2-cloudinary:^0.3

Thanks for using Yii2Cloudinary!
Feel free to report bugs or ideas in Issues.