Personal tools
Namespaces

Variants
Actions

General

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
m (Protected "General" (‎[edit=sysop] (indefinite) ‎[move=sysop] (indefinite)) [cascading])
Line 73: Line 73:
 
{|
 
{|
 
|style="padding: 0px 0px 30px 15px;"|If problem with your license persists, please contact our Support.
 
|style="padding: 0px 0px 30px 15px;"|If problem with your license persists, please contact our Support.
 +
|}
 +
 +
<meta name="keywords" content="configurable options, configurable options configuration, configurable options management, configurable options editing, configurable options guide, modulesgarden configurable options, configurable options wiki, configurable options tutorial, configurable options tips, about configurable options, configurable options documentation, configurable options faq, configurable options help"></meta>
 +
<meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About Configurable Options."></meta>
 +
 +
 +
=About Configurable Options=
 +
{|
 +
|style="padding: 10px 0px 10px 0px;"|'''Configurable options on products allow you to give your clients variables which alter the resource available at that product as well as its price.'''
 +
In this tutorial we will show you how to manage configurable options generated by our modules.
 +
|}
 +
 +
=Editing Configurable Options=
 +
{|
 +
|style="padding: 10px 0px 20px 15px;"|When you successfully set up a product, your client can order it by choosing its resource and settings from default configurable options.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO1.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|In case those options aren't fitting your needs, you can edit them.<br />
 +
To do so, go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Configurable Options' '' and press edit button next to configurable option used by your product.<br />
 +
Its name is '' 'Configurable options for your_product_name' ''.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO2.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Here you can view all products this configurable option group is assigned to.<br />
 +
Now we will show you how to edit options. Let's say you want to add an option to order VPS with 4 cores per socket.<br />
 +
To do so, edit '' 'The number of cores per socket' '' by pressing edit button as shown on the screen below.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO3.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|You will see a popup window, so make sure your browser will not block it.<br />
 +
To add new option enter it in a textbox under all other options, but if you want to replace it with an option you currently have, simply edit its textbox.<br />
 +
Next, press '' 'Save Changes' ''.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:HCO4.png]]
 +
|}
 +
 +
=Hiding Configurable Options=
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|If you decide to  hide configurable options from a client order form and manage them only from the admin area, follow steps below.<br />
 +
Firstly, go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Configurable Options' ''.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO5.png]]
 +
|}
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|Afterwards, tick '' 'Hidden' '' checkboxes next to configurable options you want to hide and confirm the action through pressing '' 'Save Changes' ''.<br />
 +
On the screen below you can see hiding of '' 'Number of Public IP' '' and '' 'Number of Private IP' ''.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:HCO6.png]]
 +
|}
 +
 +
=Setting Up Pricing For Configurable Options=
 +
{|
 +
|style="padding: 10px 0px 15px 15px;"|If you decide to  set up pricing for configurable options, follow steps below.<br />
 +
Firstly, go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Configurable Options' ''.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO7.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|Next, press edit button next to configurable options you want to set pricing for.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO8.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Afterwards, you will see a popup window, so make sure your browser will not block it.<br />
 +
Now, price you entered for resource should be in a column responsible for the same type of payment as your product uses.<br />
 +
For example, if we have product with monthly and quarterly payment, you will have to enter product pricing in the first and second columns.<br />
 +
Confirm through clicking on '' 'Save Changes' '' button as soon as you finish.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 25px;"|[[File:HCO9.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|Depending from '' 'Option Type' '', pricing you entered may be counted in various ways.<br />
 +
'' 'Dropdown' '' - You have to set price for each option. On the screen below you can find examplary setup of '' 'Dropdown' '' type configurable option.<br />
 +
'' 'Radio' '' - Same as above, only difference is display manner.<br />
 +
'' 'Yes/No' '' - Your price will be applied if client checkes this option.<br />
 +
'' 'Quantity' '' - Price you set will be multiplied by amount of configurable options your client chooses.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO10.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 15px;"|On the screen below you can see specially prepared all four configurable options on the order form.
 +
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:HCO11.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 30px 15px;"|Now you should have no problems with understanding and using the configurable options in your WHMCS.
 
|}
 
|}

Revision as of 15:46, 18 November 2013

Contents

How To Change Module Language

Please note that not all of our modules have Multi-Language Support.

1. Changing module language is very simple. First of all, go to 'lang' folder located in your module or templates directory (dependant on the module).

