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

# Update

This article explains how to update the Lagom WHMCS Leased Bundle (opens new window) to the latest available version.

It covers the required preparation, file upload process, and the final update step performed from the RS Themes addon. Follow the instructions in the order presented to ensure a smooth and successful update.

# 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 IonCube Loader 14 or later.
  2. Supports PHP 8.2 and 8.3.
  3. Recommended Apache server. Optional possible compatibility with other types of servers - learn more.
  4. Required PHP modules:
  5. Requires Modrewrite (opens new window) to be enabled on your server.
  6. Requires max_input_vars to be set to at least 5000.
  7. Requires max_execution_time to be set to at least 300 seconds.
  8. Requires InnoDB database storage engine.
  9. 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 - Enable WHMCS Maintenance mode (opens new window) and perform a full backup of your WHMCS server and database.
  2. IMPORTANT — Before updating the Leased Bundle, verify that the version of Lagom WHMCS Client Theme included in your package is compatible with your WHMCS installation. The Client Theme is a core element of the bundle, so its version must match the WHMCS requirements to ensure a successful update. Check the compatibility list here (opens new window).
  3. While we make every effort to test all our new releases, 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 want to retain the Style Manager's settings like colors and variables values, do not delete Lagom WHMCS Leased Bundle 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 wish to install 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".

# 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 /php81+/ 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 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 necessary 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" (opens new window) 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" (opens new window) section.

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

# 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 → Empty Template Cache.

# Common Problems

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

← Licensing →