README

Avenyra Order Item Images

A Magento 2 module that captures and stores product thumbnail images for order items, making them available in the admin panel on order view page and via GraphQL for headless storefronts.

Features

Automatic Image Capture: Automatically captures product thumbnail URLs when orders are placed
Admin Panel Display: Shows product thumbnails in the order view page for better visual identification
GraphQL Support: Exposes thumbnail URLs via GraphQL for headless commerce implementations
Configurable Product Support: Intelligently selects child product images for configurable products
Database Storage: Stores thumbnail URLs in the database to preserve historical product images
Placeholder Fallback: Automatically uses placeholder images when product images are unavailable

Requirements

PHP 8.1+
Magento 2.4.5+

Installation

Via Composer (Recommended)

composer require avenyra/module-order-item-images
php bin/magento module:enable Avenyra_OrderItemImages
php bin/magento setup:upgrade
php bin/magento setup:di:compile
php bin/magento setup:static-content:deploy
php bin/magento cache:flush

How It Works

Order Placement

When a customer completes checkout, the module:

Captures the product thumbnail URL for each order item
For configurable products, uses the selected variant's image
Stores the thumbnail URL in the database table
Falls back to placeholder images if product images are unavailable

Admin Panel

The module enhances the order view page by:

Adding a "Thumbnail" column to the order items grid
Displaying product images (90px height) for visual identification

ScreenShots

Configurable Products

Simple & Bundle Products

Placeholder Images

GraphQL API

The module extends the OrderItemInterface with:

item_thumbnail_url field for retrieving product thumbnails
Automatic placeholder fallback for missing images
Full compatibility with headless storefronts

GraphQL Usage

Query Example

{
    customer {
        orders {
            items {
                items {
                    product_name
                    product_sku
                    item_thumbnail_url
                    quantity_ordered
                }
            }
        }
    }
}

Response Example

{
    "data": {
        "customer": {
            "orders": {
                "items": [
                    {
                        "items": [
                            {
                                "product_name": "Sample Product",
                                "product_sku": "SAMPLE-SKU",
                                "item_thumbnail_url": "https://example.com/media/catalog/product/cache/.../image.jpg",
                                "quantity_ordered": 2
                            }
                        ]
                    }
                ]
            }
        }
    }
}

Support

Found a bug or issue? Please open an issue on GitHub.

Author

Avenyra Solutions

avenyra / module-order-item-images

Maintainers

Package info

Statistics

Security