Now copy 'english.php' file and rename it to your desired language, for example 'spanish.php' .

Lang1.png
2. Now you can enter to your newly created file and easily replace particular sentences.

For presentation purposes we changed ['manage header'] from 'Manage' to 'Ordenar' . Don't forget to save the changes.

Lang2.png
3. Now you can change the language in two ways:
  • Through changing client's language in your WHMCS system:
Lang4.png
  • Through changing language directly in the client area (keep in mind that customers can change their language anytime they want):
Lang5.png
4. As you can see on the following screen the header has changed to 'Ordenar' owing to our changes.
Lang3.png
That's all, from now on you shouldn't have any problems with changing language in our modules.

How To Debug Module

If the procedure described below doesn't work for you, please report this to our Support Team.

When you are experiencing white page or the module is not working as it should, you can enable debug mode that prints all the PHP errors on the screen.
To do so, enter the URL you are experiencing the issue with and add the additional parameter '_debug=turnon' . For example:

yourdomain.com/clientarea.php?action=productdetails&id=81&_debug=turnon
yourdomain.com/clientarea.php?_debug=turnon

To disable debug mode, simply call the same parameter but with the value turnoff. For example:

yourdomain.com/clientarea.php?_debug=turnoff

If you will get the error as shown on the screen below, please make sure that you are using the correct parameter and you have sufficient privileges.
DM1.png

How To Solve Problems With License

When you have any problems with license and you are certain that license key is entered correctly in 'license.php' file, you can reissue it.

License reissuing solves about 95% of such problems. To to so, log in to your client area, choose product and click on 'Management Actions' 'Reissue License' .

G1.png
If problem with your license persists, please contact our Support.


About Configurable Options

Configurable options on products allow you to give your clients variables which alter the resource available at that product as well as its price.

In this tutorial we will show you how to manage configurable options generated by our modules.

Editing Configurable Options

When you successfully set up a product, your client can order it by choosing its resource and settings from default configurable options.
HCO1.png
In case those options aren't fitting your needs, you can edit them.

To do so, go to 'Setup' 'Products/Services' 'Configurable Options' and press edit button next to configurable option used by your product.
Its name is 'Configurable options for your_product_name' .

HCO2.png
Here you can view all products this configurable option group is assigned to.

Now we will show you how to edit options. Let's say you want to add an option to order VPS with 4 cores per socket.
To do so, edit 'The number of cores per socket' by pressing edit button as shown on the screen below.

HCO3.png
You will see a popup window, so make sure your browser will not block it.

To add new option enter it in a textbox under all other options, but if you want to replace it with an option you currently have, simply edit its textbox.
Next, press 'Save Changes' .

HCO4.png

Hiding Configurable Options

If you decide to hide configurable options from a client order form and manage them only from the admin area, follow steps below.

Firstly, go to 'Setup' 'Products/Services' 'Configurable Options' .

HCO5.png
Afterwards, tick 'Hidden' checkboxes next to configurable options you want to hide and confirm the action through pressing 'Save Changes' .

On the screen below you can see hiding of 'Number of Public IP' and 'Number of Private IP' .

HCO6.png

Setting Up Pricing For Configurable Options

If you decide to set up pricing for configurable options, follow steps below.

Firstly, go to 'Setup' 'Products/Services' 'Configurable Options' .

HCO7.png
Next, press edit button next to configurable options you want to set pricing for.
HCO8.png
Afterwards, you will see a popup window, so make sure your browser will not block it.

Now, price you entered for resource should be in a column responsible for the same type of payment as your product uses.
For example, if we have product with monthly and quarterly payment, you will have to enter product pricing in the first and second columns.
Confirm through clicking on 'Save Changes' button as soon as you finish.

HCO9.png
Depending from 'Option Type' , pricing you entered may be counted in various ways.

'Dropdown' - You have to set price for each option. On the screen below you can find examplary setup of 'Dropdown' type configurable option.
'Radio' - Same as above, only difference is display manner.
'Yes/No' - Your price will be applied if client checkes this option.
'Quantity' - Price you set will be multiplied by amount of configurable options your client chooses.

HCO10.png
On the screen below you can see specially prepared all four configurable options on the order form.
HCO11.png
Now you should have no problems with understanding and using the configurable options in your WHMCS.
Navigation
WHMCS Modules
WHMCS Widgets
Translations
cPanel Modules
General
FAQ
Community
General