Personal tools
Namespaces

Variants
Actions

General

From ModulesGarden Wiki
(Difference between revisions)
Jump to: navigation, search
(→‎Common Problems With Magento Extensions)
(→‎How To Change WHMCS Module Language)
 
(53 intermediate revisions by 5 users not shown)
Line 1: Line 1:
−
<meta name="keywords" content="modulesgarden how to change whmcs module language, modulesgarden change language, modulesgarden whmcs module language, whmcs module language wiki, modulesgarden how to change magento module language, modulesgarden how to change magento admin theme, modulesgarden magento module language, magento module language wiki, modulesgarden general wiki, modulesgarden general problems, debug mode, debug module, modulesgarden general issues, modulesgarden module license, modulesgarden license problems, whmcs configurable options, configurable options whmcs"></meta>
+
<meta name="keywords" content="modulesgarden 7-day free access, modulesgarden common problems, whmcs widget for zendesk, modulesgarden faq, modulesgarden how to change whmcs module language, modulesgarden change language, modulesgarden whmcs module language, whmcs module language wiki, modulesgarden how to change magento module language, modulesgarden how to change magento admin theme, modulesgarden magento module language, magento module language wiki, modulesgarden general wiki, modulesgarden general problems, debug mode, debug module, modulesgarden general issues, modulesgarden module license, modulesgarden license problems, whmcs configurable options, configurable options whmcs"></meta>
−
<meta name="description" content="ModulesGarden Wiki General Is Dedicated To General Issues Not Directly Related To A Specific Module."></meta>
+
<meta name="description" content="In General Section Of ModulesGarden Wiki You Will Find Miscellaneous Information And How-To's About Our Products."></meta>
 +
 
  
 
==How To Change WHMCS Module Language==
 
==How To Change WHMCS Module Language==
−
'''<span style="color: #ff0000;">Please note that not all of our modules have Multi-Language Support.</span>'''
+
 
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|'''1. Changing WHMCS module language is very simple. First of all, go to '' 'lang' '' folder located in your module or templates directory (dependant on the module).'''<br />
+
|style="padding: 10px 0px 15px 15px;"|
−
Now copy '' 'english.php' '' file and rename it to your desired language, for example '' 'spanish.php' ''.
+
'''1. Locate the language files used by the module.'''
 +
 
 +
All modules store language strings in one or more ''langs'' directories. Depending on the module architecture, translations may be split across several locations, such as:
 +
 
 +
* Main module language files
 +
* Package language files ''e.g. App Templates (AppCenter)''
 +
* Framework component language files ''e.g. Buttons, Forms, Tables''
 +
 
 +
Modules with inbuilt packages, like '''App Templates''' in Proxmox VE VPS & Cloud module, may contain multiple language files instead of a single ''english.php'' file. <br/>
 +
In some modules, language strings can still be separated between the main addon and the server-related functionality.<br/>
 +
Some features may use language files located inside packages or framework components.
 +
 
 +
Examples of common language file locations:
 +
* Main addon language files: <code>/modules/addons/ModuleName/langs/english.php</code>
 +
 
 +
* Package language files: <code>/modules/addons/ModuleName/packages/AppCenter/langs/english.php</code>
 +
 
 +
* Framework component language files: <code>/modules/addons/ModuleName/components/Button/langs/english.php</code>
 +
 
 +
Depending on the feature you wish to translate, the required language string may be located in any of the above locations.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:Lang1.png]]
+
|style="padding: 0px 0px 15px 15px;"|
 +
'''2. Edit the language strings.'''
 +
 
 +
Open the newly created language file and replace the desired phrases with your translations. After making your changes, save the file.
 +
 
 +
Please remember that different features may use language strings from different files, depending on where the functionality is implemented.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|'''2. Now you can enter to your newly created file and easily replace particular sentences.'''<br />
+
|style="padding: 0px 0px 20px 25px;"|[[File:Lang1.png]]
−
For presentation purposes we changed ''['manage header']'' from '' 'Manage' '' to '' 'Ordenar' ''. Don't forget to save the changes.
+
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang2.png]]
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang2.png]]
 
|}
 
