+49 911 23980-870

Newsletter subscripton 

With toujou you can set up a newsletter subscription on its own or attach it to any other form. In both cases it is essential to register with an email provider.

 Manual for the newsletter subscripton  Manual for attaching the newsletter subscripton  Pieces of advice

Manual for the integration of the newsletter subscription

Before you can use toujou to create a newsletter subscription for your website, you will need a (free) account with an email provider. We highly recommend CleverReach but Mailchimp is also a good option.

Sign up with CleverReach ↗  Sign up with Mailchimp ↗

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 ↗

Attach a newsletter subscription to another form

With toujou, you can run a query in each of your forms to determine whether an additional newsletter subscription is desired. In the following steps we will explain how to integrate this query into existing forms. Currently, this can only be done if you are using CleverReach as your email provider.

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.

Pieces of advice

toujou is based on TYPO3 and anyone familiar with TYPO3 knows that there are many different options to use to reach your desired results. We would like to point out important information and little tricks that can assist you when you’re creating and editing your website.

Before implementing a newsletter subscription on your toujou website, a registration with an email provider is necessary. Beneficial to toujou is the HTML integration that both Mailchimp or CleverReach provide.

For a successful finisher for a newsletter registration with another form, it is essential to request the email address beforehand. The newsletter checkbox should also be included to guarantee that you are compliant with the consent policy and that you only store user-approved data in the back end. Other fields such as first name and surname are optional, but useful to provide a personal touch for your customers. 

Please note that both the free version of CleverReach and Mailchimp put limits on the number of allowed addresses and the amount of emails that can be delivered. Once you surpass their set limit additional fees will be charged. If you have any questions regarding the application of these or any other email providers please contact our support.