Skip to content
This repository has been archived by the owner on May 2, 2024. It is now read-only.

Latest commit

 

History

History
43 lines (33 loc) · 2.96 KB

UPGRADING.md

File metadata and controls

43 lines (33 loc) · 2.96 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 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 defaultFilesystem.

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 defaultFilesystem 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.