Installation - matoilic/t3chimp GitHub Wiki

First make sure that extbase and fluid are installed. Then, after installing the extension through the extension manager in TYPO3 (just search for t3chimp) you have to enter the API key that will be used to read and write data from and to your MailChimp account. To obtain a new API key log in to MailChimp. Then in the top navigation under Account choose "API Keys & Authorized Applications".

On the following page click on "Add A Key". Label the new key properly and copy it into the extension configuration in TYPO3. You should always use a separate key for each application. This way it is easier to revoke access for individual applications. If you have a multi page setup and want to use separate API keys for each page you can also configure the API key in the constants editor of the target page. This only works for TYPO3 from version 6.0 and up. If you are using an older version you can configure the site specific API key by setting plugin.tx_t3chimp.settings.apiKey in the root page TSConfig.

After you have configured the plugin you can add it to the desired page like all other plugins. Do not forget to include the plugin's setup item in the containing page. You will be asked to choose the list for which you want to output the signup form. You can also include the default styles of the plugin but usually you want to style the plugin on your own so it integrates perfectly in to your site's design.

And that is it. In the MailChimp backend – in the form designer or in the "List Fields and |MERGE| Tags" settings of your list – define the information you want your subscribers to enter and the extension will pick up the settings and display the sign up form on your site accordingly. Do not forget to clear the cache in TYPO3 after making changes to the list settings. T3Chimp caches the list information to optimize the page load time.

CAPTCHA

T3Chimp uses a JavaScript based CAPTCHA solution that prevents robots from submitting subscription. The CAPTCHA does not require any user interaction. It is unlikely that this will cause any problems. If the does you can deactivate the CAPTCHA in the plugin configuration.

Suhosin

If you have installed the Suhosin hardening extension make sure that it allows the usage of PHAR archives suhosin.executor.include.whitelist=phar. Otherwise you will only see a white page without a error message after adding T3Chimp on a page. See the Suhosin documentation for further information on the whitelist options.