Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
  • Loading branch information
radwebhosting committed Sep 25, 2024
2 parents 4f68cc9 + fad244c commit b9b6480
Show file tree
Hide file tree
Showing 4 changed files with 67 additions and 14 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/jekyll-gh-pages.yml
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,7 @@ jobs:
source: ./
destination: ./_site
- name: Upload artifact
uses: actions/upload-pages-artifact@v2
uses: actions/upload-artifact@v3

# Deployment job
deploy:
Expand Down
22 changes: 11 additions & 11 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ WHMCS server module for provisioning and management of VPS servers from reseller
<p align="center"><a href="https://radwebhosting.com" target="_blank"><img width="350" src="https://avatars0.githubusercontent.com/u/16030710?s=460&v=4" alt="Rad Web Hosting"></a></p>

## About
* This is a Server Provisioning module for WHMCS to integrate API functionality for VPS resellers, allowing them to remotely manage Rad Web Hosting VPS Servers in remote WHMCS installation. This module also installs Client Area domain management functions for use by end-clients.
* This is a Server Provisioning module for WHMCS to integrate API functionality for VPS resellers, allowing them to remotely manage Rad Web Hosting VPS Servers in remote WHMCS installation.
* Simplifies the automation of provisioning, selling, and managing VPS Servers, and provides for complete remote control of all VPS functions.

## Prerequisites
Expand All @@ -17,7 +17,7 @@ Users can gain access to API key by signing up for a VPS Reseller account
## Installation
1. Download the module
2. Upload to WHMCS Server Modules directory (i.e. /home/user/whmcs/modules/servers ) and extract the files
3. In WHMCS Admin area, navigate to Setup -> Products/Services -> Servers and create the `virtualizor_cloud` server
3. In WHMCS Admin area, navigate to Setup -> Products/Services -> Servers and create the `rad_cloud` server
4. Enter your API username and API secret. These can be obtained via your VPS Reseller Welcome Email.

Getting Started with VPS Reseller with WHMCS
Expand All @@ -34,7 +34,7 @@ Please follow the below guidelines to configure your VPS Reseller with WHMCS int
### Install WHMCS VPS Module

