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

# Before You Begin

  1. Make sure that the Lagom 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.
Installation - Live Preview

# 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. Extracted folder contains folder required for "Lagom 1.x" version, this file is needed for customers performing an update from Lagom 1.x version to Lagom 2.x version. If you did not had Lagom 1.x version installed on your server, you can remove /php71+/templates/lagom/ folder.
  3. Upload the /php71+/ content to your FTP server.
  4. Make sure that during upload process all files has been uploaded correcly without any errors.
  5. 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 privilages.

# 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 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, nagivate to the Common Problems article.