Installation & Configuration
Installing the Plugin
Installing “Proxy & VPN Blocker” can be done either by searching for “Proxy & VPN Blocker” via the “Plugins > Add New” screen in your WordPress dashboard, or by using the following steps:
- Download the plugin via WordPress.org
- Upload the ZIP file through the ‘Plugins > Add New > Upload’ screen in your WordPress dashboard
- Activate the plugin through the ‘Plugins’ menu in WordPress
- Follow the configuration guide below, you aren't quite finished yet!
Configuration of Proxy & VPN Blocker is simple with the following information.
proxycheck.io API key
After installing the Plugin to your WordPress please go to PVB > Proxy & VPN Blocker in your WordPress Dashboard and you will see that there are multiple settings that you can configure, one of which is the API Key field.
It is not necessary to have an API key to use this Plugin's basic features but note that it would be limited to 100 daily queries with proxycheck.io.
A free API Key gives you 1,000 daily queries and is simple to get just by entering your email address to sign up with proxycheck.io.
There are also paid plans available!
If you have an API Key, enter it in the API Key field of Proxy & VPN Blocker.
If you are using Cloudflare please turn this setting to 'on' so your visitors IP Addresses are able to be forwarded to proxycheck.io for checking. If you are not using Cloudflare or are not sure, leave this setting 'off'.
By default an IP is checked for proxy/vpn activity within the last 7 days but you can configure this to be as strict as you like between 1 and 60 days.
By default only Proxies are checked for, if you would like to also block VPN's turn this setting to 'on'.
Transport Layer Encryption is recommended to be 'on' however this has the potential to slightly slow down query time.
If you enter a custom tag in this field this will show next to IP's in your Positive Detection Log rather than the URL of the querying site/page
This feature is ideal if you would like to block ALL visitors from specific countries.
Custom Blocked Page
By default the Plugin will show a default 'blocked' page to visitors who are blocked, however you can specify a page to use within your sites field for further customisability.
Note: Selecting a page here WILL turn off 'Block On All Pages' option. You also may not select a page here that already exists in your "Restrict on Specific Pages" List.
Access Denied Message
This is the message that is shown on the default "blocked" page shown to visitors who are blocked. You can change this to say anything you like (i.e. another language than English).
Restrict on Specific Pages
Here you can define a list of pages on your site that you would also like to block Proxies and (optionally) VPN's on. This is useful if you use WordPress for a web shop and would like to use this plugin on shopping cart/checkout pages.
Note: Selecting a page here WILL turn off 'Block On All Pages' option. This also may not work if you are using a page caching plugin
Block on All Pages?
This feature is not recommended to be used however it was added on request. This WILL result in much higher query usage to the proxycheck API.
This will block people using Proxies and (optionally) VPN's on all pages of your site!
Note: This will not work if you are using a page caching plugin.
Note: This will also not work if you use a plugin that caches pages!