Latest revision as of 15:20, 15 May 2026

[edit] About Lagom Smart Order Form For WHMCS

Lagom Smart Order Form For WHMCS is a one of a kind product built to simplify and attract the ordering process at the same time.

You will be granted numerous options to customize the ordering pages, including the division into one or two pages and the choice of page layout.
If integrated with Lagom WHMCS Client Theme, your order pages will boost with some extra, eye pleasing, options.

Client Area:

✔ Unified Multi Product Ordering Flow

✔ Smart Cart-Based Order Process To Place Complete Orders

✔ Responsive Design With Mobile Support

✔ Optimized For Higher Order Conversion Rates

✔ Reduced Shopping Cart Abandonment Rate

✔ Order Process In One Or Two Steps

✔ Designed To Reduce Shopping Cart Abandonment

✔ Order Process In One Or Two Steps

✔ Quick Navigation Between Product Groups

✔ Package Slider To Display Multiple Products

✔ Domains And TLDs Showcased In Spotlights

✔ Suggested Domains List Displayed After Search

✔ Customized Order Fields With HTML Support

✔ Customized Images, Colors And Styles For Configurable Options And Product Addons

✔ Percentage Pricing Comparison Between Billing Cycles

✔ Automatic Currency And Language Selection Based On Geolocation

✔ Prices Discounts Applied Due To Discount Center For WHMCS Integration

✔ Fees And Discounts Applied Due To Payment Gateway Charges For WHMCS Integration

✔ Payment Gateway Assigned Dynamically Due To Payment Gateway Allocator For WHMCS Integration

✔ Support For Ordering Features:

✔ Intuitive Products And Product Group Selection

✔ Adding Products And Product Addons To Shopping Cart

✔ Registering And Transferring Domains

✔ Working With MarketConnect Products

✔ Working With WHMCS Metric Billing

✔ Applying Promo Codes

✔ Changing Billing Cycles

✔ Changing Currency

✔ Customizing Configurable Options

✔ Providing Client And Product Custom Fields

✔ Support For All Payment Gateways

✔ Login With Existing Account Or Creating New One

✔ Quick Shopping Cart Popup:

✔ Preview Cart With Added Items And Their Pricing

✔ Change Item Quantity

✔ Remove Single Items From Cart

✔ Clear Cart

✔ Proceed To Checkout

✔ Compatible With WHMCS Built-in "Twenty-One" Theme And "Lagom WHMCS Client Theme"

Admin Area:

✔ Choose Available Templates:

✔ Order Form Type:

✔ One Step

✔ Two Steps

✔ Package Type:

✔ Default Style

✔ Horizontal

✔ Use Display Manager To Customize Your Order Form:

✔ Manage Configurable Options:

✔ Display In Single Section

✔ Upload Custom Icons To Any Gateway

✔ Add Titles And Descriptions

✔ Select Description Type

✔ Select Display Type

✔ Select Illustration Type

✔ Add Customized Image

✔ Define Color

✔ Select Suboptions Groups

✔ Hide Zero Prices

✔ Manage Product Addons:

✔ Add Customized Image

✔ Select Image Display Form

✔ Define Color

✔ Assign Payment Gateway Icons:

✔ Assign Custom Icons To Gateways

✔ Use Prepared Icons From Library

✔ Upload Custom Icons To Any Gateway

✔ Manage Checkout Order Fields:

✔ Select Order Field Type:

✔ Checkbox

✔ Dropdown

✔ Input Text

✔ Provide Order Field Name And Description

✔ Select Order Field Requirement

✔ Manage Media Library:

✔ Use Default And Upload Custom Images Used In Order Form

✔ Manage Geolocation Settings:

✔ Enable Auto Location Detection Based On Client's Country IP Address

✔ Bypass Client Location Detection Using Specified IP Address

✔ Set Default Currency And Language

✔ Set Custom Currencies And Languages Per Detected Countries

✔ Apply General Settings:

✔ Order Settings:

✔ Disable Order Form Redirection

✔ Set SEO Title For Product Order Pages

✔ Display Settings:

✔ Hide IP Address Box

✔ Hide Group Name From Suboption Name

✔ Hide Hostname And Root Password Fields:

✔ For All Products

✔ For Selected Product Groups

✔ Hide Nameservers Fields:

✔ For All Products

✔ For Selected Product Groups

✔ Advanced Settings:

✔ Remove Hidden Data From JSON

✔ Apply Layout Settings:

✔ Product Order Layout Settings:

✔ Display Navigation Tabs

✔ Display Package Slider

✔ Mark Required Fields

✔ Change Billing Cycle Section Location

✔ Cart Layout Settings:

✔ Select Promotion Code Field Location In Product Configuration

✔ Below "Configuration Summary" (Show On Click)

✔ Below "Configuration Summary" (Show By Default)

✔ Above "Product Billing" sSection

✔ Order Page Bottom

✔ Select Promotion Code Field Location In Checkout

✔ Below "View Cart" Table

✔ Below "Order Summary" (Show By Click)

✔ Below "Order Summary" (Show By Default)

✔ Apply Domain Settings:

✔ Show Domain TLDs Dropdown

✔ Show Domain Spotlights

✔ Select Domain Configuration Elements

✔ Select Domain Configuration Elements (Logged In Users)

✔ Hide Domain TLDs Table

✔ Apply Pricing Options:

✔ Main Settings:

✔ Display Price Suffix

✔ Show Included Configuration Costs

✔ Choose Currency Selector:

✔ Always Displayed

✔ Hide If One Currency Is Available

✔ Hide Permanently

✔ Zero Value Pricing Settings:

✔ Display "0.00" Numeric Value

✔ Display "Free" Phrase

✔ Hide Values Completly (For Configurable Options And Product Addons)

✔ Apply Billing Cycles Settings:

✔ Automatically Select The Longest Billing Cycle

✔ Show Prices Comparison

✔ Hide “Select” Buttons

✔ Select Billing Cycles Order

✔ Select Number Of Columns For Desktop View

✔ Apply Billing Details Settings:

✔ Hide VAT Number Field For Selected Countries

✔ Hide Billing Details Optional Fields

✔ Define Personal Information Fields Order

✔ Define Billing Address Fields Order

✔ View And Manage Orders List With Created Order Fields

✔ Additional Integration With "Lagom Client Theme":

✔ Seamless Layouts Blending

✔ Featured Additional Styles:

✔ Default

✔ Modern

✔ Depth

✔ Futuristic

✔ Five Color Schemes Per Style

General Info:

✔ Fully Integrated With Lagom WHMCS Client Theme 2.4.1 And Later

✔ Integrated With Discount Center For WHMCS For WHMCS - Manage Discounts Applicable To Order Of Defined Combination Of Products

✔ Integrated With Payment Gateway Charges For WHMCS - Include Extra Fees And Discounts Based On Multiple Conditions

✔ Integrated With Payment Gateway Allocator For WHMCS - Apply Dynamic Payment Gateway Selection Based On Defined Rules

✔ Limited Integration With Abandoned Cart For WHMCS For WHMCS

✔ Multi-Language Support

✔ Supports PHP 8.3 Back To PHP 8.1

✔ Supports WHMCS "Twenty-One" Theme

✔ Supports WHMCS V8.13 Back To WHMCS V8.10

✔ InnoDB Engine Must Be Used By WHMCS Tables

✔ Requires ionCube Loader V14 Or Later

✔ Easy Module Upgrade To Open Source Version

[edit] Installation and Configuration

The below instructions will direct you through the whole installation and configuration process of Lagom Smart Order Form For WHMCS.

Do not hesitate, just take a closer look at the screenshots and their descriptions to get clear directives and tips.

[edit] Installation

1. Log in to our client area and download the module.

2. Upload and extract the extension into the main WHMCS directory.

Extracted files in your WHMCS directory should look like this:

3. When you install 'Lagom Smart Order Form' for the first time, you have to rename the 'license_RENAME.php' file.

The file is located in 'modules/addons/LagomOrderForm/license_RENAME.php'. Rename it from 'license_RENAME.php' to 'license.php'.

4. In order to configure your license key, you have to edit the 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 our client area → 'My Products'.

5. Now, set up the 'storage' folder as recursively writable.
This folder is available at 'your_whmcs/modules/addons/LagomOrderForm/'.

Note: The folder permissions depend on your server configuration, please set it to either: 700, 755 or 777.

6. Finally, set the 'htaccess' file rule

Open the 'htaccess' file, you will find it in the main root directory.

7. If you have 'fully friendly rewrite' set up, you will have to paste the below rule underneath 'RewriteBase /' :

   RewriteBase /
   
   #one-step-order
   RewriteRule ^order/(.*)$ order.php?m=OneStepOrder&gid=$1 [L]

Otherwise, create the below rule above the WHMCS rules:

  RewriteBase /
 
  #one-step-order
  RewriteRule ^order/(.*)$ order.php?m=OneStepOrder&gid=$1 [L]

For a WHMCS installation located in a subfolder, you must add the subfolder name before "order/".
For example, if your subfolder is named "store," the modified code would be as follows:

  RewriteBase /
 
  #one-step-order
  RewriteRule ^/order/(.*)$ store/order.php?m=OneStepOrder&gid=$1 [L]

Important note:

If you use WHMCS → System Settings → General Settings → General → Friendly URLs and click Manual Override, please note that WHMCS rewrites the entire .htaccess file.
As a result any Lagom Smart Order Form rewrite rules added inside the WHMCS rewrite block will be removed.
After using Manual Override, always verify your .htaccess file and re-add the Lagom Smart Order Form rewrite rules if necessary.

8. Make sure that all your WHMCS tables use "InnoDB Engine"

Refer to Tips section, point '5 to learn how to change the database tables engine.

*9. This step is optional:

If you are using an NGINX server, it is advised to add the below lines into its configuration file. Otherwise, the module might not work properly.

 location /order {
       rewrite ^/order/(.*)$ /order.php?m=OneStepOrder&gid=$1;
 }
       location /modules/addons/LagomOrderForm/api/ {
       try_files $uri $uri/ /modules/addons/LagomOrderForm/api/index.php?$args;
 }

In some cases the above code might not work well, in that situation, please use the below code instead ("break" added):

 location /order {
       rewrite ^/order/(.*)$ /order.php?m=OneStepOrder&gid=$1 break;
 }
       location /modules/addons/LagomOrderForm/api/ {
       try_files $uri $uri/ /modules/addons/LagomOrderForm/api/index.php?$args;
 }

Remember to adjust the above example to your WHMCS location.

[edit] Activation

10. Now, you have to activate the module in your WHMCS system.

Log in to your WHMCS admin area and proceed to 'System Settings' → 'Addon Modules'.
Afterward, find 'Lagom Smart Order Form' and press the 'Activate' button.

11. In the next step you need to permit access to this module.

To do so, click on the 'Configure' button, tick checkboxes to assign desired admin roles.

12. You have just successfully installed Lagom Smart Order Form For WHMCS!

[edit] Management

Lagom Smart Order Form For WHMCS has been designed to give flexibility for the clients and allow to configure it to specific business needs.
Below we will describe all the available customization options.

[edit] Addon Configuration

[edit] Templates

Begin by navigating to the “Lagom Smart Order Form” addon in your WHMCS admin area, where the “Templates” section will be opened by default.

[edit] Order Form Type

In the 'Order Form Type' section you may choose which of the available order types should be used in the client area. You may choose between three types, these are:

One Step
Two Steps'

For a detailed description with visualization in the client area look below.

The first one, called 'One Step' allows you to decide whether to show all of the product configuration options on a single page only.

Note that at the beginning of the ordering process your client will be able to switch between different product packages within a specific product group.

Client area view:

When the 'Two Steps' option is selected, the order process is divided into two separate steps, where the first one allows you to choose a product to order.
In the second step the configuration options available for the previously selected product are displayed.

Note: It is not possible to switch between products if this order form type is selected.

Client area 'Step 1' view:

Client area 'Step 2' view:

[edit] Package Type

This selection of the 'Template' setting, defines the layout of the product package that will be used. You can choose between two options: 'Default' and 'Horizontal'.

Client area view of the 'Default' package type:

Client area view of the 'Horizontal' package type:

[edit] Display Manager

Lagom 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.

[edit] Configurable Options

