# Configuring the Typo3 Connector

Before using the Typo3 Connector, you need to create a frontend user in Typo 3 and configure the connector.

Please consider the different configuration guides depending on your Typo3 version:

Typo3 v12 configuration guide
Typo3 v8, v9, v10 configuration guide

# Configuration Guide for Typo3 v12

# Preparing Typo3: New Page and Website User

To connect Typo3 securely with your 4ALLPORTAL using username and password, you have to create a frontend user. For this you need to create a page and Website User module and configure them:

Open Typo3. Navigate to tab List (left side panel) and use right mouse menu to create a new New subpage.
- Set Page Title, for example 4AP Test
- Make sure this page is visible. For this set Page visible to true in tab Access
- In case you don't have any pages yet, make sure to enable Use as Root Page in tab Behaviour.
Select your new page and use right mouse menu to create a New subpage. For this second page, make the following settings:
- Tab General:
  - set Type to Folder
  - set aPage Title, for example 4AP Folder
- Tab Behaviour: set Contains Plugin to Website Users
- Tab Access: make sure the page is visible
Select the folder you have created.
- Click on +Create new record and select Website Usergroup.
- Go to General and set a Group Title, for example 4AP Group.
- Go to tab Access and set Enabled to true.
Now click on +Create new record on the folder created and add a Website User make the following settings:
- tab General
  - Set Username. This is the Typo3 username in Admin Snap-In DAM/Typo3 Connector.
  - Set Password. This is the Typo3 password in Admin Snap-In DAM/Typo3 Connector.
  - Set API Key to the same value as Password-
  - Add the previously created Website Usergroup to Groups box
- Switch to tab Access and set Enabled to true.
- Switch to tab Personal Data and fill in the fields.

Now try to visit http://example.typo3.net/rest/ (opens new window).

If you can see the expected response like "OK", the configuration of the REST plugin is complete. You can now continue with the configuration of the 4ALLPORTAL (4ALLPORTAL configuration).

# Troubleshooting

If you see an error message, there may be two reasons:

# Missing Template

You may not have added a template to your root page and folder page. To fix that, do the following:

Navigate to TypoScript (left side panel).
For both the page and the folder you have created, select Constant Editor. Use default values and select Create a root script.

# Language Configuration

There may be a problem with the language settings on the site configuration. To fix that, do the following:

Navigate to Sites (left side panel).
Check for existing site configurations of your created root page.
To simplify troubleshooting, we suggest to now delete the site configuration of the root page and create a new one. For this, do the following:
Choose Add new site configuration for this site for your root page.
Tab General: Enter a Site Identifier, e.g. the value "1".
Tab General: Enter your main URL to field Entry Point, e.g. http://example.typo3.net.
Tab Languages: Set up a language configuration:
- Enter a Title, e.g. "English"
- Enter a Locale, e.g. "en_US" or "de_DE"

Save the site configuration and retry to visit http://example.typo3.net/rest/ (opens new window). You should now see the expected response like {"message":"What's up?"} for language en_US.

# Configuration Guide for Typo3 v8, v9, v10