Skip to content

Latest commit

 

History

History
65 lines (48 loc) · 3.68 KB

UPGRADING.md

File metadata and controls

65 lines (48 loc) · 3.68 KB
Raw

Upgrading

Because there are many breaking changes an upgrade is not that easy. There are many edge cases this guide does not cover. We accept PRs to improve this guide.

From v5 to v6

  • the signature of registerMediaConversions has been changed.

Change every instance of

public function registerMediaConversions()

to

public function registerMediaConversions(Media $media = null)
  • change the defaultFilesystem key in the config file to default_filesystem
  • add the image_optimizers key from the default config file to your config file.
  • be aware that the medialibrary will now optimize all conversions by default. If you do not want this tack on nonOptimized to all your media conversions.
  • toMediaLibrary has been removed. Use toMediaCollection instead.
  • toMediaLibraryOnCloudDisk has been removed. Use toMediaCollectionOnCloudDisk instead.

From v4 to v5

  • rename config/laravel-medialibrary to config/medialibrary.php. Some keys have been added or renamed. Please compare your config file againt the one provided by this package
  • all calls to toCollection and toCollectionOnDisk and toMediaLibraryOnDisk should be renamed to toMediaLibrary
  • media conversions are now handled by spatie/image. Convert all manipulations on your conversion to manipulations supported by spatie/image.
  • add a mime_type column to the media table, manually populate the column with the right values.
  • calls to getNestedCustomProperty, setNestedCustomProperty, forgetNestedCustomProperty and hasNestedCustomProperty should be replaced by their non-nested counterparts.
  • All exceptions have been renamed. If you were catching medialibrary specific exception please look up the new name in /src/Exceptions.
  • be awaregetMedia and related functions now return only the media from the default collection
  • image_generators have now been added to the config file.

From v3 to v4

  • All exceptions have been renamed. If you were catching medialibrary specific exception please look up the new name in /src/Exceptions.
  • Glide has been upgraded from 0.3 in 1.0. Glide renamed some operations in their 1.0 release, most notably the crop and fit ones. If you were using those in your conversions refer the Glide documentation how they should be changed.

From v2 to v3

You can upgrade from v2 to v3 by performing these renames in your model that has media.

  • Spatie\MediaLibrary\HasMediaTrait has been renamed to Spatie\MediaLibrary\HasMedia\HasMediaTrait.
  • Spatie\MediaLibrary\HasMedia has been renamed to Spatie\MediaLibrary\HasMedia\Interfaces\HasMediaConversions
  • Spatie\MediaLibrary\HasMediaWithoutConversions has been renamed to Spatie\MediaLibrary\HasMedia\Interfaces\HasMedia

In the config file you should rename the filesystem-option to default_filesystem.

In the db the temp-column must be removed. Add these columns:

  • disk (varchar, 255)
  • custom_properties (text) You should set the value of disk column in all rows to the name the default_filesystem specified in the config file.

Note that this behaviour has changed:

  • when calling getMedia() without providing a collection name all media will be returned (whereas previously only media from the default collection would be returned)
  • calling hasMedia() without a collection name returns true if any given collection contains files (wheres previously it would only return try if files were present in the default collection)
  • the addMedia-function has been replaced by a fluent interface.

From v1 to v2

Because v2 is a complete rewrite a simple upgrade path is not available. If you want to upgrade completely remove the v1 package and follow install instructions of v2.