Configurable Options management is an advanced tool, which introduces new features to customize and manage WHMCS product configurable options.
You can now configure different configuration layouts for every WHMCS product. Learn how to use its functions in Config Options Manager documentation.

Available management tools are described in a separate article, please refer to the following links:

[edit] Product Addons

Product Addons Manager introduces new options to manage and customize addons created in WHMCS system. You are now able to assign a custom image to every product addon.

Manage Addons:

Image - Assign image to the product addon. This field lists graphics added to the addon in the Media Library.
Illustration Type - You can choose from 4 different illustration types - learn more:
- Default
- Icon
- Illustration
- Small Illustration
Color - Set background color.

[edit] Payment Gateways

The 'Payment Gateway Icons' section is dedicated to super easy customization of your payment gateways.
You can quickly upload new gateway logos and assign them to the order payment gateways with just a few simple clicks.

To successfully upload a gateway logo, follow the steps below:

1. Upload a new icon in the "Icon Library" section

2. Assign newly uploaded graphics to a specific gateway by pressing the "Click to assign icon" box.

[edit] Order Fields

Make your order process legally compliant with any country by adding needed fields to the order. These fields will be displayed below the default WHMCS "Terms of Services" checkbox.

Add/Manage Order Fields:

Type - Choose from 3 different field types:
- Checkbox
- Input Text
- Dropdown

Name - set the field name.

Required - choose whether this field should be required, or not.

Description - provide a more detailed description for the newly created field.

Order fields are located as the last section of the Review & Checkout page:

[edit] Media Library

Upload and manage graphics that can be assigned to configurable options or product addons. This page comes with a set of predefined graphics which you can download from here.

You may fetch the ready package and upload it into the /modules/addons/LagomOrderForm/storage/gallery/ directory. Keep in mind that all the graphics must be located directly under the /gallery/ catalog.

[edit] Geolocation

The Lagom Smart Order Form may smoothly detect the customer's location automatically and display the currency according to the detected country, providing an enhanced user experience.

To use the geolocation feature the most effectively, you need to update your geolocation database. Here you will find out how to do that:

To download the free geolocation database you need to first create an account at the Maxmind portal, the instructions can be found at this site
Log in to your account, proceed to GeoIP2/ GeoLite2 → Download Files, find 'GeoLite2 Country in the table, and download the file in .mmdb format
Find the following file in your module files at /yourWHMCS/modules/addons/LagomOrderForm/app/Integrations/Geolocation/Submodules/GeoIP2/GeoLite2-Country.mmdb directory and overwrite it with the newly downloaded file.

Default Settings

Enable Geolocation - enable to let the module automatically detect the client location and adjust the used language and currency to the location based on the configuration
Custom IP Address - enter an IP address in this field and the module will ignore the client location and use the specified IP address to assign currency and language specific to that location.
Leave this field empty to enable automatic geolocation based on the client's IP address
Deafult Currency - select a currency in this field to be used for countries that do not have a specific currency assigned in the "Country Settings" section. This currency will act as a default option for those countries.
Default Language - select a language in this field to be used for countries that do not have a specific language assigned in the "Country Settings" section. This language will act as a default option for those countries.

Country Settings

Define a specific language and currency per country. If the country is detected as the client location, the dedicated currency and language will be used in the client area.
If you do not set any data per country, default settings will be used. For your comfort, you may use the mass action feature, to assign a single currency or language to numerous countries at once.

[edit] Settings

Navigate to the 'Lagom Smart Order Form' addon, 'Settings' section. There you may manage all the extra layout settings.

[edit] General Settings

Order Settings:

Disable Order Redirection - if enabled, automatic redirection from standard WHMCS cart and order pages will be turned off. When clients use a ready link to e.g. a cart, it will be displayed with a standard WHMCS view.

SEO Title for Product Order Pages - if you want to change the default title tag, enter here a new phrase, it will be visible in the title bar at the top of the browser window in the client area

Display Settings:

Hide IP Address Box - activate this setting to disable the display of the information box containing the client's IP address on the order page

Hide Group Name From Suboption Name - When activated, it will remove the duplicate "group name" from the "option name", for specific "option types"

Hide Hostname and Root Password Fields - by enabling this option, you can prevent the "Hostname" and "Root Password" fields from appearing in the "Configure Server" section of the product configuration.
You have the flexibility to hide these fields:
- For All Products
- For Product Groups - select specific product groups only

Hide Nameservers Fields - activate this feature to hide the "NS1 Prefix" and "NS2 Prefix" fields within the "Configure Server" section of the product configuration.
This guarantees that users will not see these fields when configuring their server settings. You have the flexibility to hide these fields:
- For All Products
- For Product Groups - select specific product groups only

Advanced Settings:

Remove Hidden Data from JSON - activate to ensure that products and their product groups that are labeled as 'Hidden' in WHMCS will be excluded from view within the browser's developer tool.
Note: This option is by default enabled, disable only if you are sure you need to display these data in JSON.

[edit] Layout Settings

Settings dedicated to the order page layout:

Product Order Layout Settings:

Display Navigation Tabs - if this 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.

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 in the case of the 'Sidebar' order layout,
and more than four packages in the case of the 'Bottom' order layout.

Although the 'Slider' option is enabled, your clients still have the option to display all of the packages at once, without the need to scroll them horizontally.
When All option is on, all products in the package are displayed in multiple rows.

Mark Product Required Fields - if enabled, all the obligatory fields to be filled in before continuing will be marked with the 'required' label.
Display Billing Cycle Section Above Products - if enabled, the billing cycle selector is displayed above the products section, allowing clients to choose their billing period first.

Cart Layout Settings:

Promo Code Location in Product Configuration - This option allows to change the location of the promotion field, to display it more prominently.
- 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.

The screen below shows the Below "Configuration Summary" (Show By Default) position:

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.

The screen below shows the standard Promotion Code Field Location set to Below the "View Cart" table position:

[edit] Domain Settings

Show Domain TLDs Dropdown - This option allows the user to enable the domain TLDs selector, which will be shown in the domain search field.
Show Domain Spotlights - Allows you to display "Spotlight TLDs" that have been previously configured in WHMCS settings.
When the "Show Domain Spotlights" option is disabled, no domain TLDs are displayed below the domain search bar.
Domain Configuration Elements - Select specific elements for domain configuration to impose a customized selection and your preferred sequence.
You have the flexibility to define the order in which these elements are presented and specify which of the available elements should be displayed.
If the default WHMCS configuration is your preference, simply leave this field empty to seamlessly adopt the WHMCS standard settings.
Domain Configuration Elements (Logged in Users) - Select the elements for domain configuration for clients who are logged in, and they will be displayed in the specified order.
If you opt for the default WHMCS configuration, you can leave this field empty.
Hide Domain TLDs Table - If enabled, the table with available domain TLDs will be hidden from the order form. Useful when you want to simplify the domain selection step.

Show Domain TLDs Dropdown option enabled:

Show Domain Spotlights - option enabled:

When disabled, no domain extensions are shown below the domain search bar.

Domain Configuration Elements in the client area - custom selection and changed order as defined in the addon

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.
After enabling the option, the table is no longer displayed.

[edit] Pricing Options

Main Settings:

Display Price Suffix - if enabled, the currency suffix is shown next to the price.
However, it is vital to previously configure the currency and its suffix details in your WHMCS admin area settings, based on the video tutorial
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.
Currency Selector - Controls the visibility of the currency selector on the order page; available options:
- Always visible - ensure it remains consistently accessible
- Hide permanently - the selector is never displayed
- Hide selector if one currency is available - the selector is shown only when multiple currencies are configured

The currency selector is displayed in the top section of the order page.

Zero Value Pricing - choose whether to display zero prices as a "Free" label or as a "0.00" numerical representation corresponding with currency format for:

Product Packages
- Show 0.00 values
- Show "Free" instead of 0.00 values

Product Billing Cycles
- Show 0.00 values
- Hide 0.00 values
- Show "Free" instead of 0.00 values

Domains
- Show 0.00 values
- Show "Free" instead of 0.00 values

In the case of configurable options and product addons, you may also completely hide the zero-value prices:

Product Configurable Options
- Show 0.00 values
- Show "Free" instead of 0.00 values
- Hide 0.00 values
  Note: These settings overwrite the 'Hide Zero Price' setting available for a single configurable option.

Product Addons
- Show 0.00 values
- Show "Free" instead of 0.00 values
- Hide 0.00 values

[edit] Billing Cycles

Billing cycles related configuration:

Select The Longest Billing Cycle - When this option is activated, the option with the longest billing cycle will be automatically selected.
Otherwise, the option with the shortest billing cycle will be chosen.

Show Prices Comparison - Display the price difference percentage to show how much the client will save when choosing a given billing cycle in comparison to the shortest one.

Hide “Select” Buttons - When activated, the "Select" button will be removed from the billing cycle tile

Billing Cycles Order - Define whether the product available billing cycle options shall be displayed in an ascending or descending order.

Number of Columns (desktop view) - Choose the number of columns for the billing cycle boxes, you can choose between 3 (default) and 4 columns. This option is applicable only for screen size above 1320px

[edit] Billing Settings

Tax and VAT Settings:

Hide VAT Number Field For - select countries for which the 'VAT Number' field in the account details will be hidden

Billing Fields Settings:

Hide Optional Billing Fields - select any fields, labeled as optional in your WHMCS, to prevent their appearance in the billing details section of the client area.
Personal Information Fields Order - Configure the order in which personal information fields will appear on the checkout
Billing Address Fields Order - Configure the order in which client billing details fields will appear on the checkout

[edit] Orders

Open this section to view a complete list of orders placed in your client area with the Lagom Smart Order Form module.

Order List

View the orders list directly from the addon module. The list includes all the details such as: order number, date of placement, client name payment details and status.
You may clear the list by deleting single orders. Note that the entry is removed from the addon only, the real order in WHMCS in no way changed.

Order Details - Press the "Details" icon to see all the information on the additional order fields.

[edit] Client Area

An exemplary ordering process in the client area where the 'Twenty-One' theme is used in the WHMCS system.

Important: It is possible to use the Lagom Smart Order Form For WHMCS module without the Lagom WHMCS Client Theme. The module remains fully usable and all available features are supported when the standard WHMCS "Twenty-One" theme is used.
The only limitation concerns the number of supported styles and their color schemes. For "Twenty-One" theme, the "Modern" style with "blue" color scheme is used by default and there are no extra options to choose from.

Take a look below to see what such ordering pages may look like.

Here you can see an example of a "One Step" order form view with 'Default' package type.

The next example illustrates the "Two Steps" order form view.

In this option, the first step is dedicated to selecting product packages:

In the second step, the rest of order configuration takes place.

[edit] Multi Product Support

Lagom Smart Order Form allows customers to build one order from multiple items during the same ordering process. Products, domains, and addons can be added one after another and reviewed together before checkout.

On the product configuration page, the Configuration Summary sidebar shows the current configuration, while Quick Shopping Cart provides an overview of all items already added to the cart

After selecting a product, its configuration will appear in the Configuration Summary panel on the right side. You can define domain options, add-ons, and other settings for that product.

When ready, choose one of the following buttons:

Add to Cart – adds the current configuration to the cart and keeps the customer on the current page.

Buy Now – adds the current configuration to the cart and opens checkout immediately.

Reset Configuration - clears the current selection and restores the initial state after confirmation.

Once a selected product has been added using the Add to Cart button, customers can:

Continue shopping and select another product or group - the current product configuration resets, and the newly selected product options will appear. Previously added items remain stored in the cart.

Proceed to checkout at any time - all previously added items stay safely in the cart.

Reset the product configuration to start a new selection.

Leave the order form and return later - the cart contents will remain unchanged.

Click the cart icon at the top right corner to open the Shopping Cart Preview.

Quick Shopping Cart is the cart preview available from the View Cart item in the top navigation. It allows customers to check the current cart content without leaving the page they are currently using.
It is the main element that supports Multi Product Ordering. Customers can continue configuring more items and open Quick Shopping Cart whenever they want to review what has already been added.

1. Order Items
This live preview displays all items in the cart (these can include products, domains, and product addons) along with their prices and basic details.
Product addons are displayed as separate rows directly below the related product. An additional description helps identify which product the addon belongs to. This is especially useful when the cart contains more than one service.

