User Tools

Site Tools



With version 4 of the CSF AutoUnblocker module, installation is easier than ever. You no longer have to edit templates edits. We have made it easy to install and configure the module.

Key new features

  • Six compatiable
  • No template installation
  • Remote hash update
  • Remote script update
  • Frontend full language supported
  • CSF Cluster mode support
  • Differential & Passive Unblocking Mode


Make sure the remote servers have ioncube 10 loader enabled. If you are running ioncube loader earlier than ioncube 10 then you can either run easyapache to rebuild the ioncube extension automatically or manually update the ioncube loader files.

Installation Instructions

Installation Overview

  1. The Module must be configured and enabled in your WHMCS.
  2. The Provisioning Module of the hosting service needing to use this module must have the module enabled in the Enable for Modules under the Admin Configuration page
  3. The Remote server must be setup with the remote server script Remote Server Installation (root required for installation, not required for running of the remote script). The remote server script must be reachable via http or https
  4. To test the remote server is working correctly, click on the Connection Test under the first column on the Server Listing table.

Remote Server Installation Tutorial Video

WHMCS Installation

There isn't any template modification needed for the module, simply upload the files in the whmcsUpload folder into your working WHMCS directory.

If you are using the csfunblocktech module, make sure you upload the main module first. Activate and configure it and the upload the csfunblocktech module once the main module has been configured. Otherwise, the system will crash.

WHMCS Configuration

Enable the module by going to Setup → Addon Modules. Once activated you will need to fill in the License key as well as configure other module settings under the Setup → Addons Module page.

Here are some configurable options for this module

Option Explaination
License Key Your license key
Mod Status Enable/disable the Module, will not display the unblock button in the product details page
Cluster Mode Enabling this will make the module to only connect to the main server of the cluster
Cluster Server When Cluster mode is enabled, make sure you select the main server for the cluster here. Otherwise the module will not be sending the Cluster command
Display Reason Display the blocked reasoning
Enable API Enable the usage of the API
Unblock Mode (4.56)Differential Mode will compare the whole list to the CSF directory and restart if changes are detected. Passive Mode will add/remove IP on a per individual basis. When Passive Mode is enabled, List Saving mode is disabled and you will not be able to remove DO NO DELETE blocks
Disable Do Not Delete option (Passive)When enabled, the Do Not Delete option will be disabled when Passive mode is enabled
Central Portal (4.6)This mode will allow the client to check for all hosting packages blocking status in one page
Side Bar DisplayShow the search function in the side bar
Main Content DisplayDisplay the unblock function in the main container
Add Central Portal to Service MenuShow the Central Portal under the Service menu
Max Unblock Attempt Maximum unblock a client can have per hour
Always Test Connection Enabling this will always run server connection test (Admin) during reload, otherwise only during first load for the session
Techoptions*Enable/Disable tech module functions
Disable Do Not Delete option for TechWhen enabled, the Do Not Delete option will be disabled for Tech Module
Enable Hosting Enable the display of the unblock module for regular hosting clients
Enable Reseller Enable the display of the unblock module for reseller hosting clients
Enable Server Enable the display of the unblock module for products under Server product type
Enable Other Enable the display of the unblock module for products under Other product type
Regular Reseller Enable reseller search feature for regular hosting clients

Module Configuration (Server Parameters)

Once you have activated the module you can now goto Addons → WHMCS CSF Unblocker to access the module.

There are few things you need to consider when adding the server onto the listing of servers under this module.

Parameters Explaination
IP Address This MUST match the IP of the hosting package (WHMCS → Product → Servers) it is using.
Server Name This will be the display name during the unblocking steps
Hash This must match the $hash in the remote server settings file (CSFSettings.php)
Web Address This must be a web accessible address that CSFUnblockremote.php can be reached via HTTP or HTTPS on the remote server without trailing /. For example,
X List The remote server's Deny list
Temp X List The remote server's temp deny list
White List The remote server's whitelist
Generate Hash on Server This will update the hash on the remote server automatically
Update RemoteThis will update the module package on the remote server
Mass Hash Update This will update all the hash recorded on WHMCS, note it will NOT update the $hash in the remote CSFSettings.php file

Show on Module

In order for the Unblocker module to show up in the WHMCS client area, you must enable it for at least one WHMCS Provisioning Module. To do this, goto the CSF Unblocker Admin → Show on Module

Once there, you can set which WHMCS provisioning module will have access to the CSF Unblocker

For example, if your shared hosting plans run on DirectAdmin then enable it for DirectAdmin.

Language Files

If you already have a language override file for you language, simply open the english.php file then copy and paste the content into your current override files. Otherwise just upload the current one to the modules/addons/csfunblock/lang/ directory.

You will need to make a copy of english.php to your language you are using for WHMCS if you are not using English.

Template Files

The template files are in the modules/addons/csfunblock/templates directory if you need to make any cosmetic changes.

WHMCS Client Frontend

The client end module will be shown on the Service page of the particular service. Make sure you have enabled the server provisioning module in the Admin module (Addons → WHMCS CSF Unblocker → Enable for Modules) to have it showing in the front end.

Firewall Portal (v4.6)

This can be activated by enabled Central Portal, Add Central Portal to Service Menu options in the WHMCS → Addons Configuration menu. If your theme is six compatible, then a link will automatically added to the Service menu.

You can also add a link manually to the following URL.


Remote Server Connection Test

You can run the connection test by going to the Admin Module and click on the first column's icon in the Server Listing.

Your WHMCS end should now be setup, proceed to the remote server installs. Remote Server Install (Non-WHMCS server)

whmcs-csf_unblocker_v4_installation.txt · Last modified: 2020/05/28 02:38 by wiki