Lunarhotel.co.uk

Before you begin:

If you've not received your plugin yet, check your spam folder, and please see this article

What you will need

• Access to install a plugin in your Joomla administration section
• File access to your Joomla installation (e.g. by FTP)
• Virtuemart installed and running, if you want to use the Virtuemart features
• You will also need:


A backup of your Joomla site. - This is an important point!! Getting the plugin working fully involves overwriting some language files, and potentially some template files. If you ask for support from me, the first question I will ask is whether you have a backup or not! Following these instructions shouldnt result in anything bad happening to your site, but its impossible to know the particulars of every Joomla site / ftp client / webspace out there. In addition, if you ever want to restore the Username functionality, you will need to restore the original files to thier proper location

Installation of the plugin is very simple. However the procedures involved will vary depending on your intended usage. The first 3 steps are the same:

1. Extract the zip package you received when you purchased the plugin
2. Install the plugin via the Joomla administration section
3. Publish it

If you have access to your mysql database via phpMyAdmin, then you can execute the following sql to allow users already registered to login using thier email address. Please do / keep in mind the following:

• Take a backup of your users table (normally called jos_users)
• All users (with the exception of the admin account) will ONLY be able to login with thier email addresses after running this sql (The username will be overwritten)

SQL code for converting email addresses to usernames:

update `jos_users` set username=email where name<>"Administrator";

Using Virtuemart login only (e.g. ecommerce sites)

Now, we simply edit the Virtuemart language file to suit are needs. The instructions detailed here are for English only. If your site uses another Language, you will need to edit the relavent files. All file locations should be the same however.

1. If you are using English on your site. Simply copy the administrator folder from the installation package to your <joomla root> folder (where joomla is installed) You can safely overwrite the administrator folder when asked.
2. If you are using another Language, then you only need to make the required changes to
   
   <joomla root>/administrator/components/com_virtuemart/languages/common/<your language>.ini
   
   
3. Uninstall the existing mod_virtuemart_login if you have installed it already
4. Install mod_virtuemart_login_1.1.3.Username Modded.zip from the source package. This is a modified version of the module that does not include a link to get a reminder of the username. It is not required to allow the use of email addresses as usernames. Its simply a cosmetic change. Please note that in some situations you may need to delete the folder /modules/mod_virtuemart_login but ONLY AFTER uninstalling the module using the admin back end.
5. Dont forget to publish the module in the relavent position.
6. Check the Virtuemart Login module, and the username field should be labelled "Email address" The "forgot username" link should be missing, and when you click on Register, there should only be 3 fields in the Customer information section. If however your registration looks like this:
   

Then follow these instructions:

1. Browse to www.yourdomain.com/index.php?option=com_virtuemart&page=shop.registration&forcevmhide=1. The second Email field should dissappear.

Using Joomla login / JomSocial

1. Install the plugin and publish it in the normal way.
2. If your site's Language is English. Copy the language folder into the root of your Joomla installation. You can safely overwrite the existing folder without risk of loosing any other files as a result. Currently included in the package is a GB-EN (GB English). Ill put other language files there as they become available.
3. Check to see if the following file exists in your Joomla installation. Where <joomla root> is the location where your Joomla files reside, and <your template> is the name of the template your site is using:
   
   /<joomla root>/templates/<your template>/html/com_user/register/default.php
   
   Also check for
   
   /<joomla root>/templates/<your template>/html/mod_login/default.php
   
   
4. If the paths do not exist copy the html folder into your template folder. So, for example. If the template Im using on my site is rhuk_milkyway then I copy the html folder into /templates/rhuk_milkyway/.
5. If either of the paths do exist then you will need to edit default.php in each folder manually in order to remove the username field from the html.
   To re-iterate, Take a backup of any and all files before you change them.You will need these backups if you ever wish to uninstall the plugin and reset everything to the way it was
6. Now take a look at your Joomla page. You will find that the Username field in the Login module is now labeled "Email" and the "Forgot you username" link will no longer be present. Click on Create an account (only available if you have user registrations turned on) and Check that the username field is missing from the registration screen.

Using EmailAsUsername with AjaxRegistration Pro

Follow the instructions for Using with Joomla / JomSocial Login Only