2. Hidden Details
To keep the panel compact, additional details are hidden by default. A counter such as +6 or +2 shows how many related elements are hidden for a selected item.
After expanding the item, the panel displays related details such as configurable options or domain registration addons.

3. Remove Actions
Quick Shopping Cart allows removing a single item or clearing the entire cart. Both actions are available directly in the panel, so the order can be adjusted without opening a separate cart page.

4. Quantity
If a product or addon supports quantity in WHMCS, Quick Shopping Cart shows quantity controls directly in the panel.
Changing the quantity does not change the unit price.
It only changes the final amount for the selected item and the current cart total.

5. Total Due Today
Quick Shopping Cart shows a simplified Total Due Today summary, which presents the current amount due for the cart content.
If a promotion code is applied, the discount is shown as a separate row. The final amount is then displayed after the discount, together with the original crossed-out price.
The VAT label shown next to Total Due Today depends on the customer context. For example, the amount may be displayed as (ex. VAT) or (inc. VAT) depending on whether the customer is logged in and how tax is calculated.

When ready, proceed to the Review & Checkout page to confirm your order.

Checkout completes the Multi Product Ordering flow. After products, domains, and addons are added earlier in the process, this page shows the full order in one place before payment.

Here, you can:

Review product details and prices,

Apply a promo code,

Modify quantities or remove items,

Finalize the checkout process.

[edit] Addtional Information

[edit] Custom Hooks

This section includes a list of supported by the module custom hooks.

LagomOrderFormProductsList - allows you to modify the list of products that will be displayed to the customer.

Exemplary usage:

add_hook('LagomOrderFormProductsList',1,  function($productsList){
return $productsList;
});

ShoppingCartValidateProductUpdate - allows you to include your own validation and error messages when a product in the shopping cart is being updated.

Exemplary usage:

add_hook('ShoppingCartValidateProductUpdate', 1, function($vars) {
    return [
        'Error message feedback error 1',
        'Error message feedback error 2',
    ];
});

[edit] Editing Module Files

You are allowed to modify three types of module files, these are: JS, TPL and CSS files

The JS files are compiled files which means that they are all bundled into one file. Consequently, if you decide to make any changes in a JS file, you have to additionally take one of the below-described steps to see your changes:

1. Debug
The module has a built-in system that allows you to build JS ad-hoc, to do this you need to create a .debug file (the dot at the beginning is required) in the /modules/addons/LagomOrderForm directory.
Then you can edit the JS files, and the changes will be visible in the page source.

2. Build
If you choose this method, you have to pack all the files into one. Thanks to that, the page loads faster because HTML contains less code and JS is loaded as a separate file.
Required files:

package-lock.json
gulpfile.js

Please contact us and we will provide you with the necessary files!

Next, upload these files into the main WHMCS directory and run the command:

 docker run --rm -v $(pwd):/srv  huli/gulp build

Note: Before you run the above command you must install docker in your system.
In case you do not want to use docker, you may simply install gulp with nodejs and run the following command:

gulp build

[edit] Tips

1. Adding a new language.

If you want to change the WHMCS module language, go to the following folder:

  /modules/addons/LagomOrderForm/langs

Copy english.php file and rename the newly copied directory with your desired language, for example italian.php. Then, open your personalized file now and replace particular sentences.

2. The module supports language Overrides.

The language file english.php is uncoded and can be freely modified. However, it is advised not to change this file itself, it is recommended to use overrides so the changes persist through module updates.

Open the overrides within the ~/lang/ directory.
Next, create or copy the language file you are going to change. If you want to, for example, create an override for the English language, you will have to create the following directory:

 ~/lang/overrides/english.php.

Open the just created file to edit its content.
At the top of the file you must point the used code, for example: <?php for PHP code.
Change the file content according to your needs. You may enter only single variables to be overridden or change all the lines in the language file.

For example:

~/lang/english.php:

$_LANG['order_new_product'] = 'You’re almost there! Complete your order';

~/lang/overrides/english.php:

 $_LANG['order_new_product'] = 'Complete the order';

3. Additional URLs used as direct shopping cart links.

Linking to WHMCS with additional URLs is supported by the module, yet only the two below formats are allowed, make sure you do not use any other format:

&promocode:

?promocode=testcode
promocode/testcode

&billingcycle:

?billingcycle=annually
billingcycle/annually

&addons:

?addons=10,22
addons/10,22

Exemplary supported links with additional variables used:

https://yourcompany.net/order/my-product/1/?billingcycle=biennially
https:/yourcompany.net/order/my-product/1/billingcycle/biennially

4. The module supports URLs leading to a product page with specified configurable options and currency.

Exemplary URL:

 https://mycompany.net/order/dedicated-servers/8?configoption[1]=5

Where:

configOption[1] - stands for the configurable option name
5 - value, e.g. ID configurable option value

Exemple 2:

 https://mycompany.net/order/dedicated-servers/8?domain=mytestdomain.com

Where:

domain - required parameter
mytestdomain.com - target domain name to search

5. The module requires the InnoDB Engine to be used by the WHMCS database table. Check how to change the database engine:

Log in cPanel and open phpMyAdmin.
Look at the column on the left, you will find there a list of database tables, select the one whose storage engine you are going to change.
Click on the "Operations" tab.
Find the "Storage Engine" option under the "Table options".
Select the InnoDB engine from the dropdown menu.
Press "GO" to save the changes.

Alternatively, you may run the below SQL query after selecting the desired database from phpMyAdmin (step "2").

ALTER TABLE `table_name` ENGINE = InnoDB

After the query has been successfully executed, the database engine of the selected database table will be changed to "InnoDB".

Note: In case you need a more detailed instruction with step by step illustrations, please refer to this article.

[edit] Update Instructions

An essential guidance through the process of updating the module is offered here.

Make sure that the Lagom Smart Order Form version, which you are going to install, is compatible with your WHMCS and Lagom WHMCS Client Theme installations!

Create a backup copy of your WHMCS files and database.
Download the latest version of the module from our client area
Remove all the files of the previous module version from the WHMCS root directory (except the license.php file).
Extract the `.zip` folder that has been downloaded from the client area.
Upload the `/php71+/` content to your FTP server.
Make sure that during the upload process all the files have been correctly uploaded and no errors occurred.
Clear your browser and server cache (for example Cloudflare).
Clear the WHMCS template cache in: Utilities → System → System Cleanup → "Go" → "Empty Template Cache".

[edit] Uninstallation Process

If you no longer wish to use Lagom Smart Order Form For WHMCS, you may safely uninstall the module.

To successfully and safely remove the module from your system, follow these steps:

Deactivate the addon module: Navigate to System Settings → Addon Modules, and find Lagom Smart Order Form. Click on Deactivate.
Remove all tables that begin with LagomOrderForm_ from the database.
Next, delete all the listed below files:
- The folder containing the Lagom Smart Order Form module: modules/addons/LagomOrderForm
- The order.php file.
Finally, remove the RewriteBase rule that you must have added to the htaccess file
(For additional information, please refer to the details provided in points 7 and 8 of the installation instructions)

That's it! The module is now completely uninstalled.

[edit] Upgrade Guide

Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?
There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.

Opt for the Open Source version of your Lagom Smart Order Form For WHMCS module to unlock these benefits.
Simply click on either the Get Source Code or Upgrade To Lifetime button found on the product's page in our client area to complete the one-step upgrade process, with a dedicated discount already applied.

Follow a comprehensive guide covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.

[edit] Common Problems

1. When you have problems with connection, check whether your SELinux or firewall does not block ports.

2. Third-party modules that manipulate or affect the ordering process pages will NOT be compatible with Lagom Smart Order Form For WHMCS.
Lagom Smart Order Form For WHMCS is a separate module, it works independently and it is NOT based on any default WHMCS order process template.

The module is not yet compatible with the following modules from ModulesGarden offer:

Domain Orders Extended For WHMCS
Resellers Center For WHMCS
Multibrand For WHMCS
Client Area Designer For WHMCS (this integration is not scheduled)
SMS Center For WHMCS
Product Free Trial Manager For WHMCS
Recurring Contract Billing For WHMCS (integration might be limited)

3. Error 404/403 when accessing the order process.

Reason: This issue might occur when the Lagom Smart Order Form installation was not completed correctly or some required files are missing from your environment.
Solutions:

Verify that the rewrite rules in your .htaccess file have been added correctly. Follow the steps described in the Installation Documentation.
Make sure all required files are uploaded:
- Reupload the templates and modules directories
- Reupload the order.php file
- Place them in the main WHMCS directory on your server

4. Quick Cart Popup Does Not Work.

Reason: This issue may occur if the "View Cart" menu item has been renamed or modified, which prevents it from being detected correctly.
Solutions:

Using Lagom WHMCS Client Theme:
- Go to the RSThemes addon
- Open the Menu tab
- Navigate to the Secondary menu section
- Locate the "View Cart" item
- Expand Menu Item Display Settings
- Add the following class in Custom Classes: nav-item-cart
Without Lagom WHMCS Client Theme
- If you are using a custom menu, modified or another theme, you need to manually update the "View Cart" item and add the required class: nav-item-cart.

@@ Line 1: / Line 1: @@
 <meta name="keywords" content="lagom smart order form for whmcs, whmcs lagom smart order form configuration, whmcs lagom smart order form management, whmcs lagom smart order form installation, whmcs lagom smart order form common problems, about whmcs lagom smart order form, whmcs lagom smart order form documentation, whmcs lagom smart order form faq, whmcs lagom smart order form help, whmcs lagom smart order form guide, whmcs lagom smart order form wiki, whmcs lagom smart order form tutorial, whmcs lagom smart order form tips, whmcs lagom smart order form wiki"></meta>
 <meta name="description" content="ModulesGarden Wiki Contains All The Information You Need About The Lagom Smart Order Form For WHMCS Module."></meta>
