PHPackages                             blackbird/module-algolia-migrate-merchandising - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Search &amp; Filtering](/categories/search)
4. /
5. blackbird/module-algolia-migrate-merchandising

ActiveMagento2-module[Search &amp; Filtering](/categories/search)

blackbird/module-algolia-migrate-merchandising
==============================================

1.0.0(1y ago)00MITPHP

Since May 6Pushed 1y ago1 watchersCompare

[ Source](https://github.com/blackbird-agency/blackbird-magento2-algolia-migrate-merchandising)[ Packagist](https://packagist.org/packages/blackbird/module-algolia-migrate-merchandising)[ RSS](/packages/blackbird-module-algolia-migrate-merchandising/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

Blackbird\_AlgoliaMigrateMerchandising
======================================

[](#blackbird_algoliamigratemerchandising)

The **Blackbird\_AlgoliaMigrateMerchandising** module for Magento 2 allows you to migrate Algolia rules from the classic version to the **Algolia Merchandising Studio** version. It adjusts the rules by using a new format that better handles categories with a hierarchical structure.

Setup
-----

[](#setup)

### Get the package

[](#get-the-package)

**Zip Package:**

Unzip the package in app/code/Blackbird/CategoryEmptyButton, from the root of your Magento instance.

**Composer Package:**

```
composer require blackbird/module-algolia-migrate-merchandising

```

### Install the module

[](#install-the-module)

Go to your Magento root, then run the following Magento command:

```
php bin/magento setup:upgrade

```

**If you are in production mode, do not forget to recompile and redeploy the static resources, or to use the `--keep-generated` option.**

Functionality
-------------

[](#functionality)

The module transforms the old Algolia rules, where the `rule-context` uses Magento category IDs (e.g., `magento-category-$id`), into the new **Algolia Merchandising Studio** format. In this new format, the `categories` attribute is used to specify the full category **path** in a hierarchical structure.

### Migration Structure

[](#migration-structure)

- **Old Version**: Rules contain a `rule-context` that references a Magento category using an ID (e.g., `magento-category-$id`).
- **New Version**: Migrated rules use the `categories` attribute, which holds the full category path in a hierarchical format, reflecting the category structure in **Algolia Merchandising Studio**.

Migration Command
-----------------

[](#migration-command)

Once the module is installed, you can run the following command to migrate the Algolia rules.

```
bin/magento blackbird:migrate_algolia
```

Support
-------

[](#support)

- If you have any issue with this code, feel free to [open an issue](https://github.com/blackbird-agency/magento-2-category-empty-button/issues/new).
- If you want to contribute to this project, feel free to [create a pull request](https://github.com/blackbird-agency/magento-2-category-empty-button/compare).

Contact
-------

[](#contact)

For further information, contact us:

- by email:
- or by form: [https://black.bird.eu/en/contacts/](https://black.bird.eu/contacts/)

Authors
-------

[](#authors)

- **Emilie Wittmann** - *Maintainer* - [It's me!](https://github.com/emilie-blackbird)
- **Blackbird Team** - *Contributor* - [They're awesome!](https://github.com/blackbird-agency)

License
-------

[](#license)

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

***That's all folks!***

###  Health Score

24

—

LowBetter than 32% of packages

Maintenance49

Moderate activity, may be stable

Popularity0

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity37

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

371d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/12445118?v=4)[anthony-blackbird](/maintainers/anthony-blackbird)[@anthony-blackbird](https://github.com/anthony-blackbird)

---

Top Contributors

[![emilie-blackbird](https://avatars.githubusercontent.com/u/44096169?v=4)](https://github.com/emilie-blackbird "emilie-blackbird (1 commits)")

### Embed Badge

![Health badge](/badges/blackbird-module-algolia-migrate-merchandising/health.svg)

```
[![Health](https://phpackages.com/badges/blackbird-module-algolia-migrate-merchandising/health.svg)](https://phpackages.com/packages/blackbird-module-algolia-migrate-merchandising)
```

###  Alternatives

[algolia/algoliasearch-magento-2

Algolia Search &amp; Discovery extension for Magento 2

1881.8M16](/packages/algolia-algoliasearch-magento-2)[smile/module-elasticsuite-cms-search

Smile Elasticsuite - Cms Pages Search Module for Smile Elasticsuite.

25916.7k1](/packages/smile-module-elasticsuite-cms-search)[mageworx/module-searchsuiteautocomplete

Search Suite Autocomplete extension by MageWorx for Magento 2

34293.0k1](/packages/mageworx-module-searchsuiteautocomplete)[smile/elasticsuite-for-retailer

Smile ElasticSuite for Retailers - Magento2 toolkit for Retailers : Store Locator, Availability and Prices per store, etc...

18235.4k](/packages/smile-elasticsuite-for-retailer)[comwrap/module-elasticsuite-blog-search

Comwrap Elasticsuite - Blog Post Search Module for Smile Elasticsuite.

2092.2k](/packages/comwrap-module-elasticsuite-blog-search)[blackbird/module-hyva-algolia-search

Blackbird\_HyvaAlgoliaSearch makes Algolia\_AlgoliaSearch compatible with Hyvä Themes

1414.9k](/packages/blackbird-module-hyva-algolia-search)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
