README

Impersonate frontend users from inside the TYPO3 Backend.

Features

The Impersonate extension gives backend users with administrator privileges the possibility to authenticate as any specific frontend user in the frontend with just a single click from inside the backend. This does not include default backend users.

And remember: With great power comes great responsibility. The purpose of this extension is mainly to allow for a tech support login as a specific user and see potential problems and bugs from the perspective of the user as well as doing tech support actions while impersonating the specified user account.

Setup

1. Installation

Installation with Composer

The recommended way to install the extension is using composer.

Run the following command within your Composer based TYPO3 project:

composer require portrino/impersonate.

Installation with TER

Open the TYPO3 Extension Manager, search for impersonate and install the extension.

2. Configuration (optional)

• Go to the Site Management/Sites module in the backend and include the Impersonate site set as dependency to your site configuration.

• Afterward open the Site Management/Settings module and set the id of the target page to redirect an admin to when impersonating a frontend user via the backend:

  • tx_impersonate.loginRedirectPid
    • If not set, the user will be redirected to the root page of the site.
    • Important: Impersonation needs an active backend user session for the target page hostname!
      • The target page has to have the same hostname as the backend, otherwise the impersonation will fail due to backend user session checks. This is especially important if you have multiple sites with different hostnames in your TYPO3 instance.

• By default, only backend admin users are allowed to impersonate frontend users. You can change this behavior by setting the following user TSconfig value for the respective backend user or backend user group:

  • tx_impersonate.enable = 1 (set to 0 to disable again)

3. Usage

• Go to the list module as a backend user (with administrator privileges), open a page / sysfolder with frontend user records and click the "Impersonate user" button.
• Congratulations! You are now logged in as the chosen frontend user.

Compatibility

Please note that the namespace has changed to "portrino" since version 5. If you extended impersonate with your own code, please use the new namespace also.

Authors

• See the list of contributors who participated in this project.