-<h4 style="color: #ff0000; font-weight:bold; text-align:center;">
-This article applies to module version <strong>1.2.9</strong>, which is the latest stable release.<br/>
-Documentation for the latest <strong>1.3.0 beta</strong> version will be made publicly available soon.
-</h4>
 =About [https://www.modulesgarden.com/products/whmcs/lagom-smart-order-form Lagom Smart Order Form For WHMCS]=
 {|
 |style="padding: 10px 0px 5px 0px;"|'''Lagom Smart Order Form For WHMCS''' is a one of a kind product built to simplify and attract the ordering process at the same time.<br/>
-You will be granted numerous options to customize the ordering pages, including the division into one or two pages and choose the page layout. <br/>
+You will be granted numerous options to customize the ordering pages, including the division into one or two pages and the choice of page layout. <br/>
 If integrated with [https://lagom.rsstudio.net/products/client-theme Lagom WHMCS Client Theme], your order pages will boost with some extra, eye pleasing, options.
 |}
-'''This features list is applicable to module version 1.2.9'''
 *'''Client Area:'''
 {|
-|style="padding: 10px 0px 0px 30px;"|✔ Completely Redesigned Order Process
+|style="padding: 10px 0px 0px 30px;"|✔ Unified Multi Product Ordering Flow
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Attractive And Customized "Modern" Layout
+|style="padding: 0px 0px 0px 30px;"|✔ Smart Cart-Based Order Process To Place Complete Orders
 |}
 {|
@@ Line 26: / Line 19: @@
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Improved Order Conversion Rate
+|style="padding: 0px 0px 0px 30px;"|✔ Optimized For Higher Order Conversion Rates
 |}
 {|
 |style="padding: 0px 0px 0px 30px;"|✔ Reduced Shopping Cart Abandonment Rate
+|}
+{|
+|style="padding: 0px 0px 0px 30px;"|✔ Order Process In One Or Two Steps
+|}
+{|
+|style="padding: 0px 0px 0px 30px;"|✔ Designed To Reduce Shopping Cart Abandonment
 |}
 {|
@@ Line 42: / Line 41: @@
 {|
 |style="padding: 0px 0px 0px 30px;"|✔ Domains And TLDs Showcased In Spotlights
+|}
+{|
+|style="padding: 0px 0px 0px 30px;"|✔ Suggested Domains List Displayed After Search
 |}
 {|
@@ Line 50: / Line 52: @@
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Percentage Pricing Comparison Of Billing Cycles To The Shortest One
+|style="padding: 0px 0px 0px 30px;"|✔ Percentage Pricing Comparison Between Billing Cycles
 |}
 {|
@@ Line 60: / Line 62: @@
 {|
 |style="padding: 0px 0px 0px 30px;"|✔ Fees And Discounts Applied Due To [https://www.modulesgarden.com/products/whmcs/payment-gateway-charges Payment Gateway Charges For WHMCS] Integration
+|}
+{|
+|style="padding: 0px 0px 0px 30px;"|✔ Payment Gateway Assigned Dynamically Due To [https://www.modulesgarden.com/products/whmcs/payment-gateway-allocator Payment Gateway Allocator For WHMCS] Integration
 |}
 {|
@@ Line 101: / Line 106: @@
 |}
 {|
-|style="padding: 0px 0px 10px 30px;"|✔ Compatible With WHMCS Built-in "Twenty-One" Theme And [https://lagom.rsstudio.net/products/client-theme "Lagom WHMCS Client Theme"]
+|style="padding: 0px 0px 0px 30px;"|✔ Quick Shopping Cart Popup:
 |}
-*'''Admin Area:'''
 {|
-|style="padding: 10px 0px 0px 30px;"|✔ Choose Available Templates:
+|style="padding: 0px 0px 0px 45px;"|✔ Preview Cart With Added Items And Their Pricing
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Order Form Type:
+|style="padding: 0px 0px 0px 45px;"|✔ Change Item Quantity
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ One Step
+|style="padding: 0px 0px 0px 45px;"|✔ Remove Single Items From Cart
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Two Steps
+|style="padding: 0px 0px 0px 45px;"|✔ Clear Cart
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Step By Step (Coming Soon)
+|style="padding: 0px 0px 0px 45px;"|✔ Proceed To Checkout
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Order Form Layout
+|style="padding: 0px 0px 10px 30px;"|✔ Compatible With WHMCS Built-in "Twenty-One" Theme And [https://lagom.rsstudio.net/products/client-theme "Lagom WHMCS Client Theme"]
 |}
+*'''Admin Area:'''
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Sidebar Summary
+|style="padding: 10px 0px 0px 30px;"|✔ Choose Available Templates:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Bottom Summary
+|style="padding: 0px 0px 0px 45px;"|✔ Order Form Type:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Package Type:
+|style="padding: 0px 0px 0px 60px;"|✔ One Step
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Default Style
+|style="padding: 0px 0px 0px 60px;"|✔ Two Steps
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Horizontal
+|style="padding: 0px 0px 0px 45px;"|✔ Package Type:
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Apply General Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Default Style
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Order Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Horizontal
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Disable Order Form Redirection
+|style="padding: 0px 0px 0px 30px;"|✔ Use Display Manager To Customize Your Order Form:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Enable WHMCS "View Cart" Page
+|style="padding: 0px 0px 0px 45px;"|✔ Manage Configurable Options:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Set SEO Title For Product Order Pages
+|style="padding: 0px 0px 0px 60px;"|✔ Display In Single Section
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Display Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Upload Custom Icons To Any Gateway
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Hide IP Address Box
+|style="padding: 0px 0px 0px 60px;"|✔ Add Titles And Descriptions
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Hide Group Name From Suboption Name
+|style="padding: 0px 0px 0px 60px;"|✔ Select Description Type
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Hide Hostname And Root Password Fields:
+|style="padding: 0px 0px 0px 60px;"|✔ Select Display Type
 |}
 {|
-|style="padding: 0px 0px 0px 75px;"|✔ For All Products
+|style="padding: 0px 0px 0px 60px;"|✔ Select Illustration Type
 |}
 {|
-|style="padding: 0px 0px 0px 75px;"|✔ For Selected Product Groups
+|style="padding: 0px 0px 0px 60px;"|✔ Add Customized Image
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Hide Nameservers Fields:
+|style="padding: 0px 0px 0px 60px;"|✔ Define Color
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ For All Products
+|style="padding: 0px 0px 0px 60px;"|✔ Select Suboptions Groups
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ For Selected Product Groups
+|style="padding: 0px 0px 0px 60px;"|✔ Hide Zero Prices
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Advanced Settings:
+|style="padding: 0px 0px 0px 45px;"|✔ Manage Product Addons:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Remove Hidden Data From JSON
+|style="padding: 0px 0px 0px 60px;"|✔ Add Customized Image
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Apply Layout Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Select Image Display Form
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ General Layout Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Define Color
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Select Order Fields Location
+|style="padding: 0px 0px 0px 45px;"|✔ Assign Payment Gateway Icons:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Product Order Layout Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Assign Custom Icons To Gateways
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Display Navigation Tabs
+|style="padding: 0px 0px 0px 60px;"|✔ Use Prepared Icons From Library
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Use Simplified Order Summary
+|style="padding: 0px 0px 0px 60px;"|✔ Upload Custom Icons To Any Gateway
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Display Package Slider
+|style="padding: 0px 0px 0px 45px;"|✔ Manage Checkout Order Fields:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Mark Required Fields
+|style="padding: 0px 0px 0px 60px;"|✔ Select Order Field Type:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Cart Layout Settings:
+|style="padding: 0px 0px 0px 75px;"|✔ Checkbox
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Select Promotion Code Field Location
+|style="padding: 0px 0px 0px 75px;"|✔ Dropdown
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Select Promotion Code Field Location - "View Cart" Mode
+|style="padding: 0px 0px 0px 75px;"|✔ Input Text
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Apply Domain Search Box Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Provide Order Field Name And Description
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Show Domain TLDs Dropdown
+|style="padding: 0px 0px 0px 60px;"|✔ Select Order Field Requirement
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Show Domain Spotlights
+|style="padding: 0px 0px 0px 45px;"|✔ Manage Media Library:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Domain Configuration Elements
+|style="padding: 0px 0px 0px 60px;"|✔ Use Default And Upload Custom Images Used In Order Form
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Domain Configuration Elements (Logged In Users)
+|style="padding: 0px 0px 0px 45px;"|✔ Manage Geolocation Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Apply Pricing Options:
+|style="padding: 0px 0px 0px 60px;"|✔ Enable Auto Location Detection Based On Client's Country IP Address
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Main Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Bypass Client Location Detection Using Specified IP Address
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Display Price Suffix
+|style="padding: 0px 0px 0px 60px;"|✔ Set Default Currency And Language
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Choose Currency Selector:
+|style="padding: 0px 0px 0px 60px;"|✔ Set Custom Currencies And Languages Per Detected Countries
 |}
 {|
-|style="padding: 0px 0px 0px 75px;"|✔ Always Displayed
+|style="padding: 0px 0px 0px 30px;"|✔ Apply General Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 75px;"|✔ Hide If One Currency Is Available
+|style="padding: 0px 0px 0px 45px;"|✔ Order Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 75px;"|✔ Hide Permanently
+|style="padding: 0px 0px 0px 60px;"|✔ Disable Order Form Redirection
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Zero Value Pricing Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Set SEO Title For Product Order Pages
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Display "0.00" Numeric Value
+|style="padding: 0px 0px 0px 45px;"|✔ Display Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Display "Free" Phrase
+|style="padding: 0px 0px 0px 60px;"|✔ Hide IP Address Box
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Hide Values Completly (For Configurable Options And Product Addons)
+|style="padding: 0px 0px 0px 60px;"|✔ Hide Group Name From Suboption Name
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Apply Billing Cycles Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Hide Hostname And Root Password Fields:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Automatically Select The Longest Billing Cycle
+|style="padding: 0px 0px 0px 75px;"|✔ For All Products
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Show Prices Comparison
+|style="padding: 0px 0px 0px 75px;"|✔ For Selected Product Groups
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Hide “Select” Buttons
+|style="padding: 0px 0px 0px 60px;"|✔ Hide Nameservers Fields:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Billing Cycles Order
+|style="padding: 0px 0px 0px 75px;"|✔ For All Products
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Number Of Columns For Desktop View
+|style="padding: 0px 0px 0px 75px;"|✔ For Selected Product Groups
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Apply Billing Details Settings:
+|style="padding: 0px 0px 0px 45px;"|✔ Advanced Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Hide VAT Number Field For Selected Countries
+|style="padding: 0px 0px 0px 60px;"|✔ Remove Hidden Data From JSON
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Hide Billing Details Optional Fields
+|style="padding: 0px 0px 0px 30px;"|✔ Apply Layout Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Define Personal Information Fields Order
+|style="padding: 0px 0px 0px 45px;"|✔ Product Order Layout Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Define Billing Address Fields Order
+|style="padding: 0px 0px 0px 60px;"|✔ Display Navigation Tabs
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Apply CAPTCHA Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Display Package Slider
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Enable hCaptcha Support
+|style="padding: 0px 0px 0px 60px;"|✔ Mark Required Fields
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Protection:
+|style="padding: 0px 0px 0px 60px;"|✔ Change Billing Cycle Section Location
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ For All Users
+|style="padding: 0px 0px 0px 45px;"|✔ Cart Layout Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ For Unlogged Users Only
+|style="padding: 0px 0px 0px 60px;"|✔ Select Promotion Code Field Location In Product Configuration
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Disabled
+|style="padding: 0px 0px 0px 75px;"|✔ Below "Configuration Summary" (Show On Click)
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Pages For Protection:
+|style="padding: 0px 0px 0px 75px;"|✔ Below "Configuration Summary" (Show By Default)
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Client Registration
+|style="padding: 0px 0px 0px 75px;"|✔ Above "Product Billing" sSection
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Contact Form
+|style="padding: 0px 0px 0px 75px;"|✔ Order Page Bottom
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Domain Checker
+|style="padding: 0px 0px 0px 60px;"|✔ Select Promotion Code Field Location In Checkout
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Login Forms
+|style="padding: 0px 0px 0px 75px;"|✔ Below "View Cart" Table
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Shopping Cart Checkout
+|style="padding: 0px 0px 0px 75px;"|✔ Below "Order Summary" (Show By Click)
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Ticket Submission
+|style="padding: 0px 0px 0px 75px;"|✔ Below "Order Summary" (Show By Default)
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ View And Manage Orders List With Created Order Fields
+|style="padding: 0px 0px 0px 45px;"|✔ Apply Domain Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Customize Payment Gateways
+|style="padding: 0px 0px 0px 60px;"|✔ Show Domain TLDs Dropdown
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Assign Custom Icons To Gateways
+|style="padding: 0px 0px 0px 60px;"|✔ Show Domain Spotlights
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Use Prepared Icons From Library
+|style="padding: 0px 0px 0px 60px;"|✔ Select Domain Configuration Elements
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Upload Custom Icons To Any Gateway
+|style="padding: 0px 0px 0px 60px;"|✔ Select Domain Configuration Elements (Logged In Users)
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Add And Manage Custom Order Fields:
+|style="padding: 0px 0px 0px 60px;"|✔ Hide Domain TLDs Table
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Order Field Type:
+|style="padding: 0px 0px 0px 45px;"|✔ Apply Pricing Options:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Checkbox
+|style="padding: 0px 0px 0px 60px;"|✔ Main Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Dropdown
+|style="padding: 0px 0px 0px 75px;"|✔ Display Price Suffix
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Input text
+|style="padding: 0px 0px 0px 75px;"|✔ Show Included Configuration Costs
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Provide Order Field Name And Description
+|style="padding: 0px 0px 0px 75px;"|✔ Choose Currency Selector:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Order Field Requirement
+|style="padding: 0px 0px 0px 90px;"|✔ Always Displayed
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Manage Configurable Options:
+|style="padding: 0px 0px 0px 90px;"|✔ Hide If One Currency Is Available
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Display In Single Section
+|style="padding: 0px 0px 0px 90px;"|✔ Hide Permanently
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Add Titles And Descriptions
+|style="padding: 0px 0px 0px 75px;"|✔ Zero Value Pricing Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Description Type
+|style="padding: 0px 0px 0px 90px;"|✔ Display "0.00" Numeric Value
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Display Type
+|style="padding: 0px 0px 0px 90px;"|✔ Display "Free" Phrase
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Illustration Type
+|style="padding: 0px 0px 0px 90px;"|✔ Hide Values Completly (For Configurable Options And Product Addons)
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Add Customized Image
+|style="padding: 0px 0px 0px 45px;"|✔ Apply Billing Cycles Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Define Color
+|style="padding: 0px 0px 0px 60px;"|✔ Automatically Select The Longest Billing Cycle
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Suboptions Groups
+|style="padding: 0px 0px 0px 60px;"|✔ Show Prices Comparison
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Hide Zero Prices
+|style="padding: 0px 0px 0px 60px;"|✔ Hide “Select” Buttons
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Manage Product Addons:
+|style="padding: 0px 0px 0px 60px;"|✔ Select Billing Cycles Order
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Add Customized Image
+|style="padding: 0px 0px 0px 60px;"|✔ Select Number Of Columns For Desktop View
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Select Image Display Form
+|style="padding: 0px 0px 0px 45px;"|✔ Apply Billing Details Settings:
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Define Color
+|style="padding: 0px 0px 0px 60px;"|✔ Hide VAT Number Field For Selected Countries
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Manage Media Library:
+|style="padding: 0px 0px 0px 60px;"|✔ Hide Billing Details Optional Fields
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Upload And Remove Custom Images Used In Order Form
+|style="padding: 0px 0px 0px 60px;"|✔ Define Personal Information Fields Order
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Manage Geolocation Settings:
+|style="padding: 0px 0px 0px 60px;"|✔ Define Billing Address Fields Order
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Enable Auto Location Detection Based On Client's Country IP Address
+|style="padding: 0px 0px 0px 45px;"|✔ View And Manage Orders List With Created Order Fields
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Bypass Client Location Detection Using Specified IP Address
+|style="padding: 0px 0px 0px 45px;"|✔ Additional Integration With "Lagom Client Theme":
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Set Default Currency And Language
+|style="padding: 0px 0px 0px 60px;"|✔ Seamless Layouts Blending
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Set Custom Currencies And Languages Per Detected Countries
+|style="padding: 0px 0px 0px 60px;"|✔ Featured Additional Styles:
 |}
 {|
-|style="padding: 0px 0px 0px 30px;"|✔ Additional Integration With "Lagom Client Theme":
+|style="padding: 0px 0px 0px 75px;"|✔ Default
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Seamless Layouts Blending
+|style="padding: 0px 0px 0px 75px;"|✔ Modern
 |}
 {|
-|style="padding: 0px 0px 0px 45px;"|✔ Featured Additional Styles:
+|style="padding: 0px 0px 0px 75px;"|✔ Depth
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Default
+|style="padding: 0px 0px 0px 75px;"|✔ Futuristic
 |}
 {|
-|style="padding: 0px 0px 0px 60px;"|✔ Modern
+|style="padding: 0px 0px 10px 60px;"|✔ Five Color Schemes Per Style
-|}
-{|
-|style="padding: 0px 0px 0px 60px;"|✔ Depth
-|}
-{|
-|style="padding: 0px 0px 0px 60px;"|✔ Futuristic
-|}
-{|
-|style="padding: 0px 0px 10px 45px;"|✔ Five Color Schemes Per Style
 |}
@@ Line 466: / Line 462: @@
 {|
-|style="padding: 10px 0px 0px 30px;"|✔ Fully Integrated With [https://lagom.rsstudio.net/products/client-theme/ Lagom WHMCS Client Theme 2.1.0] And Later
+|style="padding: 10px 0px 0px 30px;"|✔ Fully Integrated With [https://lagom.rsstudio.net/products/client-theme/ Lagom WHMCS Client Theme 2.4.1] And Later
 |}
 {|
@@ Line 473: / Line 469: @@
 {|
 |style="padding: 0px 0px 0px 30px;"|✔ Integrated With [https://www.modulesgarden.com/products/whmcs/payment-gateway-charges Payment Gateway Charges For WHMCS] - Include Extra Fees And Discounts Based On Multiple Conditions
+|}
+{|
+|style="padding: 0px 0px 0px 30px;"|✔ Integrated With [https://www.modulesgarden.com/products/whmcs/payment-gateway-allocator Payment Gateway Allocator For WHMCS] - Apply Dynamic Payment Gateway Selection Based On Defined Rules
 |}
 {|
@@ Line 496: / Line 495: @@
 |}
 {|
-|style="padding: 0px 0px 30px 30px;"|✔ Easy [https://www.docs.modulesgarden.com/How_To_Upgrade_WHMCS_Module Module Upgrade] To [https://www.modulesgarden.com/products/whmcs/lagom-smart-order-form#open-source-version Open Source Version]
+|style="padding: 0px 0px 30px 30px;"|✔ Easy [https://www.docs.modulesgarden.com/How_To_Upgrade_WHMCS_Module Module Upgrade] To [https://www.modulesgarden.com/products/whmcs/lagom-one-step-order-form#open-source-version Open Source Version]
 |}
 =Installation and Configuration=
 {|
-|style="padding: 10px 0px 30px 0px;"|'''The below instructions will direct you through the whole installation and configuration process of [https://www.modulesgarden.com/products/whmcs/lagom-one-step-order-form Lagom One Step Order Form For WHMCS].''' <br />
+|style="padding: 10px 0px 30px 0px;"|'''The below instructions will direct you through the whole installation and configuration process of [https://www.modulesgarden.com/products/whmcs/lagom-smart-order-form Lagom Smart Order Form For WHMCS].''' <br />
 Do not hesitate, just take a closer look at the screenshots and their descriptions to get clear directives and tips.
 |}
@@ Line 510: / Line 509: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_1.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_1.png]]
 |}
 {|
@@ Line 520: / Line 519: @@
 |}
 {|
-|style="padding: 0px 0px 15px 15px;"|'''3. When you install '' 'Lagom One Step Order Form' '' for the first time, you have to rename the '' 'license_RENAME.php' '' file.'''<br/>
+|style="padding: 0px 0px 15px 15px;"|'''3. When you install '' 'Lagom Smart Order Form' '' for the first time, you have to rename the '' 'license_RENAME.php' '' file.'''<br/>
 The file is located in '' 'modules/addons/LagomOrderForm/license_RENAME.php'.'' Rename it from '' 'license_RENAME.php' '' to '' 'license.php'.''
 |}
@@ Line 604: / Line 603: @@
 |style="padding: 10px 0px 15px 15px;"|'''10. Now, you have to activate the module in your WHMCS system.'''<br />
 Log in to your WHMCS admin area and proceed to '' 'System Settings' '' → '' 'Addon Modules'. ''<br />
-Afterward, find '' 'Lagom One Step Order Form' '' and press the '' 'Activate' '' button.
+Afterward, find '' 'Lagom Smart Order Form' '' and press the '' 'Activate' '' button.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_9.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_9.png]]
 |}
 {|
@@ Line 614: / Line 613: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_10.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_10.png]]
 |}
 {|
-|style="padding: 0px 0px 30px 15px;"|'''12. You have just successfully installed Lagom One Step Order Form For WHMCS!'''
+|style="padding: 0px 0px 30px 15px;"|'''12. You have just successfully installed Lagom Smart Order Form For WHMCS!'''
 |}
 =Management=
 {|
-|style="padding: 10px 0px 30px 15px;"|'''Lagom One Step Order Form For WHMCS''' has been designed to give flexibility for the clients and allow to configure it to specific business needs.<br/> Below we will describe all the available customization options.
+|style="padding: 10px 0px 30px 15px;"|'''Lagom Smart Order Form For WHMCS''' has been designed to give flexibility for the clients and allow to configure it to specific business needs.<br/> Below we will describe all the available customization options.
 |}
 ==Addon Configuration==
 ===Templates===
 {|
-|style="padding: 10px 0px 20px 15px;"|Begin by navigating to the “Lagom One Step Order Form” addon in your WHMCS admin area, there the “Templates” section will be opened by default.
+|style="padding: 10px 0px 20px 15px;"|Begin by navigating to the “Lagom Smart Order Form” addon in your WHMCS admin area, where the “Templates” section will be opened by default.
 |}
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_11.png]]
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_11.png]]
 |}
 ====Order Form Type====
 {|
 |style="padding: 10px 0px 15px 15px;"|In the '' 'Order Form Type' '' section you may choose which of the available order types should be used in the client area. You may choose between three types, these are:
 *'''One Step'''
-*'''Two Steps'''
+*'''Two Steps''''<br/>
-*'''Step by Step*''' ''(available soon)''<br/>
+For a detailed description with visualization in the client area look below.
-For detailed description with visualization in the client area look below.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_11_1.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_11_1.png]]
 |}
 {|
@@ Line 650: / Line 649: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_12.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_12.png]]
 |}
 {|
@@ Line 665: / Line 664: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_14.png]]
+|style="padding: 0px 0px 30px 25px;"|[[File:LOF_14.png]]
+|}
+====Package Type====
+{|
+|style="padding: 10px 0px 20px 15px;"|This selection of the '' 'Template' '' setting, defines the layout of the product package that will be used. You can choose between two options: '' 'Default' '' and '' 'Horizontal'.''
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LOF_19.png]]
+|}
+{|
+|style="padding: 0px 0px 20px 15px;"|Client area view of the '' 'Default' '' package type:
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_20.png]]
+|}
+{|
+|style="padding: 0px 0px 20px 15px;"|Client area view of the '' 'Horizontal' '' package type:
 |}
 {|
-|style="padding: 0px 0px 30px 15px;"|'' 'Step by Step' ''- this option is not yet available, it will be added to the module in one of its upcoming versions.
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_21.png]]
 |}
