# Settings
Lagom WHMCS Smart Order Form has been designed to give flexibility for the clients and allow to configure it to specific business needs. Below we will describe all the customization options available in the current version.
# General Settings
# Order Settings
# Disable Order Redirection
Enable this option to prevent automatic redirection from standard WHMCS cart and order pages to the module order pages.
Clients will then see the default WHMCS order page instead of the module order form.
# SEO Title for Product Order Pages
Use this field to define a custom SEO title for product order pages.
The value entered here will replace the default page title and will be displayed in the browser tab and in search engine results.
After saving the setting, the custom title is displayed in the browser tab on product order pages.
# Display Settings
# Hide IP Address Box
Hides the message that displays the client's IP address on the order page.
When this option is enabled, the IP address message is hidden.
# Hide Group Name From Suboption Name
If your option names include the group name (for example: Group 1 - First Option), and you also assign these options to groups in the Lagom Smart Order Form, the group name may appear twice.
Group name is visible twice in the option label.
When the Hide Group Name From Suboption Name option is enabled, it removes the duplicated group name from the option label and keeps the option label shorter.
# Hide Hostname and Root Password Fields
Hides the "Hostname" and "Root Password" fields in the "Server Configuration" section. You can apply this setting to all products or only selected product groups.
# Hide Nameservers Fields
Hides the "NS1 Prefix" and "NS2 Prefix" fields in the "Server Configuration" section. You can apply this setting to all products or only selected product groups.
# Advanced Settings
# Remove Hidden Data from JSON
Removes products and product groups marked as hidden in WHMCS from the JSON data visible in the browser developer tools.
This option is enabled by default. Disable it only if you need to access hidden data in the developer tools.
# Layout Settings
# Product Order Layout Settings
# Display Navigation Tabs
When the "Display Navigation Tabs" option is enabled, the additional navigation tabs are shown below the main header title. The navigation tabs include product groups, which previously must be configured in WHMCS settings (opens new window).
# Package Slider
Decide whether you would like to use a slider to view the content of a product group that contains more than three packages.
Clients can still switch to the "All" view to display all packages at once without horizontal scrolling. In this mode, packages are shown in multiple rows.
# Mark Product Required Fields
Marks required product custom fields configured in WHMCS with a visible "required" label in the "Custom Fields" section of the order form.
# Display Billing Cycle Section Above Products
Displays the billing cycle selection above the product list instead of below it. Use this option if you want customers to choose their preferred billing period before selecting a product.
# Cart Layout Settings
# Promo Code Location in Product Configuration
Controls where the promotion code field is displayed on the product configuration page.
# Below "Configuration Summary" (Show On Click)
Displays a "Have a promo code?" link below the "Configuration Summary" section that reveals the field after clicking.
# Below "Configuration Summary" (Show By Default)
Displays the promotion code input field below the "Configuration Summary" section.
# Above "Product Billing" section
Displays the promotion code field above the "Product Billing" section.
# The order page bottom
Displays the promotion code field at the bottom of the order form.
# Promo Code Location in Checkout
Controls where the promotion code field is displayed on the checkout page.
# Below the "View Cart" table
Displays the promotion code field below the "View Cart" table containing all products and services currently added to the cart.
# Below "Order Summary" (Show On Click)
Displays a "Have a promo code?" link below the "Order Summary" section that reveals the field after clicking.
# Below "Order Summary" (Show By Default)
Displays the promotion code input field below the "Order Summary" section.
# Domain Settings
# Show Domain TLDs Dropdown
Displays a dropdown with available TLDs in the domain search field, allowing clients to select a domain extension before performing a search.
# Show Domain Spotlights
Displays highlighted domain extensions below the domain search field, based on the "Spotlight TLDs" configured in WHMCS settings (opens new window).
When disabled, no domain extensions are shown below the domain search bar.
# Domain Configuration Elements
This option allows you to define the order of elements displayed in the domain configuration section during the ordering process.
You can arrange the available components to control how they appear to the client when configuring a domain. The elements will be displayed in the exact order defined here.
If this field is left empty, the system will use the default WHMCS configuration for the domain configuration layout.
# Domain Configuration Elements (Logged in Users)
This option works the same as the standard Domain Configuration Elements, but applies only to users who are already logged in to their client area.
It allows you to define a separate order of elements displayed in the domain configuration section for authenticated clients.
If this field is left empty, the default WHMCS configuration will be used.
# Hide Domain TLDs Table
Shows or hides the Domain TLDs table on the Domain Search and Domain Transfer pages.
Below is the default view with the table visible.
After enabling the option, the table is no longer displayed.
# Pricing Options
# Main Settings
# Display Price Suffix
Displays the currency suffix next to product prices across the order form.
For example, a price can be shown as $35.88 USD instead of $35.88. The suffix value is defined in your WHMCS currency settings (see documentation (opens new window)).
# Show Included Configuration Costs
Displays prices of configuration options that are already included in the product price.
By default, these prices are visible only on hover. When enabled, they are always visible.
These values are shown for reference only and do not change the final price.
# Product Configuration Page
Default behavior (visible on hover)
After enabling (always visible)
# View Cart Page
Default behavior (visible on hover)
After enabling (always visible)
# Shopping Cart (Top Navigation)
Default behavior (visible on hover)
After enabling (always visible)
# Currency Selector
Controls the visibility of the currency selector on the order page.
Available options:
- Always visible – the selector is always displayed
- Hide selector if one currency is available – the selector is shown only when multiple currencies are configured
- Hide permanently – the selector is never displayed
The currency selector is displayed in the top section of the order page.
# Zero Value Pricing
These options control how prices with a value of 0.00 are displayed in selected parts of the order form.
Each component has its own dropdown, so zero value prices can be controlled separately for each area. Depending on the component, available options may allow you to show the 0.00 value, hide it, or replace it with Free.
The setting is available for the following components:
- Product Packages
- Product Billing Cycles
- Domains
- Product Configurable Options
- Product Addons
The example below shows Zero Value Pricing settings and their effect on the checkout page. In this case, zero value prices for domains and configurable options are displayed as Free.
# Billing Cycles
# Select The Longest Billing Cycle
Selects the longest available billing cycle by default instead of the shortest one.
When the option is disabled, the shortest billing cycle remains selected by default.
# Show Prices Comparison
When enabled, the order form displays the percentage difference between billing cycles to indicate how much the client can save compared to the shortest billing cycle.
# Hide "Select" Buttons
Removes the "Select" buttons from the billing cycle tiles. Clients can still choose a billing cycle by clicking directly on the tile.
Below are examples of both states.
# Billing Cycles Order
Controls the order in which billing cycles are displayed on the product configuration page.
- Ascending – from the shortest period to the longest.
- Descending – from the longest period to the shortest.
# Number of Columns (desktop view)
Choose how many columns are used to display the billing cycle boxes on desktop screens.
You can select 3 columns (default) or 4 columns. This setting applies only to screen widths above 1320px.
# Billing Settings
# Tax and VAT Settings
# Hide VAT Number Field for
Hides the VAT number field during the billing details step for selected countries. When a client selects one of these countries, the VAT number field is not displayed on the order form.
In the example below, the client selected Brazil, so the VAT number field is hidden in the billing details form.
# Billing Fields Settings
# Hide Optional Billing Fields
Hide selected billing fields that are marked as optional in your WHMCS configuration (General Settings > General > Other > Optional Client Profile Fields).
The chosen fields will not be displayed in the billing details section of the client area during the order process.
After saving the setting, the selected optional fields are hidden in the billing details form.
# Personal Information Fields Order
Defines the order of personal information fields displayed in the billing details step.
# Billing Address Fields Order
Defines the order of billing address fields displayed in the billing details step.