Bad Word Detection in Username?

[bvillers-jr]

I need to implement bad word filtering in oqtane usernames. I've initially settled on BogaNet.BadWordFilter since it includes built-in support for 25 languages out of the box, is available on Nuget and has a permissive license.

How would I go about implementing something like this where I need to inspect the username entered and possibly reject it without needing to maintain changes to Oqtane itself? Replace user registration with my own module?

[leigh-pointer]

@bvillers-jr
Rule of thumb in Oqtane: never modify the framework.

If you need to change behavior like username validation, the recommended approach is:

• Create your own module (or authentication-related module if applicable).
• Copy the relevant component(s) from Oqtane (for example, the registration UI/logic).
• Apply your changes there (e.g. run BogaNet.BadWordFilter against the username and reject invalid input).
• Build and package it as a normal Oqtane module.
• Install the package as Host.
• Place your module where registration is handled and remove/replace the original one.

This keeps:

• Upgrades safe (no merge conflicts)
• Your logic isolated
• Full control over validation rules and UX

Trying to “hook into” core registration without extension points isn’t currently how Oqtane is designed, so replacement via a custom module is the clean and supported path.

If this becomes a common requirement, it might be worth proposing an extensibility hook (e.g. username validation pipeline) upstream—but today, a module replacement is the correct solution.