Documentation JS Readmore for category description

Allows hiding part of the long text on the category page and provides users with the ability to expand and collapse the category description as needed. This modifier offers a more flexible and convenient way to present information on the category pages of your online store. You no longer need to load pages with additional content, as users can decide when they want to see the full category description themselves.

Version: 1.2
Release: 18.10.2023

Information to users

Please carefully review this information before starting to use our products. We have endeavored to provide maximum compatibility and user convenience, but some aspects may require your attention and configuration. Do not hesitate to contact us with any questions or if you need assistance.

  • The modification has been tested on the standard Opencart template but may require adaptation for other templates.
  • During installation, additional fields are created in the database. We recommend creating a backup of your data before installation for data recovery if needed.

Try first installing «Localcopy OCMOD», and then attempt to install our modification again. This sequence may resolve potential conflicts and help you successfully implement our changes on your website.

Modification installation

To install the modification, follow these steps:

  • Log in to the Admin panel and go to Menu -> Extensions -> Extension Installer;
  • Upload and install the archive file CD_Readmore_x_OpenCart_x.ocmod.zip;
  • After successful installation, go to Menu -> Extensions -> Modifications and click the «Refresh» button in the upper right corner.
  • After completing these steps, go to Menu -> Extensions -> Modules and install the JS Readmore For Category Description module.

Modification configuration

To configure the modification, navigate to Menu -> Extensions -> Modules -> JS Readmore For Category Description

Main Configuration Parameters:

  • Status - responsible for enabling this modification;
  • JavaScript Status for All Categories - allows enabling or disabling the script for all category descriptions;
  • Collapsed Height - regulates the amount of visible text while hiding the rest;
  • Screen Resolution - configures screen resolutions at which this script will work.

Database Status:

  • Displays the status of fields in the database table;
  • Manages the installation or removal of fields from the database.

Settings in categories

To configure the extension for specific category, go to Menu -> Catalog -> Categories and select the desired category. Additional settings can be found in the Design tab.

Here, you can configure the following settings:

  • JavaScript Status for Category - enable or disable the script for a specific category, or leave it as default to apply settings from the module;
  • Collapsed Height - specify the amount of text that will be visible, while the remaining text will be hidden.

These settings will help you configure the extension for specific product categories in your catalog.

Styling

If the default design of the «Expand / Collapse» button does not match your website, you can modify the CSS styles in the file cs_readmore.min.css, which is located at the following path:

/catalog/view/javascript/cs_libs/css/cs_readmore.min.css

Problems and solutions

If you have any questions or problems, we have collected in this section answers to frequently asked questions and solutions to the most common and common problems.

List of changes

  • v1.218.10.2023

    Latest release

    Changed:

    • Code optimization;
    • Replacing the jQuery «ReadMore» script with pure JavaScript.
  • v1.131.05.2023

    Changed:

    • Correction in code.
  • v1.003.05.2023

    Added:

    • Script control for each description individually;
    • Script control for all descriptions;
    • Control on screen resolutions will run the script;
    • Ability to hide part of the text.