OX WHMCS Module

About OX WHMCS Module

OX WHMCS Module has been developed to allow quick and easy management of the OX account directly from the WHMCS client area. Establish connection between your WHMCS and Open-Xchange to get access to email accounts, aliases forwarders and many more. Use the addon module to master the theme branding on your account directly in in the panel.

• Admin Area Features:

✔ Create/Suspend/Unsuspend/Terminate Context

✔ Change Package

✔ View Service Information:

✔ Status

✔ Owner

✔ Module Access

✔ Maximum Context Quota

✔ Context Username And Password

✔ Number And Limits Of:

✔ Email Accounts

✔ Email Aliases

✔ Email Forwarders

✔ Configure Product:

✔ Set Limit Of Email Accounts Per Context

✔ Set Limit Of Email Aliases Per Context

✔ Set Limit Of Email Forwarders Per Context

✔ Select Module Access

✔ Define Maximum Quota Per Email Account [MB]

✔ Define Maximum Quota Per Context [MB]

✔ Toggle Using WHMCS Own Domain Only

✔ Allow Users To Change Password

• Client Area Features:

✔ View Service Information:

✔ Status

✔ Owner

✔ Module Access

✔ Maximum Context Quota

✔ Context Username And Password

✔ Number And Limits Of:

✔ Email Accounts

✔ Email Aliases

✔ Email Forwarders

✔ Access And Management Of:

✔ Email Accounts

✔ Email Aliases

✔ Email Forwarders

✔ Email Catch-All

✔ View MX Records For Mail Domains

• Configurable Options:

✔ Email Accounts Limit

✔ Email Aliases Limit

✔ Email Forwarders Limit

✔ Email Quota

✔ Allow To Change Password

• General Info:

✔ Configurable Options Support

✔ Multi-Language Support

✔ Supports PHP 7.2 Up To PHP 7.4

✔ Supports WHMCS Themes "Six" And "Twenty-One"

✔ Supports WHMCS V8.2 And Later

Installation and Configuration

The below tutorial will show you how to successfully install and configure OX WHMCS Module. We will guide you step by step through the whole installation process.

Installation

1. Log in to our client area and download the module.

2. Upload and extract the files into the main WHMCS directory. Files in your WHMCS directory should look like on the following screen.

Activation of Addon

3. Now you have to activate the module in your WHMCS system. Log in to your WHMCS admin area. Move to the 'System Settings' and find 'Addon Modules'. Afterwards, find 'OX WHMCS Module' and press the 'Activate' button.

4. In the next step you need to permit access to this module. To do so, click on the 'Configure' button, tick the desired admin roles and press 'Save Changes'.

5. OX WHMCS Module has been successfully installed! Access the addon under 'Addons' → 'OX WHMCS Module'.

Server Configuration

6. In order to establish a successful connection, you will need to set up the server first. Log in to your WHMCS, proceed to 'System Settings' → 'Products/Services' → 'Servers'. There, press 'Add New Server'.

7. Next, enter your server name and the Open-Xchange server hostname (server URL). Choose 'OX WHMCS Module' from the 'Module' dropdown menu and type in your username and password. Select 'Secure' if you use SSL for connection. Next, test your connection and press 'Save Changes' if that has been successful. Note: Please use the reseller credentials to fill out the "Username" and "Password" fields.

8. After you configure your server correctly, you will see the following screen. Now you need to create a new group for your server. For that purpose press 'Create New Group'.

9. Enter name, click on your previously created server, press 'Add' then 'Save Changes'.

Product Configuration

10. In order to create and configure product, proceed to 'System Settings' → 'Products/Services'. Start from crating a new, dedicated group, press 'Create a New Group' button.

11. Next, enter your new product group name and press the 'Save Changes' button.

12. You can create your product now and assign it to the previously created product group. Click on 'Create a New Product'.

13. Afterwards, choose your product type and product group from dropdown menu, enter the product name and select 'OX WHMCS Module' module. You may 'Continue' to the next step now. Note: You may select "Shared Hosting" or "Other" type of the product.

14. In the product's details make sure to mark the 'Require Domain' option.

15. Now, go to the 'Module Settings' section, choose both 'OX WHMCS Module' and your previously created server group from dropdown menus.

