Categories Pro

Magento 2 Extension — User Guide & Documentation

Magento 2.3.x / 2.4.xBy MagepowAdmin + Frontend

Vendor
Magepow Extensions

1 · Installation

Two ways to install — via Composer or by uploading the app folder. Both end with the same Magento CLI steps.

Before you begin: install the extension on a staging/test server first, and take a full backup of your files and database — especially on a live store.

System requirements

Magento 2.3.x / 2.4.x installed and working
PHP, MySQL/MariaDB and web server meeting Magento 2 system requirements
SSH access to run Magento CLI commands

Method 1 — Install via Composer (recommended)

Open a terminal in your Magento 2 root directory and require the package:
```
composer require magepow/categoriespro
```
Run the Magento setup upgrade:
```
php bin/magento setup:upgrade
```

Deploy static content (production mode):

php bin/magento setup:static-content:deploy -f

Flush the cache:
```
php bin/magento cache:flush
```

Method 2 — Manual install (upload `app` folder)

Download the extension package and unzip it. Upload the app folder to your Magento 2 root so it merges with the existing app directory.

Run the following commands from the Magento 2 root:

php bin/magento setup:upgrade
php bin/magento setup:static-content:deploy -f
php bin/magento cache:flush

Log out of the Admin panel and log back in to refresh access permissions, then clear the cache under System > Cache Management.

Tip: while configuring the store, disable full-page and additional PHP caches (Varnish, Redis, OPcache/APCu) so changes appear immediately. Re-enable them when you are done.

2 · Configuration & Usage

All settings live in the Magento Admin panel. Screenshots below match the default Admin theme.

1 - How to set up a Categories Pro Rule? See the examples

To create Categories Rules please go to the admin panel → Magepow → Categories Pro Rule and click ‘Add New Rule’ button.

create rule1

Rule Infomation Tab

Rule name - The name of this rule displayed in admin.
Status - Active or InActive this rule.
Priority - Only one rule can be applied in one position. If there are several rules, the rule with the highest priority will be executed. Here 1 is the smallest priority.
Stores - Store this rule apply for.
Customer Groups - Customer Groups this rule apply for.

rule infomation

'What to Display' Conditions Tab

Choosing mode:

Choose Subcategories of Chosen One - Displays subcategories only.
Note: this options will limited position options to only Category Page in 'Where to Display' Conditions tab
Choose The Categories specified below - Displays the specified categories in Exclude Categories.

Exclude Categories- Choose the categories won't display. Click one and Ctr + A to select all; Ctr + Click to select or unselect.

what to display

what to display2

'Where to Display' Conditions Tab

Block Position- Specify where to display block.

where to display widget0

Home Page- Display on Home Page.
Shopping Cart Page- Display on Shopping Cart Page.
Display by widget- Using widget to display block.

I go to Admin menu -> Content -> Pages -> Home Page and display the block using insert widget.
Product Page- Display on Product Page.
There is a custom conditions field to filter Product applied this rule

Notice: Block in Sidebar Top or Sidebar Bottom could only display when you have set fitted layout for the product displayed it.
Categories- Display on Categories Page.
Select Specific Categories to choose which to display.

Display Settings Tab

Block Title - Title displayed in frontend.
Sort By
- Name: sort by name of category
- Meta Title: meta title in admin panel -> Catalog -> Categories -> Search Engine Optimization
- Id: sort by id of category
- Created date: sort by created date
- Admin Tree: sort by categories tree in admin panel -> Catalog -> Categories
Show Description - Description in admin panel -> Catalog -> Categories -> content
Item Amount - Item Amount in admin panel -> Catalog -> Categories
Thumbnail - Thumbnail in admin panel -> Catalog -> Categories -> content
- True: display Thumbnail
- False: display Category Image

display settings

Responsive Information Tab

resonsively choose how many items display in a row depending on resolution.

responsive

Slider Configuration

Slide - Set true to apply config below.
Slide Vertical - Set true to display slider in vertical form.
Infinite - Set true to loop back to the top after reaching the last item.
Auto Play - Automaticaly next slide.
Arrows - Display Arrows to next or back slide.
Dots - Display Dots under slider
Rows - Choose how many rows you want to display a slider.
Speed - Set how fast the autoplay next slide.
autoplay Speed - Set how long the autoplay delay the first next slide.
padding - Padding between slides.

config rule

2 - Frontend Examples

Categories Slider block in Home Page.

home example

Categories Slider block in Shopping Cart Page.

cart example

Categories Slider block in Category Page.

cat example

Categories Slider blocks in Content Top and Sidebar Bottom of Product Page.

example1

Categories Slider block in Into Native Tab Block of Product Page.

example2

3 · Support

Found a bug or need customization? Contact us — we usually reply within 24–48 hours.

Need help?

Ticket support: support.magepow.com — we reply within 24–48 hours (usually much faster). Please include your Magento version, extension version and screenshots/error messages.
Documentation: docs.magepow.com
Video tutorials: Magepow on YouTube

Bug reports

If you find a bug, please report it via the ticket system with steps to reproduce, expected vs. actual behavior, and any relevant logs (var/log/system.log, var/log/exception.log).