|}
 +
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|'''3. Now you can change the language in two ways:<br />
+
|style="padding: 0px 0px 15px 15px;"|
−
*Through changing client's language in your WHMCS system:
+
'''3. Use the built-in Translations Tool (recommended).'''
 +
 
 +
For modules that support the Translations Tool, we strongly recommend using it instead of editing language files manually.
 +
 
 +
The tool automatically collects language strings from '''all supported locations'''.
 +
 
 +
To create a translation:
 +
# Open the module addon.
 +
# Navigate to '''Translations'''.
 +
# Click '''Add Translation'''.
 +
# Select the desired language.
 +
# Save the generated translation and modify any phrases as needed.
 +
 
 +
This approach significantly simplifies translation management, especially in modules that use multiple language sources.
 +
 
 +
For detailed instructions, please refer to the dedicated documentation page: [https://www.docs.modulesgarden.com/Translations_Tool Translations Tool]
 
|}
 
|}
 +
{|
 +
|style="padding: 0px 0px 20px 25px;"|[[File:TR_1.png]]
 +
|}
 +
{|
 +
|style="padding: 0px 0px 15px 15px;"|
 +
'''4. Select the language in WHMCS.'''
 +
 +
There are two ways to display your translation:
 +
 +
* Change the client's language in the WHMCS Admin Area.
 +
|}
 +
 
{|
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang4.png]]
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang4.png]]
 
|}
 
|}
 +
 
{|
 
{|
 
|style="padding: 0px 0px 20px 15px;"|
 
|style="padding: 0px 0px 20px 15px;"|
−
*Through changing language directly in the client area (keep in mind that customers can change their language anytime they want):
+
 
−
|}
+
* Allow clients to change the language directly in the Client Area.
 +
  |}
 +
 
 
{|
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang5.png]]
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang5.png]]
 
|}
 
|}
 +
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|'''4. As you can see on the following screen the header has changed to '' 'Ordenar' '' owing to our changes.  
+
|style="padding: 0px 0px 15px 15px;"|
 +
'''5. Verify the results.'''
 +
 
 +
After switching the language, refresh the page and verify that the translated phrases are displayed correctly.
 
|}
 
|}
 +
 
{|
 
{|
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang3.png]]
 
|style="padding: 0px 0px 20px 25px;"|[[File:Lang3.png]]
 
|}
 
|}
 +
 
{|
 
{|
−
|style="padding: 0px 0px 30px 15px;"|That's all, from now on you shouldn't have any problems with changing language in our modules.
+
|style="padding: 0px 0px 30px 15px;"|
 +
If you encounter any difficulties locating a particular phrase, keep in mind that newer ModulesGarden modules may load language strings from multiple locations, including packages and framework components.
 +
 
 +
If you need any assistance, please contact our support team.
 
|}
 
|}
−
==How To Change Magento Extension Language==
+
 
 +
=How To Debug Module=
 +
'''<span style="color: #ff0000;">If the procedure described below doesn't work for you, please report it to our Support Team.</span>'''
 
