Lagom WHMCS Client Theme Documentation
Docs v2.x
/ /website-builder/ /extensions/ /module-integration/ /order-form/

# Installation

Welcome to the comprehensive installation guide for Lagom WHMCS Website Builder (opens new window). In this article, you'll find step-by-step instructions to seamlessly integrate this powerful product into your existing setup. Get ready to embark on a journey of enhanced web development possibilities.

Lagom WHMCS Website Builder does NOT support NGINX servers. Our team does not offer "Technical Support" for this type of servers.

# Product Requirements

Below is a list of requirements for latest product version, make sure that your server meets all below requirements, BEFORE you start installation process:

  1. Requires Lagom WHMCS Client Theme (opens new window) 2.2.x and later - see compatibility list.
  2. Requires IonCube Loader 10.x and later.
  3. Supports PHP 7.2.x and later.
  4. Supports WHMCS 8.7.x and later.
  5. Supports Apache and Litespeed* servers.
  6. Required PHP modules:
  7. Requires Modrewirte (opens new window) to be enabled on your server.
  8. Requires max_input_vars to be set to at least 5000.

IMPORTANT: It is highly recommended to increase the "Server Timeout" (max_execution_time) setting to a minimum of 300 seconds during the installation or update of this product. Once the installation or upgrade process is complete, you can reset the server timeout to its default value.

During the initial activation of our product, the addon creates all necessary databases and loads the required configuration. If this process is interrupted due to insufficient "Server Timeout" (max_execution_time) duration, our addon may not function correctly or may not work at all. This could result in missing features or errors related to missing databases on your WHMCS pages.

If the server interrupts the addon activation, you may need to deactivate the RS Themes addon using the "Clear Database Records" option and then activate it again. However, it is strongly recommended to increase the "Server Timeout" (max_execution_time) setting before performing this action.

# Before You Begin

  1. Make sure that Lagom WHMCS Client Theme (opens new window) is installed on your server. It is important to have this product already installed and activated on your server, BEFORE proceeding with installation of Lagom WHMCS Website Builder. If Lagom WHMCS Client Theme is NOT installed on your server, then please follow installation documentation.
  2. Make sure that the Lagom WHMCS Website Builder version, which you are trying to install, is compatible with your WHMCS and Lagom WHMCS Client Theme installations! Check the compatibility list here.
  3. Create a backup copy of your WHMCS files and database.

# Download Files

  1. Log in to our RS Studio Client Portal.
  2. Navigate to My Services.
  3. Find “Lagom Website Builder” product and click the “Manage” button.
  4. Download the latest version by pressing the “Download” button on the main product page. If you want to choose one of the previous releases, click “Show all files”.

# Assign License

  1. At the top of the management page you will see "Assigned License" section, with a dropdown list, where you need to choose Lagom Client Theme license key.
  2. Then click "Change" button, to save this changes.

# Upload Files

Lagom files can NOT be uploaded using ROOT owner, as files and folders uploaded using root can not be overwritten by RS Themes addon. This will cause issues during activation of Lagom Website Builder extension.

  1. Extract the .zip folder that has been downloaded.
  2. Upload the content of /templates/ and /modules/ folder, to the directory where your WHMCS system has been installed.
  3. Make sure that during the upload process all the files have been correctly uploaded and no errors occurred.

# Activate Product

  1. Log in to the WHMCS admin area on your server.
  2. Go to “Addons” then click “RS Themes” in the navigation menu of your WHMCS admin area.
  3. Click on “Manage” for the specific theme (this step is not visible for every installation).
  4. Select “Extensions” from the list of available tabs.
  1. Click on the “Manage” button next to “Lagom Website Builder” product.
  1. Afterwards, press “Activate”.

# Configure Product

Once installation and activation process has been completed, you can start configuration of your product.

  1. Change Display Rule - Allows you to change between "Default" and "CMS" display of Lagom Client Theme.
  2. Load Demo Pages or Start From Scratch
  3. Manage CMS Pages
  4. Activate Sitemap

# *WHMCS in Subfolder

If you have installed WHMCS in a subdirectory of your website, such as www.yourdomain.com/whmcs/, you'll need to make some adjustments to your WHMCS .htaccess file.

Follow these steps:

  1. Locate the .htaccess file in the root directory of your website.
  2. Open the .htaccess file using a text editor.
  3. Add the following RewriteBase/[directory] rule at the end of the file, replacing [directory] with the name of your WHMCS subdirectory. In our example, it will be:
RewriteBase/whmcs

This rule tells Apache to set the base directory for URL rewriting to your WHMCS subdirectory.

  1. Save the changes to the .htaccess file, and your Lagom Website Builder installation should now work correctly when accessed from a subdirectory.

# *LiteSpeed Servers

If you are using LiteSpeed server, you have to be aware that this type of servers require server restart after every change in Lagom WHMCS Website Builder functions, which implement changes to the htaccess file, for example:

  1. Activation of CMS product.
  2. Creation or deletion of CMS page.
  3. Changes in Display Rule settings.
  4. etc.

This is one of the limitations of OpenLiteSpeed web server over the Enterprise website. OLS does not read or integrates the .htaccesschanges done on the website. To make it read the webserver requires are restart using root user. This can be done by following simple steps.

  1. Log in to the root user of the OLS installed server.
  2. Run the following command to restart OpenLiteSpeed Browser.
systemctl restart lsws
  1. Check if OLS is running properly without any issues.
systemctl status lsws
  1. After restarting OLS the changes done in .htaccess files in any website will start reflecting. However, this has to be done after every change in the .htaccess file. If you don’t want to restart the webserver manually then you should consider upgrading to LiteSpeed Enterprise.

← Update →