-====Order Form Layout====
+===Display Manager===
 {|
-|style="padding: 10px 0px 15px 15px;"|The second option to customize the template is dedicated to the location of the "Order Summary" element - '' 'Order Form Layout'.''<br/>
+|style="padding: 10px 0px 15px 15px;"|Lagom 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.
-There are two possibilities to choose from:
+|}
-* '''Sidebar'''
-* '''Bottom''' - keep in mind that the bottom layout is '''not supported with the '' '[[#General_Settings|WHMCS "View Cart" Page]]' '' ''' mode used.<br/>
-Underneath you will find details of every possible choice with its visualization in the client area.
+====Configurable Options====
+{|
+|style="padding: 10px 0px 5px 15px;"| [https://lagom.rsstudio.net/docs/order-form/options-manager/ Configurable Options] management is an advanced tool, which introduces new features to customize and manage WHMCS product configurable options.<br/> You can now configure different configuration layouts for every WHMCS product. Learn how to use its functions in Config Options Manager documentation.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_15.png]]
+|style="padding: 0px 0px 15px 15px;"|Available management tools are described in a separate article, please refer to the following links:
+# [https://lagom.rsstudio.net/docs/order-form/display-manager/#configurable-option-groups Configurable Option Groups]
+# [https://lagom.rsstudio.net/docs/order-form/display-manager/#option-list Configurable Options List]
+# [https://lagom.rsstudio.net/docs/order-form/display-manager/#option-management Options Management]
+# [https://lagom.rsstudio.net/docs/order-form/display-manager/#option-types Options Types]
+# [https://lagom.rsstudio.net/docs/order-form/display-manager/#exemplary-configuration Exemplary Configuration]
 |}
 {|
-|style="padding: 0px 0px 15px 15px;"|'''Sidebar''' - if selected, the '' 'Order Summary' '' box is displayed on the right side in the client area order page.<br/> The summary box is always affixed to the top of the browser screen, so clients will also have quick access to the complete summary of the current order.
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_37.png]]
 |}
+====Product Addons====
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_16.png]]
+|style="padding: 10px 0px 15px 15px;"|Product Addons Manager introduces new options to manage and customize addons created in [https://docs.whmcs.com/9-0/products/configuration-options/product-addons/ WHMCS system]. You are now able to assign a custom image to every product addon.
 |}
 {|
-|style="padding: 0px 0px 20px 15px;"|When the '' 'Bottom' '' option is selected, the '' 'Order Summary' '' box will be displayed at the end of the order process.
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_33_0.png]]
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_17.png]]
+|style="padding: 0px 0px 15px 15px;"|Manage Addons:
+*Image - Assign image to the product addon. This field lists graphics added to the addon in the Media Library.
+*Illustration Type - You can choose from 4 different illustration types - learn more:
+** Default
+**Icon
+**Illustration
+**Small Illustration
+*Color - Set background color.
 |}
 {|
-|style="padding: 0px 0px 20px 15px;"|In case of the '' 'Bottom' '' order form layout, a quick summary bar with the total amount and the checkout button will be available at the very bottom of the screen.
+|style="padding: 0px 0px 30px 25px;"|[[File:LOF_33_2.png]]
 |}
