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

.. _upmailformtoformlegacy:

.. figure:: ext_icon_354x354.gif
	:width: 300px
	:alt: Extension icon

=============================================================
Upgrade Wizard: mailform to form_legacy
=============================================================

.. only:: html

	:Classification:
		upmailformtoformlegacy

	:Version:
		|release|

	:Language:
		en

	:Description:
		Upgrade CType mailform to EXT:form_legacy


	:Keywords:
		ctype, form_legacy, mailform 

	:Website:
		https://typo3-upmailformtoformlegacy.de/

	:Copyright:
		2021

	:Author:
		Dirk Wildt (verdigado eG)

	:Email:
		support@verdigado.com

	:License:
		This document is published under the Open Publication License
		available from http://www.opencontent.org/openpub/

	:Rendered:
		|today|

	The content of this document is related to TYPO3,
	a GNU/GPL CMS/Framework available from `www.typo3.org <https://typo3.org/>`__.


Contents
--------


Screenshots
'''''''''''

.. figure:: up1.png
	:width: 800px
	:alt: Upgrade Wizard 1st step

Upgrade Wizard for Ctype mailform


What does it do?
''''''''''''''''

This extension extends the Upgrade Wizard with a job, which migrates the CType mailform to the EXT:form in TYPO3 7.6 and EXT:form_legacy in TYPO3 8.7.

This fields are handled:

* checkbox
* hidden field
* radio button
* select form
* submit button
* text area
* text field
* upload field

This fields aren't handled, if they are used, the upgrade wizard will throw an exception:

* button
* fieldset
* password
* reset button


Dry mode
''''''''

If you like to test the migration in dry mode, please set DEV_DRY to true at 
Classes/Install/Updates/Mailformtoformlegacy.php:

.. code:: php

  const DEV_DRY = false; // if true, you will get a report only. Neither database update will done nor files will written


Credits
'''''''

Thanks to  Benjamin Serfhos, who published an initail code at https://gist.github.com/bmoex/5135f3e6685a358a54e6c955bf64d21b