heimrichhannot/contao-email2username-bundle

A Contao bundle that automatically sets the username based on the user email address.

2.0.0 2026-04-14 12:29 UTC

Requires

• php: ^8.2
• contao/core-bundle: ^5.3
• symfony/config: ^6.4 || ^7.0
• symfony/dependency-injection: ^6.4 || ^7.0
• symfony/http-foundation: ^6.4 || ^7.0
• symfony/http-kernel: ^6.4 || ^7.0
• symfony/security-core: ^6.4 || ^7.0

Requires (Dev)

• contao/contao-rector: dev-main
• contao/manager-plugin: ^2.13
• phpstan/phpstan: ^2.1
• phpstan/phpstan-symfony: ^2.0
• rector/rector: ^2.3
• symplify/easy-coding-standard: ^13.0

Replaces

• heimrichhannot/contao-email2username: *

LGPL-3.0-or-later

• Heimrich & Hannot

• contao

README

A Contao extension that allows using the e-mail address as username for members and users.

Features

• login with username or e-mail address
• set username to e-mail address on registration, member/user creation or member/user update (can be disabled)
• can be deactivated for user and/or member (see Configuration chapter)

Install & Setup

1. Install from composer or Contao Manager

    composer require heimrichhannot/contao-email2username-bundle
   

2. Customize config to your needs (e.g. enable only for backend user), see Configuration.

Configuration

# Default configuration for extension with alias: "huh_email2username"
huh_email2username:
   member:

      # Enable support for frontend member.
      enable:               true

      # Allow override existing usernames.
      override:             true
   user:

      # Enable support for backend user.
      enable:               true

      # Allow override existing usernames.
      override:             true