UniLogin

Introduction

Unilogin is a Joomla plugin allows users to log in to your Joomla site using either their email address or username, a feature not available in Joomla by default. This documentation covers the installation, configuration, and usage of the Unilogin plugin.

Download

Downloading the Extension

Email: After you purchase the extension from our store, you will receive an email containing a link to download the extension.

Store: Alternatively, you can download the extension from the "Downloads" section in our store. If you are a new user, you need to create an account using the same email address you used for the purchase.

Click to download the extension package: Unilogin_UNZIP.zip

Unzipping the Package

Use any file unzipper tool or WinRAR to unzip the Unilogin_UNZIP.zip package. After unzipping, you will find the following contents:

• plg_unilogin.zip: This is the installation file compatible with Joomla 4.x and Joomla 5.x.
• ReadMe.txt: Contains vital information about the current version of the extension.

Installing the Extension

To install the extension, log in to the backend of your Joomla website.

• For Joomla 4 & 5: Navigate to Extensions > Install, then click on the "Upload Package File" tab. Click "Browse" to select the installation file (plg_unilogin.zip), then click "Upload and Install."

A success message will be displayed once the installation is complete.

Configuration

After installation, the plugin needs to be enabled to suit your requirements. Access the plugin settings by navigating to Extensions > Plugins, and find Authentication - Unilogin in the list. Enable the plugin, and it will start working automatically, allowing users to log in using either their email address or username.

There are no additional configuration options required for this plugin. Simply enabling it integrates it seamlessly with your Joomla authentication system.

Language Override

To change the text "Username" to "Email or Username" using a language override in Joomla, follow these steps:

Changing the Text for the Login Form

1. Access Language Overrides:

   • Log in to the backend of your Joomla website.
   • Navigate to Extensions > Language(s) > Overrides.

2. Select Language and Create New Override:

   • Select the language you want to create the override for (e.g., English (en-GB)).
   • Click the New button to create a new language override.

3. Search for the Constant:

   • In the search field, type COM_USERS_LOGIN_USERNAME_LABEL.
   • Click the Search button to find the constant used for the "Username" field label.

4. Create the Override:

   • Once the constant COM_USERS_LOGIN_USERNAME_LABEL appears in the search results, click on it.
   • In the Text field, enter Email or Username (or your preferred text).
   • Click the Save & Close button.

This will override the default "Username" label with "Email or Username" on your login form and any other relevant places where this label is used.

Changing the Text for the Login Module

1. Access Language Overrides:

   • Log in to the backend of your Joomla website.
   • Navigate to Extensions > Language(s) > Overrides.

2. Select Language and Create New Override:

   • Select the language you want to create the override for (e.g., English (en-GB)).
   • Click the New button to create a new language override.

3. Search for the Constant:

   • In the search field, type MOD_LOGIN_VALUE_USERNAME.
   • Click the Search button to find the constant used for the "Username" field label in the login module.

4. Create the Override:

   • Once the constant MOD_LOGIN_VALUE_USERNAME appears in the search results, click on it.
   • In the Text field, enter Email or Username (or your preferred text).
   • Click the Save & Close button.

This will override the default "Username" label with "Email or Username" in the login module.

By following these steps, you can customize the login form and login module to better inform users that they can log in using either their email address or username.

FAQ

• How do I change the text "Username" to "Email or Username" for the login form?

  • To change the text "Username" to "Email or Username" in the login form, you can create a language override for the constant COM_USERS_LOGIN_USERNAME_LABEL. Navigate to Extensions > Language(s) > Overrides, select your language, create a new override, search for COM_USERS_LOGIN_USERNAME_LABEL, and set the override text to Email or Username.

• How do I change the text "Username" to "Email or Username" for the login module?

  • To change the text "Username" to "Email or Username" in the login module, create a language override for the constant MOD_LOGIN_VALUE_USERNAME. Navigate to Extensions > Language(s) > Overrides, select your language, create a new override, search for MOD_LOGIN_VALUE_USERNAME, and set the override text to Email or Username.

• If I want to allow users to register using only their email and not a username, will this plugin work?

  • No, the Unilogin plugin does not support registration using only an email without a username. For this functionality, you can use another plugin developed by us called Registration Simplifier, which will fulfill your requirements.

• Why is it useful to allow login using both email and username?

  • Allowing login using both email and username is useful because many users often forget their usernames but remember their email addresses. This feature makes the login process more user-friendly and reduces the chances of login issues. It is the ultimate solution and has been implemented on major sites like Amazon, Google, Facebook, and X.

Troubleshooting

• Login Not Working: Ensure the plugin is enabled by navigating to Extensions > Plugins and checking that Authentication - Unilogin is active.

• Text Not Changing to "Email or Username": Verify that you have correctly set up the language overrides for both COM_USERS_LOGIN_USERNAME_LABEL (for the login form) and MOD_LOGIN_VALUE_USERNAME (for the login module). Ensure the overrides are saved and applied to the correct language.

• Users Unable to Login with Email: Confirm that users are entering the correct email address associated with their account. If issues persist, check that the email validation is correctly configured in the plugin settings.