+====Payment Gateways====
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_18.png]]
+|style="padding: 10px 0px 15px 15px;"|The '' 'Payment Gateway Icons' '' section is dedicated to super easy customization of your payment gateways.<br/> You can quickly upload new gateway logos and assign them to the order payment gateways with just a few simple clicks.
 |}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_29.png]]
+|}
+{|
+|style="padding: 0px 0px 15px 15px;"| To successfully upload a gateway logo, follow the steps below: <br/>
-====Package Type====
+. Upload a new icon in the "Icon Library" section
+|}
 {|
-|style="padding: 10px 0px 20px 15px;"|This selection of the '' 'Template' '' setting, defines the layout of the product package that will be used. You can choose between two options: '' 'Default' '' and '' 'Horizontal'.''
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_30.png]]
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_19.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LOF_30_1.png]]
 |}
 {|
-|style="padding: 0px 0px 20px 15px;"|Client area view of the '' 'Default' '' package type:
+|style="padding: 0px 0px 20px 15px;"|2. Assign newly uploaded graphics to a specific gateway by pressing the "Click to assign icon" box.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_20.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_31.png]]
 |}
 {|
-|style="padding: 0px 0px 20px 15px;"|Client area view of the '' 'Horizontal' '' package type:
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_31_1.png]]
 |}
+====Order Fields====
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_21.png]]
+|style="padding: 10px 0px 15px 15px;"|Make your order process legally compliant with any country by adding needed fields to the order. These fields will be displayed below the default WHMCS "Terms of Services" checkbox.
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_32_1.png]]
+|}
+{|
+|style="padding: 0px 0px 15px 15px;"|Add/Manage Order Fields:
+* Type - Choose from 3 different field types:
+** Checkbox
+** Input Text
+** Dropdown
+* Name - set the field name.
+* Required - choose whether this field should be required, or not.
+* Description - provide a more detailed description for the newly created field.
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LOF_32_2.png]]
+|}
+{|
+|style="padding: 0px 0px 15px 15px;"|Order fields are located as the last section of the Review & Checkout page:
+|}
+{|
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_33_3.png]]
+|}
+====Media Library====
+{|
+|style="padding: 10px 0px 15px 15px;"|Upload and manage graphics that can be assigned to configurable options or product addons. This page comes with a set of predefined graphics which you can download from [https://www.modulesgarden.com/client-area/dl.php?type=d&id=4952 here].<br/>
+You may fetch the ready package and upload it into the ''/modules/addons/LagomOrderForm/storage/gallery/'' directory. Keep in mind that all the graphics must be located directly under the '''/gallery/ catalog'''.
+|}
+{|
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_34_0.png]]
+|}
+====Geolocation====
+{|
+|style="padding: 10px 0px 15px 15px;"|The Lagom Smart Order Form may smoothly detect the customer's location automatically and display the currency according to the detected country, providing an enhanced user experience.<br/>
+To use the geolocation feature the most effectively, you need to update your geolocation database. Here you will find out how to do that:
+# To download the free geolocation database you need to first create an account at the Maxmind portal, the instructions can be found at [https://dev.maxmind.com/geoip/geolite2-free-geolocation-data this site]
+# Log in to your account, proceed to ''GeoIP2/ GeoLite2 → Download Files'', find '''GeoLite2 Country'' in the table, and download the file in ''.mmdb'' format
+# Find the following file in your module files at ''/yourWHMCS/modules/addons/LagomOrderForm/app/Integrations/Geolocation/Submodules/GeoIP2/GeoLite2-Country.mmdb'' directory and overwrite it with the newly downloaded file.
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LOF_34_01.png]]
+|}
+{|
+|style="padding: 0px 0px 15px 15px;"|'''Default Settings'''
+* '''Enable Geolocation''' - enable to let the module automatically detect the client location and adjust the used language and currency to the location based on the configuration
+* '''Custom IP Address''' - enter an IP address in this field and the module will ignore the client location and use the specified IP address to assign currency and language specific to that location.<br/> Leave this field empty to enable automatic geolocation based on the client's IP address
+* '''Deafult Currency''' - select a currency in this field to be used for countries that do not have a specific currency assigned in the "Country Settings" section. This currency will act as a default option for those countries.
+* '''Default Language''' - select a language in this field to be used for countries that do not have a specific language assigned in the "Country Settings" section. This language will act as a default option for those countries.
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_34_1.png]]
+|}
+{|
+|style="padding: 0px 0px 15px 15px;"|'''Country Settings'''<br/>
+Define a specific language and currency per country. If the country is detected as the client location, the dedicated currency and language will be used in the client area. <br/> If you do not set any data per country, default settings will be used. For your comfort, you may use the mass action feature, to assign a single currency or language to numerous countries at once.
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_34_2.png]]
+|}
+{|
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_34_3.png]]
 |}
 ===Settings===
 {|
-|style="padding: 10px 0px 30px 15px;"|Navigate to the '' 'Lagom One Step Order Form' '' addon, '' 'Settings' '' section. There you may manage all the extra layout settings.
+|style="padding: 10px 0px 30px 15px;"|Navigate to the '' 'Lagom Smart Order Form' '' addon, '' 'Settings' '' section. There you may manage all the extra layout settings.
 |}
 ====General Settings====
@@ Line 730: / Line 838: @@
 |style="padding: 10px 0px 15px 15px;"|'''Order Settings:'''
 * '''Disable Order Redirection''' - if enabled, automatic redirection from standard WHMCS cart and order pages will be turned off. When clients use a ready link to e.g. a cart, it will be displayed with a standard WHMCS view.
+<!--
-* '''Enable WHMCS "View Cart" Page''' - When this option is enabled, the module will skip billing-related fields such as Billing Details, Domain Registrant, and Payment Details. This means that the entire checkout process will take place directly within WHMCS.<br/> Note that this option does not support the  '' 'Bottom' '' page layout, as the '' 'Order Summary' '' is always displayed. <br/>For more details on this flow, please move to the dedicated article [[#WHMCS_View_Cart_Page_Mode|here]].
+* '''Enable WHMCS "View Cart" Page''' - When this option is enabled, the module will skip billing-related fields such as Billing Details, Domain Registrant, and Payment Details. This means that the entire checkout process will take place directly within WHMCS.<br/> Note that this option does not support the  '' 'Bottom' '' page layout, as the '' 'Order Summary' '' is always displayed. <br/>For more details on this flow, please move to the dedicated article [[#WHMCS_View_Cart_Page_Mode|here]].-->
 * '''SEO Title for Product Order Pages''' - if you want to change the default title tag, enter here a new phrase, it will be visible in the title bar at the top of the browser window in the client area
@@ Line 754: / Line 862: @@
 |}
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_27_1.png]]
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_27_1.png]]
 |}
@@ Line 762: / Line 870: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_28_0.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_28_0.png]]
-|}
-{|
-|style="padding: 0px 0px 15px 15px;"|'''General Layout Settings:'''
-*'''Order Fields Location''' - Choose the location of WHMCS "Terms of Services" checkbox and other custom order fields, which can be configured in product addon management page.
-** '''Order Summary box''' - By default the "Terms of Services" checkbox and all custom order fields are displayed in the "Summary Box", however, you need to be aware that this location has limited space.<br/> That is why it is suggested to display maximum 2-3 order fields in this location.
-** '''Last section on order form''' - When this option is selected, all your order fields will be displayed on the last position on the order form.<br/> This location can include more custom order fields than the option described above.<br/>
-The below screen represents the default '' 'Order Summary box' '' option:
-|}
-{|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_23_2.png]]
 |}
 {|
@@ Line 779: / Line 877: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_28.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_28.png]]
-|}
-{|
-|style="padding: 0px 0px 20px 15px;"|
-* '''Simplified Summary''' - if enabled, the "Order Summary" box displays only '' 'Totals' '' and '' 'Total Due Today' '' values.<br/> It will not display any details about added products, domains or addons.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_24.png]]
 |}
 {|
@@ Line 793: / Line 884: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_22.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_22.png]]
 |}
 {|
@@ Line 799: / Line 890: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_23.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_23.png]]
 |}
 {|
 |style="padding: 0px 0px 15px 15px;"|
-*'''Mark Required Fields''' - if enabled, all the fields that are obligatory to be filled in before continuing, will be marked with the  '' 'required' '' label.
+*'''Mark Product Required Fields''' - if enabled, all the obligatory fields to be filled in before continuing will be marked with the  '' 'required' '' label.
+*'''Display Billing Cycle Section Above Products''' - if enabled, the billing cycle selector is displayed above the products section, allowing clients to choose their billing period first.
 |}
 {|
 |style="padding: 0px 0px 15px 15px;"|'''Cart Layout Settings:'''
-*'''Promotion Code Field Location''' - This option allows to change the location of the promotion field, to display it more prominently.
+*'''Promo Code Location in Product Configuration''' - This option allows to change the location of the promotion field, to display it more prominently.
-** Below "Order Summary" - By default, the promotion code field is located under the summary box. The input field will be shown after clicking the "Have a promo code?" link.
+** Below "Configuration Summary" (Show On Click) - Displays a "Have a promo code?" link below the "Configuration Summary" section that reveals the field after clicking.
-** Above "Product Billing" Section - Display the promotion code field above the "Product Billing" section.
+** Below "Configuration Summary" (Show By Default) - Displays the promotion code input field below the "Configuration Summary" section.
-** Above "Payment Method" Section - Display the promotion code field above the "Payment Method" section.
+** Above "Product Billing" Section - Displays the promotion code field above the "Product Billing" section.
-** The order page bottom - Display the promotion code field as the last section on the order form.<br/>
+** The order page bottom - Displays the promotion code field at the bottom of the order form.<br/>
-The below screen shows the ''Above "Product Billing" Section'' position:
+The screen below shows the ''Below "Configuration Summary" (Show By Default)'' position:
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_23_1.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_23_1.png]]
 |}
-<!--
 {|
 |style="padding: 0px 0px 15px 15px;"|
-*'''Promotion Code Field in View Cart''' - ............
+*'''Promo Code Location in Checkout''' - Controls where the promotion code field is displayed on the checkout page.
-** Below View Cart Table -
+** 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" -
+** Below "Order Summary" (Show On Click) - Displays a "Have a promo code?" link below the "Order Summary" section that reveals the field after clicking.
-** The end of view cart page - ....  <br/>
+** Below "Order Summary" (Show By Default) - Displays the promotion code input field below the "Order Summary" section. <br/>
-The below screen shows the ''yz" Section'' position:
+The screen below shows the standard ''Promotion Code Field Location'' set to '''Below the "View Cart" table''' position:
 |}
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_23_1.png]]
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_23_2.png]]
 |}
--->
-====Domain Search Box====
+<span id="Domain_Search_Box"></span>
+====Domain Settings====
 {|
 |style="padding: 10px 0px 15px 15px;"|
@@ Line 838: / Line 930: @@
 * '''Domain Configuration Elements''' -  Select specific elements for domain configuration to impose a customized selection and your preferred sequence.<br/> You have the flexibility to define the order in which these elements are presented and specify which of the available elements should be displayed.<br/> If the default WHMCS configuration is your preference, simply leave this field empty to seamlessly adopt the WHMCS standard settings.
 * '''Domain Configuration Elements (Logged in Users)''' - Select the elements for domain configuration for clients who are logged in, and they will be displayed in the specified order.<br/> If you opt for the default WHMCS configuration, you can leave this field empty.
+* '''Hide Domain TLDs Table''' - If enabled, the table with available domain TLDs will be hidden from the order form. Useful when you want to simplify the domain selection step.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_21_01.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_21_01.png]]
 |}
 {|
@@ Line 847: / Line 940: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_21_0.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_21_0.png]]
 |}
