PHPackages                             amphibee/akeneo-connector - 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. [API Development](/categories/api)
4. /
5. amphibee/akeneo-connector

ActiveWordpress-plugin[API Development](/categories/api)

amphibee/akeneo-connector
=========================

Connect Akeneo with WooCommerce. The plugin uses the Akeneo api to import Akeneo PIM data (attributes, products, variations..)

1.22.2(1y ago)01962[1 issues](https://github.com/AmphiBee/Akeneo-Connector/issues)[8 PRs](https://github.com/AmphiBee/Akeneo-Connector/pulls)GPL-3.0+PHPPHP &gt;=7.4.0

Since Sep 6Pushed 2mo ago2 watchersCompare

[ Source](https://github.com/AmphiBee/Akeneo-Connector)[ Packagist](https://packagist.org/packages/amphibee/akeneo-connector)[ Docs](https://amphibee.fr)[ RSS](/packages/amphibee-akeneo-connector/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependencies (14)Versions (13)Used By (0)

Akeneo Connector for WooCommerce
================================

[](#akeneo-connector-for-woocommerce)

Overview
--------

[](#overview)

The Akeneo Connector for WooCommerce is a powerful integration tool that synchronizes product data between Akeneo PIM (Product Information Management) and WooCommerce. This connector enables seamless product data management by importing various entities from Akeneo to your WooCommerce store.

Features
--------

[](#features)

- **Comprehensive Data Import**: Import categories, attributes, attribute options, product models, and products from Akeneo to WooCommerce.
- **Smart Change Detection**: Uses hash-based change detection to only import modified data, significantly improving performance.
- **Multilingual Support**: Full support for multilingual content with automatic translation synchronization.
- **Robust Error Handling**: Advanced error logging and retry mechanisms for API calls.
- **WP-CLI Commands**: Convenient command-line interface for running imports and migrations.
- **Variable Products Support**: Complete support for Akeneo product models as WooCommerce variable products.

Requirements
------------

[](#requirements)

- WordPress 5.0+
- WooCommerce 4.0+
- Akeneo PIM 4.0+
- PHP 7.4+

Installation
------------

[](#installation)

1. Upload the plugin files to the `/wp-content/plugins/akeneo-connector` directory, or install the plugin through the WordPress plugins screen.
2. Activate the plugin through the 'Plugins' screen in WordPress.
3. Configure the Akeneo API credentials in the plugin settings.

Configuration
-------------

[](#configuration)

### API Credentials

[](#api-credentials)

Navigate to the Akeneo Connector settings page and enter your Akeneo API credentials:

- Akeneo Host URL
- Client ID
- Client Secret
- Username
- Password
- Channel (optional)

### Retry Configuration

[](#retry-configuration)

The connector includes a configurable retry mechanism for API calls:

```
'retry' => [
    'enabled' => true,
    'max_retries' => 3,
    'delay' => 2,
    'status_codes' => [429, 500, 502, 503, 504],
],
```

Usage
-----

[](#usage)

### WP-CLI Commands

[](#wp-cli-commands)

The connector provides several WP-CLI commands for importing data:

```
# Import categories
wp akeneo categories import

# Import attributes
wp akeneo attributes import

# Import attribute options
wp akeneo attribute_options import

# Import product models (variable products)
wp akeneo models import

# Import products
wp akeneo products import

# Run migrations
wp akeneo migrate_hash_column run
wp akeneo migrate_attribute_hash run
```

### Scheduled Imports

[](#scheduled-imports)

You can set up cron jobs to run imports automatically:

```
# Example cron job to import products every hour
0 * * * * cd /path/to/wordpress && wp akeneo products import --path=/path/to/wordpress
```

Data Mapping
------------

[](#data-mapping)

The connector uses a mapping system to determine how Akeneo attributes should be imported into WooCommerce:

- **global\_attribute**: Imported as a WooCommerce global attribute (visible to customers)
- **private\_global\_attribute**: Imported as a WooCommerce global attribute (not visible to customers)
- **text\_attribute**: Imported as a WooCommerce text attribute
- **post\_meta**: Imported as a product meta field
- **external\_media**: Imported as external media

Performance Optimization
------------------------

[](#performance-optimization)

The connector implements several performance optimizations:

1. **Hash-based Change Detection**: Only imports data that has changed since the last import.
2. **Batch Processing**: Processes data in batches to reduce memory usage.
3. **API Retry Mechanism**: Automatically retries failed API calls with configurable backoff.

Advanced Features
-----------------

[](#advanced-features)

### Product Models and Variations

[](#product-models-and-variations)

The connector fully supports Akeneo's product models and variants:

- Product models are imported as WooCommerce variable products
- Product variants are imported as WooCommerce product variations
- Attribute axes are properly mapped to WooCommerce variation attributes

### Multilingual Support

[](#multilingual-support)

The connector supports multilingual content through integration with WPML or Polylang:

- Automatically creates translations for products, categories, and attributes
- Synchronizes translations between different language versions

Troubleshooting
---------------

[](#troubleshooting)

### Logging

[](#logging)

The connector logs all import activities and errors to log files located in:

```
/path/to/wordpress/logs/akeneo_connector-debug.log
/path/to/wordpress/logs/akeneo_connector-error.log

```

### Common Issues

[](#common-issues)

- **API Connection Issues**: Verify your Akeneo API credentials and ensure your server can reach the Akeneo instance.
- **Memory Limit Errors**: Increase PHP memory limit in your wp-config.php file.
- **Import Timeouts**: For large catalogs, consider importing data in smaller batches or increasing PHP execution time.

Contributing
------------

[](#contributing)

Contributions to the Akeneo Connector are welcome! Please feel free to submit pull requests or create issues for bugs and feature requests.

License
-------

[](#license)

The Akeneo Connector for WooCommerce is licensed under the MIT License.

Credits
-------

[](#credits)

Developed by [Amphibee](https://amphibee.fr/) - Specialists in e-commerce and PIM integration.

###  Health Score

38

—

LowBetter than 85% of packages

Maintenance68

Regular maintenance activity

Popularity14

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity50

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 78.4% 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

Every ~196 days

Total

4

Last Release

391d ago

PHP version history (2 changes)1.16.0PHP &gt;=7.2.0

1.21PHP &gt;=7.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/8435080f3e74b629258f291a62cb72aa9d63ee44d74e588f594dc6378c328fa2?d=identicon)[amphibee](/maintainers/amphibee)

---

Top Contributors

[![ogorzalka](https://avatars.githubusercontent.com/u/149651?v=4)](https://github.com/ogorzalka "ogorzalka (40 commits)")[![chermant](https://avatars.githubusercontent.com/u/92034659?v=4)](https://github.com/chermant "chermant (5 commits)")[![renovate[bot]](https://avatars.githubusercontent.com/in/2740?v=4)](https://github.com/renovate[bot] "renovate[bot] (3 commits)")[![tgeorgel](https://avatars.githubusercontent.com/u/11785727?v=4)](https://github.com/tgeorgel "tgeorgel (3 commits)")

---

Tags

pluginwordpress

###  Code Quality

Code StylePHP CS Fixer

### Embed Badge

![Health badge](/badges/amphibee-akeneo-connector/health.svg)

```
[![Health](https://phpackages.com/badges/amphibee-akeneo-connector/health.svg)](https://phpackages.com/packages/amphibee-akeneo-connector)
```

###  Alternatives

[sylius/sylius

E-Commerce platform for PHP, based on Symfony framework.

8.4k5.6M651](/packages/sylius-sylius)[prestashop/prestashop

PrestaShop is an Open Source e-commerce platform, committed to providing the best shopping cart experience for both merchants and customers.

9.0k15.4k](/packages/prestashop-prestashop)[googleads/googleads-php-lib

Google Ad Manager SOAP API Client Library for PHP

67410.3M25](/packages/googleads-googleads-php-lib)[sybrew/the-seo-framework

An automated, advanced, accessible, unbranded and extremely fast SEO solution for any WordPress website.

47078.8k](/packages/sybrew-the-seo-framework)[open-dxp/opendxp

Content &amp; Product Management Framework (CMS/PIM)

7310.3k29](/packages/open-dxp-opendxp)[imranhsayed/headless-cms

A WordPress plugin that adds features to use WordPress as a headless CMS with any front-end environment using REST API

2125.1k](/packages/imranhsayed-headless-cms)

PHPackages © 2026

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