Upgrade from Lagom 1.x

• Before You Begin
• Install Lagom 2
  • Download Files
  • Backup Server
  • Remove Addon Files
  • Upload Files
  • Update Extensions
  • Final Steps
• Configure Lagom 2
  • Migrate Settings from Lagom 1.x
  • Activate Lagom 2
  • Clear Cache

The "Lagom 2" product launched new features that required changes in the Lagom WHMCS Client Theme code as well as its file structure. As a result, the Lagom 2 versions will be available in the “RS Themes” addon as a brand new theme called “Lagom 2”. All modifications implemented to the Lagom 1.x version need to be manually migrated to the “Lagom 2” product.

This article has been prepared for customers who already use the Lagom 1.x version on their WHMCS installations.

• If you are a new customer and wish to perform the first product installation, please follow the “Installation” article.
• If you are currently using “Lagom 2” and want to carry out the version update, please follow the “Update” article.

Before You Begin

1. Verify if the Lagom 2 theme version is compatible with your WHMCS installation! Check the compatibility list here.
2. If you have purchased the product modification from the RS Studio team, then please ensure that these changes have been updated to the Lagom 2 version. What is important, we need 16-32 business days to update customized packages for all our customers.
3. We highly recommend to test Lagom 2 release on your staging server, which contains exact copy of your production server.
4. The “Lagom 2” files will be installed in a separate folder which means that the Lagom 1.x files will not be overwritten.

Install Lagom 2

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.

Backup Server

1. Turn on "Maintenance" (opens new window) mode in your WHMCS system.
2. Important: Create a full backup of your WHMCS server and database, before you proceed in to next steps.

Remove Addon Files

This step is optional - Addon file structure has changed in Lagom 2, so removing these files will keep your environment clean from not needed files.

1. Login to SFTP/FTP of your WHMCS server and go to /modules/addons/ directory.
2. Go to RSThemes folder and remove all files except below folders:
   • /modules/addons/RSThemes/views/adminarea/extensions
   • /modules/addons/RSThemes/src/Extensions

Upload Files

The “Lagom 2” files will be installed in a separate folder which means that the Lagom 1.x files will not be overwritten by the following steps.

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 with latest Lagom version that has been downloaded in previous steps.
2. Upload all folders located in the /php71+/ folder, to main WHMCS directory on your server.
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.

Update Extensions

It's important to perform an update of below Lagom extensions (if you use them with Lagom 1.x version):

1. Update Email Template for Lagom WHMCS Client Theme Extension.
2. Update Promotion Manager for Lagom WHMCS Client Theme Extension.
3. Update Lagom Module Integration Extensions.

Final Steps

Before you disable "Maintenance" mode you need to test if installation of Lagom 2 has been performed correctly.

1. Visit WHMCS Client Portal and test if Lagom 1.x works as before.
2. Go to WHMCS admin area and open "RS Themes" addon. Manage "Lagom 1" theme and check if all addon pages load without any problems.
3. Check if all installed "Extensions" works correctly.
4. If everything function correctly, you can disable "Maintenance" mode and start configuration of Lagom 2 theme.

If update process corrupted your Lagom 1.x theme, then immediately restore your server from previously created backup and contact our team.

Configure Lagom 2

Migrate Settings from Lagom 1.x

The “Lagom 2” product has been installed as a new theme, so it is necessary to migrate all modifications implemented in “Lagom 1” manually by following these steps:

1. Go to “Addons” then click “RS Themes” in the navigation menu of your WHMCS admin area.

2. Click the “Manage” button in the “Lagom 2” theme box.

3. Provide the same product license key as for Lagom 1 and press the “Save” button. Both themes will use the same license and the Lagom 1 theme will not be deactivated.

4. Upload your company logo.
5. Select the Lagom Style and configure its colors.
6. Choose the Lagom Layout for the main navigation and footer layout.
7. Set up navigation menu items.
8. Configure pages settings.
9. Define the “Modern” homepage content.
10. If you created custom files in the “Lagom 1” folder, you need to copy all these files manually to the “Lagom 2” folder. For example:
    • You have designed a custom template for the Lagom page.
    • You have overwritten some specific template elements.
    • You have created custom hooks in the /templates/lagom/core/hooks/ folder.
    • You have added the theme-custom.css file to your Lagom Style.
11. If you performed customization of “Lagom 1” core files, then all these changes need to be manually merged with the “Lagom 2” files and copied to the correct locations.
12. Preview changes implemented in “Lagom 2” by selecting “Preview” from the “Actions” dropdown menu. This will activate the theme only for your browser session.

Activate Lagom 2

If you are sure that the configuration and migration processes have been completed and you have also tested all theme pages, you can activate it for all your customers by following these steps.

1. Click the “Activate Theme” button to activate the client area theme.

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