Open-source event management and ticket selling platform — perfect for concerts, conferences, and everything in between 🎟️ If you find this project helpful, please consider giving us a star ⭐️
PHP attendize-alternativedoor-managementevent-check-inevent-managementevent-registrationevent-ticketingeventbrite-alternativeeventslaravelopen-sourcephpreactself-hostedsell-ticketssell-tickets-onlineticket-sellingticketing-systemtickettailor-alternativetito-alternative
Feature: Extract image metadata on upload (LQIP, width, height and avg colour) (#947)
Dave Earley2ad5454eba9d
diff --git a/backend/Dockerfile b/backend/Dockerfileindex b626f541c..609a307da 100644--- a/backend/Dockerfile+++ b/backend/Dockerfile@@ -9,7 +9,7 @@ RUN echo "" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf && \echo "user = www-data" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf && \echo "group = www-data" >> /usr/local/etc/php-fpm.d/docker-php-serversideup-pool.conf-RUN install-php-extensions intl+RUN install-php-extensions intl imagickCOPY --chown=www-data:www-data . .diff --git a/backend/Dockerfile.dev b/backend/Dockerfile.devindex 9aed46137..e4f9153f5 100644--- a/backend/Dockerfile.dev+++ b/backend/Dockerfile.dev@@ -12,7 +12,7 @@ COPY --chown=www-data:www-data . /var/www/html# Switch to root user to install PHP extensionsUSER root-RUN install-php-extensions intl+RUN install-php-extensions intl imagickUSER www-dataRUN chmod -R 755 /var/www/html/storage \diff --git a/backend/app/Console/Commands/BackfillImageMetadataCommand.php b/backend/app/Console/Commands/BackfillImageMetadataCommand.phpnew file mode 100644index 000000000..a15a0842a--- /dev/null+++ b/backend/app/Console/Commands/BackfillImageMetadataCommand.php@@ -0,0 +1,252 @@+<?php++namespace HiEvents\Console\Commands;++use HiEvents\DomainObjects\Generated\ImageDomainObjectAbstract;+use HiEvents\Models\Image;+use HiEvents\Services\Infrastructure\Image\DTO\ImageMetadataDTO;+use Illuminate\Console\Command;+use Illuminate\Filesystem\FilesystemManager;+use Imagick;+use Psr\Log\LoggerInterface;+use Throwable;++class BackfillImageMetadataCommand extends Command+{+ protected $signature = 'images:backfill-metadata+ {--limit=100 : Maximum number of images to process per batch}+ {--batch-size=50 : Number of images to process before clearing memory}+ {--dry-run : Show what would be done without actually doing it}+ {--force : Re-process images that already have metadata}';++ protected $description = 'Backfill image metadata (dimensions, average colour, LQIP) for existing images';++ private const LQIP_MAX_DIMENSION = 16;+ private const LQIP_QUALITY = 60;++ public function __construct(+ private readonly FilesystemManager $filesystemManager,+ private readonly LoggerInterface $logger,+ ) {+ parent::__construct();+ }++ public function handle(): int+ {+ if (!$this->isImagickAvailable()) {+ $this->error('Imagick extension is not available. Please install it first.');+ return self::FAILURE;+ }++ $this->info('Starting image metadata backfill...');++ $limit = (int)$this->option('limit');+ $batchSize = (int)$this->option('batch-size');+ $dryRun = $this->option('dry-run');+ $force = $this->option('force');++ if ($dryRun) {+ $this->warn('DRY RUN MODE - No changes will be made');+ }++ $query = Image::query()+ ->whereNull('deleted_at');++ if (!$force) {+ $query->where(function ($q) {+ $q->whereNull(ImageDomainObjectAbstract::WIDTH)+ ->orWhereNull(ImageDomainObjectAbstract::HEIGHT)+ ->orWhereNull(ImageDomainObjectAbstract::AVG_COLOUR)+ ->orWhereNull(ImageDomainObjectAbstract::LQIP_BASE64);+ });+ }++ $totalCount = $query->count();++ if ($totalCount === 0) {+ $this->info('No images found that need metadata backfill.');+ return self::SUCCESS;+ }++ $toProcess = min($totalCount, $limit);+ $this->info("Found {$totalCount} images without complete metadata. Processing {$toProcess}...");++ $progressBar = $this->output->createProgressBar($toProcess);+ $progressBar->start();++ $successCount = 0;+ $errorCount = 0;+ $skippedCount = 0;+ $processedInBatch = 0;++ $query->take($limit)+ ->orderBy('id')+ ->chunk($batchSize, function ($images) use (+ &$successCount,+ &$errorCount,+ &$skippedCount,+ &$processedInBatch,+ $progressBar,+ $dryRun,+ $batchSize,+ ) {+ foreach ($images as $image) {+ try {+ $result = $this->processImage($image, $dryRun);++ if ($result === 'success') {+ $successCount++;+ } elseif ($result === 'skipped') {+ $skippedCount++;+ } else {+ $errorCount++;+ }+ } catch (Throwable $e) {+ $this->newLine();+ $this->error("Failed to process image #{$image->id}: {$e->getMessage()}");+ $errorCount++;+ }++ $progressBar->advance();+ $processedInBatch++;++ if ($processedInBatch >= $batchSize) {+ gc_collect_cycles();+ $processedInBatch = 0;+ }+ }+ });++ $progressBar->finish();+ $this->newLine(2);++ $this->info('Backfill complete!');+ $this->table(+ ['Status', 'Count'],+ [+ ['Success', $successCount],+ ['Errors', $errorCount],+ ['Skipped', $skippedCount],+ ['Total Processed', $successCount + $errorCount + $skippedCount],+ ]+ );++ return $errorCount > 0 ? self::FAILURE : self::SUCCESS;+ }++ private function processImage(Image $image, bool $dryRun): string+ {+ $disk = $image->disk;+ $path = $image->path;++ if (!$disk || !$path) {+ $this->logger->warning("Image #{$image->id} has no disk or path");+ return 'skipped';+ }++ $filesystem = $this->filesystemManager->disk($disk);++ if (!$filesystem->exists($path)) {+ $this->logger->warning("Image file not found for image #{$image->id}: {$path}");+ return 'skipped';+ }++ if ($dryRun) {+ $this->newLine();+ $this->line("Would process: Image #{$image->id}, Path: {$path}");+ return 'success';+ }++ $tempFile = null;+ $imagick = null;++ try {+ $tempFile = tempnam(sys_get_temp_dir(), 'img_backfill_');+ file_put_contents($tempFile, $filesystem->get($path));++ $imagick = new Imagick($tempFile);++ $metadata = $this->extractMetadata($imagick);++ $image->update([+ ImageDomainObjectAbstract::WIDTH => $metadata->width,+ ImageDomainObjectAbstract::HEIGHT => $metadata->height,+ ImageDomainObjectAbstract::AVG_COLOUR => $metadata->avg_colour,+ ImageDomainObjectAbstract::LQIP_BASE64 => $metadata->lqip_base64,+ ]);++ return 'success';+ } finally {+ if ($imagick !== null) {+ $imagick->clear();+ $imagick->destroy();+ }++ if ($tempFile !== null && file_exists($tempFile)) {+ unlink($tempFile);+ }+ }+ }++ private function extractMetadata(Imagick $imagick): ImageMetadataDTO+ {+ $width = $imagick->getImageWidth();+ $height = $imagick->getImageHeight();+ $avgColour = $this->extractAverageColour($imagick);+ $lqipBase64 = $this->generateLqip($imagick);++ return new ImageMetadataDTO(+ width: $width,+ height: $height,+ avg_colour: $avgColour,+ lqip_base64: $lqipBase64,+ );+ }++ private function extractAverageColour(Imagick $imagick): string+ {+ $clone = clone $imagick;+ $clone->resizeImage(1, 1, Imagick::FILTER_LANCZOS, 1);+ $pixel = $clone->getImagePixelColor(0, 0);+ $rgb = $pixel->getColor();+ $clone->clear();+ $clone->destroy();++ return sprintf('#%02x%02x%02x', $rgb['r'], $rgb['g'], $rgb['b']);+ }++ private function generateLqip(Imagick $imagick): string+ {+ $clone = clone $imagick;++ $width = $clone->getImageWidth();+ $height = $clone->getImageHeight();++ if ($width > $height) {+ $newWidth = self::LQIP_MAX_DIMENSION;+ $newHeight = (int)round($height * (self::LQIP_MAX_DIMENSION / $width));+ } else {+ $newHeight = self::LQIP_MAX_DIMENSION;+ $newWidth = (int)round($width * (self::LQIP_MAX_DIMENSION / $height));+ }++ $newWidth = max(1, $newWidth);+ $newHeight = max(1, $newHeight);++ $clone->resizeImage($newWidth, $newHeight, Imagick::FILTER_LANCZOS, 1);+ $clone->setImageFormat('webp');+ $clone->setImageCompressionQuality(self::LQIP_QUALITY);+ $clone->stripImage();++ $blob = $clone->getImageBlob();+ $clone->clear();+ $clone->destroy();++ return 'data:image/webp;base64,' . base64_encode($blob);+ }++ private function isImagickAvailable(): bool+ {+ return extension_loaded('imagick') && class_exists(Imagick::class);+ }+}diff --git a/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.php b/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.phpindex 60059c09b..f2d88a668 100644--- a/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.php+++ b/backend/app/DomainObjects/Generated/ImageDomainObjectAbstract.php@@ -23,6 +23,10 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstracfinal public const CREATED_AT = 'created_at';final public const UPDATED_AT = 'updated_at';final public const DELETED_AT = 'deleted_at';+ final public const WIDTH = 'width';+ final public const HEIGHT = 'height';+ final public const AVG_COLOUR = 'avg_colour';+ final public const LQIP_BASE64 = 'lqip_base64';protected int $id;protected ?int $account_id = null;@@ -37,6 +41,10 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstracprotected ?string $created_at = 'CURRENT_TIMESTAMP';protected ?string $updated_at = 'CURRENT_TIMESTAMP';protected ?string $deleted_at = null;+ protected ?int $width = null;+ protected ?int $height = null;+ protected ?string $avg_colour = null;+ protected ?string $lqip_base64 = null;public function toArray(): array{@@ -54,6 +62,10 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstrac'created_at' => $this->created_at ?? null,'updated_at' => $this->updated_at ?? null,'deleted_at' => $this->deleted_at ?? null,+ 'width' => $this->width ?? null,+ 'height' => $this->height ?? null,+ 'avg_colour' => $this->avg_colour ?? null,+ 'lqip_base64' => $this->lqip_base64 ?? null,];}@@ -199,4 +211,48 @@ abstract class ImageDomainObjectAbstract extends \HiEvents\DomainObjects\Abstrac{return $this->deleted_at;}++ public function setWidth(?int $width): self+ {+ $this->width = $width;+ return $this;+ }++ public function getWidth(): ?int+ {+ return $this->width;+ }++ public function setHeight(?int $height): self+ {+ $this->height = $height;+ return $this;+ }++ public function getHeight(): ?int+ {+ return $this->height;+ }++ public function setAvgColour(?string $avg_colour): self+ {+ $this->avg_colour = $avg_colour;+ return $this;+ }++ public function getAvgColour(): ?string+ {+ return $this->avg_colour;+ }++ public function setLqipBase64(?string $lqip_base64): self+ {+ $this->lqip_base64 = $lqip_base64;+ return $this;+ }++ public function getLqipBase64(): ?string+ {+ return $this->lqip_base64;+ }}diff --git a/backend/app/Resources/Image/ImageResource.php b/backend/app/Resources/Image/ImageResource.phpindex 26c4cbaf5..244890e73 100644--- a/backend/app/Resources/Image/ImageResource.php+++ b/backend/app/Resources/Image/ImageResource.php@@ -20,7 +20,11 @@ class ImageResource extends BaseResource'size' => $this->getSize(),'file_name' => $this->getFileName(),'mime_type' => $this->getMimeType(),- 'type' => $this->getType()+ 'type' => $this->getType(),+ 'width' => $this->getWidth(),+ 'height' => $this->getHeight(),+ 'avg_colour' => $this->getAvgColour(),+ 'lqip_base64' => $this->getLqipBase64(),];}}diff --git a/backend/app/Services/Domain/Image/ImageUploadService.php b/backend/app/Services/Domain/Image/ImageUploadService.phpindex 267080cf2..c7fcf6f0f 100644--- a/backend/app/Services/Domain/Image/ImageUploadService.php+++ b/backend/app/Services/Domain/Image/ImageUploadService.php@@ -5,6 +5,7 @@ namespace HiEvents\Services\Domain\Image;use HiEvents\DomainObjects\ImageDomainObject;use HiEvents\Repository\Interfaces\ImageRepositoryInterface;use HiEvents\Services\Infrastructure\Image\Exception\CouldNotUploadImageException;+use HiEvents\Services\Infrastructure\Image\ImageMetadataService;use HiEvents\Services\Infrastructure\Image\ImageStorageService;use Illuminate\Http\UploadedFile;@@ -12,9 +13,9 @@ class ImageUploadService{public function __construct(private readonly ImageStorageService $imageStorageService,- private readonly ImageRepositoryInterface $imageRepository- )- {+ private readonly ImageRepositoryInterface $imageRepository,+ private readonly ImageMetadataService $imageMetadataService,+ ) {}/**@@ -29,8 +30,9 @@ class ImageUploadService): ImageDomainObject{$storedImage = $this->imageStorageService->store($image, $imageType);+ $metadata = $this->imageMetadataService->extractMetadata($image);- return $this->imageRepository->create([+ $data = ['account_id' => $accountId,'entity_id' => $entityId,'entity_type' => $entityType,@@ -40,6 +42,15 @@ class ImageUploadService'path' => $storedImage->path,'size' => $storedImage->size,'mime_type' => $storedImage->mime_type,- ]);+ ];++ if ($metadata !== null) {+ $data['width'] = $metadata->width;+ $data['height'] = $metadata->height;+ $data['avg_colour'] = $metadata->avg_colour;+ $data['lqip_base64'] = $metadata->lqip_base64;+ }++ return $this->imageRepository->create($data);}}diff --git a/backend/app/Services/Infrastructure/Image/DTO/ImageMetadataDTO.php b/backend/app/Services/Infrastructure/Image/DTO/ImageMetadataDTO.phpnew file mode 100644index 000000000..17bc7982f--- /dev/null+++ b/backend/app/Services/Infrastructure/Image/DTO/ImageMetadataDTO.php@@ -0,0 +1,14 @@+<?php++namespace HiEvents\Services\Infrastructure\Image\DTO;++readonly class ImageMetadataDTO+{+ public function __construct(+ public int $width,+ public int $height,+ public string $avg_colour,+ public string $lqip_base64,+ ) {+ }+}diff --git a/backend/app/Services/Infrastructure/Image/ImageMetadataService.php b/backend/app/Services/Infrastructure/Image/ImageMetadataService.phpnew file mode 100644index 000000000..ca6cbc67c--- /dev/null+++ b/backend/app/Services/Infrastructure/Image/ImageMetadataService.php@@ -0,0 +1,96 @@+<?php++namespace HiEvents\Services\Infrastructure\Image;++use HiEvents\Services\Infrastructure\Image\DTO\ImageMetadataDTO;+use Illuminate\Http\UploadedFile;+use Imagick;+use Psr\Log\LoggerInterface;++class ImageMetadataService+{+ private const LQIP_MAX_DIMENSION = 16;+ private const LQIP_QUALITY = 60;++ public function __construct(+ private readonly LoggerInterface $logger,+ ) {+ }++ public function extractMetadata(UploadedFile $image): ?ImageMetadataDTO+ {+ if (!$this->isImagickAvailable()) {+ return null;+ }++ try {+ $imagick = new Imagick($image->getRealPath());++ $width = $imagick->getImageWidth();+ $height = $imagick->getImageHeight();+ $avgColour = $this->extractAverageColour($imagick);+ $lqipBase64 = $this->generateLqip($imagick);++ $imagick->clear();+ $imagick->destroy();++ return new ImageMetadataDTO(+ width: $width,+ height: $height,+ avg_colour: $avgColour,+ lqip_base64: $lqipBase64,+ );+ } catch (\Exception $e) {+ $this->logger->warning('Failed to extract image metadata: ' . $e->getMessage());++ return null;+ }+ }++ private function isImagickAvailable(): bool+ {+ return extension_loaded('imagick') && class_exists(Imagick::class);+ }++ private function extractAverageColour(Imagick $imagick): string+ {+ $clone = clone $imagick;+ $clone->resizeImage(1, 1, Imagick::FILTER_LANCZOS, 1);+ $pixel = $clone->getImagePixelColor(0, 0);+ $rgb = $pixel->getColor();+ $clone->clear();+ $clone->destroy();++ return sprintf('#%02x%02x%02x', $rgb['r'], $rgb['g'], $rgb['b']);+ }++ private function generateLqip(Imagick $imagick): string+ {+ $clone = clone $imagick;++ $width = $clone->getImageWidth();+ $height = $clone->getImageHeight();++ if ($width > $height) {+ $newWidth = self::LQIP_MAX_DIMENSION;+ $newHeight = (int) round($height * (self::LQIP_MAX_DIMENSION / $width));+ } else {+ $newHeight = self::LQIP_MAX_DIMENSION;+ $newWidth = (int) round($width * (self::LQIP_MAX_DIMENSION / $height));+ }++ $newWidth = max(1, $newWidth);+ $newHeight = max(1, $newHeight);++ $clone->resizeImage($newWidth, $newHeight, Imagick::FILTER_LANCZOS, 1);+ $clone->setImageFormat('webp');+ $clone->setImageCompressionQuality(self::LQIP_QUALITY);+ $clone->stripImage();++ $blob = $clone->getImageBlob();+ $clone->clear();+ $clone->destroy();++ return 'data:image/webp;base64,' . base64_encode($blob);+ }+}diff --git a/backend/composer.json b/backend/composer.jsonindex bcb60aa74..55b0bb88f 100644--- a/backend/composer.json+++ b/backend/composer.json@@ -30,6 +30,9 @@"stripe/stripe-php": "^17.0","ext-xmlwriter": "*"},+ "suggest": {+ "ext-imagick": "Required for image dimension extraction and LQIP generation"+ },"require-dev": {"druc/laravel-langscanner": "dev-l12-compatibility","fakerphp/faker": "^1.9.1",diff --git a/backend/database/migrations/2025_12_07_150927_add_image_metadata_columns_to_images_table.php b/backend/database/migrations/2025_12_07_150927_add_image_metadata_columns_to_images_table.phpnew file mode 100644index 000000000..084d77fb6--- /dev/null+++ b/backend/database/migrations/2025_12_07_150927_add_image_metadata_columns_to_images_table.php@@ -0,0 +1,31 @@+<?php++use Illuminate\Database\Migrations\Migration;+use Illuminate\Database\Schema\Blueprint;+use Illuminate\Support\Facades\Schema;++return new class extends Migration+{+ /**+ * Run the migrations.+ */+ public function up(): void+ {+ Schema::table('images', function (Blueprint $table) {+ $table->unsignedInteger('width')->nullable()->after('mime_type');+ $table->unsignedInteger('height')->nullable()->after('width');+ $table->string('avg_colour', 7)->nullable()->after('height');+ $table->text('lqip_base64')->nullable()->after('avg_colour');+ });+ }++ /**+ * Reverse the migrations.+ */+ public function down(): void+ {+ Schema::table('images', function (Blueprint $table) {+ $table->dropColumn(['width', 'height', 'avg_colour', 'lqip_base64']);+ });+ }+};diff --git a/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.php b/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.phpindex 4d684c3aa..9f8f4328b 100644--- a/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.php+++ b/backend/tests/Unit/Services/Domain/Image/ImageUploadServiceTest.php@@ -5,8 +5,10 @@ namespace Tests\Unit\Services\Domain\Image;use HiEvents\DomainObjects\ImageDomainObject;use HiEvents\Repository\Interfaces\ImageRepositoryInterface;use HiEvents\Services\Domain\Image\ImageUploadService;+use HiEvents\Services\Infrastructure\Image\DTO\ImageMetadataDTO;use HiEvents\Services\Infrastructure\Image\DTO\ImageStorageResponseDTO;use HiEvents\Services\Infrastructure\Image\Exception\CouldNotUploadImageException;+use HiEvents\Services\Infrastructure\Image\ImageMetadataService;use HiEvents\Services\Infrastructure\Image\ImageStorageService;use Illuminate\Http\UploadedFile;use Mockery as m;@@ -16,6 +18,7 @@ class ImageUploadServiceTest extends TestCase{private ImageStorageService $imageStorageService;private ImageRepositoryInterface $imageRepository;+ private ImageMetadataService $imageMetadataService;private ImageUploadService $service;protected function setUp(): void@@ -24,14 +27,72 @@ class ImageUploadServiceTest extends TestCase$this->imageStorageService = m::mock(ImageStorageService::class);$this->imageRepository = m::mock(ImageRepositoryInterface::class);+ $this->imageMetadataService = m::mock(ImageMetadataService::class);$this->service = new ImageUploadService($this->imageStorageService,- $this->imageRepository+ $this->imageRepository,+ $this->imageMetadataService);}- public function testUploadSuccessfullyCreatesImageRecord(): void+ public function testUploadSuccessfullyCreatesImageRecordWithMetadata(): void+ {+ $uploadedFile = m::mock(UploadedFile::class);+ $storedImage = new ImageStorageResponseDTO(+ filename: 'foo.jpg',+ disk: 'public',+ path: 'images/foo.jpg',+ size: 123456,+ mime_type: 'image/jpeg'+ );+ $metadata = new ImageMetadataDTO(+ width: 800,+ height: 600,+ avg_colour: '#ff5500',+ lqip_base64: 'data:image/webp;base64,abc123',+ );+ $imageDomainObject = m::mock(ImageDomainObject::class);+ $accountId = 123;++ $this->imageStorageService+ ->shouldReceive('store')+ ->once()+ ->with($uploadedFile, 'profile')+ ->andReturn($storedImage);++ $this->imageMetadataService+ ->shouldReceive('extractMetadata')+ ->once()+ ->with($uploadedFile)+ ->andReturn($metadata);++ $this->imageRepository+ ->shouldReceive('create')+ ->once()+ ->with([+ 'account_id' => $accountId,+ 'entity_id' => 1,+ 'entity_type' => 'user',+ 'type' => 'profile',+ 'filename' => 'foo.jpg',+ 'disk' => 'public',+ 'path' => 'images/foo.jpg',+ 'size' => 123456,+ 'mime_type' => 'image/jpeg',+ 'width' => 800,+ 'height' => 600,+ 'avg_colour' => '#ff5500',+ 'lqip_base64' => 'data:image/webp;base64,abc123',+ ])+ ->andReturn($imageDomainObject);++ $result = $this->service->upload($uploadedFile, 1, 'user', 'profile', $accountId);++ $this->assertSame($imageDomainObject, $result);+ }++ public function testUploadSuccessfullyCreatesImageRecordWithoutMetadata(): void{$uploadedFile = m::mock(UploadedFile::class);$storedImage = new ImageStorageResponseDTO(@@ -50,6 +111,12 @@ class ImageUploadServiceTest extends TestCase->with($uploadedFile, 'profile')->andReturn($storedImage);+ $this->imageMetadataService+ ->shouldReceive('extractMetadata')+ ->once()+ ->with($uploadedFile)+ ->andReturn(null);+$this->imageRepository->shouldReceive('create')->once()diff --git a/backend/tests/Unit/Services/Infrastructure/Image/ImageMetadataServiceTest.php b/backend/tests/Unit/Services/Infrastructure/Image/ImageMetadataServiceTest.phpnew file mode 100644index 000000000..884e72a22--- /dev/null+++ b/backend/tests/Unit/Services/Infrastructure/Image/ImageMetadataServiceTest.php@@ -0,0 +1,95 @@+<?php++namespace Tests\Unit\Services\Infrastructure\Image;++use HiEvents\Services\Infrastructure\Image\ImageMetadataService;+use Illuminate\Http\UploadedFile;+use Mockery as m;+use PHPUnit\Framework\TestCase;+use Psr\Log\LoggerInterface;++class ImageMetadataServiceTest extends TestCase+{+ private LoggerInterface $logger;+ private ImageMetadataService $service;++ protected function setUp(): void+ {+ parent::setUp();++ $this->logger = m::mock(LoggerInterface::class);+ $this->service = new ImageMetadataService($this->logger);+ }++ public function testExtractMetadataReturnsNullWhenImagickNotAvailable(): void+ {+ if (extension_loaded('imagick')) {+ $this->markTestSkipped('This test requires Imagick to NOT be installed');+ }++ $uploadedFile = m::mock(UploadedFile::class);++ $result = $this->service->extractMetadata($uploadedFile);++ $this->assertNull($result);+ }++ public function testExtractMetadataReturnsMetadataWhenImagickAvailable(): void+ {+ if (!extension_loaded('imagick')) {+ $this->markTestSkipped('This test requires Imagick to be installed');+ }++ $testImagePath = $this->createTestImage();+ $uploadedFile = new UploadedFile($testImagePath, 'test.png', 'image/png', null, true);++ $result = $this->service->extractMetadata($uploadedFile);++ $this->assertNotNull($result);+ $this->assertEquals(100, $result->width);+ $this->assertEquals(100, $result->height);+ $this->assertMatchesRegularExpression('/^#[a-f0-9]{6}$/i', $result->avg_colour);+ $this->assertStringStartsWith('data:image/webp;base64,', $result->lqip_base64);++ unlink($testImagePath);+ }++ public function testExtractMetadataLogsWarningOnFailure(): void+ {+ if (!extension_loaded('imagick')) {+ $this->markTestSkipped('This test requires Imagick to be installed');+ }++ $uploadedFile = m::mock(UploadedFile::class);+ $uploadedFile->shouldReceive('getRealPath')+ ->once()+ ->andReturn('/nonexistent/path/to/image.png');++ $this->logger->shouldReceive('warning')+ ->once()+ ->with(m::type('string'));++ $result = $this->service->extractMetadata($uploadedFile);++ $this->assertNull($result);+ }++ private function createTestImage(): string+ {+ $imagick = new \Imagick();+ $imagick->newImage(100, 100, '#ff5500');+ $imagick->setImageFormat('png');++ $tempPath = sys_get_temp_dir() . '/test_image_' . uniqid() . '.png';+ $imagick->writeImage($tempPath);+ $imagick->destroy();++ return $tempPath;+ }++ protected function tearDown(): void+ {+ m::close();+ parent::tearDown();+ }+}diff --git a/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scss b/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scssindex 565577164..5fd6b1822 100644--- a/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scss+++ b/frontend/src/components/layouts/EventHomepage/EventHomepage.module.scss@@ -134,17 +134,47 @@ $transition-slow: 0.4s cubic-bezier(0.4, 0, 0.2, 1);width: 100%;max-height: 560px;overflow: hidden;+ background-color: var(--accent-soft);++ // When aspect ratio is provided via CSS custom property, use it+ // Otherwise fall back to auto sizing based on image+ &[style*="--cover-aspect-ratio"] {+ aspect-ratio: var(--cover-aspect-ratio);+ }@include mixins.respond-below(md) {max-height: 400px;}}+.coverLqip {+ position: absolute;+ inset: 0;+ width: 100%;+ height: 100%;+ object-fit: cover;+ filter: blur(20px);+ transform: scale(1.1);+ z-index: 0;+}+.coverImage {width: 100%;- height: auto;display: block;transition: transform $transition-slow;+ z-index: 1;++ // When wrapper has aspect ratio, image should fill it+ .coverWrapper[style*="--cover-aspect-ratio"] & {+ position: relative;+ height: 100%;+ object-fit: cover;+ }++ // When no aspect ratio, let image determine height naturally+ .coverWrapper:not([style*="--cover-aspect-ratio"]) & {+ height: auto;+ }.mainCard:hover & {transform: scale(1.02);diff --git a/frontend/src/components/layouts/EventHomepage/index.tsx b/frontend/src/components/layouts/EventHomepage/index.tsxindex 56f3659b4..8a29e6363 100644--- a/frontend/src/components/layouts/EventHomepage/index.tsx+++ b/frontend/src/components/layouts/EventHomepage/index.tsx@@ -1,9 +1,9 @@import classes from "./EventHomepage.module.scss";import SelectProducts from "../../routes/product-widget/SelectProducts";import "../../../styles/widget/default.scss";-import {useEffect, useRef, useState} from "react";+import React, {useEffect, useRef, useState} from "react";import {EventDocumentHead} from "../../common/EventDocumentHead";-import {eventCoverImageUrl, eventHomepageUrl, imageUrl, organizerHomepageUrl} from "../../../utilites/urlHelper.ts";+import {eventCoverImage, eventHomepageUrl, imageUrl, organizerHomepageUrl} from "../../../utilites/urlHelper.ts";import {Event, OrganizerStatus} from "../../../types.ts";import {EventNotAvailable} from "./EventNotAvailable";import {@@ -110,7 +110,8 @@ const EventHomepage = ({...loaderData}: EventHomepageProps) => {'--event-border-color': cssVars['--theme-border'],} as React.CSSProperties;- const coverImage = eventCoverImageUrl(event);+ const coverImageData = eventCoverImage(event);+ const coverImage = coverImageData?.url;const organizer = event.organizer!;const organizerSocials = organizer?.settings?.social_media_handles;const organizerLogo = imageUrl('ORGANIZER_LOGO', organizer?.images);@@ -209,7 +210,20 @@ const EventHomepage = ({...loaderData}: EventHomepageProps) => {{/* Hero Section */}<div className={classes.heroSection}>{coverImage && (- <div className={classes.coverWrapper}>+ <div+ className={classes.coverWrapper}+ style={(coverImageData?.width && coverImageData?.height) ? {+ '--cover-aspect-ratio': `${coverImageData.width} / ${coverImageData.height}`,+ } as React.CSSProperties : undefined}+ >+ {coverImageData?.lqip_base64 && (+ <img+ src={coverImageData.lqip_base64}+ alt=""+ aria-hidden="true"+ className={classes.coverLqip}+ />+ )}<imgsrc={coverImage}alt={event.title}diff --git a/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scss b/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scssindex 0b629fa27..35807a524 100644--- a/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scss+++ b/frontend/src/components/layouts/OrganizerHomepage/OrganizerHomepage.module.scss@@ -127,19 +127,36 @@ $transition-slow: 0.4s cubic-bezier(0.4, 0, 0.2, 1);.coverWrapper {position: relative;width: 100%;- aspect-ratio: 2.5 / 1;+ aspect-ratio: var(--cover-aspect-ratio, 2.5 / 1);+ max-height: 400px;overflow: hidden;+ background-color: var(--accent-soft);@include mixins.respond-below(md) {- aspect-ratio: 16 / 10;+ aspect-ratio: var(--cover-aspect-ratio, 16 / 10);+ max-height: 300px;}}+.coverLqip {+ position: absolute;+ inset: 0;+ width: 100%;+ height: 100%;+ object-fit: cover;+ filter: blur(20px);+ transform: scale(1.1);+ z-index: 0;+}+.coverImage {+ position: absolute;+ inset: 0;width: 100%;height: 100%;object-fit: cover;transition: transform $transition-slow;+ z-index: 1;.heroSection:hover & {transform: scale(1.02);diff --git a/frontend/src/components/layouts/OrganizerHomepage/index.tsx b/frontend/src/components/layouts/OrganizerHomepage/index.tsxindex 02a89241a..8fde5ba47 100644--- a/frontend/src/components/layouts/OrganizerHomepage/index.tsx+++ b/frontend/src/components/layouts/OrganizerHomepage/index.tsx@@ -148,7 +148,20 @@ export const OrganizerHomepage = ({{/* Hero Section */}<div className={classes.heroSection}>{organizerCover && (- <div className={classes.coverWrapper}>+ <div+ className={classes.coverWrapper}+ style={organizerCover?.width && organizerCover?.height ? {+ '--cover-aspect-ratio': `${organizerCover.width} / ${organizerCover.height}`,+ } as React.CSSProperties : undefined}+ >+ {organizerCover?.lqip_base64 && (+ <img+ src={organizerCover.lqip_base64}+ alt=""+ aria-hidden="true"+ className={classes.coverLqip}+ />+ )}<imgsrc={organizerCover.url}alt="Cover"diff --git a/frontend/src/types.ts b/frontend/src/types.tsindex c07b2f93a..a1967cb93 100644--- a/frontend/src/types.ts+++ b/frontend/src/types.ts@@ -160,6 +160,10 @@ export interface Image {size: number;mime_type: string;type: ImageType;+ width?: number | null;+ height?: number | null;+ avg_colour?: string | null;+ lqip_base64?: string | null;}export type ImageType = 'EVENT_COVER' | 'EDITOR_IMAGE' | 'ORGANIZER_LOGO' | 'ORGANIZER_COVER' | 'ORGANIZER_IMAGE' | 'TICKET_LOGO';diff --git a/frontend/src/utilites/urlHelper.ts b/frontend/src/utilites/urlHelper.tsindex e4e1f614c..b32ca77f8 100644--- a/frontend/src/utilites/urlHelper.ts+++ b/frontend/src/utilites/urlHelper.ts@@ -29,6 +29,10 @@ export const eventCoverImageUrl = (event: Event) => {return event?.images?.find((image) => image.type === 'EVENT_COVER')?.url;}+export const eventCoverImage = (event: Event): Image | undefined => {+ return event?.images?.find((image) => image.type === 'EVENT_COVER');+}+export const imageUrl = (imageType: ImageType, images?: Image[], fallbackUrl?: string) => {if (!images || images.length === 0) {return fallbackUrl || getConfig('VITE_DEFAULT_IMAGE_URL');