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

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

Extracted files in your WHMCS directory should look like this:

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

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

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

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

   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]

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

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

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.

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

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

• One Step
• Two Steps
• Step by Step* (available soon)
  

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

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:

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

Client area 'Step 1' view:

There are two possibilities to choose from:

• Sidebar
• Bottom - keep in mind that the bottom layout is not supported with the 'WHMCS "View Cart" Page' mode used.
  

Underneath you will find details of every possible choice with its visualization in the client area.

• 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.
  Note that this option does not support the 'Bottom' page layout, as the 'Order Summary' is always displayed.
  For more details on this flow, please move to the dedicated article 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

• 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

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

• 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.
    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.
    This location can include more custom order fields than the option described above.
    

The below screen represents the default 'Order Summary box' option:

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

• Simplified Summary - if enabled, the "Order Summary" box displays only 'Totals' and 'Total Due Today' values.
  It will not display any details about added products, domains or addons.

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

• Mark Required Fields - if enabled, all the fields that are obligatory to be filled in before continuing, will be marked with the 'required' label.

• Promotion Code Field Location - 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.
  • Above "Product Billing" Section - Display the promotion code field above the "Product Billing" section.
  • Above "Payment Method" Section - Display the promotion code field above the "Payment Method" section.
  • The order page bottom - Display the promotion code field as the last section on the order form.
    

The below screen shows the Above "Product Billing" Section position:

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

• Show Domain TLDs Dropdown option enabled:

• Show Domain Spotlights - option enabled:

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

• Domain Configuration Elements (Logged in Users) in the client area - view with default WHMCS elements (field in the addon is left empty)

• 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 their video tutorial
• Currency Selector - choose how the currency selector behaves:
  • Always visible - ensure it remains consistently accessible
  • Hide permanently
  • Hide selector if one currency is available

• 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

• 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

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

• 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

• CAPTCHA Type - You may choose between two available captcha protection types. That is "Default" and "hCaptcha"
  • Default - In case you choose this type, the standard WHMCS "Captcha Form Protection" will be enabled. You may manage it in your 'WHMCS admin area' → 'General Settings' → 'Security'.
    Select the type there, choose forms in the client area and enter your Site and Secret Keys.
  • hCaptcha - For hCaptcha verification you will need to provide the full configuration with the connection details here in the addon.
• hCaptcha Protection - Enable protection for:
  • all users
  • unlogged users only
    • disable this feature

• Pages with hCaptcha Protection - Select the client area pages for which the hCaptcha verification will be active:
  • Shopping Cart Checkout
  • Domain Checker
  • Contact Form
  • Ticket Submission
  • Login Forms

• hCaptcha Site Key - Provide your hCaptcha Site Key, you need to be registered first!

• hCaptcha Secret Key - Enter your hCaptcha Secret Key.

For WHMCS versions earlier than 8.11, the CAPTCHA configuration within the module remains active, allowing users on older WHMCS versions to manage hCaptcha settings directly through the module settings.
This functionality is maintained to support compatibility with earlier versions of WHMCS and will be removed once the module compatibility with WHMCS versions below 8.11 is ceased.

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.

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

• 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 Summary box (default) - By default "Terms of Services" checkbox and all custom order fields are displayed in the "Summary Box".
  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.

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

1. Configurable Option Groups
2. Configurable Options
3. Options Management
4. Options Types
5. Exemplary Configuration
6. Additional Fields Translation

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

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.

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

1. 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
2. Log in to your account, proceed to GeoIP2/ GeoLite2 → Download Files, find 'GeoLite2 Country in the table, and download the file in .mmdb format
3. 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.

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

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.

Important: It is possible to use the Lagom One Step 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.
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.

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.

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

Lagom One Step Order Form For WHMCS works seamlessly with all payment gateways that are implemented according to WHMCS official documentation.

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.

The ordering process displays the 'Order Summary' on the left side of the screen.

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

• 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',
    ];
});

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    

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.

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';

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:

1. ?promocode=testcode
2. promocode/testcode

&billingcycle:

1. ?billingcycle=annually
2. billingcycle/annually

&addons:

1. ?addons=10,22
2. addons/10,22

Exemplary supported links with additional variables used:

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

Exemplary URL:

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

Where:

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

Exemple 2:

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

Where:

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

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

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!

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

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

1. Deactivate the addon module: Navigate to System Settings → Addon Modules, and find Lagom One Step Order Form. Click on Deactivate.
   
2. Remove all tables that begin with LagomOrderForm_ from the database.
   
3. Next, delete all the listed below files:
   • The folder containing the Lagom One Step Order Form module: modules/addons/LagomOrderForm
   • The order.php file.
     
4. 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.

Opt for the Open Source version of your Lagom One Step 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.

The module is not yet compatible with the below 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