1. Download and extract the WHMCS integration \[[HERE](https://marketplace.whmcs.com/product/6108-vps-reseller "Download WHMCS Module")\].
2. Copy the entire directory via FTP, SFTP, SCP, etc. to /<WHMCS\_PATH>/modules/servers/virtualizor\_cloud/
2. Copy the entire directory via FTP, SFTP, SCP, etc. to /<WHMCS\_PATH>/modules/servers/rad\_cloud/

### Get API Credentials

Expand All @@ -55,7 +55,7 @@ Please follow the below guidelines to configure your VPS Reseller with WHMCS int
3. IP Address: This will be provided by the data center.
4. Nameservers are not required for this module
3. **Server Details**
1. Module: "Virtualizor\_cloud" .
1. Module: "Rad\_cloud" .
2. Username: API Key (created in previous step)
3. Password: API Password (created in previous step)
4. Access Hash: Leave empty
Expand All @@ -70,7 +70,7 @@ Please follow the below guidelines to configure your VPS Reseller with WHMCS int
2. Product Group: Any
3. Product Name: Any
3. Go to "Module Settings" tab and enter the following details:
1. Module: **Virtualizor\_cloud**
1. Module: **Rad\_cloud**
2. The remaining fields as described on that page ![Configure Product Module Settings](https://new.radwebhosting.com/client_area/images/knowledgebase/vps-reseller-whmcs-configure-module-settings.png)
4. Go to "Custom Fields" and create new Custom Field with the following details:
1. Field Name: "vpsid" (without quotes)
Expand All @@ -79,11 +79,11 @@ Please follow the below guidelines to configure your VPS Reseller with WHMCS int
4. Validation: Leave blank
5. Check **Admin Only** tick box.
5. Create "Custom Fields" entry to satisfy **VPS operating system** requirements:
1. Field Name: **"OS"** (without quotes) or **"OS|Operating System"**
1. Field Name: **OS** or **OS|Operating System**
2. Field Type: **Dropdown**
3. Description: **Choose OS to install on server**
4. Validation: Leave blank
5. Select Options field: enter OS template file names (without .img extensions) like "centos-7.1-x86_64". Retrieve possible values from: [VPS Guides -> List of Available OS Templates](https://radwebhosting.com/client_area/knowledgebase/246/List-of-Available-OS-Templates.html).
5. Select Options field: enter OS template file names (without .img extensions) like **debian-12-x86_64**. Retrieve possible values from: [VPS Guides -> List of Available OS Templates](https://radwebhosting.com/client_area/knowledgebase/246/List-of-Available-OS-Templates.html).

![Product Custom Fields](https://new.radwebhosting.com/client_area/images/knowledgebase/vps-reseller-configure-product-custom-fields.png)

Expand All @@ -104,7 +104,7 @@ We are glad to inform you that the virtual machine you ordered has been set up.
Manager Details
=============================
URL: https://your.master.domain.com:4083
URL: https://<custom_cloud_panel_domain>:4083
Username: {$service_username}
Password: {$service_password}
Expand All @@ -127,7 +127,7 @@ http://www.chiark.greenend.org.uk/~sgtatham/putty/download.html
### Configuration Tips to Simplify Administration

* Instead of creating each VPS product with Custom Field: "OS|Operating System" and drop-down list of all available templates, we recommend creating a "Configurable Options" group with the "Operating System" configurable option.
* Instead of creating each VPS product with Custom Field: "OS|Operating System" and drop-down list of all available templates, we recommend creating a "Configurable Options" group with the **Operating System** configurable option.
* Please also refer to [this article](https://docs.whmcs.com/Addons_and_Configurable_Options#Configurable_Options) to find more information about using configurable options in WHMCS.
* Configurable Options group can be assigned to all VPS products (of the same Virtualization)-this will be much more desirable from an administrative perspective, should the available OS templates options ever change.
* In the event of new OS template available for VPS, you can simply modify this single Configurable Option (assuming the group is assigned to multiple VPS products for same Virtualization), as opposed to editing the custom fields drop-down values for every related VPS product individually.
Expand All @@ -148,10 +148,10 @@ Read our guide, [How to Integrate VPS Reseller with WHMCS](https://blog.radwebho
For full documentation, please visit the Rad Web Hosting VPS API documentation on the website.

## Help
If you have any questions or problems please submit a [Support Ticket](https://radwebhosting.com/client_area/submitticket.php).
If you have any questions or problems please submit a [Support Ticket](https://radwebhosting.com/client_area/knowledgebase/112/Open-Support-Ticket.html).

## Bugs
If you discover any bugs or issues with this module, please notify our staff via the [24/7 Helpdesk](https://radwebhosting.com/client_area/submitticket.php).
If you discover any bugs or issues with this module, please notify our staff via the [24/7 Helpdesk](https://radwebhosting.com/support).

## License
This project is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).
53 changes: 53 additions & 0 deletions whmcs/modules/addons/rwhserverimport/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,53 @@
This article provides a guide for how to enable and run the Rad Cloud Server Import WHMCS addon module.

### What is Rad Cloud Server Import Addon Module?

As of [v2.0.0](https://github.com/Rad-Web-Hosting/whmcs-vps-reseller/releases/tag/2.0.0), or later, of WHMCS VPS Reseller module, an addon module, 'Rad Cloud Server Import' is bundled with the 'Rad_cloud' server module. The 'Rad Cloud Server Import' addon enables possibility to import pre-configured Cloud VPS products with 'Rad_cloud' server integrations.

![Rad Cloud Server Import addon module](//new.radwebhosting.com/client_area/images/knowledgebase/new-rwh-server-import-addon.webp)

#### Features of Rad Cloud Server Import Addon:

* 1-click creation of ready-to-sell Cloud VPS products
* Setup imported products options (Product Group, Welcome Email Template, Import Level)
* Automatic configuration of all required 'Rad_cloud' server options
* From installation to VPS selling in under 3 minutes

Rad Cloud Server Import Addon Prerequisites

This guide assumes the following system and environment requirements are met:

* Rad Cloud API Account
* Rad_cloud server module installed & connected 
* Rad Cloud Server Import addon module installed

How to Enable Rad Cloud Server Import Addon Module for WHMCS

To enable Rad Cloud Server Import addon module for WHMCS, follow the steps:

1. Navigate to the Addon Modules settings interface (Access from '/whmcs/your_admin/configaddonmods.php', where "your_admin" is the WHMCS admin directory).
2. Click the "Activate" button corresponding with the "Rad Cloud Server Import" module:
![Activate Rad Cloud Server Import addon module](https://imgur.com/lZHPekv)
3. Click "Configure" to configure the module access group.
4. Choose "Full Administrator" and click "Save Changes" to enable the settings:
![Configure access for the ](https://imgur.com/fyhcQi3)
5. Navigate to 'Rad Cloud Server Import' from the Addons dropdown menu:
![Navigate to Rad Cloud Server Importer from addons menu](https://imgur.com/MWtQUID)
6. (STEP 1) From the Rad Cloud Server Import Manager, click "Continue" to initiate Rad Cloud Server Import process:
![initiate Rad Cloud Server Import addon module](https://imgur.com/q4KVZGi)
7. (STEP 2) Configure the Import Settings according to your preferences:
![Step 2: Configure import settings](https://imgur.com/655LoiL)
8. (STEP 2) Configure the Product Group imported products should be assigned to:
![configure product group for imported products](https://imgur.com/4dKr7in)
9. (STEP 2) Configure the Welcome Email template imported products should use:
![configure the Welcome Email template to assign to imported products](https://imgur.com/ssjGKdx)
10. (STEP 2) Select "Import Level" value ('Lite Import' recommended for new installs)
11. (STEP 2) Once all options set, click "Start Importing Process" button to initiate import
12. (STEP 3) Receive confirmation of successfully imported products and list of products:
![Step 3: Successful product creation confirmation](https://imgur.com/MTxDZtZ)
13. Navigate to Products/Services settings page in WHMCS Admin for overview:
![Overview of imported products from WHMCS admin Products/Services settings page](https://imgur.com/4X1BOV1)

### Conclusion

That's it. You have successfully enabled and run the Rad Cloud Server Import addon module.
4 changes: 2 additions & 2 deletions whmcs/modules/addons/rwhserverimport/whmcs.json
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
{
"schema": "1.0",
"type": "rwh-addons",
"name": "RWHServerImport",
"name": "rwhserverimport",
"version": "1.0.0",
"license": "proprietary",
"category": "other",
"category": "utilities",
"description": {
"name": "RWH Server Import",
"tagline": "The module will offer one time discount for any product you choose.",
Expand Down

0 comments on commit b9b6480

Please sign in to comment.