product_manager_tool

Introduction

Product Manager Tool provides powerful bulk management capabilities for Drupal Commerce products and variations. It enables you to clone Layout Builder configurations and update fields across multiple products simultaneously, with full translation support.

Key benefits: Save hours of repetitive work by applying layout templates and field updates to hundreds of products at once, while maintaining complete control over what gets updated through an intuitive preview and confirmation workflow.

Features

Layout Template Manager

• Create Templates: Save any product's Layout Builder configuration as a reusable template
• Bulk Apply Layouts: Clone layouts to multiple products with a single click
• Translation Support: Apply layouts to specific language versions or all translations
• Template Products: Special support for products prefixed with [TEMPLATE] for easy identification
• Block Preservation: All block configurations, settings, and content are maintained during cloning
• Preview Mode: See exactly which products will be updated before applying changes

Field Manager

• Bulk Field Updates: Update empty fields across multiple products or variations simultaneously
• Empty Field Detection: Automatically identifies which fields need values
• Override Control: Choose per-field whether to overwrite existing values or only fill empty ones
• Multi-language Support: Update specific translations or all languages at once
• Field Statistics: View detailed reports showing how many entities have empty vs filled fields
• Complex Field Support: Works with Entity Reference, Inline Entity Form, Paragraphs, and all standard Drupal field types
• Translation-aware: Per-language field status reporting and selective translation updates

Core Capabilities

• Entity Selection: Flexible checkbox-based selection with filtering options
• Dry-run Preview: See what will change before committing to updates
• Permission System: Granular access control for all operations
• Progress Tracking: Detailed statistics on successful updates, skips, and failures
• Error Handling: Comprehensive validation and error reporting
• Gin Theme Compatible: Fully optimized for Gin admin theme in both light and dark modes

Use Cases

• Apply a standard product layout across your entire catalog
• Fill missing fields (descriptions, specifications, etc.) across multiple products
• Update product information in multiple languages simultaneously
• Maintain consistent product presentation across product types
• Migrate layout configurations during site restructuring
• Quickly populate newly added fields across existing products

Post-Installation

1. Enable the Module

drush en product_manager_tool

2. Configure Permissions

Navigate to /admin/people/permissions and assign these permissions:

• Access Product Manager Tool: Basic access to the interface
• Manage Product Layouts: Create and apply layout templates
• Bulk Update Product Fields: Update fields across multiple entities
• Create Layout Templates: Save new layout templates

3. Access the Tool

Navigate to: /admin/commerce/product-manager-tool

The interface provides two main tabs:

• Layout Manager: For managing and applying layout templates
• Field Manager: For bulk field updates

4. Using Layout Templates

1. Create a product with your desired Layout Builder configuration
2. Optionally, prefix the product title with [TEMPLATE] for easy identification
3. Go to Layout Manager tab
4. Select your template product and save it as a template
5. Select target products and apply the template

5. Using Field Manager

1. Select entity type (Product or Variation)
2. Choose the product/variation type
3. Select language and filter options
4. Check products you want to update
5. Fill in field values and configure options
6. Preview and confirm changes

No additional configuration is required. The module works immediately after installation and permission assignment.

Additional Requirements

Required Drupal Core

• Drupal 10 or Drupal 11

Required Modules

• Commerce - Drupal Commerce core module
• Commerce Product - Product entities and management
• Layout Builder - Drupal core Layout Builder (for layout features)
• Inline Entity Form - For complex field type support

No External Libraries Required

All functionality is self-contained within the module and its dependencies.

Recommended modules/libraries

Enhancing Functionality

• Gin Admin Theme - Optimized UI experience (fully compatible with light and dark modes)
• Disable Field - Integration for managing disabled fields in bulk operations
• Field Group - Better field organization in the interface

Complementary Modules

• Commerce Bulk - Additional bulk operations for other Commerce entities
• Admin Toolbar - Quick access to the Product Manager Tool

Supporting this Module

Contributing

• Issue Queue: Report bugs and request features on the project issue queue
• Patches: Contributions and improvements are welcome
• Testing: Help test beta releases and provide feedback
• Documentation: Improve documentation and add usage examples

Sponsorship

If this module saves you time and you'd like to support ongoing development:

• Star the project on Drupal.org
• Share your success stories in the issue queue
• Credit the module in your client projects

Community Documentation

Getting Started

• Full Documentation: See README.md in the module for comprehensive usage guide
• Permissions Setup: Detailed permission configuration examples included
• Troubleshooting Guide: Common issues and solutions in documentation

Quick Links

• Access URL: /admin/commerce/product-manager-tool
• Permissions: /admin/people/permissions (search for "Product Manager")
• Issue Queue: Report bugs and request features

Best Practices

• Start Small: Test with a few products before bulk operations
• Use Preview: Always preview changes before applying
• Template Products: Create dedicated template products with [TEMPLATE] prefix
• Check Permissions: Verify users have appropriate entity and field access

Security and Performance

Security Features

• Permission-based access control
• Per-entity access validation
• Field-level permission checks
• Input sanitization and validation
• CSRF protection via Drupal Form API
• Comprehensive audit logging

Performance Considerations

• Recommended batch size: 100-500 products per operation
• Translation updates: Processing time increases with number of languages
• Complex fields: IEF and Paragraphs require more processing time
• Memory: Increase PHP memory limit for very large operations

Technical Details

Architecture

• Service-oriented: Modular service architecture for extensibility
• Form API: Standard Drupal form workflows with AJAX
• Entity API: Proper entity handling and validation
• Translation API: Full integration with Drupal content translation

Browser Compatibility

• All modern browsers (Chrome, Firefox, Safari, Edge)
• Responsive design for tablet and desktop
• Optimized for Gin admin theme
• Works with standard Drupal admin themes (Seven, Claro)

This project has been developed for the Drupal Commerce community to address the need for efficient bulk product management with layout and field control capabilities.