Personal tools
Namespaces

Variants
Actions

Office 365 For WHMCS

From ModulesGarden Wiki
Revision as of 13:08, 6 June 2017 by Gregor (Talk | contribs)

Jump to: navigation, search


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 WHMCS 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. Choose 'Office365' from a dropdown menu. Enter your Microsoft Partner username, password, API URL, Native APP ID, Domain And Microsoft ID. Then press 'Save Changes'.
O 9.png
  • To find your 'Native APP ID' go to the 'Microsoft Partner Center' panel → 'Account Settings' 'App Management' and copy 'App ID' from 'Native App' section:
O 9 1.png
  • To obtain 'Domain' and 'Microsoft ID' go to the 'Microsoft Partner Center' panel → 'Dashboard' 'Customers' and expand desired account you want use to sell subscriptions:
O 9 2.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

Configuration of Product

10. In order to create a product, go to 'Setup' 'Products/Services' 'Products/Services' .

If you do not have a product group, click on 'Create a New Group' . If you do, simply skip step 13.

O 12.png
11. Fill in a product group name and press 'Save Changes'.
O 13.png
12. When you have a product group added, you can create your product and assign it to Office 365 module.
O 14.png
13. Afterwards, choose your product type and product group from dropdown menus, enter your product name and press 'Continue' .
O 15.png
14. Now, go to 'Module Settings' section, choose both 'Office365' and a previously created server group from dropdown menus and press 'Save Changes' .
O 16.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 'Office365' from 'Module Name' and previously created 'Server Group' .
O 16.png
Now choose 'Country'. from which you will be offer your Office 365 services.

Next select available 'Company Domain' ' and choose one of desired Office 365 plans. You may also assign additional services to the main plan as addons which will be described in further parts.

O 17.png
Next go to the 'Custom Fields' tab and add two new text box fields: userid|User ID and orderid|Order ID as shown on the following screen:
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