Mage2Plenty v2.3 - Tag Management & Export Foundations

We're excited to announce Mage2Plenty v2.3, introducing a comprehensive Tag Management System for PlentyONE integration and laying the groundwork for our upcoming Product Export capabilities. This release also brings improvements to category handling and several bug fixes.

What's New in v2.3

This release focuses on tag-based order organization, enhanced data providers for items and variations, and smarter category localization. We've also added infrastructure for product export that will power future releases.

Tag Management System

Organize Orders with PlentyONE Tags

The new tag management system enables you to assign and manage PlentyONE tags directly from Magento:

Tag Features:
  ├─ Create tags from Magento admin
  ├─ Assign tags to orders during export
  ├─ Configure tag rules per order status
  └─ TagOptions UI component for easy selection

Key Components:

• TagManagement Service - Full CRUD operations for PlentyONE tags
• TagOptions UI - Dropdown component for tag selection in admin forms
• Order Tag Assignment - Automatic tagging based on export configuration

Use Cases

• Fulfillment tracking - Tag orders by warehouse or shipping method
• Priority handling - Mark VIP or expedited orders
• Source identification - Tag orders by sales channel or store view
• Custom workflows - Integrate with PlentyONE processes and event procedures

Enhanced Data Providers

Item & Variation Data Providers

New centralized data providers for efficient PlentyONE data access:

// ItemDataProvider - Centralized item data access
$itemData = $itemDataProvider->get($itemId);

// VariationDataProvider - Efficient variation lookup
$variationData = $variationDataProvider->get($variationId);
$relations = $variationDataProvider->get($variationId, 'variationRelations');

Benefits:

• Unified data access patterns across modules
• Built-in caching for repeated lookups
• Batch response handling for API efficiency
• Memory optimization with reset capabilities

Category Improvements

Locale-Aware Category Names

Categories now resolve names correctly based on language configuration:

// New getDefaultName() method
// Returns category name in default/fallback language
$categoryName = $category->getDefaultName();

Improvements:

• Fixed category path resolution using correct locale
• Added getDefaultName() to Category model
• Enhanced CategoryIdCache with type-safe handling

Product Export Infrastructure

This release introduces foundational components for product export (coming in v2.4):

• MediaChecksumComputeService - Detects changed product images via checksum comparison
• Memory reset capabilities - Handles large batch operations efficiently
• Export context storage - Tracks export state and variation mappings

Bug Fixes

• Property Data Deletion - Fixed FlushData controller to properly delete all property records
• Profile Schedule Save - Added missing model property declaration
• Category Path Resolution - Now uses correct locale for category names
• Type Safety - Improved integer casting in category ID assignments

Upgrade Guide

Quick Upgrade

# Update via Composer
composer require softcommerce/mage2plenty-os:^2.3

# Run Magento updates
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento cache:flush

Updated Modules

Module	Version	Changes
module-plenty-client	2.1.0	Tag management system
module-plenty-order-profile	2.3.0	Order tag assignment
module-plenty-profile	2.1.0	TagOptions UI component
module-plenty-item	2.2.0	Data providers
module-plenty-category	2.2.0	getDefaultName method
module-core	2.2.0	MediaChecksumComputeService

What's Next

v2.4 Preview: Full product export from Magento to PlentyONE, including:

• Variation creation and updates
• Price synchronization
• Image upload with change detection
• Property and attribute mapping

Resources

• Complete Changelog
• Tag Management Guide (coming soon)
• GitHub Releases

---

Ready to organize your orders with tags? Upgrade to v2.3 today!