tourze/easy-admin-image-preview-field-bundle

EasyAdmin image preview field with modal support

1.0.0 2025-10-31 15:41 UTC

Requires

• easycorp/easyadmin-bundle: ^4
• symfony/config: ^7.3
• symfony/console: ^7.3
• symfony/dependency-injection: ^7.3
• symfony/event-dispatcher: ^7.3
• symfony/expression-language: ^7.3
• symfony/form: ^7.3
• symfony/framework-bundle: ^7.3
• symfony/http-foundation: ^7.3
• symfony/http-kernel: ^7.3
• symfony/messenger: ^7.3
• symfony/options-resolver: ^7.3
• symfony/property-access: ^7.3
• symfony/string: ^7.3
• symfony/twig-bundle: ^7.3
• symfony/yaml: ^7.3
• tourze/bundle-dependency: 1.*
• tourze/symfony-dependency-service-loader: 1.*
• twig/twig: ^3.21

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5
• symfony/phpunit-bridge: ^7.3
• tourze/phpunit-symfony-kernel-test: 1.*
• tourze/phpunit-symfony-unit-test: 1.*

MIT

README

English | 中文

EasyAdmin bundle providing image preview fields with modal support.

Usage

use Tourze\EasyAdminImagePreviewFieldBundle\Field\ImagePreviewField;

public function configureFields(string $pageName): iterable
{
    // Basic usage
    yield ImagePreviewField::new('url', 'Image');
    
    // Custom configuration
    yield ImagePreviewField::new('imageUrl', 'Preview')
        ->setWidthProperty('imageWidth')    // default: 'width'
        ->setHeightProperty('imageHeight')  // default: 'height'  
        ->setFilenameProperty('originalName') // default: 'fileName'
        ->setMaxSize(120, 80)              // list view size
        ->setDetailMaxSize(400, 300);      // detail view size
}

Features

• List view: Small thumbnails with modal preview on click
• Detail view: Larger preview images with "open in new window" link
• Configurable: Customize property names and sizes
• Responsive: Modal closes on click/ESC key