Office 365 For WHMCS
From ModulesGarden Wiki
(Difference between revisions)
|
|
Line 74: |
Line 74: |
| {| | | {| |
| |style="padding: 0px 0px 15px 15px;"|'''4. When you install Office 365 for the first time you have to rename '' 'license_RENAME.php' '' file.'''<br /> | | |style="padding: 0px 0px 15px 15px;"|'''4. When you install Office 365 for the first time you have to rename '' 'license_RENAME.php' '' file.'''<br /> |
− | File is located in '' 'modules/servers/Office 365apps/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. '' | + | File is located in '' 'modules/servers/office365/license_RENAME.php'. '' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'. '' |
| |} | | |} |
| {| | | {| |
Revision as of 08:57, 5 June 2017
Office 365 For WHMCS will enable you to provision and manage Office 365 accounts in your own WHMCS system.
xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
|
✔ Create/Suspend/Unsuspend/Terminate Account
|
✔ 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.
|
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 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'.
|
API Configuration
7. After you have logged in, create a new project.
|
8. You have just entered Office 365 API Manager. Firstly, go to 'OAuth consent screen' under 'Credentials' section.
Afterwards, enter email address and product name, they will be visible during your requests.
Save changes through pressing 'Save' button.
|
8. To proceed, go to 'Office 365 APIs' under 'Overview' tab.
Find 'Office 365 Apps Reseller API' among all applications.
|
9. You have to enable 'Office 365 Apps Reseller API' as shown on the following screen.
|
10. Now, switch to 'Credentials' tab and add new credentials .
|
11. Afterwards, tick 'Web application'.
Next, enter website URL into 'Authorized JavaScript origins' field and path to 'oauth_callback.php' into 'Authorized redirect URI' field.
Confirm changes through pressing 'Create'.
|
12. Well done, now when you have all the necessary details you can proceed to authenticate Office 365 Apps.
|
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.
|
14. Choose product type and product group from dropdown menus and enter your new product's name. 'Continue'.
|
15. Go to 'Module Settings' of your product and choose 'Office 365apps' from a 'Module Name' dropdown menu.
|
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'.
|
17. If your entered data are correct, you will be redirected to the page with permission request. Press 'Allow access' button.
|
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.
|
19. Fields called 'Office 365Apps Domain' and 'Office 365Apps PurchaseOrderID' are added automatically.
|
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.
|
'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).
|
Here you can decide whether on terminate you want to suspend or cancel customer's services.
|
Configurable Options
In order to automatically generate configurable options, simply press button marked on the screen.
|
In your WHMCS system press 'Setup' → 'Products/Services' → 'Configurable Options'.
Find 'Office 365Apps' options on the list.
|
Here you can manage and alter added configurable options.
|
Provide values for your new option and enter your desired price. 'Save Changes'.
|
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.
|
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.
|
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.
|
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'.
|
Tips
Common Problems
1. When you have problems with connection, check whether your SELinux or firewall does not block ports.
|