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

# Common Problems

The Lagom WHMCS Leased Bundle (opens new window) includes multiple Lagom products delivered as a single package. In most cases, issues are related to one specific component rather than the bundle mechanism itself.

For this reason, solutions are documented within the dedicated sections of each individual product.

Use the sections below to navigate to the appropriate area of the documentation. If you are unsure where to start, review the section headings in the table of contents and select the one that best matches your issue.

# Installation and Update

During installation or update of the Lagom WHMCS Leased Bundle, the installer may display messages related to server configuration, file permissions, missing requirements, or environment validation.

# Stuck on "Installing Addon Core"

Potential Issue: A 500 error may appear in the browser's developer tools under the Network tab. The error is often related to the following endpoint: /modules/addons/RSThemes/src/Api/adminApi.php?controller=installApi&method=installAddon

Cause: This issue is likely caused by a misconfiguration in your server, specifically related to database credentials.

Steps to resolve:

  1. Verify the database credentials in your WHMCS configuration file (configuration.php).
    • Ensure the database username, password, hostname, and database name are correct.
  2. Check the database user's permissions.
    • The database user must have full privileges for the WHMCS database.
  3. If the issue persists, inspect server logs (e.g., /var/log/apache2/error.log or /var/log/nginx/error.log) for more details on the error.

# Error 404 during installation/update

Full warning message: A server error occurred, but no detailed information about the error was found.

This error indicates that a server-side issue occurred during installation. Since the RS Themes addon cannot specifically identify the problem due to its nature, additional troubleshooting is required. The error may be caused by various factors depending on your server configuration.:

  • Review developer console when issue occurs to ensure if any error message can be found that might aid in idenifying source of issue.
  • Ensure that all Lagom WHMCS Client Theme files have been sucesfully uploaded according to our documentation here (opens new window)
  • Review your server logs including WAF / Mod Security / Firewall logs to ensure that no assets of Lagom WHMCS Client Theme are being blocked by your security configuration.

If your review confirms that the issue is related to your server’s security settings, you will need to add the Api folder to the exceptions in your WAF / ModSecurity / Firewall settings. Ideally, you should exclude the entire parent folder: /modules/addons/RSThemes.

# Licensing and Access

This section covers issues related to license validation, subscription status, and access to updates or downloads.

# Subscription and Update Access

If your issue is related to subscription status, renewal, license validation, or access to updates and downloads, please review the Licensing – Lagom WHMCS Leased Bundle (opens new window) section.

# Additional Extension

If your issue concerns assigning an additional extension license to your existing Lagom WHMCS Leased Bundle installation, refer to the Extensions – Licensing (opens new window) section.

# Your server details do not match details saved on our licensing server

Our licensing server checks your server details daily. This error occurs if your license is assigned to a different server, often due to changes in server details such as domain, directory, or IP address.

# Steps To Resolve

  1. Reissue the License
    Reissuing updates the server details in our system, including the valid domain, IP address, and directory. Note that the error may still be visible for up to a day after reissuing due to the daily server checks.

  2. Verify Firewall Settings
    Ensure your server's firewall configuration is not blocking outgoing connections to our licensing server. Unrestricted access is necessary for license validation.

  3. Contact Support
    If the issue persists, contact our support team with a detailed description of the problem, error messages, and steps you've already tried.

Our support team is available to guide you through additional troubleshooting steps to quickly resolve your issue.

# Theme Addon

# Color schemes do not load

If you see "black" blocks in the "style" list or colors fail to load when managing a specific Lagom Style, as shown below:

Ensure all "variable" files and folders have been copied from the "defaults" folder, as demonstrated in the example below:

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

# Website and Client Area

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

# Have Not Found Answer?

If the issue persists after reviewing the relevant documentation, please contact us using the Contact Us (opens new window) form and include detailed information about your environment together with the exact message displayed.

← First Steps →