.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

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


Migration from tt_news to news
------------------------------
This tutorial will help you to migrate data from tt_news to news.

Requirements
^^^^^^^^^^^^
- Installed extension news
- Installed extension news_ttnewsimport

.. hint:: If you experience any troubles during imports, test the latest versions of the 2 extensions which can be found at https://git.typo3.org/TYPO3CMS/Extensions/news.git and https://github.com/fsaris/news_ttnewsimport.

Migration
^^^^^^^^^

Migration of records
""""""""""""""""""""
To be able to migrate records, you need to activate the import module.
This needs to be done in the configuration of EXT:news inside the Extension Manager.

#. Activate the checkbox "Show importer", save and reload the backend. Now you should see the backend module "News Import".
#. Switch to the backend module.
#. Select "Import tt_news category records" from the select box and start the import of categories.
#. Select "Import tt_news news records" from the select box and start the import of news records.

Migration of plugins
""""""""""""""""""""
Since the latest version of news_ttnewsimport it is also possible to migrate tt_news plugins
which is especially useful if you got some dozens of those.

All settings which can be mapped are migrated!

For further information, please take a look at the manual of news_ttnewsimport!

Not migrated
""""""""""""
Be aware that some things are **not** migrated:

- Templates
- TypoScript configuration
- Backenduser & -group configuration
- Additional fields added to tt_news by 3rd party extensions