16. In this section you can define the limit settings per product. Email Accounts Limit - the maximum allowed number of email accounts per context is 500 Email Aliases Limit - the maximum allowed number of email aliases per email account is 50 Email Forwarders Limit - note that only one redirection is allowed per one forwarding alias Product Components - select the combination of modules and addons the client will have access to Maximum Quota Per Email Account [MB] - set the maximum quota for single email account [MB] Maximum Quota Per Context [MB] - the maximum quota value cannot be lower than 10 000 MB (10 GB) Use Only WHMCS Own Domain - only users with with an active domain on WHMCS will be able to manage this product Allow To Change Password - when executing the "Create" and "Change Package" functions, the user will be allowed to change the password in the created context

17. Additionally, you can replace the module static limits with the dynamic ones in the form of configurable options. Press 'Create Configurable Options' to generate default set of configurable options. More about management of configurable options can be found here.

18. After saving the product configuration, please make sure if the module generated custom fields have been successfully created:

19. That's all, you have just correctly created and customized a new product, now you can check the results. This is what your customers should see in your client area.

Here is the view of a properly created and configured product from the administrator site.

Addon Configuration

Before you start your actual work with OX WHMCS Module, move again to 'Addons' → 'OX WHMCS Module'. The addon allows an easy and comfortable access to the Contexts list and the OX panel cloud settings. The first section is dedicated to created contexts. You will find there a clear and detailed list with the following details: Client Name Domain Context ID Context Name Current Status

The next section, that is 'Cloud Settings' is dedicated to the configuration and branding of the OX theme UI. Take a look at the available settings.

You may provide a link to a logo image, specify its width and height to adjust its perfect display in the OX panel.

Under 'Theme' you will find 8 options related to the main, topbar, link and list items coloring. Choose the colors of your preference from the palette and enable the theme items customization.

When you have a ready configuration, make sure to save the changes. Now, you can create new context and check in the OX panel your design alive. Important: The changes made in teh addon are not

Management

OX WHMCS Module allows your customers to manage their Open-Xchange accounts directly in your WHMCS client area. Read through the next chapters which illustrate all the possibilities of our addon module.

Admin Area

From now on, all your clients who ordered a previously created product will be able to manage their OX accounts via your WHMCS system. The screen below presents a summary view of the ordered product in admin area. Among the available actions you will find: Module Commands: 'Create', 'Suspend'/'Unsuspend', 'Terminate' the product and 'Change Package' action Change configurable options values - available options depend on configuration in 'Module Settings' Service Information Context ID Context Name

Client Area

In the below section, you will find basic tools used to manage your OX account shown and described. Analyze them carefully to enjoy full and easy management.

Ordering Process

Order page view of a product with the configurable options generated:

Order page view of a product with static limits setup:

Management

OX WHMCS Module allows your customers to manage their OX email accounts from your WHMCS client area. This is what its management page looks like in the client area. Move to the below sections to learn more details.

Email Accounts

Email Accounts section enables full management of accounts associated with your domain. You may edit existing accounts with a wide range of options and create new ones within defined limits.

Press 'Create Account' to create a new account. Fill out the fields to provide any details on the account owner. Note: The provided 'Quota' field must be lower that the set up limit. If the limit has been reached, the client will not be able to create an account.

As you can see, the just created account is now visible on the list of all email accounts. Use marked buttons to either delete a single account or change its settings.

Apart form changing all the basic data of the selected account, you may change its status here. Just toggle the adequate switcher to enable or disable the email account.

Email Aliases

Email Aliases enable you to create and use additional address for the same e-mail account. Note: Email aliases are created within the same email domain.

Any aliases can be quickly removed through pressing an adequate icon.

Email Forwarders

In this section you can set up email forwarders and choose from several destination options to adjust mail forwarding perfectly to your needs. Press the 'Create Forwarder' button, specify the forwarded email and define the destination emails.

A full list of existing email forwarders is now available to preview. You may add more forwarders, yet, once the limit is reached, you will have to delete some to be allowed to add new ones.

Email Catch-All

Email Catch-All is a feature that allows you to forward emails that are sent to the non-existent email address of your domain name. Once you add an email catch-all, you may delete it using action buttons.

MX Records

These MX records are to be used for mail domains which are accessed under the appsuite.cloud domain either in EU or in US. Important: In case custom endpoints are used with your own domain, you will get a different set of MX records during onboarding.

Tips

1.???????????

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.