User Bundle

The User Bundle provides the user layer for Symfony applications built with Softspring packages.

It covers the common parts most projects need:

• a reusable User model base
• login and logout
• optional self-registration
• email confirmation
• reset password
• user settings pages
• admin user management
• optional invitations, access history, impersonation bar, and OAuth integration
• optional Google Identity Platform login

Start Here

Read the guides in this order when you are integrating the bundle for the first time:

1. Install
2. Login and security
3. Register and reset password
4. User settings pages
5. Admin area

Then add the optional guides you need:

• Invitations and access history
• OAuth login
• Google Identity Platform login
• Extend and customize

Common Project Shapes

This bundle fits several common application shapes.

Admin-Only Backoffice

Use login, reset password, admin routes, and CLI commands.

Keep public registration disabled and create users manually or from the admin area.

Public Self-Service Application

Enable login, register, email confirmation, reset password, and settings pages.

This is the typical setup for SaaS products, client portals, and user-facing web applications.

Invitation-Only Platform

Disable public registration.

Enable invitations and let admins create access from the backoffice or from CLI commands.

Multi-Bundle Application

The bundle integrates well with account-bundle, permissions-bundle, and admin-oriented bundles such as cms-bundle and media-bundle.

This is the usual pattern in Armonic-based applications.

What To Read Next

• Install explains the base entity, bundle configuration, routes, security, and first admin user.
• Login and security explains provider, firewall, throttling, remember me, target path, switch user, and impersonation bar.
• Register and reset password explains self-registration, confirmation emails, and password recovery.
• Mailer explains the optional email integration for confirmation, invitation, and reset password messages.
• User settings pages explains preferences, change email, change username, change password, and resend confirmation email.
• Admin area explains routes, permissions, menu integration, and the user and administrator screens.
• Invitations and access history explains the extra entities and routes required for invitation-only or audited systems.
• OAuth login explains the current Facebook integration path.
• Google Identity Platform login explains how to enable Google Sign-In through Google Identity Platform.
• Extend and customize explains how to replace forms, override templates, and use lifecycle events.