Product Linker For WHMCS
From ModulesGarden Wiki
(Difference between revisions)
|
|
| Line 2: |
Line 2: |
| | <meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Product Linker For WHMCS Module."></meta> | | <meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Product Linker For WHMCS Module."></meta> |
| | | | |
| − | =About [http://www.modulesgarden.com/products/whmcs/password_manager/features Product Linker For WHMCS]= | + | =About [http://www.modulesgarden.com/products/whmcs/product_linker/features Product Linker For WHMCS]= |
| | {| | | {| |
| | |style="padding: 10px 0px 5px 0px;"|'''Product Linker For WHMCS''' allows you to sell your products in bundles.<br /> | | |style="padding: 10px 0px 5px 0px;"|'''Product Linker For WHMCS''' allows you to sell your products in bundles.<br /> |
Revision as of 17:31, 15 January 2014
Product Linker For WHMCS allows you to sell your products in bundles.
Product bundles content is defined by clients through chosen addons or configurable options.
Module will also allow you to view, filter and delete existing connections used by your customers.
|
| ✔ Create A Single Or Multiple Relations Between Your WHMCS Products, Addons And Configurable Options
|
| ✔ Allow Your Clients To Purchase Multiple Products, Addons And Configurable Options Through Ordering Just One Of Them
|
| ✔ Dependencies Between Module Actions - Every Action: Create, Terminate, Suspend Or Unsuspend Called On The Main Product Will Result With The Same Action Performed On The Child Products
|
| ✔ Product Updates With Automatic Email Notifications To Admin
|
| ✔ View And Delete Existing Connections
|
| ✔ Flexible Filtering Of Existing Connections
|
| ✔ Integrated With cPanel Manage2 For WHMCS - Easy Reselling Of cPanel Licenses (read more)
|
| ✔ Integrated With DirectAdmin Licenses For WHMCS - Easy DirectAdmin Licenses Reselling (soon)
|
| ✔ Integrated With Parallels Key Administrator For WHMCS - Easy Parallels Licenses Reselling (soon)
|
| ✔ Improved Update Of Products
|
| ✔ Supports WHMCS V5 and Later
|
Installation
This tutorial will show you how to successfully install Product Linker For WHMCS.
We will guide you step by step through the whole installation and configuration process.
|
| 1. Log in to your client area and download Product Linker For WHMCS.
|
2. Upload and extract the module into the main WHMCS directory.
Files in your WHMCS directory should look like this.
|
3. When you install Product Linker for the first time you have to rename 'license_RENAME.php' file.
File is located at 'modules/addons/productlinker/license_RENAME.php' . Rename it from 'license_RENAME.php' to 'license.php' .
|
4. 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 at your client area → 'My Products' .
|
5. Now you have to activate the module in your WHMCS system.
Log in to your WHMCS admin area. Go to 'Setup' → 'Addon Modules' . Afterwards, find 'Product Linker' and press 'Activate' button.
|
6. In the next step you need to permit access to this module.
To do so, click on 'Configure' button, select administrator groups which should have access to this addon and press 'Save Changes' .
|
7. To enable logs from failed actions, go to 'Utilities' → 'Logs' → 'Module Log' .
Afterwards, press 'Enable Debug Logging' .
|
8. You have just successfully installed Product Linker For WHMCS!
You can access your module at 'Addons' → 'Product Linker' .
|
Configuration and Management
Product Linker For WHMCS allows to sell bundle of product through ordering one product with specific product addons and configurable options.
It also automatically forward basic commands ordered by admin on main product to all linked products.
You can define link between product by product addon or configurable options, more about it in 'Add Relation' section.
|
Relation Management
At 'Relation Management' tab you can define links between products.
They will be triggered as soon as your client will make an order for product with product addon/configurable option chosen at relation.
|
Add Relation
To add new relation, go to 'Product Linker' → 'Relation Management' and find table 'Crate' .
Select relation type from 'Type' dropdown menu, you can choose between relation triggered by product addon or configurable option.
|
Next, select addon name or configurable option name from 'Product Addon/Configurable Option' dropdown menu.
If you chosen 'Configurable option' relation type, additionally you have to select configurable option value.
|
Finish through selecting product which will be linked by triggering this relation.
Save relation through pressing 'Add Relation' button.
|
Edit Relation
Editing relations is quite easy, go to 'Relation Management' tab and start making changes.
You can alter one relation or multiple relations simultaneously, difference is button used to save changes.
If you are making changes in only one relation, press 'Save Changes' button next to it (green arrow), otherwise use 'Save Changes' at the bottom of the page (red arrow).
|
Existing Connections
'Existing Connections' tab allows you to view list of all products ordered by your clients for which relation was triggered.
You can find all information related to created link, like for example main product, linked product, their owner or domain which both product uses.
You can quickly move to user or any of his product by simply clicking on client/product name.
|
We also allow you to order records on list by selected column through pressing on its headline.
For example, to order by client name, press on 'Client Name' column header as shown on the following screen.
|
To display only specific records you can use filters.
To open filters form, press 'Toggle Filters' .
|
You are able to set up filtering by client name, both main and linked product and domain.
When you select values you desire, click 'Filter Results' button (red arrow).
If you decide to clear filters you have set up earlier, open filters form and press 'Clear Filter' (green arrow).
|
Module Logs
If there was any trouble with linked products, information about error will appear in 'Module Logs' tab.
Error message can be found at 'Clean Response' and 'Parsed Response' column.
To localize products for which error occurred, you can use data in 'Request Parameters' column.
For example, '[accountid]' and '[domain]' should be enough to quickly localize products.
Note: Module also checks if module log is turn on and provide link to it.
|
You can look for product with details you found in previous step, but way quicker way is to use a link.
All you have to do is enter value of '[accountid]' in place of account_id in link below.
your_whmcs/admin/clientsservices.php?id=account_id
To confirm if you are looking at right product, check if domain in product math domain you found in error log.
|
Example Settings
| At 'Example Settings' we will show you how to set up relations between specific products.
|
cPanel Extended + cPanel Manage2
Before following these steps, make sure both products are configured correctly.
In these steps we will show you linking product through product addon, while you can also link them using configurable options.
Product linked to main product should be set to hidden and free, you will set his price at product addon.
1. Start from creating 'IP' custom field at main product visible on order form.
In order to do so, go to 'Setup' → 'Products/Services' → 'Products/Services' and edit your cPanel Extended product.
|
2. Open 'Custom Fields' tab, enter 'IP' into 'Field Name' and mark 'Show on Order Form' checkbox.
Confirm changes through pressing 'Save Changes' , you successfully created 'IP' custom field.
|
3. Afterwards, it is time to create product addon which will trigger relation.
Go to 'Setup' → 'Products/Services' → 'Products Addons' and press 'Add New Addon' .
|
4. Enter addon name, description and recurring price.
Choose billing cycle from 'Billing Cycle' dropdown menu.
It is adviced to set up same billing cycle as in main product.
You also have to mark 'Show on Order' checkbox and checkbox next to main product, in this example it will be 'Cpanel - cPanel Extended' .
Press 'Save Changes' .
|
| 5. Now, create relation at your 'Product Linker' → 'Relation Management' .
|
To check if relation works as it should, place an order from admin area for main product with addon triggering relation.
Do not forget to type domain and IP address. Afterwards, press 'Submit Order' .
|
| Select 'Run Module Create' and press 'Accept Order' .
|
| If new entry appeared as the one marked on the following screen you have successfully configured both product and linked them through addon.
|
Tips
| 1. If your client order product with settings triggering two relation to the same product, only one product will be created.
|
2. If your client order product configurable options upgrade/downgrade, old linked product bound by previous configurable option will stay active.
You need to remove link between old linked product and main product in addon and terminate old linked product manually.
|
Common Problems
| 1. When you have problems with connection, check whether your SELinux or firewall is not blocking ports.
|
