Initial commit - Typo3 11.5.41

typo3conf/ext/tt_address/Documentation/Administration/Updating/Index.rst

@@ -0,0 +1,65 @@
+.. include:: /Includes.rst.txt
+
+.. _administration-updating:
+
+========
+Updating
+========
+
+In general after every update you should update the database scheme in
+:guilabel:`Admin tools > Maintenance > Analyze Database` and flush all caches.
+
+Updating from 5.x to 6.0.0
+--------------------------
+
+The field `name` is **not** filled automatically anymore by the first and last
+name and the field will be remove with one of the next versions. If your
+templates or third party extension depend on this field to be filled you can
+activate the legacy behaviour in
+:guilabel:`Admin tools > Settings > Extension Configuration` by checking
+:guilabel:`Store backwards compatibility name in name field`.
+
+Translation files for languages other then English are not included directly
+in the extension anymore. You can get them from the translation server at
+:guilabel:`Admin tools > Maintenance > Manage Languages`.
+
+Updating from 4.x to 5.0.0
+--------------------------
+
+.. warning::
+
+	The upgrade wizard to migrate from pibase to extbase plugins have been removed. If you need those, please install version 4.x first and upgrade afterwards.
+
+With the version 5.0.0 the TYPO3 versions 9 and 10 are supported which also means that the support for version 8 has been dropped.
+
+
+Updating from 3.x to 4.0.0
+--------------------------
+With the version 4.0.0 the code base changed a lot to support TYPO3 8.7 LTS and 9.5 LTS.
+
+The most important changes are:
+
+- Changing the vendor name from `TYPO3` to `FriendsOfTYPO3`
+- Usage of Extbase & Fluid. The previous plugin is deprecated and will be removed with version 5.0.0
+- Changing the location of TypoScript files of old plugin
+
+An upgrade wizard in the Install Tool makes it possible to upgrade the TypoScript usages.
+It migrates `EXT:tt_address/static/pi1` to `EXT:tt_address/Configuration/TypoScript/LegacyPlugin`.
+
+.. warning::
+
+	The upgrade wizard does not update any TS inclusion done in your site package.
+
+Another upgrade wizard migrates old piBase plugins to extbase plugins. The `Template` option is converted to
+`Display mode`. So for example your `Template` is `my_template.html`, then
+
+- Add TSconfig `TCEFORM.tt_content.pi_flexform.ttaddress_listview.sDISPLAY.settings\\.displayMode.addItems.my_template = My Template`
+- Add a section named `displayMode_my_template` in your custom `List.html` fluid template
+
+After execution (via cli) you get a list of custom templates you used in your installation.
+
+Updating from 2.x to 4.0.0
+--------------------------
+
+It is **not** possible to upgrade from version 2.x to 4.0 directly! Update first to the latest 3.x version and use
+the upgrade wizards to migrate from custom category records to sys_category records and to FAL elements.