.. include:: ../../Includes.txt

========
Updating
========

If you update EXT:kk_downloader to a newer version, please read this section carefully!

Update to Version 5.2.3
=======================

There was a bug in CategoryUpgradeWizard since version 5.1.0. If you have problems after the upgrade, please restore
a DB backup and execute the wizard again.


Update to Version 5.2.0
=======================

With TYPO3 9.5 the compatibility for files and file references in TCA group fields was deprecated and will be
removed in TYPO3 10.0. See here:
`Deprecation: #86406 - TCA type group internal_type file and file_reference <https://docs.typo3.org/c/typo3/cms-core/master/en-us/Changelog/9.5/Deprecation-86406-TCATypeGroupInternal_typeFileAndFile_reference.html#deprecation-86406-tca-type-group-internal-type-file-and-file-reference>`__

As kk_downloader uses this system a lot we have added two new UpdateWizards:

* UpdateWizard to migrate your downloadable files from `/uploads/kk_downloader/` to `fileadmin/_migrated/kk_downloader`.
* UpdateWizard to migrate imagepreview files from `/uploads/kk_downloader/` to `fileadmin/_migrated/kk_downloader`.

As all values from column `downloaddescription` were migrated into the file reference of your downloaded files, we
have removed this column from table `tx_kkdownloader_images`.

.. hint::

   The UpdateWizards checks each file for existence in full `fileadmin/` folder. If found, it will update the relation
   automatically. So it may happen that `fileadmin/_migrated/kk_downloader/` folder will contain less files then in
   `uploads/kk_downloader/`.


Update to Version 5.1.0
=======================

With TYPO3 6.0 we got a new possibility to manage categories. So there is no need to keep our own system
for kk_downloader categories.

Please execute UpdateWizard `[kk_downloader] Migrate KK categories to TYPO3 sys_categories` to migrate the
categories. This Wizard also updates the category relations to your download records and updates the
selected categories in all of your FlexForms.


Update to Version 5.0.0
=======================

This version is not TYPO3 7.6 compatible anymore!
We have added TYPO3 9.6 compatibility.

We have moved TS template from `styles/css` to `Configuration/TypoScript`. As there is no UpdateWizard available
you have to re-add the TS template of kk_downloader to your system.

You will find the new default fluid template here: `EXT:kk_downloader/Resources/Private/Templates/MainTemplate.html`.
If you have overwritten this file, please adopt changes into your own template. All marker based variables
have been replaced with fluid variables!

A lot of TCA was moved to more accepted folders. Please clear system cache after upgrading.


Update to Version 4.0.0
=======================

Was never released

PHP classes of plugin were moved from `/pi` directory to `Classes/Plugin`.


Update to Version 3.0.1
=======================

jweiland.net has taken over the extension key.