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

# Installation

This article will walk you through the steps necessary to install our Lagom WHMCS Client Theme on servers where this theme has not been installed previously. We will guide you carefully through the whole installation 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 - Enable WHMCS Maintenance mode (opens new window) and perform a full backup of your WHMCS server and database.
  2. 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).
  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.

# 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 /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 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.

# Activate Addon

  1. Log in to the WHMCS admin area on your server.
  2. In the top right corner, click on “System Settings” and then choose “Addon Modules”.
  1. Activate the “RS Themes” addon.
  1. Press the “Configure” button and select admin role groups (these groups may differ depending on the WHMCS installation) to grant access according to your needs, then save changes.

# Visit RS Themes Addon

  1. To activate the Client Area Theme, navigate to Addons -> RS Themes.
  1. The installer window will appear. Click the "Start Installation" button, follow the on-screen instructions.
  1. Next, you will be prompted to enter your Lagom WHMCS Client Theme license key. Paste your license key into the field provided, then click “Verify License Key” to continue.

  1. The installation will go through the following processes:

    • Starting Installation
    • Checking Module Requirements
    • Installing Theme Core
    • Installing Addon Core
    • Building Color Styles
    • Creating Default Pages
    • Building Product Pricing Cache
    • Polishing
    • Finalizing Installation

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

  1. After the installation is complete, you will be notified of the outcome and automatically redirected to the template selection screen.
  1. Click the "Manage" button located next to the previously installed product.
  1. Enter a product license key and press the "Save" button. Your product license key can be found in RS Studio Client Portal.
  1. Click the "Activate Theme" button to activate the Lagom WHMCS Client Theme for the "client area" and the "ordering process". If you would like to preview the theme before activating it, please check this step.

# Clear Cache

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

# Configure Theme

Once the installation process has been completed, you can proceed to the configuration of your theme.

  1. Upload your company logo.
  2. Select the Lagom Style and configure its colors.
  3. Choose the Lagom Layout for the main navigation and footer layout.
  4. Set up navigation menu items.
  5. Configure pages settings.
  6. Edit general settings.
  7. Define the “Modern” homepage content.

# Common Problems

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

← Update →