Skip to main content
Shopper supports assigning images to products, variants, brands, collections and categories. It is an additional layer provided by the framework with the help of the Spatie Media Library

​
Configuration

The config/shopper/media.php file allows you to customize how media files are handled. Below are the available configuration options:

​
Storage Disk

Specifies the storage disk used to save media files. By default, Shopper uses the public disk, but you can change it to use services like S3, Cloudinary, or other storage systems. Since the file system is based on the Spatie Laravel Media Library, you also need to define the name of the collection of images and thumbnails for your Models. 
'storage' => [
    'collection_name' => 'uploads',
    'thumbnail_collection' => 'thumbnail',
    'disk_name' => 'public',
]

​
Accepts Mime Types

Lists the MIME types allowed for media files. This ensures that only specified file formats can be uploaded. For your need you can add more types. 
'accepts_mime_types' => [
    'image/jpg',
    'image/jpeg',
    'image/png',
]

​
Media Filesize

Sets the maximum allowed file size for media uploads (in kilobytes). This helps control file sizes to avoid performance issues. 
'max_size' => [
    'thumbnail' => 1024, // Default size for thumbnail image (1MB).
    'images' => 2048, // Default size for individual collection image for product (2MB)
]

​
Image Conversions

Configures image conversions to generate resized or optimized versions of uploaded images. For example, you can create thumbnails or mobile-friendly images. 
'conversions' => [
    'large' => [
        'width' => 800,
        'height' => 800,
    ],
    'medium' => [
        'width' => 500,
        'height' => 500,
    ],
]

​
Image Conversions

Shopper registers image conversions from the config/shopper/media.php conversions array. By default, two conversions are available: large (800x800) and medium (500x500). All conversions use Fit::Fill and preserve the original image format. To add custom conversions, add entries to the conversions config: 
'conversions' => [
    'large' => ['width' => 800, 'height' => 800],
    'medium' => ['width' => 500, 'height' => 500],
    'small' => ['width' => 200, 'height' => 200],
],

​
Retrieving Images

To get the thumbnail URL for a product, brand, or collection: 
$collection = config('shopper.media.storage.thumbnail_collection');

$product->getFirstMediaUrl($collection);
$product->getFirstMediaUrl($collection, 'medium');
To get gallery images: 
$collection = config('shopper.media.storage.collection_name');

$product->getMedia($collection);
$product->getFirstMediaUrl($collection);

​
Advanced Customization

If you need further customization, configure a custom disk in config/filesystems.php and update the disk_name in config/shopper/media.php. See the Laravel Filesystem documentation for details.