Lagom WHMCS Client Theme Documentation
Docs v2.x
/ /website-builder/ /leased-bundle/ /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

IMPORTANT: Starting with version 1.2.1, Lagom Website Builder no longer supports PHP below 8.2.

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.4.2 and later - see compatibility list (opens new window).
  2. Requires IonCube Loader 14 or later.
  3. Supports PHP 8.2 and 8.3.
  4. Recommended Apache server. Optional possible compatibility with other types of servers - learn more.
  5. Required PHP modules:
  6. Requires Modrewrite (opens new window) to be enabled on your server.
  7. Requires max_input_vars to be set to at least 5000.
  8. Requires max_execution_time to be set to at least 300 seconds.
  9. Requires InnoDB database storage engine.
  10. Requires WHMCS Friendly URLs to be set to either Full Friendly Rewrite or Basic URLs (configured in General Settings -> General -> Friendly URLs). Avoid using Friendly index.php, as it may cause issues with Lagom WHMCS Website Builder functionality (e.g., pages like cart.php not loading correctly).

# Before You Begin

  1. IMPORTANT - Make a full backup of your WHMCS server and database and enable WHMCS Maintenance mode (opens new window).
  2. 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 (opens new window).
  3. 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 (opens new window).
  4. 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. Using an FTP client, upload the contents of the /php82+/ folder to the directory where your WHMCS system is installed. You can find the WHMCS installation directory in the WHMCS admin area under "Help" > "License Information" > "Valid Directory".
  3. Make sure that during the upload process all the files have been correctly uploaded and no errors occurred.

# Activate Product

If you encounter licensing-related errors during this step, please refer to the Licensing section for more information.

  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 (opens new window) - Allows you to change between "Default" and "CMS" display of Lagom WHMCS Client Theme.
  2. Load Demo Pages or Start From Scratch (opens new window)
  3. Manage CMS Pages (opens new window)
  4. Activate Sitemap (opens new window)

# *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 →