# justbetter/magento2-akeneo-bundle

> Magento2 bundle for extending the Akeneo connector with awesome features.

`composer require justbetter/magento2-akeneo-bundle`

Canonical URL: https://packagento.com/justbetter/magento2-akeneo-bundle

## At a glance

- **Vendor**: justbetter (https://packagento.com/justbetter.md)
- **Latest version**: 2.1.2 — released 2026-01-27
- **Pricing**: Free
- **Package type**: Magento 2 module
- **Status**: active, accepting new buyers

## Installation

Packagento is licence-gated, so even free packages need a licence on a project before Composer can resolve them.

1. **Sign in or create an account** at https://packagento.com/customer/account/.

2. **Add the package to your account.** Open https://packagento.com/justbetter/magento2-akeneo-bundle and complete the free checkout. A licence is minted automatically.

3. **Create or pick a project, then activate the licence on it.**
   - Projects represent the Magento installs you deploy to. Manage them at https://packagento.com/projects/.
   - Activate the new licence on the project you'll deploy this package to. Activation is what generates the Composer credentials scoped to that project.

4. **Add the project credentials to your Magento codebase.**

   Grab the project's public + private key from https://packagento.com/projects/ (open the project, then its Credentials tab), and add them to `auth.json`:

   ```json
   {
     "http-basic": {
       "packagento.com": {
         "username": "ppk_live_...",
         "password": "psk_live_..."
       }
     }
   }
   ```

   Add the Packagento Composer repository to `composer.json`:

   ```json
   {
     "repositories": [
       { "type": "composer", "url": "https://packagento.com" }
     ]
   }
   ```

5. **Install and apply.**

   ```bash
   composer require justbetter/magento2-akeneo-bundle:*
   bin/magento setup:upgrade
   bin/magento setup:di:compile
   bin/magento cache:flush
   ```

## What it does

Magento2 bundle for extending the Akeneo connector with awesome features.

## README

<a href="https://github.com/justbetter/magento2-akeneo-bundle" title="JustBetter Magento 2 Akeneo Bundle">
    <img src="./.github/assets/banner.svg" alt="JustBetter Magento 2 Akeneo Bundle - Essential features the Akeneo Connector is missing">
</a>
<h1>JustBetter - Magento 2 Akeneo Bundle</h1>
<a id="readme-top"></a>

[![Latest Version on Packagist][packagist-version-shield]][packagist-version-url]
[![GPL-3.0 License][license-shield]][license-url]
[![Total Downloads][packagist-downloads-shield]][packagist-downloads-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]

<br />
<div align="center">
  <a href="https://justbetter.nl">
    <img src="https://raw.githubusercontent.com/justbetter/art/master/justbetter-logo.png" alt="JustBetter Logo" width="200">
  </a>

  <h3 align="center">JustBetter - Magento 2 Akeneo Bundle</h3>

  <p align="center">
    Extends the official <a href="https://github.com/akeneo/magento2-connector-community">Akeneo Connector</a> with several features and optimizations.
    <br />
    <a href="https://github.com/justbetter/magento2-akeneo-bundle/issues">Report Bug</a>
    ·
    <a href="https://github.com/justbetter/magento2-akeneo-bundle/issues">Request Feature</a>
  </p>
</div>

<details>
  <summary>Table of Contents</summary>
  <ol>
    <li>
      <a href="#about-the-package">About The Package</a>
      <ul>
        <li><a href="#built-with">Built With</a></li>
      </ul>
    </li>
    <li>
      <a href="#getting-started">Getting Started</a>
      <ul>
        <li><a href="#prerequisites">Prerequisites</a></li>
        <li><a href="#installation">Installation</a></li>
      </ul>
    </li>
    <li><a href="#features">Features</a></li>
    <li><a href="#configuration">Configuration</a></li>
    <li><a href="#usage">Usage</a></li>
    <li><a href="#events">Events</a></li>
    <li><a href="#contributing">Contributing</a></li>
    <li><a href="#license">License</a></li>
    <li><a href="#contact">Contact</a></li>
  </ol>
</details>

### About The Package

This Magento 2 extension made by [JustBetter](https://justbetter.nl) extends the official [Akeneo Connector](https://github.com/akeneo/magento2-connector-community) with several features and optimizations.

These features can be enabled / disabled via an extra configuration section called `JustBetter Akeneo` that is added to the default Akeneo Connector Configuration in Magento.

#### Built With

* [![PHP][PHP-badge]][PHP-url]
* [![Magento][Magento-badge]][Magento-url]
* [![Akeneo][Akeneo-badge]][Akeneo-url]

#### Contributors

Thanks to all the people who have contributed to this project:

<a href="https://github.com/justbetter/magento2-akeneo-bundle/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=justbetter/magento2-akeneo-bundle" alt="Contributors" />
</a>

<p align="right">(<a href="#readme-top">back to top</a>)</p>

### Getting Started

#### Installation

1. Install via Composer
   ```sh
   composer require justbetter/magento2-akeneo-bundle
   ```

2. Enable the module
   ```sh
   bin/magento module:enable JustBetter_AkeneoBundle
   ```

3. Run setup upgrade and flush cache
   ```sh
   bin/magento setup:upgrade && bin/magento cache:flush
   ```

<p align="right">(<a href="#readme-top">back to top</a>)</p>

### Features

#### Feature Overview

For detailed documentation of each feature, see **[FEATURES.md](FEATURES.md)**.  
For configuration instructions and best practices, see **[Configuration Guide](FEATURES.md#configuration-guide)**.

| Category | Feature | Configuration Path |
|----------|---------|-------------------|
| **<a href="FEATURES.md#product-import-features">Product Import</a>** | <a href="FEATURES.md#important-attributes">Important Attributes</a> | JustBetter Akeneo > Important Attributes |
| | <a href="FEATURES.md#default-store-values">Default Store Values</a> | JustBetter Akeneo > Default Store Values |
| | <a href="FEATURES.md#exclude-families">Exclude Families from Import</a> | Products Filters > Excluded Families |
| | <a href="FEATURES.md#dynamic-family-filtering">Dynamic Family Filtering</a> | Products Filters > Dynamic Family Filtering |
| | <a href="FEATURES.md#remove-redundant-eav">Remove Redundant EAV</a> | JustBetter Akeneo > Remove Redundant EAV |
| **<a href="FEATURES.md#category-features">Category</a>** | <a href="FEATURES.md#category-exist">Category Exist - Skip URL Regeneration</a> | JustBetter Akeneo > Category Exist |
| **<a href="FEATURES.md#tax--pricing-features">Tax & Pricing</a>** | <a href="FEATURES.md#set-tax-class">Set Tax Class</a> | JustBetter Akeneo > Set Tax Class |
| **<a href="FEATURES.md#attribute-features">Attributes</a>** | <a href="FEATURES.md#metric-units">Metric Units Import</a> | JustBetter Akeneo > Enable Metric Units |
| | <a href="FEATURES.md#format-media-name">Format Media Name (SEO)</a> | JustBetter Akeneo > Format Media Name |
| **<a href="FEATURES.md#visibility-features">Visibility</a>** | <a href="FEATURES.md#not-visible-individually">Set Families Not Visible</a> | JustBetter Akeneo > Not Visible Families |
| **<a href="FEATURES.md#website-association-features">Website Association</a>** | <a href="FEATURES.md#required-attribute-mapping">Required Attribute Mapping</a> | Products > Required Attribute Mapping |
| **<a href="FEATURES.md#management--administration">Management</a>** | <a href="FEATURES.md#akeneo-manager">Akeneo Manager</a> | JustBetter Akeneo > Akeneo Manager |
| **<a href="FEATURES.md#notification-features">Notifications</a>** | <a href="FEATURES.md#slack-notifications">Slack Notifications</a> | JustBetter Akeneo > Slack |
| **<a href="FEATURES.md#event-system">Events</a>** | <a href="FEATURES.md#import-finished-events">Import Finished Events</a> | - |

<p align="right">(<a href="#readme-top">back to top</a>)</p>

### Configuration

All features are configured in the Magento Admin Panel:

_(README truncated for .md surface. Full README on https://packagento.com/justbetter/magento2-akeneo-bundle.)_

## Recent Versions

| Version | Released |
|---|---|
| 2.1.2 | 2026-01-27 |
| 2.1.1 | 2026-01-26 |
| 2.1.0 | 2026-01-16 |
| 2.0.0 | 2025-11-26 |
| 1.19.3 | 2025-08-01 |
| 1.19.2 | 2025-07-11 |
| 1.19.1 | 2025-07-02 |
| 1.19.0 | 2025-02-07 |
| 1.18.1 | 2025-01-14 |
| 1.18.0 | 2025-01-08 |

Showing 10 of 50 versions. Full release history on https://packagento.com/justbetter/magento2-akeneo-bundle.

## Dependencies

### Require

| Package | Constraint |
|---|---|
| akeneo/module-magento2-connector-community | ^105.1.0 |
| justbetter/magento2-core | ^1.0.0 |
| php | ^8.2 |

### Require (dev)

| Package | Constraint |
|---|---|
| bitexpert/phpstan-magento | ^0.11.0 |
| magento/magento-coding-standard | ^33 |
| phpro/grumphp | ^2.0 |
| phpstan/phpstan | ^1.10 |
| squizlabs/php_codesniffer | ^3.0 |

## Quality

Latest release (2.1.2) fails the Packagento QA pipeline. Verdicts below are per-cell (Magento line × PHP version) for the matrixed tools, and run-once for the static / security tiers.


### Compatibility

Each Magento line is installed on its supported PHP versions, then the module is built (DI compile + static-content deploy). Cells show passed / failed / untested; staircase gaps render as `–`.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | Pass | Pass | – | – |
| 2.4.8 | – | Pass | not tested | – |
| 2.4.9 | – | – | not tested | not tested |


### Code Quality

Advisory checks against the module's source. Never affect the Compatibility verdict — a phpcs finding can't make a module incompatible.

#### Static Analysis

Coding standards (phpcs), mess detection (phpmd), copy-pasted code (cpd), PHP cross-version compatibility, composer.json validity. Each runs once for the whole module.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| PHPCS | Warning | 42 | 42 warnings (ruleset: Magento2) |
| PHPMD | Warning | 24 | 24 rule violations (UnusedFormalParameter:10, IfStatementAssignment:4, CyclomaticComplexity:3, UnusedLocalVariable:3, NPathComplexity:2) |
| Cpd | Pass | 0 |  |
| Composer validate | Pass | 0 |  |

#### PHPStan

Type-checks the module against a real Magento install. Re-runs per Magento + PHP version because resolvable symbols differ between releases.

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | 1 | 1 | – | – |
| 2.4.8 | – | 1 | 1 | – |
| 2.4.9 | – | – | 1 | 1 |


### Tests

Unit and integration suites run per Magento + PHP cell. Test failures speak to the module's behaviour, not its compatibility with a line, so they're reported here separately.

#### Unit Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |

#### Integration Tests

| Magento | PHP 8.2 | PHP 8.3 | PHP 8.4 | PHP 8.5 |
|---|---|---|---|---|
| 2.4.7 | N/A | N/A | – | – |
| 2.4.8 | – | N/A | N/A | – |
| 2.4.9 | – | – | N/A | N/A |


### Security

Dependency-advisory audit (composer audit) plus a source malware scan. A malware detection fails the version outright.

| Tool | Status | Findings | Summary |
|---|---|---|---|
| Composer audit | Pass | 0 |  |
| Malware scan | Pass | 0 |  |

## Licence and pricing

Free. A licence is still minted on checkout and bound to your project for Composer access — no payment step.

Refundable within 14 days of first purchase via https://packagento.com/account/refunds/.

## Install via Claude Code or any MCP client

The Packagento MCP server can run the licence + project + Composer steps above in one tool call:

```
purchase_and_install_packages(
  composer_names=["justbetter/magento2-akeneo-bundle"],
  project_id="proj_xxx"
)
```

This handles cart, checkout, licence minting, project activation, and writes auth.json credentials. Connect a client with `claude mcp add packagento https://mcp.packagento.com`. Full setup at https://packagento.com/docs/mcp-setup.

## Vendor

justbetter is a Magento 2 vendor on Packagento. See https://packagento.com/justbetter.md for their full catalogue.