README

Free, open-source Magento 2 extension
by Arjun Dhiman — Adobe Commerce Certified Master
Part of the MageMatch developer ecosystem

MageMatch_AdminProductGridCategoryFilter adds a category column and category filter dropdown to Magento admin product listing grids.

Features

Adds a Categories column to admin product grids.
Adds a Categories filter for Product, Related, Cross-sell, and Up-sell listing grids.
Uses category option source model for quick filter selection.
Works with modern Magento 2.4 installations.

How to use

Go to Catalog > Products in admin:

Use the Categories filter to narrow product lists.
See product category names in the Categories column.

The same behavior is available in related product selectors (Related, Cross-sell, Up-sell).

Module Structure

Model/Category/CategoryList.php builds category filter options.
Ui/Component/Listing/Column/Category.php renders category names in the grid column.
Ui/DataProvider/Product/*.php applies category-based filtering for product listings.
view/adminhtml/ui_component/*.xml injects the filter/column into admin listing UI components.

CI Matrix

This repository includes a GitHub Actions workflow at .github/workflows/ci.yml.

Validation runs on:

PHP 8.2
PHP 8.4

It validates Composer metadata, PHP syntax, and XML well-formedness.

Install commands by environment

Stable production install:

composer require magematch/magento2-catalog-grid-category-tools:^1.0

Staging/dev install (before first stable tag is visible):

composer require magematch/magento2-catalog-grid-category-tools:"dev-main@dev"

Troubleshooting: duplicate module registration

If you see:

Module 'MageMatch_AdminProductGridCategoryFilter' ... has been already defined in 'vendor/...'.

it means Magento found the same module in both locations:

app/code/MageMatch/AdminProductGridCategoryFilter
vendor/magematch/magento2-catalog-grid-category-tools

Fix (Composer-based install):

rm -rf app/code/MageMatch/AdminProductGridCategoryFilter
composer install
php bin/magento setup:upgrade
php bin/magento cache:flush

Installation

composer require magematch/magento2-catalog-grid-category-tools
bin/magento module:enable MageMatch_CatalogGridCategoryTools
bin/magento setup:upgrade
bin/magento cache:clean

Compatibility

Magento Open Source 2.4.x
Adobe Commerce 2.4.x
PHP 8.1, 8.2, 8.3

Support & Custom Development

Need custom Magento development?
Find vetted Adobe Commerce developers at
magematch.com

License

MIT License — free to use commercially

magematch / magento2-catalog-grid-category-tools

Maintainers

Package info

Statistics

Security