=== BAN Users ===
Contributors: webxmedia
Donate link: http://webxmedia.co.uk
Tags: users, ban, lock account, block account, deny access, security, account, disable, login, logon, suspend, temporary, user, disable user, wp-admin disable, wp-login disable
Requires at least: 4.2
Tested up to: 4.6
Stable tag: 1.2.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html

Ban a user from logging into their wordpress account.

== Description ==

<p>The BAN Users WordPress Plugin has been developed to enable administrators to quickly BAN (aka disable, suspend…) users from logging into their WordPress user account, as well as the option to change the status of all their posts. For instance setting them to draft to hide them from public viewing. A user can be BANed from the admin users table or via their profile. There are several configurable options that allow the administrator to control how the BAN will be implemented such as redirecting them to a custom holding page, or sending them a custom email notification. Once BANned they will be unable to login until an administrator reinstates their account.</p>

<h4>Plugin Features</h4>
<ul>
<li>Automatically change user’s Posts status (i.e. to pending) when BANned.</li>
<li>Force logout when user BANned.</li>
<li>Set custom logout URL when BANned.</li>
<li>Set message to display when a BANned user attempts to login.</li>
<li>If already logged in, display message to user when BANned.</li>
<li>Send custom email notification to user when banned/unbanned.</li>
<li>Capture unique reason for banning each user.</li>
<li>Set duration of BAN using date picker.</li>
<li>BANned users highlighted in users table with icon/coloured background row.</li>
<li>Users table shows reason user banned.</li>
<li>Users table shows date user banned.</li>
<li>Users table shows date user reinstated.</li>
</ul>

<h4>How is it Useful?</h4>
<ul>
<li>You want to ban malicious users from logging in.</li>
<li>You want to ban users who have breached terms of use or another policy.</li>
<li>You want to temporarily control access to admin.</li>
<li>You want to restrict a registered user from making any changes during development.</li>
<li>You have a client/user who has an unpaid invoice.</li>
<li>Ideal solution for moderators who monitor wordpress forums/posts.</li>
</ul>

<h4>Docs &amp; Support</h4>
<p>You can find further documentation, FAQs and more detailed information about our <a href="https://wordpress.org/plugins/ban-users/" rel="nofollow">Ban Users plugin</a> on <a href="https://webxmedia.ticksy.com" rel="nofollow">webxmedia.ticksy.com</a>. If you were unable to find the answer to your question on our FAQs or in any of the documentation, you should visit the support forum on <a href="https://wordpress.org/support/plugin/ban-users" rel="nofollow">WordPress.org</a>. If you can't locate any relevant topics, either post a new topic or <a href="https://webxmedia.ticksy.com/submit/" rel="nofollow">submit a support ticket</a>.</p>

== Installation ==

This section describes how to install the plugin and get it working.

1. Upload the plugin files to the /wp-content/plugins directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Go to Users->All Users to view the list of users.

4a. Click on a username to access their profile page, or hover over the user and select 'Edit'.
5a. Scroll down to the 'Account Management' Section of the profile page.
6a. Click on the checkbox which says 'Ban this User' beside it to either ban or unban the user.
7a. Scroll to the bottom of the page and select 'Update User' to confirm the changes made to the user.

4b. Hover over a user to display a list of possible modifications.
5b. Press the 'Ban' / 'Unban' button in order to change the users current state.

== Frequently Asked Questions ==

= Can all users be banned, regardless of role? =

Yes, anyone can be banned by an administrator. Administrators are not able to ban themselves however.

= Who can ban / unban another user? =

Only Administrators are allowed to ban / unban other users by default.

= How will I know if another user is banned? =

In the user edit page, the user will be marked in a checkbox in the row called 'Ban User'. If you also hover over the user on the 'All Users' page, the user will be the opposite of the stated 'ban' / 'unban' button.

= How can I get unbanned? =

You will need to contact a website administrator and asked to be unbanned. Each website may have their own policy for banning / unbanning users. If all administrators are banned, remove the plugin manually. Make sure an administrator is logged in on the website. Reinstall the plugin but with 'force_logout' set to false (0) and 'custom message' also set to false (0) in the settings file. The administrator can then unban people as usual. 

== Screenshots ==

1. screenshot-1.png
2. screenshot-2.png
3. screenshot-3.png
4. screenshot-4.png
5. screenshot-5.png
6. screenshot-6.png
7. screenshot-7.png
8. screenshot-8.png
9. screenshot-9.png
10. screenshot-10.png
11. screenshot-11.png
12. screenshot-12.png

== Changelog ==

= 1.2.2 =
* [Added] Set message to display when a BANned user attempts to login.
* [Added] Users table includes tooltip to show reason user banned.
* [Added] Users table includes tooltip to show date user banned.
* [Added] Users table includes tooltip to show date user reinstated.

= 1.2.1 =
* [Added] Toggle BANned column in users table on/off
* [Added] Toggle BANned highlighted red row in users table
* [Added] Minor security enhancements

= 1.2.0 =
* [Added] Set duration of BAN using date picker
* [Fixed] Move PHP functions into class structure
* [Added] Custom UnBAN email template for user notification
* [Fixed] Secured plugin files by preventing direct access

= 1.1.1 =
* [Fixed] Fatal error: Can't use function return value in write context

= 1.1.0 =
* [Added] BAN user email notification
* [Added] Custom BAN email template for user notification
* [Fixed] Corrected force logout bug
* [Added] Ability to capture reason for BANning user
* [Added] WordPress Uninstall configuration

= 1.0.1 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
Initial release.