diff --git a/documentation/blog/2024-5-30-openpanel-whmcs-module.md b/documentation/blog/2024-5-30-openpanel-whmcs-module.md index ebb7b10e..5d825d4c 100644 --- a/documentation/blog/2024-5-30-openpanel-whmcs-module.md +++ b/documentation/blog/2024-5-30-openpanel-whmcs-module.md @@ -12,4 +12,49 @@ OpenPanel WHMCS module allows users to integrate billing automations with their -More info soon. +WHMCS module is now available for OpenPanel. +Currently supported actions are: + +- ✅ create account +- ✅ change password +- ✅ suspend account +- ✅ unsuspend account +- ✅ terminate account +- ✅ autologin from frontend +- ✅ autologin from backend +- ❌ get disk usage for account +- ✅ change package + +To setup WHMCS to use your OpenPanel server follow these steps: + +1. **Enable API access on OpenPanel server** + First make sure that API access is enabled by going to `OpenAdmin > API` or by running `opencli config get api` from the terminal: + ![enable_api](https://i.postimg.cc/L6vwMQ4t/image.png) + If API is not enabled, click on the "Enable API access" button or from terminal run `opencli config update api on`. + + We recommend creating new Administrator user for API, to create a new user navigate to *OpenAdmin > OpenAdmin Settings* and create new admin user, or from terminal run: `opencli admin new USERNAME_HERE PASSWORD_HERE` + +2. **Install OpenPanel WHMC Module** + Login to SSH for WHMCS server + Navigate to `path_to_whmcs/modules/servers` + Run this command to create a new folder and in it download the module: `git clone https://github.com/stefanpejcic/openpanel-whmcs-module.git openpanel` + +3. **Establish connection between the two servers** + On OpenPanel server make sure that the OpenAdmin port 2087 is open on `OpenAdmin > Firewall` or whitelist the IP adress of your WHMCS server. + to whitelist ip address from terminal run: `ufw allow from WHMCS_IP_HERE` + + On WHMCS server also make sure that the 2087 port is opened or whitelist the IP address of your OpenPanel server. + From WHMS navigate to: *System Settings > Products & Services > Servers* + ![screenshot](https://i.postimg.cc/MHWpL3tc/image.png) + Click on *Create New Server* and under module select **OpenPanel** then add OpenPanel server IP, username and password for the OpenAdmin panel: + ![create_whmcs_group](https://i.postimg.cc/3Jh3nqWY/image.png) + +4. **Create hosting packages** + Hosting packages need to be created on both OpenPanel and WHMCS servers. + On OpenPanel server login to admin panel and on `OpenAdmin > Plans` create hosting packages that you will be assinging to users on WHMCS. + + On the WHMCS server create first a new group and then create new plans under this group. When creating products, make sure to select OpenPanel for Module and the newly created group + ![screenshot2](https://i.postimg.cc/NLvF4GSc/image.png) + +5. **Test creating new accounts** + Create an order and create a new order to test OpenPanel API.