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

# Update

In this article, you will find out how to successfully update Lagom WHMCS Client Theme. We will guide you step by step through the whole update process.

# Product Requirements

IMPORTANT: Starting with version 2.4.2, Lagom Client Theme no longer supports PHP below 8.2.

Below is a list of requirements for latest product version:

  1. Requires IonCube Loader 14 or later.
  2. Supports PHP 8.2 and 8.3.
  3. Required PHP modules:
  4. Requires max_execution_time to be set to at least 300 seconds.
  5. Requires max_input_vars to be set to at least 5000.
  6. Requires InnoDB database storage engine.

# Before You Begin

  1. IMPORTANT - If you migrate from the Lagom 1.x, please follow the migration process outlined in the following document - Upgrade from Lagom 1.x (opens new window).
  2. IMPORTANT - Make a full backup of your WHMCS server and database and enable WHMCS Maintenance mode (opens new window).
  3. IMPORTANT - Ensure that the Lagom WHMCS Client Theme version, which you would like to install, is compatible with your WHMCS installation! Check the compatibility list here (opens new window).
  4. We are continuously striving for excellence in testing all our new releases, however, we strongly recommend giving our product a try on your WHMCS installation before activating it. You can preview the installed theme by clicking the "Live Preview" button as presented below.
  1. If you have ordered the Basic or Advanced integration from the RS Studio team, then please make sure that these packages have been updated. What is important, we need 16-32 business days to update customized packages for all our customers. The version of the customized package needs to be the same as the latest theme release, otherwise, your custom package has not been updated yet.
  2. If you want to retain the Style Manager's settings like colors and variables values, do not delete Lagom WHMCS Client Theme files before the upload process. Instead, just upload new version's package files and overwrite the existing ones.

# Download Files

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

# 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 the Lagom Color Schemes.

  1. Extract the .zip file downloaded from the Client Portal.
  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. Ensure that all files are uploaded and overwritten correctly without any errors during the transfer process.
  4. After successfully uploading the Lagom package to your WHMCS server, verify that the files and folders in /templates/lagom2/core/styles/ have the required write permissions.

# Visit RS Themes Addon

  1. After you have uploaded the necessary files for the update, navigate to WHMCS Admin Area -> Addons -> RS Themes. Here, locate the theme you are updating and click the Manage button.
  1. Once inside the RS Themes addon page, the dynamic updater window will appear. Simply click "Start Update" and follow the on-screen instructions. If you encounter any problems, please refer to our "Common Problems" section.

  1. The updater will go through the following processes:

    • Starting Update
    • Checking Module Requirements
    • Updating Lagom Data
    • Building Color Styles
    • Polishing
    • Finalizing Update

  2. During the update process, various errors or warnings may appear. Below is a sample message, and a full list of them can be found in the "Common Problems" section.

  1. After the update process is complete, you will be notified of the outcome and automatically redirected to the template selection screen.

# Update Extensions

Please verify if Lagom Extensions you are using are compatible with the theme version that has been installed.

  1. Visit the extension documentation.
  2. Initiate the update process of incompatible extensions.

# Clear Cache

IMPORTANT: Remember to clear the WHMCS template cache after completing the update. This ensures that WHMCS does not retain cached template files from the previous version. Failing to perform this step may result in improper functionality of your theme.

  1. Clear your browser and server cache (for example Cloudflare).
  2. Clear the WHMCS template cache in: Utilities > System > System Cleanup > "Go" > "Empty Template Cache".

# Common Problems

To find out more about common problems and errors, navigate to the Common Problems article.

← Licensing →