C) Configuration - top
All Login Ninja's options are configured in WP admin under Settings - Login Ninja.
Redirections by user roles
After login users that have a certain role can be redirected using one of five available rules. Custom user roles are fully supported.
- Default (normal) behaviour - same behaviour as if you don't have Login Ninja installed
- Disable login - prevents users from logging in. This option is not available for admin role.
- Redirect to a custom URL - redirect users to any specified URL. Variables can be used to make the URL dynamic; {username} - current user's username, {user_id} - current user's ID, {month} - current month with leading zeros, {day} - current day with leading zeros, {year} - current year (4 digits), {site_url} - full site URL.
- Redirect to a random post - you can choose a category or set it to "all categories"
- Redirect to the most recent post - you can choose a category or set it to "all categories"
Redirections by users
After login users can be redirected using one of five available rules. Please note that redirections defined on usernames are parsed before the ones on roles. Rules are the same as for roles, see above.
Banned IPs
IP can get banned in two ways; automatically by failing to login x times in y minutes (see options tab), or manually by entering the IP. IPs are entered in standard notation: abc.abc.abc.abc, wildcards (*, %) are not supported and leading zeroes have to be removed. Ie this is not good: 192.168.001.017, it should read 192.168.1.17. Bans can be manually deleted or they will be automatically removed once the ban time passes.
For automatically banned IPs ban time is set in options, while for manual ones you can set the time to your liking in the "Add new ban" dialog. Depending on the set option banned IPs will either be blocked from the entire site and a custom message (see options) will be displayed to them, or they'll be able to access the site but wont be able to login until ban is removed.
Log
Log displays all events on the site related to logins, logouts, failed logins and bans. You can search the records and sort them in ascending or descending order.
"Delete all log entries" will completely remove all log entries. Please note that there's no undo.
Settings - Ban rules
- Maximum number of failed login attempts before ban - defines the number of failed attempts user has to make in a set amount of time before his IP gets banned. Please note that opening the login form or just clicking the "Login" button does not count as a failed attempt. You have to enter a username and a password and click "Login".
- Default ban time - when an IP gets auto-banned this is the amount of the user wont be able to login/access the site. After the time passes ban is automatically removed.
- Banned users - are not able to login (but can view the site) or they can't access the whole site and the only thing they see is the ban message.
- Message for banned users - if option above is set to "can't access the whole site" this is the message banned users will see. HTML is fully supported.
- Login notice - message displayed above login form to inform users they might get banned. HTML is fully supported.
Settings - Email notifications
- Notification e-mail - admin's e-mail where the notifications will be send to.
- Send notification on failed login - admin will get an email for every failed login.
- Send notification on successful login - admin will get an email for every successful login.
- Send notification when new IP gets banned - admin will get an email every time someone gets banned. We recommend keeping this setting enabled.
Settings - Captcha settings
- Protect login and register forms with captcha - if enabled those two forms will be protected by an easy to read and solve captcha image
- Captcha background color - captcha image background color. Transparent is supported.
- Captcha question text - text displayed before captcha image on login and register forms
- Add noise to captcha image so it is more difficult to read - adds noise to the image making it more difficult to read for humans and bots.
Settings - Other settings
- Redirect URL on logout - on logout users will be redirected to the defined URL. You can make the URL dynamic by using the following variables: {month}, {day}, {year}, {site_url}.
D) FAQ - top
Will it work on my theme?
Yes! Login Ninja works with all themes.
Will it work with my plugins?
It will work with all non-security related plugins. Please contact us if you want to use it with other security plugins.
Will it work with my custom login form?
Yes if your form uses all actions and filters needed by Login Ninja. Otherwise it wont.
Will it work Security Ninja?
Absolutely!
Will this plugin slow my site down?
No.
I banned myself! What to do? Help!
There are several options to remove the ban:
- wait until the ban is lifted
- login on the site via another IP and delete the ban
- open your WP database, wp_options table and delete the row that has "option name" set to "wf_login_ninja_banned"
- open login-ninja.php and place the following code as the first line of init() function (around line #29): clear_banned();
Once again, thank you so much for purchasing this premium WordPress plugin. As stated at the beginning, we'd be glad to help you if you have any questions relating to this plugin. We'll do our best to assist. If you have a more general question related to plugins on CodeCanyon, you might consider visiting the forums and asking your question in the "Item Discussion" section.
