English Русский Українська

Documentation Additional Category Description + Settings

Adding text, banners, or HTML code to the bottom of category pages, different from the standard description, is now available. Additionally, control over top and bottom descriptions, images, and scripts for categories is provided, offering more settings for displaying information.

Version: 3.2
Release: 19.10.2023
Return to the catalog
More about the modification
1. Information to users
2. Modification installer
3. Modification configuration
4. Settings in categories
5. Stylization
6. List of changes

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.

Download for OpenCart 2x
Download for OpenCart 3x

Modification installation

The installation process of the modification consists of two steps:

  • AD_Category_x_OpenCart_x.ocmod.zip - this archive contains the main functionality of the module and the modification;
  • AD_Category_FrontEnd_Default_OpenCart_x.ocmod.zip - this archive contains a modification for connecting the template.

To install the modification, follow these steps:

  • Login to the Admin Panel and navigate to Menu -> Extensions -> Extension Installer;
  • Upload and install both archives;
  • After successful installation, you will receive a notification;
  • 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 module Additional Category Descriptions + Settings.

Modification configuration

To configure the modification, go to Menu -> Extensions -> Modules -> Additional Category Descriptions + Settings

Main configuration parameters:

  • Description Positions - allows you to swap the top and bottom descriptions;
  • Status - activates this modification.

Additional settings for top and bottom descriptions:

  • Description Status - displays the description block on the website;
  • Image Status - displays the category image next to the text;
  • Image Position - determines which side of the text to place the image;
  • Description on Pagination Pages - configures the display of text on the first page or all pages;
  • «Read More» Button Status - allows enabling or disabling the script for all category descriptions;
  • Visible Text Height - adjusts the amount of visible text, with the rest being hidden;
  • Screen Resolution - configures screen resolutions where 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.

Category settings

To configure the extension for a specific product, go to Menu -> Catalog -> Categories and select the desired category. Additional parameters are located in the Design tab.

Here you can configure the following parameters:

  • «Read More» Button Status - enable or disable the script for a specific category, or leave it as default, in which case the module's settings will apply;
  • Visible Text Height - specify the amount of text that will be visible, with the rest hidden.

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

Styling

You can modify the layout of description blocks by editing files located at the following paths.

Top description block:

/catalog/view/theme/default/template/custom_templates/addons/ad_category_top.(twig/tpl)

Bottom description block:

/catalog/view/theme/default/template/custom_templates/addons/ad_category_bottom.(twig/tpl)

CSS-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_ad_category.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.

Familiarize

List of changes

  • v3.219.10.2023

    Latest release

    Changed:

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

    Changed:

    • Correction in code.
  • v3.030.11.2022

    Added:

    • Image position control.

    Changed:

    • Same settings for Opencart 2 and 3 versions;
    • Control at which screen resolutions the script will run for the top and bottom descriptions.
  • v2.010.06.2021

    Added For Opencart 3:

    • Control on which screen resolutions the script will run;
    • Replace descriptions;
    • Control image display;
    • Manage top and bottom descriptions;
    • Title for bottom description.
  • v1.012.12.2017

    Added:

    • Adding bottom description for Opencart 3 version;
    • Ability to hide part of the text.
  • v1.026.02.2016

    Added:

    • Adding bottom description to Opencart 2;
    • Hide description on all pages except the first;
    • Script control for each description individually;
    • The ability to hide part of the text.