{|
 
{|
−
|style="padding: 10px 0px 15px 15px;"|'''1. In order to change Magento extension language follow steps shown below.'''<br />
+
|style="padding: 10px 0px 20px 15px;"|'''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.'''
−
Go to the '' 'your_magento\app\locale\' '' where you can find language files.<br />
+
−
Choose language folder that you desire to translate from and find file bounded to extension.<br />
+
−
For purpose of an example, we will create Polish language file for GPN DATA For Magento .<br />
+
−
Copy '' 'Modulesgarden_Gpndata' '' file from '' 'en_US\' '' folder to '' 'pl_PL\' '' folder.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HCLM_1.png]]
+
|style="padding: 0px 0px 15px 15px;"|To do so, enter the URL you are experiencing the issue with and add an additional parameter''''' '_debug=turnon'. ''''' For example:<br />
 +
yourdomain.com/clientarea.php?action=productdetails&id=81'''&_debug=turnon'''<br />
 +
yourdomain.com/clientarea.php?'''_debug=turnon'''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|'''2. Edit previously created file in '' 'pl_PL\' '' folder. As you can see, each line consists of two phrases.'''<br />
+
|style="padding: 0px 0px 10px 15px;"|To disable debug mode, simply call the same parameter but with value '''''turnoff.''''' For example:<br />
−
First one (underlined with green) is a phrase in English which determines phrase to translate.<br />
+
yourdomain.com/clientarea.php?'''_debug=turnoff'''
−
Second one (underlined with red) is a phrase which will be displayed. On the following screen it is Polish translation for '' 'Gateway URL' ''.
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HCLM_2.png]]
+
|style="padding: 0px 0px 20px 15px;"|'''If you get the error as shown on the screen below, please make sure that you are using the correct parameter and you have sufficient privileges.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|'''3. Log in to your Magento admin area and proceed to the '' 'System' '' → '' 'Configuration' ''.'''<br />
+
|style="padding: 0px 0px 30px 25px;"|[[File:DM1.png]]
−
Choose desired language from '' 'Locale' '' dropdown menu under '' 'Locate Options' '' section as shown on the following screen.<br />
+
−
To see changes that you made, re log in to your account.
+
 
|}
 
|}
 +
 +
=How To Solve Problems With Module License=
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HCLM_3.png]]
+
|style="padding: 10px 0px 20px 15px;"|'''In case you encounter any problems with the license, please read through the below points to find a solution.'''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|4. As you can see on the screen below, the '' 'Gateway URL' '' was replaced by '' 'Adres URL Bramki' '' owing to our changes.
+
|style="padding: 0px 0px 15px 15px;"|1. Make sure your license key applies to the used license. For example:<br/>
 +
*If you had a trial version and then bought a full version (separately), then the license key must be changed.
 +
*If you own a trial version and then upgrade it to a full version, then a trial license key should be used.<br/>
 +
If you want to learn more about upgrades, please follow [https://www.docs.modulesgarden.com/7-Day_Free_Access here].
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HCLM_4.png]]
+
|style="padding: 0px 0px 15px 15px;"|2. Check if ''License_RENAME.php'' file has been removed ''(or renamed)''.<br/>
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 15px;"|That's all, from now on you should not have any problems with changing language in our Magento modules.  
+
|style="padding: 0px 0px 15px 15px;"|3. Make sure your license file content format is correct.<br/>
−
|}
+
Former license format '''(no longer supported)''':
 +
 
 +
<?php
 +
/*
 +
  * LICENSE:
 +
  * Please provide your DNS Manager Module For WHMCS license below
 +
  */
 +
$dns_manager_licensekey="ModulesGarden_DNSManager_xxxxxxxxxxxx";
 +
?>
  
−
==How To Change Magento Admin Theme==
+
'''Current and correct''' license file format:
−
{|
+
 
−
|style="padding: 10px 0px 20px 0px;"|'''Proceed with step listed below in order to upload and enable custom admin panel theme.'''
+
<?php
 +
/*
 +
  * LICENSE:
 +
  * Please provide your DNS Manager Module For WHMCS license below
 +
  */
 +
$dns_manager_licensekey="ModulesGarden_DNSManager_xxxxxxxxxxxx";
 +
 
 +
Please note that the below symbol is no longer used: <pre style="color: red; font-weight:bold;">?></pre>
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 15px;"|'''1. Download desired admin panel theme archive.'''
+
|style="padding: 0px 0px 20px 15px;"|4. Check if your firewall does not block our domain: ''modulesgarden.com.''
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|'''2. Upload and extract the theme archive into the main Magento directory.'''<br />
+
|style="padding: 0px 0px 20px 15px;"|5. If you notice the following error message in your client area: <br/>
−
Files in your Magento directory should look like this.
+
'''"A problem with module occurred. Please contact the administration."'''<br/>
−
|}
+
 
−
{|
+
Then we recommend reissuing your license in the ModulesGarden client area.
−
|style="padding: 0px 0px 20px 25px;"|[[File:G_MAT_1.png]]
+
 
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 15px 15px;"|'''3. Log in to the Magento admin panel, clear cache and proceed to '' 'System' '' → '' 'Configuration' ''.'''<br />
+
−
Now, press '' 'Design' '' under '' 'General' '' section.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:G_MAT_2.png]]
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 15px 15px;"|'''4. Press '' 'Admin Theme' '' and choose a previously uploaded theme from a dropdown menu.'''<br />
+
−
Confirm through pressing '' 'Save Config' ''.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 25px;"|[[File:G_MAT_3.png]]
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 15px 15px;"|'''5. Congratulations, you can enjoy your new admin panel theme!'''
+
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 25px;"|[[File:G_MAT_4.png]]
+
|style="padding: 0px 0px 15px 15px;"|6. In case you see an error: <br/>
−
|}
+
−
=Common Problems With Magento Extensions=
+
−
{|
+
−
|style="padding: 10px 0px 30px 15px;"|'''This section contains tips and tricks of solving problems related to Magento extensions' behaviour.'''
+
−
|}
+
−
==Before Extension's Activation==
+
−
{|
+
−
|style="padding: 10px 0px 30px 15px;"|During the extension activation process we recommend to disable Compiler.<br />
+
−
1. Proceed to '' 'System' '' → '' 'Tools' '' → '' 'Compilation' '' and disable the Compiler.<br />
+
−
2. Install the extension.<br />
+
−
3. Recompile the Magento system.<br />
+
−
4. Activate the Compiler.<br />
+
−
''Note: If you encounter any problems with deactivation of the compiler, simply log into your Magento FTP account and rename '' 'include' '' folder.
+
−
|}
+
−
== After Extension's Activation==
+
−
{|
+
−
|style="padding: 10px 0px 30px 15px;"|If you encounter any problem after activation of our extension, ensure that you:
+
−
1. Cleared the Magento cache under '' 'System' '' → '' 'Cache Management' ''.<br />
+
−
2. Re-logged in to your Magento admin panel.
+
−
|}
+
−
==Other Issues==
+
−
{|
+
−
|style="padding: 10px 0px 30px 15px;"|1'''. Missing logs in '' '/var/log' '' folder. '''<br />
+
−
Solution : Set up '' 'var' '' folder as writable.<br />
+
−
Proceed to '' 'System' '' → '' 'Configuration ' '' → '' 'Developer ' '' and select '' 'Yes' '' from '' 'Enabled' '' dropdown menu under '' 'Log Settings' '' section.
+
−
|}
+
  
