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.

# 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 12.x and later.
  3. Supports PHP 7.2.x and later.
  4. Supports WHMCS 8.7.x and later.
  5. Recommended Apache server. Optional possible compatibility with other types of servers - learn more.
  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 WHMCS 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 /templates/ and the /modules/ folders into 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 WHMCS 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

Due to our limited technical knowledge and possible diverse environment configurations, our team offer limited "Technical Support" for this type of 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.

# *NGINX Server

Due to our limited technical knowledge and possible diverse environment configurations, our team offer limited "Technical Support" for this type of servers.

If you are using NGINX 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. Here is a step-by-step configuration guide.

# Configure the NGINX Virtual Host file

  1. Include the NGINX htaccess configuration file in your NGINX Virtual Host configuration. The location of this file vary and often is /etc/nginx/sites-available/default.
  2. Add this line to include the htaccess file: include {path-to-whmcs-directory}.htaccess-nginx;. For instance, include /var/www/.htaccess-nginx;.

# Use the New NGINX htaccess Generating Tool

Every time you save a apage in Lagom WHMCS Website Builder (RS Themes -> Pages), you have to use the "NGINX .htaccess Generator Tool" tool found under Addons -> RS Themes -> Tools. If everything is configured correctly, the tool will confirm that the NGINX htaccess file is valid.

Remember to restart your NGINX server to apply the changes after using the tool.

# Product Support and Access Duration Policy

# Support and Downloads Availability

All versions of our Lagom products receive full support and access to downloads for 24 months from their release date. During this period, customers can benefit from comprehensive support services and have unrestricted access to download the respective versions from our client portal.

# End of Life Policy

After the 24-month support period, the download of that version will no longer be available through our client portal. It is important to note that once a version reaches its end of life (EOL), support for that version may be limited or entirely unavailable. We encourage our customers to stay updated with the latest versions to ensure they continue receiving full support and access to new features and improvements.

# Patches and Fixes

We do not release any patches or fixes for versions that have crossed their end of life date. To maintain optimal performance and security, we recommend upgrading to the latest version of our products.

# Recommendations

For the best experience with our Lagom products, we advise customers to:

  1. Regularly check for new releases: Stay informed about the latest updates and enhancements.
  2. Plan upgrades accordingly: Ensure that your system is always running a supported version.
  3. Contact support for upgrade assistance: If you need help with upgrading, our support team is here to assist you.

By adhering to these guidelines, you can ensure continued access to our high-quality support and the latest product advancements.

For any questions or further information, please do not hesitate to contact our support team.

← Update →