@@ Line 855: / Line 948: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_25.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_25.png]]
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_26.png]]
+|style="padding: 0px 0px 20px 15px;"|When disabled, no domain extensions are shown below the domain search bar.
+|}
+{|
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_26.png]]
 |}
 {|
@@ Line 869: / Line 965: @@
 {|
 |style="padding: 0px 0px 20px 15px;"|
-*'''Domain Configuration Elements (Logged in Users)''' in the client area - view with '''default''' WHMCS elements (field in the addon is left empty)
+*'''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. <br/>It allows you to define a separate order of elements displayed in the domain configuration section for authenticated clients. <br/>If this field is left empty, the default WHMCS configuration will be used
 |}
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_26_0.png]]
+|style="padding: 0px 0px 30px 15px;"|
+* '''Hide Domain TLDs Table''' - Shows or hides the Domain TLDs table on the Domain Search and Domain Transfer pages.<br/> After enabling the option, the table is no longer displayed.
+|}
+{|
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_26_2.png]]
 |}
@@ Line 878: / Line 978: @@
 {|
 |style="padding: 10px 0px 15px 15px;"|'''Main Settings:'''
-* '''Display Price Suffix''' - if enabled, the currency suffix is shown next to the price.<br/> However, it is vital to previously configure the currency and its suffix details in your WHMCS admin area settings, based on their video tutorial
+* '''Display Price Suffix''' - if enabled, the currency suffix is shown next to the price.<br/> However, it is vital to previously configure the currency and its suffix details in your WHMCS admin area settings, based on the video tutorial
-* '''Currency Selector''' - choose how the currency selector behaves:
+* '''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. <br/>These values are shown for reference only and do not change the final price.
+* '''Currency Selector''' - Controls the visibility of the currency selector on the order page; available options:
 ** ''Always visible'' - ensure it remains consistently accessible
-** ''Hide permanently''
+** ''Hide permanently'' - the selector is never displayed
-** ''Hide selector if one currency is available''
+** ''Hide selector if one currency is available'' - the selector is shown only when multiple currencies are configured<br/>
+The currency selector is displayed in the top section of the order page.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_21.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_21.png]]
 |}
 {|
@@ Line 892: / Line 994: @@
 ** Show 0.00 values
 ** Show "Free" instead of 0.00 values
 * '''Product Billing Cycles'''
 ** Show 0.00 values
@@ Line 913: / Line 1,016: @@
 |}
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_21_02.png]]
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_21_02.png]]
 |}
@@ Line 921: / Line 1,024: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_25_04.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_25_04.png]]
 |}
 {|
@@ Line 928: / Line 1,031: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_25_4.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_25_4.png]]
 |}
 {|
@@ Line 935: / Line 1,038: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_25_0.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_25_0.png]]
 |}
 {|
@@ Line 958: / Line 1,061: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_25_6.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_25_6.png]]
 |}
 {|
@@ Line 964: / Line 1,067: @@
 |}
+<!--
 ====CAPTCHA Settings====
 {|
@@ Line 993: / Line 1,097: @@
 |style="padding: 0px 0px 20px 25px;"|[[File:LOF_25_2.png]]
 |}
+-->
 ===Orders===
 {|
-|style="padding: 10px 0px 15px 15px;"|Open this section to view a complete list of orders placed in your client area with the Lagom One Step Order Form module.
+|style="padding: 10px 0px 15px 15px;"|Open this section to view a complete list of orders placed in your client area with the Lagom Smart Order Form module.
 |}
 {|
@@ Line 1,003: / Line 1,108: @@
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_25_3.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_25_3.png]]
 |}
 {|
@@ Line 1,012: / Line 1,117: @@
 |}
-===Miscellaneous===
+==Client Area==
 {|
-|style="padding: 10px 0px 15px 15px;"|Lagom WHMCS One Step 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.
+|style="padding: 10px 0px 15px 15px;"|An exemplary ordering process in the client area where the '' 'Twenty-One' '' theme is used in the WHMCS system.<br/>
-|}
-====Payment Gateways====
-{|
-|style="padding: 10px 0px 15px 15px;"|The '' 'Payment Gateways' '' section is dedicated to super easy customization of your payment gateways.<br/> You can quickly upload new gateway logos and assign them to the order payment gateways with just a few simple clicks.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_29.png]]
-|}
-{|
-|style="padding: 0px 0px 15px 15px;"|In order to successfully upload a gateway logo, follow the below steps: <br/>
-. Upload a new icon in the "Icon Library" section
+'''''Important:''' It is possible to use the '''Lagom Smart Order Form For WHMCS''' module without the '''[https://lagom.rsstudio.net/products/client-theme Lagom WHMCS Client Theme].''' The module remains fully usable and all available features are supported when the standard WHMCS "Twenty-One" theme is used. <br/> The only limitation concerns the number of supported styles and their color schemes. For "Twenty-One" theme, the "Modern" style with "blue" color scheme is used by default and there are no extra options to choose from.''
+Take a look below to see what such ordering pages may look like.<br/>
+Here you can see an example of a ''' "One Step" ''' order form view with '' 'Default' '' package type.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_30.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_32.png]]
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_30_1.png]]
+|style="padding: 0px 0px 15px 15px;"|The next example illustrates the ''' "Two Steps" ''' order form view. <br/>
+In this option, the first step is dedicated to selecting product packages:
 |}
 {|
-|style="padding: 0px 0px 20px 15px;"|2. Assign newly uploaded graphics to a specific gateway by pressing the "Click to assign icon" box.
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_33.png]]
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_31.png]]
+|style="padding: 0px 0px 20px 15px;"|In the second step, the rest of order configuration takes place.
 |}
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_31_1.png]]
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_34.png]]
 |}
-====Order Fields====
+===Multi Product Support===
 {|
-|style="padding: 10px 0px 15px 15px;"|Make your order process legally compliant with any country by adding needed fields to the order. These fields will be displayed below the default WHMCS "Terms of Services" checkbox.
+|style="padding: 10px 0px 15px 15px;"|Lagom Smart Order Form allows customers to build one order from multiple items during the same ordering process. Products, domains, and addons can be added one after another and reviewed together before checkout.
+On the product configuration page, the Configuration Summary sidebar shows the current configuration, while Quick Shopping Cart provides an overview of all items already added to the cart
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_32_1.png]]
+|style="padding: 0px 0px 15px 15px;"|After selecting a product, its configuration will appear in the '''Configuration Summary''' panel on the right side. You can define domain options, add-ons, and other settings for that product.
-|}
-{|
-|style="padding: 0px 0px 15px 15px;"|Add/Manage Order Fields:
-* Type - Choose from 3 different field types:
-** Checkbox
-** Input Text
-** Dropdown
-* Name - set the field name.
+When ready, choose one of the following buttons:
-* Required - choose whether this field should be required, or not.
+* '''Add to Cart''' – adds the current configuration to the cart and keeps the customer on the current page.
-* Description - provide a more detailed description for the newly created field.
+* '''Buy Now''' – adds the current configuration to the cart and opens checkout immediately.
+* '''Reset Configuration''' - clears the current selection and restores the initial state after confirmation.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_32_2.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_35_04.png]]
-|}
-{|
-|style="padding: 0px 0px 15px 15px;"|Fields Location can be managed using the "Order Fields Location" option in addon settings. You can choose from two different locations.
-*'''Order Summary box (default)''' - By default "Terms of Services" checkbox and all custom order fields are displayed in the "Summary Box".<br> Please be aware that this location has limited space, that is why it is suggested to display maximum 2-3 order fields in this location.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_32_3.png]]
 |}
 {|
 |style="padding: 0px 0px 15px 15px;"|
-*'''Last section on order form''' - When this option is selected, all the "Order Fields" will be displayed in the last order section. This location can contain more fields than the above alternative.
-|}
-{|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_33_3.png]]
-|}
-====Configurable Options====
+Once a selected product has been added using the '''Add to Cart''' button, customers can:
-{|
-|style="padding: 10px 0px 15px 15px;"| [https://lagom.rsstudio.net/docs/order-form/options-manager/ Configurable Options] management is an advanced tool, which introduces new features to customize and manage WHMCS product configurable options.<br/> You can now configure different configuration layouts for every WHMCS product. Learn how to use its functions in Config Options Manager documentation.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_37.png]]
-|}
-{|
-|style="padding: 0px 0px 30px 15px;"|Available management tools are described in a separate article, please refer to the following links:
-# [https://lagom.rsstudio.net/docs/order-form/options-manager/#configurable-option-groups Configurable Option Groups]
-# [https://lagom.rsstudio.net/docs/order-form/options-manager/#configurable-options Configurable Options]
-# [https://lagom.rsstudio.net/docs/order-form/options-manager/#option-management Options Management]
-# [https://lagom.rsstudio.net/docs/order-form/options-manager/#option-types Options Types]
-# [https://lagom.rsstudio.net/docs/order-form/options-manager/#exemplary-configuration Exemplary Configuration]
-# [https://lagom.rsstudio.net/docs/order-form/options-manager/#additional-fields-translation Additional Fields Translation]
-|}
-====Product Addons====
+* Continue shopping and select another product or group - the current product configuration resets, and the newly selected product options will appear. Previously added items remain stored in the cart.
-{|
-|style="padding: 10px 0px 15px 15px;"|Product Addons Manager introduces new options to manage and customize addons created in WHMCS system (opens new window). You are now able to assign a custom image to every product addon.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_33_0.png]]
-|}
-{|
-|style="padding: 0px 0px 15px 15px;"|Manage Addons:
-*Image - Assign image to the product addon. This field lists graphics added to the addon in the Media Library.
-*Illustration Type - You can choose from 4 different illustration types - learn more:
-** Default
-**Icon
-**Illustration
-**Small Illustration
-*Color - Set background color.
-|}
-{|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_33_2.png]]
-|}
-====Media Library====
+* Proceed to checkout at any time - all previously added items stay safely in the cart.
-{|
-|style="padding: 10px 0px 15px 15px;"|Upload and manage graphics that can be assigned to configurable options or product addons. This page comes with a set of predefined graphics which you can download from [https://www.modulesgarden.com/client-area/dl.php?type=d&id=4952 here].<br/>
-You may fetch the ready package and upload it into the ''/modules/addons/LagomOrderForm/storage/gallery/'' directory. Keep in mind that all the graphics must be located directly under the '''/gallery/ catalog'''.
+* Reset the product configuration to start a new selection.
-|}
-{|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_34_0.png]]
-|}
-====Geolocation====
-{|
-|style="padding: 10px 0px 15px 15px;"|The Lagom One Step Order Form may smoothly detect the customer's location automatically and display the currency according to the detected country, providing an enhanced user experience.<br/>
-To use the geolocation feature the most effectively, you need to update your geolocation database. Here you will find out how to do that:
+* Leave the order form and return later - the cart contents will remain unchanged.
-# To download the free geolocation database you need to first create an account at the Maxmind portal, the instructions can be found at [https://dev.maxmind.com/geoip/geolite2-free-geolocation-data this site]
-# Log in to your account, proceed to ''GeoIP2/ GeoLite2 → Download Files'', find '''GeoLite2 Country'' in the table, and download the file in ''.mmdb'' format
-# Find the following file in your module files at ''/yourWHMCS/modules/addons/LagomOrderForm/app/Integrations/Geolocation/Submodules/GeoIP2/GeoLite2-Country.mmdb'' directory and overwrite it with the newly downloaded file.
 |}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_34_01.png]]