−
=How To Debug Module=
+
'''Order Accept Encountered Problems'''<br/>
−
'''<span style="color: #ff0000;">If the procedure described below doesn't work for you, please report this to our Support Team.</span>'''
+
'''License Invalid: MD5 Checksum Verification Failed'''<br/>
−
{|
+
 
−
|style="padding: 10px 0px 20px 15px;"|'''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.'''
+
Make sure all module files are correctly downloaded and installed.  
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|To do so, enter the URL you are experiencing the issue with and add the additional parameter''''' '_debug=turnon' '''''. For example:<br />
+
|style="padding: 0px 0px 20px 15px;"|7. If, despite following all of the above pieces of advice, problems with you license persist, try to reissue your license. <br/>
−
yourdomain.com/clientarea.php?action=productdetails&id=81'''&_debug=turnon'''<br />
+
To to so, log in to our client area, choose a product, and click the 'Reissue License' button located next to your license key. ''
−
yourdomain.com/clientarea.php?'''_debug=turnon'''
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 10px 15px;"|To disable debug mode, simply call the same parameter but with the value '''''turnoff'''''. For example:<br />
+
−
yourdomain.com/clientarea.php?'''_debug=turnoff'''
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 20px 15px;"|'''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.
+
−
|}
+
−
{|
+
−
|style="padding: 0px 0px 30px 25px;"|[[File:DM1.png]]
+
−
|}
+
−
 
+
−
=How To Solve Problems With Module License=
+
−
{|
+
−
|style="padding: 10px 0px 15px 15px;"|'''When you have any problems with module license and you are certain that license key is entered correctly in 'license.php' file, you can reissue it.'''<br />
+
−
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' ''.
+
 
|}
 
|}
 
{|
 
{|
Line 168: Line 189:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 30px 15px;"|If problem with your license persists, please contact our Support.
+
|style="padding: 0px 0px 30px 15px;"|'''In case of further issues, please [https://www.modulesgarden.com/support/ticket/general-support contact our Support Team.]'''
 
|}
 
|}
−
 
−
<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>
 
  
 
=How To Use Configurable Options=
 
=How To Use Configurable Options=
Line 188: Line 206:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|In case those options aren't fitting your needs, you can edit them.<br />
+
|style="padding: 0px 0px 15px 15px;"|In case those options do not suit 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 />
 
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' ''.
 
