How QCFUM Handles Optional Usernames During Direct Creation

The Username field in QCFUM Direct Create is optional. When it is blank, QCFUM derives a Joomla username from the email address before the normal Joomla user is saved.

QCFUM also normalizes a username entered by staff. Because the 2.0.4 normalizer permits the lowercase character set a-z, digits, underscore, period, and hyphen, enter custom usernames in lowercase to avoid surprising character removal.

When Username Is Blank

QCFUM first lowercases the submitted email address. If Username is empty, it takes the portion of that email before the @ and uses it as the starting username. It then removes characters outside the allowed lowercase letters, digits, underscore, period, and hyphen.

If nothing usable remains after normalization, QCFUM falls back to a generated value beginning with user plus the current timestamp.

When Username Is Entered

The same allowed-character normalization is applied to a supplied username. In QCFUM 2.0.4, uppercase characters are outside the normalizer’s allowed character class before the final lowercase conversion, so administrators should train staff to enter custom usernames in lowercase.

Example: a blank Username with This email address is being protected from spambots. You need JavaScript enabled to view it. derives alex.morgan. A custom username should already use the supported lowercase pattern, such as alex.morgan-2.

Duplicate Checks Still Apply

Before creation, QCFUM checks Joomla Users for the normalized username and the submitted email. If either already belongs to an existing Joomla user, Direct Create stops with the message that a Joomla user with that email or username already exists.

The duplicate check happens after username normalization, so troubleshoot the normalized value rather than only the raw text typed into the form.

Practical Recommendation

  • Leave Username blank when the email local-part is an acceptable login name.
  • If a custom username is required, enter it in lowercase using letters, numbers, underscore, period, or hyphen.
  • If creation reports a duplicate, check both the email and the normalized username in Joomla Users.
  • Do not use the Username field to communicate or expose temporary passwords; password handling is separate.

Community Discussion

Want to compare Joomla user-onboarding workflows, share practical QCFUM tips, or discuss how other administrators use this feature? Visit the QC Frontend User Manager Community. For private support, bug reports, account-specific entitlement problems, or feature requests, use the QuantaCade support system.