Troubleshooting
Email login does nothing / fails
- Confirm Authentication - UniLogin is enabled and ordered before Authentication - Joomla. Confirm the email matches an unblocked user. Check domain and group restrictions.
Username login fails when Fallback is off
- Expected for UniLogin — turn Username Fallback on, or rely on Authentication - Joomla for username-only login.
Label still says Username
- Save the plugin params. Custom label applies to the
com_users.loginform. Hard-refresh or clear cache. For some module layouts, use a language override as well.
- Save the plugin params. Custom label applies to the
Account locked
- Wait for lockout duration, or delete matching rows from
#__unilogin_attempts. Raise Max Attempts / Lockout Duration if legitimate users hit the limit.
- Wait for lockout duration, or delete matching rows from
Redirect ignored
- Enable Custom Redirect and set a valid internal URL (
/path,index.php?…, or same-site absolute URL). External absolute URLs and//…URLs are rejected.
- Enable Custom Redirect and set a valid internal URL (
Attempts table missing
- Reinstall/upgrade the plugin so
script.phpruns, or create the table from the installer SQL.
- Reinstall/upgrade the plugin so
Failed login lands on a 404
- Usually a site menu/SEF issue (no dedicated Users login menu item), not UniLogin. Create a published Login menu item or fix the Users component menu. Auth and logging still work.