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

# Module Requirements

Below is a list of requirements for latest product version:

  1. Requires IonCube Loader 10.x and later.
  2. Supports PHP 7.2.x and later.

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 the Lagom WHMCS Client Theme version, which you are trying to install, is compatible with your WHMCS installation! Check the compatibility list here.
  2. 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 folder that has been downloaded from the Client Portal.
  2. Upload content of /php71+/ folder to using FTP server, to the directory where your WHMCS system is installed. WHMCS system installation directory can be found in WHMCS admin area. Go to "Help" > "License Information" > "Valid Directory".
  3. Make sure that during upload process all files has been uploaded correctly without any errors.
  4. Once Lagom package has been correctly uploaded to your WHMCS Server, please check if files and folders located in /templates/lagom2/core/styles/ has write privileges.

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

# Activate Client Area Theme

  1. Go to “Addons” then click “RS Themes” in the navigation menu of your WHMCS admin area.
  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 firstly without 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 > "Go" > "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.