Newsletter subscripton 

Creating a newsletter embedding

• Before embedding a newsletter subscription via HTML in toujou you must first generate the necessary code via your email provider. You will find instructions for CleverReach and Mailchimp in the respective links below. 
• For the newsletter subscription to appear in the front end as a form, you need to create a new content element on the desired page. Click on the + Content button and then on the widgets tab on the desired HTML element. For example, if you want a form to extend to text width, you can choose HTML.
• Under the Content tab, you can copy and paste the HTML code generated by the newsletter provider into the text field.
• Save the changes.

HTML embedding with CleverReach ↗  HTML embedding with Mailchimp ↗

Preparing the CleverReach shortcut

• If you want to attach the newsletter subscription to another form, you will first need the four additional CleverReach parameters: Client ID, Client Secret, Form ID and Group ID.
• You will get the Client ID and Client Secret when you create the Outh app in the REST API section.
• The form ID can be found in the forms section and the Group ID in the recipient section (see screenshot).

Creating a CleverReach Connection Record

• To attach a newsletter subscription to another form, you first need to link the CleverReach account to your toujou back end.
• To do so, click on the List view in the module list, then on Storage Folder in the tree view and then the cross icon. When you press the CleverReach Connection button in the toujou section (left box) you then open a new folder. 
• Enter the desired name (e.g. Newsletter) under Title. Under Client ID and Client Secret, type the corresponding data of CleverReach (see above).
• Save your settings. Afterwards, the corresponding document is available under List > Storage Folder > CleverReach Connection.

Select form 

• Click on forms in your module bar and select the desired form (e.g. Request for a demo). The form mask will appear with all the input fields you have set up (see next picture).
• To find out how to add or remove additional input fields to a form, and how to set up a form in general, see the video »create new form« in the TYPO3 tutorial »Create forms«.

Create finisher and enter data

• To finalize the link the form data and CleverReach you need to create a finisher.  Click on the drop-down menu Add Finisher and select CleverReach Subscribe. A CleverReach form opens in a new window. 
• Press the CleverReach Record button under the field CleverReach Connection, which will cause the module tree appears then. Click on Storage Folder and the desired CleverReach Connection to generate the connection. 
• Locate the Target Form ID and enter the CleverReach Form ID. For the Target Group ID, enter the Group ID. 
• By clicking on the corresponding selection field on the right side (symbol with arrow down) you can fill in the input field email. To select one, an email address must be marked as mandatory field in the form.
• Next you will need to add the Newsletter Checkbox. This is a required aspect of any newsletter because it allows users to confirm that they do in fact want to receive the newsletter. To ensure that the checkbox works properly you must select the corresponding item.
• Finally, save all changes.