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

# Common Problems

This article describes common problems that may occur when installing, updating, or using Lagom WHMCS Website Builder (opens new window).

Use the sections below to find the issue that matches your case and follow the suggested steps.

# Installation & Update

When installing or updating the Lagom WHMCS Website Builder, you may see various messages depending on the issues encountered. Refer to the information below for additional details on these messages.

# Incompatible Extension Version

This error appears when installing or updating the Lagom WHMCS Website Builder. It means that the license key you entered does not include access to the selected extension version.

Each license comes with an "Updates & Support" period. You can access all versions released during that period, but anything released after it requires a valid, active subscription. Learn more – Product Version Access Validation (opens new window).

What Can You Do?

  1. Make sure you entered a license key that has access to the selected version.
  2. Log in to your RSStudio account (opens new window) to check your "Updates & Support" period.
  3. Compare the last paid invoice date with the version’s release date listed in our Website Builder Changelog (opens new window).
  4. If needed, renew your subscription or use a version available to your license.

After verifying the license, click Try Again to continue. If the issue persists, click Contact Us (opens new window) for support.

# Website

# "Oops! Something went wrong..." erorr on website

# rsthemes_pricing_cache

If you are seeing any Oops! Something went wrong and we could't process request error on your WHMCS website, once Lagom WHMCS Website Builder has been activated, and error include rsthemes_pricing_cache message, then try clear "Pricing" cache by clicking on "Refresh button in "Tools" page:

# Display Issues in Website Builder

After the Website Builder activation, you might encounter display issues on your pages. This is often due to the styles not refreshing automatically after the CSS file creation.

To fix this:

  1. Navigate to the RS Themes addon in your WHMCS admin area.
  2. Go to the Styles section and select your active style.
  3. Click the Save button without making any changes. This action forces the cms.css file to be created or updated, ensuring that the Website Builder pages display correctly.

Following these steps should resolve any display inconsistencies and ensure your Website Builder pages look as intended.

# Addon

# Page Creation Issue

This guide provides a detailed explanation of common issues related to page creation in Lagom WHMCS Website Builder. If you encounter any of these issues, follow the instructions below to resolve them.

# Missing custom_page_template.php file

Why this happens

This file is required for the Lagom WHMCS Website Builder to function properly. If it is missing, the system cannot create new pages.

How to Fix It

  • Check if the file exists
    • Open File Manager in your hosting panel (e.g., cPanel, Plesk) or use an FTP/SFTP client (FileZilla, WinSCP).
    • Navigate to your main WHMCS installation directory and look for custom_page_template.php.
  • If missing, re-upload the file
    • Download the Lagom WHMCS Website Builder package from your Client Panel.
    • Extract the package and locate custom_page_template.php.
    • Upload the file to your main WHMCS directory.
  • Retry your action
    • Return to RS Themes addon, refresh the page, and check if the issue is resolved.

# The /templates/lagom2/ directory is not writable

Why this happens

If the system does not have permission to write files in this folder, it cannot create new pages.

How to Fix It

  1. Check and adjust folder permissions

    • Open File Manager in your hosting panel (e.g., cPanel, Plesk) or use an FTP/SFTP client (e.g. FileZilla, WinSCP).
    • Navigate to /templates/ in your WHMCS directory.

  2. Set correct permissions for lagom2 folder

    • Via FTP/File Manager: Right-click on lagom2, go to Permissions, and set it to 755 (or 775 if 755 does not work).

    • Via SSH: Run:(Replace /your_path/to with the correct path to your WHMCS installation.)

      chmod -R 755 /your_path/to/templates/lagom2

  3. Retry your action

    • Return to RS Themes addon, refresh the page, and check if the issue is resolved.

# The .htaccess file is missing or not writable

Why this happens

This file is required to process URLs correctly in WHMCS. If it is missing or restricted, pages may not load properly.

How to Fix

  1. Check if the file exists

    • Open File Manager in your hosting panel (cPanel, Plesk) or use an FTP/SFTP client (FileZilla, WinSCP).
    • Look for .htaccess in your WHMCS root directory.

  2. Adjust file permissions (if the file exists)

    • File Manager/FTP: Right-click on .htaccess, go to Permissions, and set it to 644.

    • SSH: Run the command (replace /your_path/to with the correct path to your WHMCS installation):

      chmod 644 /your_path/to/.htaccess

  3. Generate .htaccess via WHMCS (if missing)

    • In WHMCS, go to Setup → General Settings → General.
    • Under Friendly URLs, click Advanced Settings → Rewrite File → Synchronize.
    • For a visual reference, visit WHMCS documentation (opens new window).

  4. Manually create the file (if needed)

    • If for some reason you cannot perform the above action or the file is not being created, you can create a new .htaccess file in the WHMCS root directory via File Manager or FTP.
    • Set file permissions to 644.
    • Ensure the file’s owner matches the WHMCS directory owner.

  5. Retry your action

    • Return to RS Themes addon, refresh the page, and check if the issue is resolved.

← Display CMS →