Its name is '' 'Configurable options for your_product_name' ''.
Line 197: Line 215:
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|Here you can view all products this configurable option group is assigned to.<br />
 
|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 />
+
Now we will show you how to edit options. Let's say you want to add an option to order a product with up to 5 snapshots.<br />
−
To do so, edit '' 'The number of cores per socket' '' by pressing edit button as shown on the screen below.
+
To do so, edit '' 'Snapshots Limit' '' by pressing edit button as shown on the screen below.
 
|}
 
|}
 
{|
 
{|
Line 205: Line 223:
 
{|
 
{|
 
|style="padding: 0px 0px 15px 15px;"|You will see a popup window, so make sure your browser will not block it.<br />
 
|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 />
+
Enter the maximum allowed number of options and save the changes.  
−
Next, press '' 'Save Changes' ''.
+
 
|}
 
|}
 
{|
 
{|
Line 214: Line 231:
 
==Hiding Configurable Options==
 
==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 />
+
|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 the steps below.<br />
−
Firstly, go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Configurable Options' ''.
+
Firstly, go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Configurable Options'.''
 
|}
 
|}
 
{|
 
{|
Line 221: Line 238:
 
|}
 
|}
 
{|
 
{|
−
|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 />
+
|style="padding: 0px 0px 20px 15px;"|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' ''.
+
 
 
|}
 
|}
 
{|
 
{|
Line 230: Line 247:
 
==Setting Up Pricing For Configurable Options==
 
==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 />
+
|style="padding: 10px 0px 20px 15px;"|If you decide to  set up pricing for configurable options, follow the steps described below.
−
Firstly, go to '' 'Setup' '' → '' 'Products/Services' '' → '' 'Configurable Options' ''.
+
 
|}
 
|}
 
{|
 
{|
Line 237: Line 253:
 
|}
 
|}
 
{|
 
{|
−
|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 15px;"|Press the edit icon next to configurable options you want to set the pricing for.
 
|}
 
|}
 
{|
 
{|
Line 243: Line 259:
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 15px 15px;"|Afterwards, you will see a popup window, so make sure your browser will not block it.<br />
+
|style="padding: 0px 0px 10px 15px;"|Afterwards, you will see a popup window, so make sure your browser does 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 />
 
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 />
+
For example, if we have product with monthly and quarterly payments allowed, 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.
 
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 on '' 'Option Type' '', pricing you entered may be counted in various ways.<br />
−
|}
+
'' 'Dropdown' '' - You have to set price for each option.<br />
−
{|
+
'' 'Radio' '' - Same as above, only difference is the display manner.<br />
−
|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 />
 
'' '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.
 
'' '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 30px 25px;"|[[File:HCO9.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 15px;"|On the screen below you can see all configurable options types available on the order form.
 
|}
 
|}
 
{|
 
{|
−
|style="padding: 0px 0px 20px 25px;"|[[File:HCO11.png]]
+
|style="padding: 0px 0px 20px 25px;"|[[File:HCO10.png]]
 
|}
 
|}
 
{|
 
{|
 
|style="padding: 0px 0px 30px 15px;"|Now you should have no problems with understanding and using the configurable options in your WHMCS.
 
|style="padding: 0px 0px 30px 15px;"|Now you should have no problems with understanding and using the configurable options in your WHMCS.
 
|}
 
|}

Latest revision as of 11:07, 11 June 2026


Contents

[edit] How To Change WHMCS Module Language

1. Locate the language files used by the module.

All modules store language strings in one or more langs directories. Depending on the module architecture, translations may be split across several locations, such as:

  • Main module language files
  • Package language files e.g. App Templates (AppCenter)
  • Framework component language files e.g. Buttons, Forms, Tables

Modules with inbuilt packages, like App Templates in Proxmox VE VPS & Cloud module, may contain multiple language files instead of a single english.php file.
In some modules, language strings can still be separated between the main addon and the server-related functionality.
Some features may use language files located inside packages or framework components.

Examples of common language file locations:

  • Main addon language files: /modules/addons/ModuleName/langs/english.php
  • Package language files: /modules/addons/ModuleName/packages/AppCenter/langs/english.php
  • Framework component language files: /modules/addons/ModuleName/components/Button/langs/english.php

Depending on the feature you wish to translate, the required language string may be located in any of the above locations.

2. Edit the language strings.

Open the newly created language file and replace the desired phrases with your translations. After making your changes, save the file.

Please remember that different features may use language strings from different files, depending on where the functionality is implemented.

Lang1.png
Lang2.png

3. Use the built-in Translations Tool (recommended).

For modules that support the Translations Tool, we strongly recommend using it instead of editing language files manually.

The tool automatically collects language strings from all supported locations.

To create a translation:

  1. Open the module addon.
  2. Navigate to Translations.
  3. Click Add Translation.
  4. Select the desired language.
  5. Save the generated translation and modify any phrases as needed.

This approach significantly simplifies translation management, especially in modules that use multiple language sources.

For detailed instructions, please refer to the dedicated documentation page: Translations Tool

TR 1.png

4. Select the language in WHMCS.

There are two ways to display your translation:

  • Change the client's language in the WHMCS Admin Area.
Lang4.png
  • Allow clients to change the language directly in the Client Area.
Lang5.png

5. Verify the results.

After switching the language, refresh the page and verify that the translated phrases are displayed correctly.

Lang3.png

If you encounter any difficulties locating a particular phrase, keep in mind that newer ModulesGarden modules may load language strings from multiple locations, including packages and framework components.

If you need any assistance, please contact our support team.

[edit] How To Debug Module

If the procedure described below doesn't work for you, please report it 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 an 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 value turnoff. For example:

yourdomain.com/clientarea.php?_debug=turnoff

If you 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

[edit] How To Solve Problems With Module License

In case you encounter any problems with the license, please read through the below points to find a solution.
1. Make sure your license key applies to the used license. For example:
  • If you had a trial version and then bought a full version (separately), then the license key must be changed.
  • If you own a trial version and then upgrade it to a full version, then a trial license key should be used.

If you want to learn more about upgrades, please follow here.

2. Check if License_RENAME.php file has been removed (or renamed).
3. Make sure your license file content format is correct.

Former license format (no longer supported): 

<?php
/*
 * LICENSE:
 * Please provide your DNS Manager Module For WHMCS license below
 */
$dns_manager_licensekey="ModulesGarden_DNSManager_xxxxxxxxxxxx";
?>

Current and correct license file format: 

<?php
/*
 * LICENSE:
 * Please provide your DNS Manager Module For WHMCS license below
 */
$dns_manager_licensekey="ModulesGarden_DNSManager_xxxxxxxxxxxx";
Please note that the below symbol is no longer used: 
?>
4. Check if your firewall does not block our domain: modulesgarden.com.
5. If you notice the following error message in your client area:

"A problem with module occurred. Please contact the administration."

Then we recommend reissuing your license in the ModulesGarden client area.

6. In case you see an error:

Order Accept Encountered Problems
License Invalid: MD5 Checksum Verification Failed

Make sure all module files are correctly downloaded and installed.

7. If, despite following all of the above pieces of advice, problems with you license persist, try to reissue your license.

To to so, log in to our client area, choose a product, and click the 'Reissue License' button located next to your license key.

G1.png
In case of further issues, please contact our Support Team.

[edit] How To Use 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.

[edit] 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 do not suit 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 a product with up to 5 snapshots.
To do so, edit 'Snapshots Limit' 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.

Enter the maximum allowed number of options and save the changes.

HCO4.png

[edit] Hiding Configurable Options

If you decide to hide configurable options from a client order form and manage them only from the admin area, follow the 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'.
HCO6.png

[edit] Setting Up Pricing For Configurable Options

If you decide to set up pricing for configurable options, follow the steps described below.
HCO7.png
Press the edit icon next to configurable options you want to set the pricing for.
HCO8.png
Afterwards, you will see a popup window, so make sure your browser does 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 payments allowed, 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.

Depending on 'Option Type' , pricing you entered may be counted in various ways.

'Dropdown' - You have to set price for each option.
'Radio' - Same as above, only difference is the 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.

HCO9.png
On the screen below you can see all configurable options types available on the order form.
HCO10.png
Now you should have no problems with understanding and using the configurable options in your WHMCS.
Retrieved from "https://www.docs.modulesgarden.com/index.php?title=General&oldid=79897"
Navigation
WHMCS Modules
WHMCS Module Bundles
WHMCS Widgets
Tools And Applications
Translations
General
FAQ
Community
General