Skip to main content
The technical documentation for this extension uses the Composer package aix/tonic and the extension key tonic. The vendor is also rebranding the product as TONICTYPES, and its marketing pages reference a newer package name, k3n/tonictypes. Before you install, check the TER extension page to confirm which package name and TYPO3 version range are current for your project.

Step 1 - Install the Extension

Install the extension with Composer, or upload it manually with the Extension Manager. :: composer require aix/tonic Once the extension is installed and the version matches your TYPO3 installation, it appears in your extension list. TypoTonic extension listed in the TYPO3 Extension Manager The extension in the TYPO3 Extension Manager after installation

Step 2 - Include the Static Template

TypoTonic needs its static template included in your site template. This adds the fields and configuration TypoTonic needs to work.
  1. Open the Template module for your site’s root page.
  2. Select Info/Modify, then Edit the whole template record.
  3. Switch to the Includes tab.
  4. Under Include static (from extensions), add [TypoTonic] General Configuration (tonic).
Including the TypoTonic static template in the site template Adding the TypoTonic static template under Includes

Step 3 - Clear the Caches

Clear all TYPO3 caches so your new TypoScript configuration is loaded.

Additional Configuration

Predefine Templates in TypoScript

You can predefine templates for the template selector in TypoScript instead of choosing a file manually every time. Add this to your root page TypoScript:
Predefined template shown in the TypoTonic template selector A predefined template appearing in the template selector Once a template is predefined this way, you can render it in Fluid with the Template.RenderViewHelper. See ViewHelpers for the full syntax.

Toolbar Item (Professional Feature)

TypoTonic Professional adds a toolbar item for fast access to create and edit records. TypoTonic Professional toolbar item in the TYPO3 backend The Professional toolbar item To turn the toolbar item off, add this to the User TSconfig:

Frontend Record Editing (Professional Feature)

TypoTonic Professional can also show an edit button on the frontend detail page, so logged-in backend users can jump straight to editing a record. Frontend record edit button added by TypoTonic Professional The frontend edit button, shown in the top-right corner of the page Enable it with this User TSconfig:

Add Record Creation Buttons to the DocHeader

You can add “create new record” buttons for specific Datatypes to the list module’s DocHeader. Add the Datatype UIDs to the Page TSconfig:
Record creation buttons added to the list module DocHeader DocHeader buttons for creating new Datatype records
This button is also added automatically when you configure the page’s Behaviour setting with a Datatype.

Next Steps

Continue with Getting Started to create your first field, Datatype, and record.