Tutorial for IP Login
There is a Free and a Pro version of IP Login.
The parts in this tutorial that only concern the Pro version will be marked with: PRO
Introduction
IP Login is a Joomla! system plugin that allows you to log into your Joomla site automatically by IP address.
It can work for both the frontend and administrator areas of the site, based on your preference.
How to use it
You can simply set up your IP address and a secret URL key in your user profile in the administrator.
After installing IP Login, you will have the following settings in every user profile. So to set up IP Login for your user, go to the User Manager and click on your user account.
Enter your desired IP address, and any secret key you would like to use. For example:
With the above example, you will be able to automatically log in on IP address 123.456.789.123
with URL key mxx8hrv4
.
The URL key needs to be put in the URL as a 'query' variable, like:
http://www.yourdomain.com?mxx8hrv4
If the URL already contains a ?
, you can prepend the key with an &
, like:
http://www.yourdomain.com/administrator/index.php?option=com_content&mxx8hrv4
.
Multiple Setup PRO
With the Pro version of IP Login, you can set up the automatic login for up to 5 combinations of IP addresses/ranges per user, all with their own unique settings and URL keys.
IP Lists PRO
The pro version of IP Login gives you the ability to use multiple IP addresses per key.
You can enter a list of IP addresses by simply separating them with a comma.
So if you want to use the key for IP addresses 110.120.130.1
and 110.120.130.10
you simply enter:
110.120.130.1,110.120.130.10
IP Ranges PRO
The pro version of IP Login also gives you the ability to use IP ranges.
You can set ranges using the * wildcard to match any IP that starts with the given characters.
Or you can use a "dash" (-) for from - to ranges. In this case, the matched IP range depends on how many IP parts you give for the ending IP.
Here are some examples to show you how these work:
IPv4 Ranges
IP Range | IP addresses matching range |
---|---|
110.120.130.* |
110.120.130.0 to 110.120.130.255 |
110.120.* |
110.120.0.0 to 110.120.255.255 |
110.120.130.50-110.120.130.100 |
110.120.130.50 to 110.120.130.100 |
110.120.130.50-100 |
110.120.130.50 to 110.120.130.100 |
110.120.50.0-100.255 |
110.120.50.0 to 110.120.100.255 |
IPv6 Ranges
IP Range | IP addresses matching range |
---|---|
1111:2222:3333:4444:5555:6666:7777:* |
1111:2222:3333:4444:5555:6666:7777:0000 to 1111:2222:3333:4444:5555:6666:7777:ffff |
1111:2222:3333:4444:5555:6666:7777:1000-1111:2222:3333:4444:5555:6666:7777:a0000 |
1111:2222:3333:4444:5555:6666:7777:1000 to 1111:2222:3333:4444:5555:6666:7777:a000 |
1111:2222:3333:4444:5555:6666:7777:8888-dddd.eeee.ffff |
1111:2222:3333:4444:5555:6666:7777:8888 to 1111:2222:3333:4444:5555:dddd.eeee.ffff |
Security warning
Be aware that there is a small security risk.
Though the risk is low, as a hacker would have to find out your IP address (and spoof it), know that you have set it up as an auto-login IP address, and somehow find out your secret URL key.
So security breaches are unlikely.
Settings
IP Login comes with options, giving you control over how the plugin behaves. Here is the full list of options you can find in the User Manager and in the Plugin system settings:
User: IP Login
Enable In | Select whether to enable in the frontend or administrator side or both. Options: None, Both, Admin, Frontend |
IP Address | Enter the IP address you want to auto login on. |
IP Address / Range | Enter the IP address or range you want to auto login on. |
Secret URL Key | The secret URL key you need to place in the URL, like: http://www.yourdomain.com/administrator?123abc |
Note | Enter an optional note. |
The Pro version of IP Login will give you the ability to set up to 5 IP addresses/ranges per user. PRO
Plugin: Behaviour
Remove URL Key | Select to remove the secret URL key from the URL on pageload. Options: No, Yes, Admin, Frontend |
Installation
You can either install IP Login by using the core extension manager available in the Joomla! Administrator Control Panel, or by using the powerful Regular Labs Extension Manager.
Note: When updating IP Login, you do not need to uninstall it first. The package will update all the files automatically.
Keep in mind that when you update to a major new version (or uninstall first), you might lose some configuration settings.
Regular Labs Extension Manager
It is very easy to install/update any Regular Labs Extension using the Regular Labs Extension Manager.
Please see the Tutorial for the Regular Labs Extension Manager for more detailed information...
Joomla! Extension Manager
To install via the Joomla! Extension Manager, just follow these steps:
- Log into your Joomla administrator;
- In the menu, choose: Extensions >> Extensions;
- Choose the tab: Install from Web (or enable it if you haven't done so yet);
- Select the search field and enter
IP Login
and hit enter; - Click on the IP Login listing;
- Click on Install;
- Click on Install to confirm.
Or if you need to install the Pro version or cannot install via the 'Install via Web' method for some reason:
- Download the extension install file (.zip);
- Log into your Joomla administrator;
- In the menu, choose: Extensions >> Extensions;
- Choose the tab: Upload Package File;
- Click on the Choose File button and select the extension zip;
- Click on Upload & Install.
If you have problems installing IP Login, please try the manual installation process as described here: docs.joomla.org/Installing_an_extension