+|style="padding: 0px 0px 15px 15px;"|Click the cart icon at the '''top right corner''' to open the '''Shopping Cart Preview'''.  <br/>
-|}
+Quick Shopping Cart is the cart preview available from the View Cart item in the top navigation. It allows customers to check the current cart content without leaving the page they are currently using. <br/>It is the main element that supports Multi Product Ordering. Customers can continue configuring more items and open Quick Shopping Cart whenever they want to review what has already been added.
-{|
-|style="padding: 0px 0px 15px 15px;"|'''Default Settings'''
-* '''Enable Geolocation''' - enable to let the module automatically detect the client location and adjust the used language and currency to the location based on the configuration
-* '''Custom IP Address''' - enter an IP address in this field and the module will ignore the client location and use the specified IP address to assign currency and language specific to that location.<br/> Leave this field empty to enable automatic geolocation based on the client's IP address
-* '''Deafult Currency''' - select a currency in this field to be used for countries that do not have a specific currency assigned in the "Country Settings" section. This currency will act as a default option for those countries.
-* '''Default Language''' - select a language in this field to be used for countries that do not have a specific language assigned in the "Country Settings" section. This language will act as a default option for those countries.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_34_1.png]]
-|}
-{|
-|style="padding: 0px 0px 15px 15px;"|'''Country Settings'''<br/>
-Define a specific language and currency per country. If the country is detected as the client location, the dedicated currency and language will be used in the client area. <br/> If you do not set any data per country, default settings will be used. For your comfort, you may use the mass action feature, to assign a single currency or language to numerous countries at once.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_34_2.png]]
-|}
-{|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_34_3.png]]
-|}
-==Client Area==
+'''1. Order Items'''<br/>
-{|
+This live preview displays all items in the cart ''(these can include products, domains, and product addons)'' along with their prices and basic details.<br/>
-|style="padding: 10px 0px 15px 15px;"|An exemplary ordering process in the client area where the '' 'Twenty-One' '' theme is used in the WHMCS system.<br/>
+Product addons are displayed as separate rows directly below the related product. An additional description helps identify which product the addon belongs to. This is especially useful when the cart contains more than one service.
-'''''Important:''' It is possible to use the '''Lagom One Step Order Form For WHMCS''' module without the '''[https://lagom.rsstudio.net/products/client-theme Lagom WHMCS Client Theme].''' The module remains fully usable and all available features are supported when the standard WHMCS "Twenty-One" theme is used. <br/> The only limitation concerns the number of supported styles and their color schemes. For "Twenty-One" theme, the "Modern" style with "blue" color scheme is used by default and there are no extra options to choose from.''
+'''2. Hidden Details'''<br/>
+To keep the panel compact, additional details are hidden by default. A counter such as +6 or +2 shows how many related elements are hidden for a selected item. <br/> After expanding the item, the panel displays related details such as configurable options or domain registration addons.<br/>
-Take a look below to see what such ordering pages may look like.<br/> '''''Note:''' Please keep in mind that the "Lagom One Step Order Form" module currently only permits ordering one item per transaction, and it does not support multiple orders yet.'' <br/>
+'''3. Remove Actions'''<br/>
+Quick Shopping Cart allows removing a single item or clearing the entire cart. Both actions are available directly in the panel, so the order can be adjusted without opening a separate cart page.<br/>
-Here you can see an example of a ''' "One Step" ''' order form view with the '' 'Package Slider' '' option turned on, '' 'Sidebar' '' order form layout and '' 'Default' '' package type.
+'''4. Quantity'''<br/>
-|}
+If a product or addon supports quantity in WHMCS, Quick Shopping Cart shows quantity controls directly in the panel. <br/>Changing the quantity does not change the unit price. <br/>It only changes the final amount for the selected item and the current cart total.<br/>
+'''5. Total Due Today''' <br/>
+Quick Shopping Cart shows a simplified Total Due Today summary, which presents the current amount due for the cart content. <br/> If a promotion code is applied, the discount is shown as a separate row. The final amount is then displayed after the discount, together with the original crossed-out price. <br/ >The VAT label shown next to Total Due Today depends on the customer context. For example, the amount may be displayed as (ex. VAT) or (inc. VAT) depending on whether the customer is logged in and how tax is calculated.
+|}
 {|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_32.png]]
+|style="padding: 0px 0px 20px 25px;"|[[File:LSOF_35_06.png]]
 |}
 {|
-|style="padding: 0px 0px 15px 15px;"|The next example illustrates the ''' "Two Steps" ''' order form view. <br/>
+|style="padding: 0px 0px 15px 15px;"|When ready, proceed to the '''Review & Checkout''' page to confirm your order.  <br/>
-In this option, the first step is dedicated to selecting product packages:
+Checkout completes the Multi Product Ordering flow. After products, domains, and addons are added earlier in the process, this page shows the full order in one place before payment.
-|}
-{|
+Here, you can:
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_33.png]]
-|}
-{|
-|style="padding: 0px 0px 20px 15px;"|In the second step, the rest of order configuration takes place.
-|}
-{|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_34.png]]
-|}
-===WHMCS View Cart Page Mode===
-{|
-|style="padding: 10px 0px 15px 15px;"|The '''"View Cart" mode''' in the Lagom One Step Order Form For WHMCS module offers an alternative checkout flow that is similar to the standard WHMCS ordering process.<br/> This feature was introduced to '''support payment gateways that may not be fully compatible with single-page checkout''', ensuring that all available payment options remain accessible to users.<br/>
-Lagom One Step Order Form For WHMCS works seamlessly with all payment gateways that are implemented according to [https://developers.whmcs.com/payment-gateways/getting-started/ WHMCS official documentation].
+* Review product details and prices,
-When you are using a payment gateway that is not fully supported by the single-page checkout (such as PayPal), please always turn on the ''WHMCS "View Cart" Page'' option.
+* Apply a promo code,
-|}
-{|
+* Modify quantities or remove items,
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_35_0.png]]
-|}
+* Finalize the checkout process.
-{|
-|style="padding: 0px 0px 15px 15px;"|When "View Cart" mode is active, the checkout flow aligns with the default WHMCS ordering process, splitting order summary and checkout stages across separate pages.<br/>
-The ordering process displays the '' 'Order Summary' '' on the left side of the screen.
-|}
-{|
-|style="padding: 0px 0px 20px 25px;"|[[File:LOF_35_01.png]]
-|}
-{|
-|style="padding: 0px 0px 15px 15px;"| Upon clicking '' 'Checkout' '', users are redirected to the '' 'Review & Checkout' '' page where they can:
-* Review the order details, including any selected addons.
-* Provide or confirm billing information for new or existing accounts.
-* Select their preferred payment method to complete the purchase.
 |}
 {|
-|style="padding: 0px 0px 30px 25px;"|[[File:LOF_35_02.png]]
+|style="padding: 0px 0px 30px 25px;"|[[File:LSOF_35_07.png]]
 |}
@@ Line 1,353: / Line 1,356: @@
 {|
 |style="padding: 10px 0px 30px 15px;"|An essential guidance through the process of updating the module is offered '''[https://www.docs.modulesgarden.com/How_To_Update_WHMCS_Module here]'''.<br/><br/>
-Make sure that the Lagom One Step Order Form version, which you are going to install, is compatible with your WHMCS and Lagom WHMCS Client Theme installations!
+Make sure that the Lagom Smart Order Form version, which you are going to install, is compatible with your WHMCS and Lagom WHMCS Client Theme installations!
 # Create a backup copy of your WHMCS files and database.
@@ Line 1,367: / Line 1,370: @@
 ==Uninstallation Process==
 {|
-|style="padding: 10px 0px 30px 15px;"|If you no longer wish to use Lagom One Step Order Form For WHMCS, you may safely uninstall the module.<br/>
+|style="padding: 10px 0px 30px 15px;"|If you no longer wish to use Lagom Smart Order Form For WHMCS, you may safely uninstall the module.<br/>
 To successfully and safely remove the module from your system, follow these steps: <br/>
-# Deactivate the addon module: Navigate to System Settings → Addon Modules, and find ''Lagom One Step Order Form.'' Click on ''Deactivate.''<br/>
+# Deactivate the addon module: Navigate to System Settings → Addon Modules, and find ''Lagom Smart Order Form.'' Click on ''Deactivate.''<br/>
 # Remove all tables that begin with ''LagomOrderForm_'' from the database.<br/>
 # Next, delete all the listed below files:
-#* The folder containing the Lagom One Step Order Form module:  '''''modules/addons/LagomOrderForm'''''
+#* The folder containing the Lagom Smart Order Form module:  '''''modules/addons/LagomOrderForm'''''
 #* The '''''order.php''''' file.<br/>
 # Finally, remove the '''''RewriteBase''''' rule that you must have added to the htaccess file <br/>''(For additional information, please refer to the details provided in points 7 and 8 of the [[#Installation |installation instructions]])''
@@ Line 1,384: / Line 1,387: @@
 |style="padding: 10px 0px 30px 15px;"|Seeking a solution that offers greater flexibility, customization tailored to your precise needs, and unrestricted availability?<br/> There is an option that not only proves to be cost-effective in the long run but also includes prioritized support services, making it a truly valuable investment.<br/>
-Opt for the [https://www.modulesgarden.com/products/whmcs/lagom-one-step-order-form#open-source-version Open Source version] of your Lagom One Step Order Form For WHMCS module to unlock these benefits.<br/> Simply click on either the '''Get Source Code''' or '''Upgrade To Lifetime''' button found on the product's page in our client area to complete the one-step upgrade process, with a '''dedicated discount''' already applied.<br/>
+Opt for the [https://www.modulesgarden.com/products/whmcs/lagom-smart-order-form#open-source-version Open Source version] of your Lagom Smart Order Form For WHMCS module to unlock these benefits.<br/> Simply click on either the '''Get Source Code''' or '''Upgrade To Lifetime''' button found on the product's page in our client area to complete the one-step upgrade process, with a '''dedicated discount''' already applied.<br/>
 Follow a [https://www.docs.modulesgarden.com/How_To_Upgrade_WHMCS_Module comprehensive guide] covering the transition process, the advantages it brings, and step-by-step instructions on what to do next after the order has been successfully finalized.
@@ Line 1,394: / Line 1,397: @@
 |}
 {|
-|style="padding: 0px 0px 5px 15px;"|2. '''Third-party modules''' that manipulate or affect the ordering process pages will '''NOT''' be compatible with '''Lagom One Step Order Form For WHMCS'''.<br/> '''Lagom One Step Order Form For WHMCS''' is a separate module, it works independently and it is NOT based on any default WHMCS order process template.<br/>
+|style="padding: 0px 0px 5px 15px;"|2. '''Third-party modules''' that manipulate or affect the ordering process pages will '''NOT''' be compatible with '''Lagom Smart Order Form For WHMCS'''.<br/> '''Lagom Smart Order Form For WHMCS''' is a separate module, it works independently and it is NOT based on any default WHMCS order process template.<br/>
-The module is '''not yet''' compatible with the below modules from ModulesGarden offer:
+The module is '''not yet''' compatible with the following modules from ModulesGarden offer:
-* Payment Gateway Allocator For WHMCS ''(compatible soon)''
-* Product Cross-Selling For WHMCS ''(EoS)''
 * Domain Orders Extended For WHMCS
 * Resellers Center For WHMCS
 * Multibrand For WHMCS
-* Stripe SEPA Payments For WHMCS ''(EoS)''
 * Client Area Designer For WHMCS ''(this integration is not scheduled)''
 * SMS Center For WHMCS
 * Product Free Trial Manager For WHMCS
-* Recurring Contract Billing For WHMCS - ''Integration works flawlessly when the '''[[#WHMCS_View_Cart_Page_Mode|WHMCS "View Cart" Page]]''' mode is enabled in the Lagom One Step Order Form For WHMCS module.''
+* Recurring Contract Billing For WHMCS ''(integration might be limited)''
+|}
+{|
+|style="padding: 0px 0px 5px 15px;"|3. '''Error 404/403 when accessing the order process.'''<br/>
+''Reason:'' This issue might occur when the Lagom Smart Order Form installation was not completed correctly or some required files are missing from your environment.<br/>
+''Solutions:''
+* Verify that the rewrite rules in your ''.htaccess'' file have been added correctly. Follow the steps described in the [[#Installation|Installation Documentation]].
+* Make sure all required files are uploaded:
+** Reupload the templates and modules directories
+** Reupload the order.php file
+** Place them in the main WHMCS directory on your server
 |}
 {|
-|style="padding: 0px 0px 30px 15px;"|3. The module is compatible with WHMCS v8.8 yet please be aware that the new WHMCS '''On-Demand Renewals''' feature is not yet supported.<br/> Please follow the module changelog for information on the full compatibility.
+|style="padding: 0px 0px 30px 15px;"|4. '''Quick Cart Popup Does Not Work.'''<br/>
+''Reason:'' This issue may occur if the "View Cart" menu item has been renamed or modified, which prevents it from being detected correctly.<br/>
+''Solutions:''
+* Using Lagom WHMCS Client Theme:
+**Go to the RSThemes addon
+**Open the Menu tab
+**Navigate to the Secondary menu section
+**Locate the "View Cart" item
+**Expand Menu Item Display Settings
+**Add the following class in Custom Classes: <code>nav-item-cart</code>
+*Without Lagom WHMCS Client Theme
+**If you are using a custom menu, modified or another theme, you need to manually update the "View Cart" item and add the required class: <code>nav-item-cart</code>.
 |}

Personal tools

Namespaces

Variants

Views

Actions

Search

Lagom Smart Order Form For WHMCS