Personal tools
Namespaces

Variants
Actions

Office 365 For WHMCS

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
(API Configuration)
(Configuration of Server)
Line 88: Line 88:
 
==Configuration of Server==
 
==Configuration of Server==
 
{|
 
{|
|style="padding: 10px 0px 15px 15px;"|'''10 To begin, you must add a new server.'''<br />
+
|style="padding: 10px 0px 15px 15px;"|'''6. To begin, you must add a new server.'''<br />
 
Go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Servers' '' and press '' 'Add New Server'. ''
 
Go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Servers' '' and press '' 'Add New Server'. ''
 
|}
 
|}
Line 95: Line 95:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'''11. Enter your server name, IP address, username and a password. Choose '' 'cpanelExtended' '' from a dropdown menu and press '' 'Save Changes'. '''''<br />
+
|style="padding: 0px 0px 15px 15px;"|'''7. Enter your server name, IP address, username and a password. Choose '' 'cpanelExtended' '' from a dropdown menu and press '' 'Save Changes'. '''''<br />
 
If you connect with your cPanel server via SSL, then make sure that you checked '' 'Secure' '' located at the bottom of the page.<br />
 
If you connect with your cPanel server via SSL, then make sure that you checked '' 'Secure' '' located at the bottom of the page.<br />
 
''Note: Keep in mind that 'Login to Webmail'  and 'Login to cPanel' buttons' URLs, located in the client area, derive from 'Hostname' or 'IP Address' fields input.''
 
''Note: Keep in mind that 'Login to Webmail'  and 'Login to cPanel' buttons' URLs, located in the client area, derive from 'Hostname' or 'IP Address' fields input.''
Line 103: Line 103:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 15px 15px;"|'''12. Once your server has been configured correctly, you will see a following screen.'''<br />
+
|style="padding: 0px 0px 15px 15px;"|'''8. Once your server has been configured correctly, you will see a following screen.'''<br />
 
Create a new group for your server.  Press '' 'Create New Group' '' to follow.
 
Create a new group for your server.  Press '' 'Create New Group' '' to follow.
 
|}
 
|}
Line 110: Line 110:
 
|}
 
|}
 
{|
 
{|
|style="padding: 0px 0px 20px 15px;"|'''13. Enter name, click on your previously created server, press '' 'Add' '' then '' 'Save Changes'.'' '''
+
|style="padding: 0px 0px 20px 15px;"|'''9. Enter name, click on your previously created server, press '' 'Add' '' then '' 'Save Changes'.'' '''
 
|}
 
|}
 
