Office 365 For WHMCS
From ModulesGarden Wiki
(Difference between revisions)
|
|
| Line 232: |
Line 232: |
| | |} | | |} |
| | {| | | {| |
| − | |style="padding: 0px 0px 20px 15px;"|Go to the '' 'Applicable Products' '' tab and select product for which you want to offer this addon. '' 'Save Changes' ''. | + | |style="padding: 0px 0px 20px 15px;"|Go to the '' 'Applicable Products' '' tab and select product for which you want to offer this addon. '' Then press 'Save Changes' ''. |
| | |} | | |} |
| | {| | | {| |
Revision as of 09:59, 7 June 2017
| Office 365 For WHMCS offers a variety of Microsoft Office 365 plans along with addon services and handles their key aspects remotely: suspends or switches the subscription, alter the password and more.
|
| ✔ Create/Suspend/Unsuspend Office 365 Subscriptions
|
| ✔ Create/Suspend/Unsuspend Addon Services
|
| ✔ Upgrade/Downgrade Office 365 Subscriptions
|
| ✔ Office 365 Education / Education E5
|
| ✔ Office 365 Business / Business Essentials / Business Premium
|
| ✔ Office 365 ProPlus / Enterprise E1 / E3 / E5 / K1
|
| ✔ Skype For Business Online
|
| ✔ Project Portfolio Management
|
| ✔ Business Intelligence Service
|
| ✔ Online Diagram Software
|
| ✔ Information Rights Management
|
| ✔ Supports PHP 5.4 Up To PHP 7
|
| ✔ Supports WHMCS Templates Five and 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 the module.
|
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'.
|
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.
|
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'.
|
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'.
|
Configuration of Server
6. To begin, you must add a new server.
Go to 'Setup' → 'Products/Services' → 'Servers' and press 'Add New Server'.
|
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'.
|
- 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:
- 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:
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.
|
| 9. Enter name, click on your previously created server, press 'Add' then 'Save Changes'.
|
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.
|
| 11. Fill in a product group name and press 'Save Changes'.
|
| 12. When you have a product group added, you can create your product and assign it to Office 365 module.
|
| 13. Afterwards, choose your product type and product group from dropdown menus, enter your product name and press 'Continue' .
|
14. Now, go to 'Module Settings' section, choose both 'Office365' and a previously created server group from dropdown menus and press 'Save Changes' .
|
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 by choosing 'Office365' from 'Module Name' and previously created 'Server Group' .
|
Now choose 'Country'. from which you will offer your Office 365 services.
Then 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.
|
| Subsequently 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.
|
Additional Services
|
In order to offer additional services for product plan you need to create a new addon first.
In your WHMCS system press 'Setup' → 'Products/Services' → 'Product Addons' and select 'Add New Addon' .
|
| Enter name for the addon, choose addon to be visible on order and configure the rest of the desired options.
|
| Go to the 'Applicable Products' tab and select product for which you want to offer this addon. Then press 'Save Changes' .
|
| Go back your product and at 'Module Settings' tab you can now associate created addon with one of the available additional services.
|
'Save Changes' . Remember that you can add more addons for other services.
|
Order
Once the product configuration is complete, clients will be able to order the selected subscription and addons.
|
Client Area
|
At the moment the module does not support any special features in the client area.
The customer can order additional services to their subscription, change their password to Office 365 panel, upgrade subscription plan or request a service cancellation.
|
Admin Area
Let's check your new product in admin area product page. After successful creation it should look like on the screen below.
|
The 'Username' and 'Password' are used to sign up in to Office 365 user panel.
|
The 'User ID' , 'Order ID' and 'Subscription ID' are custom fields are used to associate the product to the created subscription in your Microsoft Partner Center.
If one customer buys more than one subscription then common 'User ID' will be used for association.
|
Suspend/Terminate
|
Due to API limitation, ordered subscriptions can only be suspended or unsuspended. For this reason the 'Terminate' command will work just like the 'Suspend' one.
|
|
In case of product suspension, all addons which belongs to the product will also be suspended.
Information about product suspension will be shown in 'Admin Notes' field.
|
Change Password
|
Change Password will change the password for all services assigned to user. To change it for a new one you need to:
- Provide a new password → Press 'Save Changes' → Press 'Change Password' .
|
Note that the password must also meet the following requirements:
- At least 8 characters in length
- At least 1 uppercase character
- At least 1 special character
- At least 1 numeric character
|
Addons
| Information about addons will depend on their status and will be shown in 'Admin Notes' field. By default, there is provided the service 'Subscription ID'.
|
| For example, if the addon is suspended the information will also appear in this field.
|
Common Problems
| 1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
|