{|
 
{|

Revision as of 09:05, 5 June 2017


Contents

About [1]

Office 365 For WHMCS will enable you to provision and manage Office 365 accounts in your own WHMCS system.

xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

  • Admin Area Features:
✔ Create/Suspend/Unsuspend/Terminate Account
✔ Change Package
✔ xxxx
  • Client Area Features:
✔ xxxx
✔ xxxx
✔ xxxx
  • General Info:
✔ xxxx
✔ Multi-Language Support
✔ Supports PHP 5.4 Up To PHP 7
✔ Supports WHMCS Template Six
✔ Supports WHMCS V6 and V7

Installation and Authentication

This tutorial will show you how to successfully install and authenticate Office 365 For WHMCS.

We will guide you step by step through the whole installation and authentication process.

1. Log in to your client area and download Office 365 For WHMCS.
O 1.png
2. In the downloaded file you will find two packages that support different PHP versions.
As presented on the screen below, the first one is dedicated to PHP 7, while the second one is aimed at PHP 5.4 up to PHP 5.6.
It does not apply to open source versions.

Note: You can check current PHP version in your WHMCS. To do so proceed to 'Utilities' → 'System' → 'PHP Info'.

O 2.png
3. Extract the downloaded file and choose the one with the right PHP version. Upload and extract the PHP file into the main WHMCS directory.

The content of PHP version files should look like this.

O 2 2.png
4. When you install Office 365 for the first time you have to rename 'license_RENAME.php' file.

File is located in 'modules/servers/office365/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

O 3.png
5. In order to configure your license key you have to edit a previously renamed 'license.php' file.

Enter your license key between quotation marks as presented on the following screen. You can find your license key in your client area → 'My Products'.

O 4.png

Configuration of Server

6. To begin, you must add a new server.

Go to 'Setup' 'Products/Services' 'Servers' and press 'Add New Server'.

O 8.png
7. Enter your server name, IP address, username and a password. Choose 'cpanelExtended' from a dropdown menu and press 'Save Changes'.

If you connect with your cPanel server via SSL, then make sure that you checked 'Secure' located at the bottom of the page.
Note: Keep in mind that 'Login to Webmail' and 'Login to cPanel' buttons' URLs, located in the client area, derive from 'Hostname' or 'IP Address' fields input.

O 9.png
8. Once your server has been configured correctly, you will see a following screen.

Create a new group for your server. Press 'Create New Group' to follow.

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

Product Configuration

13. Now go back to your WHMCS system and create a new product for your Office 365Apps.

Move to 'Setup' → 'Products/Services' → 'Products/Services' and add a new product.

O 5 6 1.png
14. Choose product type and product group from dropdown menus and enter your new product's name. 'Continue'.
O 5 6 2.png
15. Go to 'Module Settings' of your product and choose 'Office 365apps' from a 'Module Name' dropdown menu.
O 5 7.png
16. Enter your previously obtained 'Client ID', 'Client Secret' and make sure that 'Callback URL' is correct.

Then press 'Grant access with Office 365 account'.

File:O 5 8.png
17. If your entered data are correct, you will be redirected to the page with permission request. Press 'Allow access' button.
File:O 5 9.png
18. And that is all. You will be redirected back to your WHMCS and you will see a following screen.

Move to 'Custom Fields' now.

O 14.png
19. Fields called 'Office 365Apps Domain' and 'Office 365Apps PurchaseOrderID' are added automatically.
File:O 19.png

Configuration and Management

Configuration and management of Office 365 For WHMCS is very intuitive. Read the below sections to see how easy it is.

Basic Configuration

Let's start the module settings from choosing 'Default Product SKU ID'. In other words Office 365 services.

As you can see on the following screen our module supports Office 365 Apps For Business, Office 365 Drive Storage and Office 365 Vault.

O 16.png
'Plan Name' allows you to select the method of payment. You can pay once per year (Annual), once per month (Flexible) or as the client chooses (Automatic).
O 17.png
Here you can decide whether on terminate you want to suspend or cancel customer's services.
O 18.png

Configurable Options

In order to automatically generate configurable options, simply press button marked on the screen.
File:O 21.png
In your WHMCS system press 'Setup' 'Products/Services' 'Configurable Options'.

Find 'Office 365Apps' options on the list.

O 22.png
Here you can manage and alter added configurable options.
O 23.png
Provide values for your new option and enter your desired price. 'Save Changes'.
O 24.png
At your product 'Module Settings' you can fill out the fields for ' Default Number of Seats' and 'Default Max Number of Seats'.
Remember, however, that these values will be used only if configurable options are NOT generated.
O 25.png
From now on you can easily and quickly change value of your product. Remember that you can add more configurable options for other values.

Admin Area

Let's check your new product in admin area product page. It should look like on the screen below.
O 19.1.png

Client Area

This is how the module will look like in the client area. Office 365 For WHMCS also allows your customers to quickly access Office 365 account services.
O 20.png

Update of Existing Customers

You can link existing customers accounts by properly filling in the Custom Fields: 'Office 365Apps Domain' and 'Office 365Apps PurchaseOrderID'.

After your customers order a new subscription, they should insert their primary Office 365 account domain name in the 'Office 365Apps Domain' field.
Then, the new subscription will be added to that account.
If you want to manually create an order for existing subscription, additionally to the above, you need to find the 'Purchase Order ID' (usually on the invoice).
Copy the ID and paste it to the 'Office 365Apps PurchaseOrderID ' field.
Afterwards do not run the create command - just press 'Save Changes' button. You can also change the status to 'Active'.

O 28.png

Tips

1. xxx.
2. xxx.

Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
Office 365 For WHMCS