Zwischenstand vom 29.05.2026

2026-05-29 11:14:02 +02:00
parent b6d2142214
commit dba154e572
36 changed files with 5113 additions and 649 deletions
--- a/packages/vitec/Classes/Controller/OgImageController.php
+++ b/packages/vitec/Classes/Controller/OgImageController.php
@@ -0,0 +1,152 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\Controller;
+
+use Evomedien\Vitec\Service\OgImageGeneratorService;
+use Psr\Http\Message\ResponseInterface;
+use Psr\Http\Message\ServerRequestInterface;
+use TYPO3\CMS\Backend\Attribute\AsController;
+use TYPO3\CMS\Backend\Routing\UriBuilder;
+use TYPO3\CMS\Backend\Template\ModuleTemplateFactory;
+use TYPO3\CMS\Core\Http\JsonResponse;
+use TYPO3\CMS\Core\Http\RedirectResponse;
+use TYPO3\CMS\Core\Messaging\FlashMessage;
+use TYPO3\CMS\Core\Messaging\FlashMessageService;
+use TYPO3\CMS\Core\Page\PageRenderer;
+use TYPO3\CMS\Core\Type\ContextualFeedbackSeverity;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
+/**
+ * Backend module controller for OG Image generation.
+ */
+#[AsController]
+final class OgImageController
+{
+    public function __construct(
+        private readonly ModuleTemplateFactory $moduleTemplateFactory,
+        private readonly OgImageGeneratorService $ogImageGeneratorService,
+        private readonly FlashMessageService $flashMessageService,
+        private readonly PageRenderer $pageRenderer,
+        private readonly UriBuilder $uriBuilder,
+    ) {}
+
+    /**
+     * Renders the OG image builder form.
+     */
+    public function indexAction(ServerRequestInterface $request): ResponseInterface
+    {
+        $this->pageRenderer->addJsFile(
+            'EXT:vitec/Resources/Public/Javascript/og-image-preview.js'
+        );
+
+        $moduleTemplate = $this->moduleTemplateFactory->create($request);
+
+        $moduleTemplate->assignMultiple([
+            'formData'        => $this->getDefaultFormData(),
+            'savedImages'     => $this->ogImageGeneratorService->getSavedImages(),
+            'presets'         => $this->getPresets(),
+            'backgroundImages' => $this->ogImageGeneratorService->getBackgroundImages(),
+        ]);
+
+        return $moduleTemplate->renderResponse('OgImage/Index');
+    }
+
+    /**
+     * Handles form submission and generates the OG image.
+     */
+    public function generateAction(ServerRequestInterface $request): ResponseInterface
+    {
+        $parsedBody = $request->getParsedBody();
+        $formData   = $parsedBody['ogimage'] ?? [];
+
+        [$success, $message, $filePath] = $this->ogImageGeneratorService->generate($formData);
+
+        $severity = $success
+            ? ContextualFeedbackSeverity::OK
+            : ContextualFeedbackSeverity::ERROR;
+
+        $flashMessage = GeneralUtility::makeInstance(
+            FlashMessage::class,
+            $message,
+            $success ? 'OG Image created' : 'Generation failed',
+            $severity,
+            true
+        );
+        $this->flashMessageService
+            ->getMessageQueueByIdentifier()
+            ->addMessage($flashMessage);
+
+        $moduleUrl = (string)$this->uriBuilder->buildUriFromRoute('web_vitecogimage');
+        return new RedirectResponse($moduleUrl, 303);
+    }
+
+    /**
+     * Returns a base64 PNG preview without saving to disk (AJAX).
+     */
+    public function previewAction(ServerRequestInterface $request): ResponseInterface
+    {
+        $parsedBody = $request->getParsedBody();
+        $formData   = $parsedBody['ogimage'] ?? [];
+
+        [$success, $message, $dataUri] = $this->ogImageGeneratorService->generatePreview($formData);
+
+        return new JsonResponse([
+            'success'  => $success,
+            'message'  => $message,
+            'dataUri'  => $dataUri,
+        ]);
+    }
+
+    // ──────────────────────────────────────────────────────────────────
+    // Helpers
+    // ──────────────────────────────────────────────────────────────────
+
+    private function getDefaultFormData(): array
+    {
+        return [
+            'bg_type'           => 'color',
+            'bg_color'          => '#1a1a2e',
+            'bg_image'          => '',
+            'overlay_opacity'   => 40,
+            'title'             => 'Your Page Title',
+            'title_color'       => '#ffffff',
+            'title_size'        => 64,
+            'subtitle'          => 'A short description of your page',
+            'subtitle_color'    => '#cccccc',
+            'subtitle_size'     => 32,
+            'label_text'        => 'VITEC',
+            'label_bg_color'    => '#e63946',
+            'label_text_color'  => '#ffffff',
+            'label_position'    => 'top-left',
+            'logo_path'         => '',
+            'output_format'     => 'jpg',
+            'output_quality'    => 90,
+        ];
+    }
+
+    private function getPresets(): array
+    {
+        return [
+            'dark-blue' => [
+                'label'    => 'Dark Blue',
+                'bg_color' => '#1a1a2e',
+                'title_color' => '#ffffff',
+                'subtitle_color' => '#aaaacc',
+            ],
+            'light'     => [
+                'label'    => 'Clean Light',
+                'bg_color' => '#f8f9fa',
+                'title_color' => '#212529',
+                'subtitle_color' => '#6c757d',
+            ],
+            'brand-red' => [
+                'label'    => 'VITEC Brand Red',
+                'bg_color' => '#1f1f1f',
+                'title_color' => '#ffffff',
+                'subtitle_color' => '#e63946',
+            ],
+        ];
+    }
+}
--- a/packages/vitec/Classes/DataProcessing/ContainerChildrenProcessor.php
+++ b/packages/vitec/Classes/DataProcessing/ContainerChildrenProcessor.php
@@ -3,6 +3,10 @@ declare(strict_types=1);

 namespace Evomedien\Vitec\DataProcessing;

+use Evomedien\Vitec\UserFunc\ProductListJsonRenderer;
+use Evomedien\Vitec\UserFunc\ProductShowJsonRenderer;
+use Evomedien\Vitec\UserFunc\UsecaseListJsonRenderer;
+use Evomedien\Vitec\UserFunc\UsecaseShowJsonRenderer;
 use TYPO3\CMS\Core\Database\Connection;
 use TYPO3\CMS\Core\Database\ConnectionPool;
 use TYPO3\CMS\Core\Utility\GeneralUtility;
@@ -15,6 +19,11 @@ use TYPO3\CMS\Frontend\ContentObject\DataProcessorInterface;
 *   { id, type, colPos, sorting, appearance, data }
 * `data` only contains non-empty content-relevant fields.
 *
+ * VITEC list-plugins nested as container children (productlist, productshow,
+ * usecaselist, usecaseshow) are resolved to the SAME JSON the top-level
+ * headless rendering produces, injected into `data` under their respective
+ * key. The raw pi_flexform XML is then dropped from `data`.
+ *
 * Exception-safe.
 */
 final class ContainerChildrenProcessor implements DataProcessorInterface
@@ -27,7 +36,6 @@ final class ContainerChildrenProcessor implements DataProcessorInterface

    /** Technical / system / TCA-default fields — never sent to frontend. */
    private const SYSTEM_FIELDS = [
-        // versioning / language / workspace / housekeeping
        'pid', 'sys_language_uid', 'l18n_parent', 'l18n_diffsource',
        'l10n_source', 'l10n_state', 'l10n_parent',
        't3_origuid', 'tx_impexp_origuid',
@@ -38,8 +46,6 @@ final class ContainerChildrenProcessor implements DataProcessorInterface
        't3ver_id', 't3ver_label', 't3ver_count', 't3ver_tstamp',
        'editlock', 'sorting_foreign', 'rowDescription',
        'spaceBefore', 'spaceAfter', // legacy
-        // TCA defaults that TYPO3 always sets on every tt_content row,
-        // regardless of CType — rarely relevant to the frontend:
        'imagecols', 'sectionIndex', 'linkToTop', 'recursive', 'date',
        'bullets_type', 'cols',
        'table_delimiter', 'table_enclosure', 'table_header_position',
@@ -53,6 +59,19 @@ final class ContainerChildrenProcessor implements DataProcessorInterface
        'header_layout',
    ];

+    /**
+     * Nested VITEC list-plugins: list_type => [ rendererClass, jsonKey ].
+     * The renderer's renderForRecord() is invoked with the child's own
+     * tt_content row so the result is record-accurate (works with multiple
+     * containers / plugins on the same page).
+     */
+    private const PLUGIN_RENDERERS = [
+        'vitec_productlist'  => [ProductListJsonRenderer::class, 'products'],
+        'vitec_productshow'  => [ProductShowJsonRenderer::class, 'product'],
+        'vitec_usecaselist'  => [UsecaseListJsonRenderer::class, 'usecases'],
+        'vitec_usecaseshow'  => [UsecaseShowJsonRenderer::class, 'usecase'],
+    ];
+
    public function process(
        ContentObjectRenderer $cObj,
        array $contentObjectConfiguration,
@@ -124,6 +143,9 @@ final class ContainerChildrenProcessor implements DataProcessorInterface
            $data[$field] = $this->castValue($field, $value);
        }

+        // Resolve nested VITEC list-plugins to their headless JSON.
+        $this->resolvePluginData($record, $data);
+
        return [
            'id' => (int)$record['uid'],
            'type' => (string)$record['CType'],
@@ -139,6 +161,48 @@ final class ContainerChildrenProcessor implements DataProcessorInterface
        ];
    }

+    /**
+     * If the child is a VITEC list-plugin, run its JSON renderer for THIS
+     * record and inject the decoded result under its key. Drops the raw
+     * pi_flexform XML afterwards. Never throws.
+     *
+     * @param array<string,mixed> $record
+     * @param array<string,mixed> $data
+     */
+    private function resolvePluginData(array $record, array &$data): void
+    {
+        $listType = (string)($record['list_type'] ?? '');
+        if ($listType === '' || !isset(self::PLUGIN_RENDERERS[$listType])) {
+            return;
+        }
+
+        try {
+            [$rendererClass, $jsonKey] = self::PLUGIN_RENDERERS[$listType];
+            $renderer = GeneralUtility::makeInstance($rendererClass);
+
+            if (!method_exists($renderer, 'renderForRecord')) {
+                return;
+            }
+
+            $json = $renderer->renderForRecord($record);
+            if ($json === '' || $json === null) {
+                return;
+            }
+
+            $decoded = json_decode($json, true);
+            if ($decoded === null && json_last_error() !== JSON_ERROR_NONE) {
+                return;
+            }
+
+            $data[$jsonKey] = $decoded;
+
+            // The raw FlexForm XML is noise once the plugin is resolved.
+            unset($data['pi_flexform']);
+        } catch (\Throwable $e) {
+            // Leave the raw data untouched on any failure.
+        }
+    }
+
    private function isEmpty(mixed $value): bool
    {
        return $value === null
--- a/packages/vitec/Classes/DataProcessing/ContainerChildrenProcessor.php.bak.20260518160048
+++ b/packages/vitec/Classes/DataProcessing/ContainerChildrenProcessor.php.bak.20260518160048
@@ -0,0 +1,157 @@
+<?php
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\DataProcessing;
+
+use TYPO3\CMS\Core\Database\Connection;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Frontend\ContentObject\ContentObjectRenderer;
+use TYPO3\CMS\Frontend\ContentObject\DataProcessorInterface;
+
+/**
+ * Collect container children grouped by colPos and emit a lean, transport-
+ * ready structure. Each child is normalised to:
+ *   { id, type, colPos, sorting, appearance, data }
+ * `data` only contains non-empty content-relevant fields.
+ *
+ * Exception-safe.
+ */
+final class ContainerChildrenProcessor implements DataProcessorInterface
+{
+    /** Fields that go to the envelope (not to `data`). */
+    private const ENVELOPE = [
+        'uid', 'CType', 'colPos', 'sorting',
+        'layout', 'frame_class', 'space_before_class', 'space_after_class',
+    ];
+
+    /** Technical / system / TCA-default fields — never sent to frontend. */
+    private const SYSTEM_FIELDS = [
+        // versioning / language / workspace / housekeeping
+        'pid', 'sys_language_uid', 'l18n_parent', 'l18n_diffsource',
+        'l10n_source', 'l10n_state', 'l10n_parent',
+        't3_origuid', 'tx_impexp_origuid',
+        'tx_container_parent',
+        'tstamp', 'crdate', 'cruser_id',
+        'hidden', 'deleted', 'starttime', 'endtime', 'fe_group',
+        't3ver_oid', 't3ver_wsid', 't3ver_state', 't3ver_stage',
+        't3ver_id', 't3ver_label', 't3ver_count', 't3ver_tstamp',
+        'editlock', 'sorting_foreign', 'rowDescription',
+        'spaceBefore', 'spaceAfter', // legacy
+        // TCA defaults that TYPO3 always sets on every tt_content row,
+        // regardless of CType — rarely relevant to the frontend:
+        'imagecols', 'sectionIndex', 'linkToTop', 'recursive', 'date',
+        'bullets_type', 'cols',
+        'table_delimiter', 'table_enclosure', 'table_header_position',
+        'table_tfoot', 'table_caption',
+        'filelink_size', 'filelink_sorting', 'filelink_sorting_direction',
+        'uploads_description', 'uploads_type',
+    ];
+
+    /** Fields whose 0/empty value is still meaningful. */
+    private const KEEP_IF_ZERO = [
+        'header_layout',
+    ];
+
+    public function process(
+        ContentObjectRenderer $cObj,
+        array $contentObjectConfiguration,
+        array $processorConfiguration,
+        array $processedData
+    ): array {
+        $as = (string)($processorConfiguration['as'] ?? 'items');
+
+        try {
+            $parentUid = (int)($cObj->data['uid'] ?? 0);
+            if ($parentUid <= 0) {
+                $processedData[$as] = [];
+                return $processedData;
+            }
+
+            $pid = (int)($cObj->data['pid'] ?? 0);
+            $sysLanguageUid = (int)($cObj->data['sys_language_uid'] ?? 0);
+
+            $qb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tt_content');
+            $rows = $qb
+                ->select('*')
+                ->from('tt_content')
+                ->where(
+                    $qb->expr()->eq('tx_container_parent', $qb->createNamedParameter($parentUid, Connection::PARAM_INT)),
+                    $qb->expr()->eq('pid', $qb->createNamedParameter($pid, Connection::PARAM_INT)),
+                    $qb->expr()->eq('sys_language_uid', $qb->createNamedParameter($sysLanguageUid, Connection::PARAM_INT))
+                )
+                ->orderBy('colPos')
+                ->addOrderBy('sorting')
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            $byColPos = [];
+            foreach ($rows as $record) {
+                $byColPos[(int)$record['colPos']][] = $this->normalise($record);
+            }
+            ksort($byColPos);
+
+            $items = [];
+            foreach ($byColPos as $colPos => $contentElements) {
+                $items[] = [
+                    'config' => ['colPos' => $colPos],
+                    'contentElements' => $contentElements,
+                ];
+            }
+
+            $processedData[$as] = $items;
+        } catch (\Throwable $e) {
+            $processedData[$as] = [];
+        }
+
+        return $processedData;
+    }
+
+    private function normalise(array $record): array
+    {
+        $data = [];
+        foreach ($record as $field => $value) {
+            if (in_array($field, self::ENVELOPE, true)) {
+                continue;
+            }
+            if (in_array($field, self::SYSTEM_FIELDS, true)) {
+                continue;
+            }
+            if ($this->isEmpty($value) && !in_array($field, self::KEEP_IF_ZERO, true)) {
+                continue;
+            }
+            $data[$field] = $this->castValue($field, $value);
+        }
+
+        return [
+            'id' => (int)$record['uid'],
+            'type' => (string)$record['CType'],
+            'colPos' => (int)$record['colPos'],
+            'sorting' => (int)($record['sorting'] ?? 0),
+            'appearance' => [
+                'layout' => (string)($record['layout'] ?? ''),
+                'frameClass' => (string)($record['frame_class'] ?? 'default'),
+                'spaceBefore' => (string)($record['space_before_class'] ?? ''),
+                'spaceAfter' => (string)($record['space_after_class'] ?? ''),
+            ],
+            'data' => (object)$data,
+        ];
+    }
+
+    private function isEmpty(mixed $value): bool
+    {
+        return $value === null
+            || $value === ''
+            || $value === 0
+            || $value === '0';
+    }
+
+    private function castValue(string $field, mixed $value): mixed
+    {
+        if (in_array($field, ['header_layout'], true)) {
+            return (int)$value;
+        }
+        return $value;
+    }
+}
--- a/packages/vitec/Classes/Service/OgImageGeneratorService.php
+++ b/packages/vitec/Classes/Service/OgImageGeneratorService.php
@@ -0,0 +1,419 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\Service;
+
+use TYPO3\CMS\Core\Core\Environment;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+
+/**
+ * Generates 1200×630 OG images using the PHP GD library.
+ */
+final class OgImageGeneratorService
+{
+    private const OG_WIDTH  = 1200;
+    private const OG_HEIGHT = 630;
+
+    /** Where generated images are stored relative to the web root */
+    private const SAVE_DIR = 'fileadmin/og-images/';
+
+    /** Font paths (ordered by preference) */
+    private const FONT_BOLD = '/usr/share/fonts/truetype/dejavu/DejaVuSans-Bold.ttf';
+    private const FONT_REG  = '/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf';
+
+    private const PADDING = 80;
+
+    // ──────────────────────────────────────────────────────────────────
+    // Public API
+    // ──────────────────────────────────────────────────────────────────
+
+    /**
+     * Generate and save an OG image.
+     *
+     * @return array{0: bool, 1: string, 2: string}  [success, message, publicPath]
+     */
+    public function generate(array $opts): array
+    {
+        try {
+            $gd = $this->buildImage($opts);
+
+            $saveDir = Environment::getPublicPath() . '/' . self::SAVE_DIR;
+            GeneralUtility::mkdir_deep($saveDir);
+
+            $hashSeed = json_encode($opts, JSON_THROW_ON_ERROR) . microtime(true) . random_int(1000, 9999);
+            $fileName = 'og-' . substr(sha1($hashSeed), 0, 12) . '.' . ($opts['output_format'] ?? 'jpg');
+            $fullPath  = $saveDir . $fileName;
+
+            $this->saveImage($gd, $fullPath, $opts['output_format'] ?? 'jpg', (int)($opts['output_quality'] ?? 90));
+            imagedestroy($gd);
+
+            $publicUrl = '/' . self::SAVE_DIR . $fileName;
+
+            return [true, 'Image saved: ' . $publicUrl, $publicUrl];
+        } catch (\Throwable $e) {
+            return [false, 'Error: ' . $e->getMessage(), ''];
+        }
+    }
+
+    /**
+     * Generate a base64 data-URI preview (no file write).
+     *
+     * @return array{0: bool, 1: string, 2: string}  [success, message, dataUri]
+     */
+    public function generatePreview(array $opts): array
+    {
+        try {
+            $gd = $this->buildImage($opts);
+
+            ob_start();
+            imagepng($gd);
+            $raw = ob_get_clean();
+            imagedestroy($gd);
+
+            return [true, 'OK', 'data:image/png;base64,' . base64_encode($raw)];
+        } catch (\Throwable $e) {
+            return [false, $e->getMessage(), ''];
+        }
+    }
+
+    /**
+     * Return list of previously generated images in the save dir.
+     */
+    public function getSavedImages(): array
+    {
+        $dir = Environment::getPublicPath() . '/' . self::SAVE_DIR;
+        if (!is_dir($dir)) {
+            return [];
+        }
+
+        $files = glob($dir . '*.{jpg,jpeg,png}', GLOB_BRACE) ?: [];
+        usort($files, static fn($a, $b) => filemtime($b) <=> filemtime($a));
+
+        return array_map(static fn($f) => [
+            'path'    => '/' . self::SAVE_DIR . basename($f),
+            'name'    => basename($f),
+            'created' => date('Y-m-d H:i', filemtime($f)),
+        ], array_slice($files, 0, 20));
+    }
+
+    /**
+     * Return selectable background images from fileadmin/og-backgrounds/.
+     */
+    public function getBackgroundImages(): array
+    {
+        $dir = Environment::getPublicPath() . '/fileadmin/og-backgrounds/';
+        if (!is_dir($dir)) {
+            return [];
+        }
+
+        $files = glob($dir . '*.{jpg,jpeg,png,webp}', GLOB_BRACE) ?: [];
+
+        return array_map(static fn($f) => [
+            'path'  => '/fileadmin/og-backgrounds/' . basename($f),
+            'label' => basename($f),
+        ], $files);
+    }
+
+    // ──────────────────────────────────────────────────────────────────
+    // Core image builder
+    // ──────────────────────────────────────────────────────────────────
+
+    /** @return \GdImage */
+    private function buildImage(array $opts): \GdImage
+    {
+        $canvas = imagecreatetruecolor(self::OG_WIDTH, self::OG_HEIGHT);
+        if ($canvas === false) {
+            throw new \RuntimeException('imagecreatetruecolor failed – GD not available.');
+        }
+
+        // Enable alpha blending
+        imagealphablending($canvas, true);
+        imagesavealpha($canvas, true);
+
+        // 1. Background
+        $this->drawBackground($canvas, $opts);
+
+        // 2. Optional dark overlay when bg_image is set
+        if (!empty($opts['bg_image']) && ($opts['bg_type'] ?? '') === 'image') {
+            $opacity = max(0, min(100, (int)($opts['overlay_opacity'] ?? 40)));
+            $this->drawOverlay($canvas, $opacity);
+        }
+
+        // 3. Label / badge
+        if (!empty(trim($opts['label_text'] ?? ''))) {
+            $this->drawLabel($canvas, $opts);
+        }
+
+        // 4. Title
+        if (!empty(trim($opts['title'] ?? ''))) {
+            $this->drawTitle($canvas, $opts);
+        }
+
+        // 5. Subtitle
+        if (!empty(trim($opts['subtitle'] ?? ''))) {
+            $this->drawSubtitle($canvas, $opts);
+        }
+
+        // 6. Logo (optional)
+        if (!empty($opts['logo_path'])) {
+            $this->drawLogo($canvas, $opts['logo_path']);
+        }
+
+        return $canvas;
+    }
+
+    // ──────────────────────────────────────────────────────────────────
+    // Drawing helpers
+    // ──────────────────────────────────────────────────────────────────
+
+    private function drawBackground(\GdImage $canvas, array $opts): void
+    {
+        $bgType = $opts['bg_type'] ?? 'color';
+
+        if ($bgType === 'image' && !empty($opts['bg_image'])) {
+            $imagePath = $this->resolvePath($opts['bg_image']);
+            $src = $this->loadImageFromPath($imagePath);
+
+            if ($src !== null) {
+                imagecopyresampled(
+                    $canvas, $src,
+                    0, 0, 0, 0,
+                    self::OG_WIDTH, self::OG_HEIGHT,
+                    imagesx($src), imagesy($src)
+                );
+                imagedestroy($src);
+                return;
+            }
+        }
+
+        // Solid colour fallback
+        $hex = ltrim($opts['bg_color'] ?? '#1a1a2e', '#');
+        [$r, $g, $b] = $this->hexToRgb($hex);
+        $bg = imagecolorallocate($canvas, $r, $g, $b);
+        imagefilledrectangle($canvas, 0, 0, self::OG_WIDTH - 1, self::OG_HEIGHT - 1, $bg);
+    }
+
+    private function drawOverlay(\GdImage $canvas, int $opacityPercent): void
+    {
+        // opacity 0 = fully transparent overlay, 100 = solid black
+        $alpha = (int)round(127 - ($opacityPercent / 100 * 127));
+        $color = imagecolorallocatealpha($canvas, 0, 0, 0, $alpha);
+        imagefilledrectangle($canvas, 0, 0, self::OG_WIDTH - 1, self::OG_HEIGHT - 1, $color);
+    }
+
+    private function drawLabel(\GdImage $canvas, array $opts): void
+    {
+        $text     = strtoupper(trim($opts['label_text'] ?? 'LABEL'));
+        $fontSize = 22;
+        $font     = $this->fontPath(true);
+
+        $padding  = 14;
+        $bbox     = imagettfbbox($fontSize, 0, $font, $text);
+        $textW    = abs($bbox[4] - $bbox[0]);
+        $textH    = abs($bbox[5] - $bbox[1]);
+        $boxW     = $textW + $padding * 2;
+        $boxH     = $textH + $padding;
+
+        $position = $opts['label_position'] ?? 'top-left';
+        [$bx, $by] = $this->labelCoords($position, $boxW, $boxH);
+
+        [$br, $bg, $bb] = $this->hexToRgb(ltrim($opts['label_bg_color'] ?? '#e63946', '#'));
+        $bgColor = imagecolorallocate($canvas, $br, $bg, $bb);
+        imagefilledrectangle($canvas, $bx, $by, $bx + $boxW, $by + $boxH, $bgColor);
+
+        [$tr, $tg, $tb] = $this->hexToRgb(ltrim($opts['label_text_color'] ?? '#ffffff', '#'));
+        $textColor = imagecolorallocate($canvas, $tr, $tg, $tb);
+        imagettftext($canvas, $fontSize, 0, $bx + $padding, $by + $textH + (int)($padding / 2), $textColor, $font, $text);
+    }
+
+    private function drawTitle(\GdImage $canvas, array $opts): void
+    {
+        $text     = trim($opts['title'] ?? '');
+        $fontSize = max(20, min(120, (int)($opts['title_size'] ?? 64)));
+        $font     = $this->fontPath(true);
+        $maxWidth = self::OG_WIDTH - self::PADDING * 2;
+
+        [$r, $g, $b] = $this->hexToRgb(ltrim($opts['title_color'] ?? '#ffffff', '#'));
+        $color = imagecolorallocate($canvas, $r, $g, $b);
+
+        $lines   = $this->wrapText($text, $fontSize, $font, $maxWidth);
+        $lineH   = (int)($fontSize * 1.3);
+        $startY  = $this->titleStartY($opts, count($lines), $lineH, $fontSize);
+
+        foreach ($lines as $i => $line) {
+            $y = $startY + $i * $lineH;
+            imagettftext($canvas, $fontSize, 0, self::PADDING, $y, $color, $font, $line);
+        }
+    }
+
+    private function drawSubtitle(\GdImage $canvas, array $opts): void
+    {
+        $text     = trim($opts['subtitle'] ?? '');
+        $fontSize = max(14, min(80, (int)($opts['subtitle_size'] ?? 32)));
+        $font     = $this->fontPath(false);
+        $maxWidth = self::OG_WIDTH - self::PADDING * 2;
+
+        [$r, $g, $b] = $this->hexToRgb(ltrim($opts['subtitle_color'] ?? '#cccccc', '#'));
+        $color = imagecolorallocate($canvas, $r, $g, $b);
+
+        $lines  = $this->wrapText($text, $fontSize, $font, $maxWidth);
+        $lineH  = (int)($fontSize * 1.4);
+        $startY = $this->subtitleStartY($opts, $fontSize);
+
+        foreach ($lines as $i => $line) {
+            $y = $startY + $i * $lineH;
+            imagettftext($canvas, $fontSize, 0, self::PADDING, $y, $color, $font, $line);
+        }
+    }
+
+    private function drawLogo(\GdImage $canvas, string $logoPath): void
+    {
+        $path = $this->resolvePath($logoPath);
+        $src  = $this->loadImageFromPath($path);
+        if ($src === null) {
+            return;
+        }
+
+        $logoW = 200;
+        $logoH = (int)(imagesy($src) * ($logoW / imagesx($src)));
+        $x     = self::OG_WIDTH  - self::PADDING - $logoW;
+        $y     = self::OG_HEIGHT - self::PADDING - $logoH;
+
+        imagecopyresampled($canvas, $src, $x, $y, 0, 0, $logoW, $logoH, imagesx($src), imagesy($src));
+        imagedestroy($src);
+    }
+
+    // ──────────────────────────────────────────────────────────────────
+    // Layout helpers
+    // ──────────────────────────────────────────────────────────────────
+
+    private function titleStartY(array $opts, int $lineCount, int $lineH, int $fontSize): int
+    {
+        $totalH  = $lineCount * $lineH;
+        $subH    = empty(trim($opts['subtitle'] ?? '')) ? 0 : (int)($opts['subtitle_size'] ?? 32) + 20;
+        $block   = $totalH + $subH;
+        $center  = (int)((self::OG_HEIGHT - $block) / 2);
+        // nudge up slightly so text block feels centered
+        return max(self::PADDING + $fontSize, $center);
+    }
+
+    private function subtitleStartY(array $opts, int $fontSize): int
+    {
+        $titleSize  = max(20, min(120, (int)($opts['title_size'] ?? 64)));
+        $titleText  = trim($opts['title'] ?? '');
+        $font       = $this->fontPath(true);
+        $maxWidth   = self::OG_WIDTH - self::PADDING * 2;
+        $titleLines = $this->wrapText($titleText, $titleSize, $font, $maxWidth);
+        $titleLineH = (int)($titleSize * 1.3);
+        $titleBlock = count($titleLines) * $titleLineH;
+
+        $subH   = empty(trim($opts['subtitle'] ?? '')) ? 0 : $fontSize + 20;
+        $block  = $titleBlock + $subH;
+        $center = (int)((self::OG_HEIGHT - $block) / 2);
+        $topOfTitle = max(self::PADDING + $titleSize, $center);
+
+        return $topOfTitle + $titleBlock + 20;
+    }
+
+    private function labelCoords(string $position, int $w, int $h): array
+    {
+        $pad = self::PADDING;
+        return match ($position) {
+            'top-right'    => [self::OG_WIDTH  - $pad - $w, $pad],
+            'bottom-left'  => [$pad,                         self::OG_HEIGHT - $pad - $h],
+            'bottom-right' => [self::OG_WIDTH  - $pad - $w, self::OG_HEIGHT - $pad - $h],
+            default        => [$pad, $pad], // top-left
+        };
+    }
+
+    // ──────────────────────────────────────────────────────────────────
+    // Utility helpers
+    // ──────────────────────────────────────────────────────────────────
+
+    /** Wrap text to fit within $maxWidth px */
+    private function wrapText(string $text, int $fontSize, string $font, int $maxWidth): array
+    {
+        $words = explode(' ', $text);
+        $lines = [];
+        $current = '';
+
+        foreach ($words as $word) {
+            $test = $current !== '' ? "$current $word" : $word;
+            $bbox = imagettfbbox($fontSize, 0, $font, $test);
+            $w    = abs($bbox[4] - $bbox[0]);
+
+            if ($w > $maxWidth && $current !== '') {
+                $lines[]  = $current;
+                $current  = $word;
+            } else {
+                $current = $test;
+            }
+        }
+
+        if ($current !== '') {
+            $lines[] = $current;
+        }
+
+        return $lines ?: [''];
+    }
+
+    private function fontPath(bool $bold): string
+    {
+        $path = $bold ? self::FONT_BOLD : self::FONT_REG;
+        if (!file_exists($path)) {
+            $path = self::FONT_REG; // fallback to regular
+        }
+        if (!file_exists($path)) {
+            throw new \RuntimeException("TTF font not found at $path");
+        }
+        return $path;
+    }
+
+    private function hexToRgb(string $hex): array
+    {
+        $hex = ltrim($hex, '#');
+        if (strlen($hex) === 3) {
+            $hex = $hex[0] . $hex[0] . $hex[1] . $hex[1] . $hex[2] . $hex[2];
+        }
+        return [
+            hexdec(substr($hex, 0, 2)),
+            hexdec(substr($hex, 2, 2)),
+            hexdec(substr($hex, 4, 2)),
+        ];
+    }
+
+    private function resolvePath(string $path): string
+    {
+        if (str_starts_with($path, '/')) {
+            return Environment::getPublicPath() . $path;
+        }
+        return Environment::getPublicPath() . '/' . ltrim($path, '/');
+    }
+
+    /** @return \GdImage|null */
+    private function loadImageFromPath(string $path): ?\GdImage
+    {
+        if (!file_exists($path)) {
+            return null;
+        }
+
+        $ext = strtolower(pathinfo($path, PATHINFO_EXTENSION));
+
+        return match ($ext) {
+            'jpg', 'jpeg' => imagecreatefromjpeg($path) ?: null,
+            'png'         => imagecreatefrompng($path) ?: null,
+            'gif'         => imagecreatefromgif($path) ?: null,
+            'webp'        => imagecreatefromwebp($path) ?: null,
+            default       => null,
+        };
+    }
+
+    private function saveImage(\GdImage $gd, string $path, string $format, int $quality): void
+    {
+        match (strtolower($format)) {
+            'png'  => imagepng($gd, $path, max(0, min(9, (int)(9 - $quality / 11)))),
+            default => imagejpeg($gd, $path, $quality),
+        };
+    }
+}
--- a/packages/vitec/Classes/UserFunc/ProductListJsonRenderer.php
+++ b/packages/vitec/Classes/UserFunc/ProductListJsonRenderer.php
@@ -16,23 +16,19 @@ use TYPO3\CMS\Core\Utility\GeneralUtility;
 use TYPO3\CMS\Extbase\Service\ImageService;

 /**
- * UserFunc to render product list as JSON for headless
+ * UserFunc to render product list as JSON for headless.
+ *
+ * `render()` performs page discovery (used for top-level list plugins via
+ * TypoScript). `renderForRecord()` processes one specific tt_content row and
+ * is used both internally and by ContainerChildrenProcessor to resolve a
+ * product-list plugin nested inside a b13 container.
 */
 class ProductListJsonRenderer
 {
    public function render(string $content, array $conf): string
    {
-        // IMPORTANT: Headless creates new cObj contexts when rendering JSON fields,
-        // losing the current content element context. Also, Extbase repositories don't work
-        // in UserFunc context because the full Extbase framework isn't bootstrapped.
-        //
-        // Solution: Query tt_content directly to find the plugin configuration,
-        // then use direct database queries for products instead of Extbase repositories.
-
-        // Get current page UID
        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);

-        // Query tt_content for vitec_productlist on this page
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
            ->getQueryBuilderForTable('tt_content');

@@ -49,95 +45,93 @@ class ProductListJsonRenderer
            ->fetchAllAssociative();

        if (empty($contentElements)) {
-            return json_encode(['debug' => 'No vitec_productlist on page ' . $pageId]);
+            // Not a product-list page: emit nothing so headless removes the key.
+            return '';
        }

-        // Take the first one (there should typically be only one)
-        $contentElement = $contentElements[0];
+        return $this->renderForRecord($contentElements[0]);
+    }

-        // Parse FlexForm
-        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
-        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
-        $settings = $flexFormData['settings'] ?? [];
+    /**
+     * Render exactly the given tt_content row (the product-list plugin element).
+     * Exception-safe: returns '' on any failure.
+     *
+     * @param array<string,mixed> $contentElement tt_content row of the plugin
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            // Parse FlexForm of THIS element
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];

-        // Extract category UIDs and debug setting
-        $categoryUids = array_filter(
-            array_map('intval', explode(',', (string)($settings['categories'] ?? '')))
-        );
-        $debugMode = (bool)($settings['debug'] ?? false);
-        $allProducts = (bool)($settings['allproducts'] ?? false);
-
-        // Extbase repositories don't work in UserFunc context
-        // Use direct database query instead
-        $productQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
-            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
-
-        $productQuery = $productQueryBuilder
-            ->select('p.*')
-            ->from('tx_vitec_domain_model_product', 'p')
-            ->where(
-                $productQueryBuilder->expr()->eq('p.deleted', 0),
-                $productQueryBuilder->expr()->eq('p.hidden', 0),
-                $productQueryBuilder->expr()->eq('p.legacy', 0),
-                $productQueryBuilder->expr()->eq('p.supportproduct', 0),
-                $productQueryBuilder->expr()->eq('p.hideonwebsite', 0),
-                $productQueryBuilder->expr()->eq('p.hideonproducts', 0),
-                $productQueryBuilder->expr()->eq('p.subproduct', 0)
+            $categoryUids = array_filter(
+                array_map('intval', explode(',', (string)($settings['categories'] ?? '')))
            );
+            $debugMode = (bool)($settings['debug'] ?? false);
+            $allProducts = (bool)($settings['allproducts'] ?? false);

-        // Add category filter if specified and allProducts is not enabled
-        if (!empty($categoryUids) && !$allProducts) {
-            // Join with sys_category_record_mm to filter by categories
-            $productQuery
-                ->join(
-                    'p',
-                    'sys_category_record_mm',
-                    'mm',
-                    'mm.uid_foreign = p.uid AND mm.tablenames = ' . $productQueryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . ' AND mm.fieldname = ' . $productQueryBuilder->createNamedParameter('categories', ParameterType::STRING)
-                )
-                ->andWhere(
-                    $productQueryBuilder->expr()->in('mm.uid_local', $productQueryBuilder->createNamedParameter($categoryUids, Connection::PARAM_INT_ARRAY))
-                )
-                ->groupBy('p.uid');
+            // Extbase repositories don't work in UserFunc context — direct query.
+            $productQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+            $productQuery = $productQueryBuilder
+                ->select('p.*')
+                ->from('tx_vitec_domain_model_product', 'p')
+                ->where(
+                    $productQueryBuilder->expr()->eq('p.deleted', 0),
+                    $productQueryBuilder->expr()->eq('p.hidden', 0),
+                    $productQueryBuilder->expr()->eq('p.legacy', 0),
+                    $productQueryBuilder->expr()->eq('p.supportproduct', 0),
+                    $productQueryBuilder->expr()->eq('p.hideonwebsite', 0),
+                    $productQueryBuilder->expr()->eq('p.hideonproducts', 0),
+                    $productQueryBuilder->expr()->eq('p.subproduct', 0)
+                );
+
+            if (!empty($categoryUids) && !$allProducts) {
+                $productQuery
+                    ->join(
+                        'p',
+                        'sys_category_record_mm',
+                        'mm',
+                        'mm.uid_foreign = p.uid AND mm.tablenames = ' . $productQueryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . ' AND mm.fieldname = ' . $productQueryBuilder->createNamedParameter('categories', ParameterType::STRING)
+                    )
+                    ->andWhere(
+                        $productQueryBuilder->expr()->in('mm.uid_local', $productQueryBuilder->createNamedParameter($categoryUids, Connection::PARAM_INT_ARRAY))
+                    )
+                    ->groupBy('p.uid');
+            }
+
+            $products = $productQuery->executeQuery()->fetchAllAssociative();
+
+            $productsData = [];
+            foreach ($products as $product) {
+                $productsData[] = $this->serializeProduct($product);
+            }
+
+            if ($debugMode) {
+                return json_encode([
+                    'products' => $productsData,
+                    'debug' => [
+                        'pageId' => (int)($GLOBALS['TSFE']->id ?? 0),
+                        'categoryUids' => $categoryUids,
+                        'productCount' => count($productsData),
+                        'settings' => $settings,
+                    ],
+                ]);
+            }
+
+            return json_encode($productsData);
+        } catch (\Throwable $e) {
+            return '';
        }
-
-        $products = $productQuery->executeQuery()->fetchAllAssociative();
-
-        // Serialize products (they're already associative arrays from the query)
-        $productsData = [];
-        foreach ($products as $product) {
-            $productsData[] = $this->serializeProduct($product);
-        }
-
-        // If debug mode is enabled, return object with products and debug info
-        if ($debugMode) {
-            return json_encode([
-                'products' => $productsData,
-                'debug' => [
-                    'pageId' => $pageId,
-                    'categoryUids' => $categoryUids,
-                    'productCount' => count($productsData),
-                    'settings' => $settings
-                ]
-            ]);
-        }
-
-        // Otherwise return products array directly (backward compatible)
-        return json_encode($productsData);
    }

    /**
     * Serialize a single product DB row to the full headless JSON structure.
     *
-     * Includes every field declared on the Product domain model
-     * (Evomedien\Vitec\Domain\Model\Product) plus all fully resolved
-     * relations (categories, productimage, downloads, ogimage, relatedprodukt).
-     *
-     * DB-only columns that are NOT part of the domain model
-     * (cta, links, sorting1-5, key1-3, apptext1-3, productlayout, image,
-     * relatedimage, system fields) are intentionally omitted.
-     *
-     * @param array<string,mixed> $product Associative DB row of tx_vitec_domain_model_product
+     * @param array<string,mixed> $product
     * @return array<string,mixed>
     */
    protected function serializeProduct(array $product): array
@@ -145,10 +139,8 @@ class ProductListJsonRenderer
        $uid = (int)$product['uid'];

        return [
-            // --- identifier ---
            'uid' => $uid,

-            // --- scalar string fields (Product domain model) ---
            'title' => (string)($product['title'] ?? ''),
            'slug' => (string)($product['slug'] ?? ''),
            'urltitle' => (string)($product['urltitle'] ?? ''),
@@ -166,7 +158,6 @@ class ProductListJsonRenderer
            'contentelement' => (string)($product['contentelement'] ?? ''),
            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),

-            // --- boolean flags (Product domain model) ---
            'hideonapp' => (bool)($product['hideonapp'] ?? false),
            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
@@ -176,10 +167,8 @@ class ProductListJsonRenderer
            'supportproduct' => (bool)($product['supportproduct'] ?? false),
            'subproduct' => (bool)($product['subproduct'] ?? false),

-            // --- convenience link (kept for backward compatibility) ---
            'link' => '/product/' . (string)($product['slug'] ?? ''),

-            // --- fully resolved relations ---
            'categories' => $this->getProductCategories($uid),
            'images' => $this->getProductImages($uid),
            'downloads' => $this->getProductDownloads($uid),
@@ -188,10 +177,6 @@ class ProductListJsonRenderer
        ];
    }

-    /**
-     * Get product images from FAL (sys_file_reference)
-     * Processes images through ImageService and generates srcset for responsive images
-     */
    protected function getProductImages(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -217,10 +202,8 @@ class ProductListJsonRenderer
        $images = [];
        foreach ($fileReferences as $fileRefData) {
            try {
-                // Get FAL FileReference object
                $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);

-                // Define image sizes for srcset
                $sizes = [
                    'small' => ['width' => 400, 'height' => null],
                    'medium' => ['width' => 800, 'height' => null],
@@ -247,7 +230,6 @@ class ProductListJsonRenderer
                    ];
                }

-                // Get original/default image
                $defaultProcessed = $imageService->applyProcessingInstructions(
                    $fileReference,
                    ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
@@ -267,7 +249,6 @@ class ProductListJsonRenderer
                    ]
                ];
            } catch (\Exception $e) {
-                // Skip images that can't be processed
                continue;
            }
        }
@@ -276,8 +257,6 @@ class ProductListJsonRenderer
    }

    /**
-     * Get the single Open Graph image (ogimage) for a product, or null.
-     *
     * @return array<string,mixed>|null
     */
    protected function getProductOgImage(int $productUid): ?array
@@ -331,9 +310,6 @@ class ProductListJsonRenderer
        }
    }

-    /**
-     * Get categories for a product (resolved sys_category records).
-     */
    protected function getProductCategories(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -369,9 +345,6 @@ class ProductListJsonRenderer
        }, $categories);
    }

-    /**
-     * Get all downloads for a product (resolved via tx_vitec_product_download_mm).
-     */
    protected function getProductDownloads(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -400,7 +373,6 @@ class ProductListJsonRenderer
        foreach ($downloads as $download) {
            $fileInfo = null;

-            // Get file information from FAL if file reference exists
            if (!empty($download['file'])) {
                $fileQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
                    ->getQueryBuilderForTable('sys_file_reference');
@@ -448,12 +420,6 @@ class ProductListJsonRenderer
        return $result;
    }

-    /**
-     * Get related products (resolved via tx_vitec_product_related_mm).
-     *
-     * Returns a shallow representation (no nested relations) to avoid
-     * infinite recursion between mutually related products.
-     */
    protected function getRelatedProducts(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
@@ -480,8 +446,6 @@ class ProductListJsonRenderer
        $result = [];
        foreach ($related as $rel) {
            $relUid = (int)$rel['uid'];
-            $images = $this->getProductImages($relUid);
-
            $result[] = [
                'uid' => $relUid,
                'title' => (string)($rel['title'] ?? ''),
@@ -490,7 +454,7 @@ class ProductListJsonRenderer
                'teaser' => (string)($rel['teaser'] ?? ''),
                'description' => (string)($rel['description'] ?? ''),
                'link' => '/product/' . (string)($rel['slug'] ?? ''),
-                'images' => $images,
+                'images' => $this->getProductImages($relUid),
            ];
        }

--- a/packages/vitec/Classes/UserFunc/ProductListJsonRenderer.php.bak.20260518160048
+++ b/packages/vitec/Classes/UserFunc/ProductListJsonRenderer.php.bak.20260518160048
@@ -0,0 +1,499 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use Evomedien\Vitec\Domain\Repository\ProductRepository;
+use Psr\Http\Message\ServerRequestInterface;
+use TYPO3\CMS\Core\Database\Connection;
+use TYPO3\CMS\Core\Imaging\ImageManipulation\CropVariantCollection;
+use TYPO3\CMS\Core\Resource\FileReference;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render product list as JSON for headless
+ */
+class ProductListJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        // IMPORTANT: Headless creates new cObj contexts when rendering JSON fields,
+        // losing the current content element context. Also, Extbase repositories don't work
+        // in UserFunc context because the full Extbase framework isn't bootstrapped.
+        //
+        // Solution: Query tt_content directly to find the plugin configuration,
+        // then use direct database queries for products instead of Extbase repositories.
+
+        // Get current page UID
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+        // Query tt_content for vitec_productlist on this page
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $queryBuilder
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $queryBuilder->expr()->eq('pid', $queryBuilder->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('list_type', $queryBuilder->createNamedParameter('vitec_productlist', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($contentElements)) {
+            return json_encode(['debug' => 'No vitec_productlist on page ' . $pageId]);
+        }
+
+        // Take the first one (there should typically be only one)
+        $contentElement = $contentElements[0];
+
+        // Parse FlexForm
+        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+        $settings = $flexFormData['settings'] ?? [];
+
+        // Extract category UIDs and debug setting
+        $categoryUids = array_filter(
+            array_map('intval', explode(',', (string)($settings['categories'] ?? '')))
+        );
+        $debugMode = (bool)($settings['debug'] ?? false);
+        $allProducts = (bool)($settings['allproducts'] ?? false);
+
+        // Extbase repositories don't work in UserFunc context
+        // Use direct database query instead
+        $productQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $productQuery = $productQueryBuilder
+            ->select('p.*')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->where(
+                $productQueryBuilder->expr()->eq('p.deleted', 0),
+                $productQueryBuilder->expr()->eq('p.hidden', 0),
+                $productQueryBuilder->expr()->eq('p.legacy', 0),
+                $productQueryBuilder->expr()->eq('p.supportproduct', 0),
+                $productQueryBuilder->expr()->eq('p.hideonwebsite', 0),
+                $productQueryBuilder->expr()->eq('p.hideonproducts', 0),
+                $productQueryBuilder->expr()->eq('p.subproduct', 0)
+            );
+
+        // Add category filter if specified and allProducts is not enabled
+        if (!empty($categoryUids) && !$allProducts) {
+            // Join with sys_category_record_mm to filter by categories
+            $productQuery
+                ->join(
+                    'p',
+                    'sys_category_record_mm',
+                    'mm',
+                    'mm.uid_foreign = p.uid AND mm.tablenames = ' . $productQueryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . ' AND mm.fieldname = ' . $productQueryBuilder->createNamedParameter('categories', ParameterType::STRING)
+                )
+                ->andWhere(
+                    $productQueryBuilder->expr()->in('mm.uid_local', $productQueryBuilder->createNamedParameter($categoryUids, Connection::PARAM_INT_ARRAY))
+                )
+                ->groupBy('p.uid');
+        }
+
+        $products = $productQuery->executeQuery()->fetchAllAssociative();
+
+        // Serialize products (they're already associative arrays from the query)
+        $productsData = [];
+        foreach ($products as $product) {
+            $productsData[] = $this->serializeProduct($product);
+        }
+
+        // If debug mode is enabled, return object with products and debug info
+        if ($debugMode) {
+            return json_encode([
+                'products' => $productsData,
+                'debug' => [
+                    'pageId' => $pageId,
+                    'categoryUids' => $categoryUids,
+                    'productCount' => count($productsData),
+                    'settings' => $settings
+                ]
+            ]);
+        }
+
+        // Otherwise return products array directly (backward compatible)
+        return json_encode($productsData);
+    }
+
+    /**
+     * Serialize a single product DB row to the full headless JSON structure.
+     *
+     * Includes every field declared on the Product domain model
+     * (Evomedien\Vitec\Domain\Model\Product) plus all fully resolved
+     * relations (categories, productimage, downloads, ogimage, relatedprodukt).
+     *
+     * DB-only columns that are NOT part of the domain model
+     * (cta, links, sorting1-5, key1-3, apptext1-3, productlayout, image,
+     * relatedimage, system fields) are intentionally omitted.
+     *
+     * @param array<string,mixed> $product Associative DB row of tx_vitec_domain_model_product
+     * @return array<string,mixed>
+     */
+    protected function serializeProduct(array $product): array
+    {
+        $uid = (int)$product['uid'];
+
+        return [
+            // --- identifier ---
+            'uid' => $uid,
+
+            // --- scalar string fields (Product domain model) ---
+            'title' => (string)($product['title'] ?? ''),
+            'slug' => (string)($product['slug'] ?? ''),
+            'urltitle' => (string)($product['urltitle'] ?? ''),
+            'seotitle' => (string)($product['seotitle'] ?? ''),
+            'seometa' => (string)($product['seometa'] ?? ''),
+            'keywords' => (string)($product['keywords'] ?? ''),
+            'structureddata' => (string)($product['structureddata'] ?? ''),
+            'teaser' => (string)($product['teaser'] ?? ''),
+            'subtitle' => (string)($product['subtitle'] ?? ''),
+            'video' => (string)($product['video'] ?? ''),
+            'applications' => (string)($product['applications'] ?? ''),
+            'description' => (string)($product['description'] ?? ''),
+            'highlights' => (string)($product['highlights'] ?? ''),
+            'shortcutpid' => (string)($product['shortcutpid'] ?? ''),
+            'contentelement' => (string)($product['contentelement'] ?? ''),
+            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),
+
+            // --- boolean flags (Product domain model) ---
+            'hideonapp' => (bool)($product['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
+            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
+            'hideonproducts' => (bool)($product['hideonproducts'] ?? false),
+            'shortcut' => (bool)($product['shortcut'] ?? false),
+            'legacy' => (bool)($product['legacy'] ?? false),
+            'supportproduct' => (bool)($product['supportproduct'] ?? false),
+            'subproduct' => (bool)($product['subproduct'] ?? false),
+
+            // --- convenience link (kept for backward compatibility) ---
+            'link' => '/product/' . (string)($product['slug'] ?? ''),
+
+            // --- fully resolved relations ---
+            'categories' => $this->getProductCategories($uid),
+            'images' => $this->getProductImages($uid),
+            'downloads' => $this->getProductDownloads($uid),
+            'ogimage' => $this->getProductOgImage($uid),
+            'relatedprodukt' => $this->getRelatedProducts($uid),
+        ];
+    }
+
+    /**
+     * Get product images from FAL (sys_file_reference)
+     * Processes images through ImageService and generates srcset for responsive images
+     */
+    protected function getProductImages(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileReferences = $queryBuilder
+            ->select('sfr.uid', 'sfr.uid_local', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter('productimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $imageService = GeneralUtility::makeInstance(ImageService::class);
+        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+
+        $images = [];
+        foreach ($fileReferences as $fileRefData) {
+            try {
+                // Get FAL FileReference object
+                $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+                // Define image sizes for srcset
+                $sizes = [
+                    'small' => ['width' => 400, 'height' => null],
+                    'medium' => ['width' => 800, 'height' => null],
+                    'large' => ['width' => 1200, 'height' => null],
+                    'xlarge' => ['width' => 1600, 'height' => null],
+                ];
+
+                $srcset = [];
+                foreach ($sizes as $sizeName => $dimensions) {
+                    $processedImage = $imageService->applyProcessingInstructions(
+                        $fileReference,
+                        [
+                            'width' => $dimensions['width'],
+                            'height' => $dimensions['height'],
+                            'crop' => $fileRefData['crop'] ?? null
+                        ]
+                    );
+
+                    $imageUri = $imageService->getImageUri($processedImage);
+                    $srcset[] = [
+                        'url' => $imageUri,
+                        'width' => $dimensions['width'],
+                        'descriptor' => $dimensions['width'] . 'w'
+                    ];
+                }
+
+                // Get original/default image
+                $defaultProcessed = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+                );
+
+                $images[] = [
+                    'uid' => (int)$fileRefData['uid'],
+                    'url' => $imageService->getImageUri($defaultProcessed),
+                    'title' => $fileRefData['title'] ?? '',
+                    'alternative' => $fileRefData['alternative'] ?? '',
+                    'description' => $fileRefData['description'] ?? '',
+                    'srcset' => $srcset,
+                    'properties' => [
+                        'width' => $fileReference->getProperty('width'),
+                        'height' => $fileReference->getProperty('height'),
+                        'mimeType' => $fileReference->getProperty('mime_type')
+                    ]
+                ];
+            } catch (\Exception $e) {
+                // Skip images that can't be processed
+                continue;
+            }
+        }
+
+        return $images;
+    }
+
+    /**
+     * Get the single Open Graph image (ogimage) for a product, or null.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getProductOgImage(int $productUid): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter('ogimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $processed = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 1200, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($processed),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a product (resolved sys_category records).
+     */
+    protected function getProductCategories(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+
+    /**
+     * Get all downloads for a product (resolved via tx_vitec_product_download_mm).
+     */
+    protected function getProductDownloads(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
+
+        $downloads = $queryBuilder
+            ->select('d.*')
+            ->from('tx_vitec_domain_model_download', 'd')
+            ->join(
+                'd',
+                'tx_vitec_product_download_mm',
+                'mm',
+                'mm.uid_foreign = d.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('d.deleted', 0),
+                $queryBuilder->expr()->eq('d.hidden', 0),
+                $queryBuilder->expr()->eq('d.hideonwebsite', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($downloads as $download) {
+            $fileInfo = null;
+
+            // Get file information from FAL if file reference exists
+            if (!empty($download['file'])) {
+                $fileQueryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+                    ->getQueryBuilderForTable('sys_file_reference');
+
+                $fileRef = $fileQueryBuilder
+                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
+                    ->from('sys_file_reference', 'fr')
+                    ->join('fr', 'sys_file', 'f', 'fr.uid_local = f.uid')
+                    ->where(
+                        $fileQueryBuilder->expr()->eq('fr.uid_foreign', $fileQueryBuilder->createNamedParameter((int)$download['uid'], ParameterType::INTEGER)),
+                        $fileQueryBuilder->expr()->eq('fr.tablenames', $fileQueryBuilder->createNamedParameter('tx_vitec_domain_model_download', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.fieldname', $fileQueryBuilder->createNamedParameter('file', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.deleted', 0),
+                        $fileQueryBuilder->expr()->eq('f.missing', 0)
+                    )
+                    ->orderBy('fr.sorting_foreign', 'ASC')
+                    ->setMaxResults(1)
+                    ->executeQuery()
+                    ->fetchAssociative();
+
+                if ($fileRef) {
+                    $fileInfo = [
+                        'uid' => (int)$fileRef['file_uid'],
+                        'name' => $fileRef['name'],
+                        'url' => '/fileadmin' . $fileRef['identifier'],
+                        'size' => (int)$fileRef['size'],
+                        'extension' => $fileRef['extension'],
+                        'mimeType' => $fileRef['mime_type'] ?? '',
+                    ];
+                }
+            }
+
+            $result[] = [
+                'uid' => (int)$download['uid'],
+                'title' => $download['title'] ?? '',
+                'slug' => $download['slug'] ?? '',
+                'teaser' => $download['teaser'] ?? '',
+                'description' => $download['description'] ?? '',
+                'keywords' => $download['keywords'] ?? '',
+                'icon' => $download['icon'] ?? '',
+                'file' => $fileInfo,
+            ];
+        }
+
+        return $result;
+    }
+
+    /**
+     * Get related products (resolved via tx_vitec_product_related_mm).
+     *
+     * Returns a shallow representation (no nested relations) to avoid
+     * infinite recursion between mutually related products.
+     */
+    protected function getRelatedProducts(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(\TYPO3\CMS\Core\Database\ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $related = $queryBuilder
+            ->select('p.uid', 'p.title', 'p.slug', 'p.subtitle', 'p.teaser', 'p.description')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->join(
+                'p',
+                'tx_vitec_product_related_mm',
+                'mm',
+                'mm.uid_foreign = p.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('p.deleted', 0),
+                $queryBuilder->expr()->eq('p.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($related as $rel) {
+            $relUid = (int)$rel['uid'];
+            $images = $this->getProductImages($relUid);
+
+            $result[] = [
+                'uid' => $relUid,
+                'title' => (string)($rel['title'] ?? ''),
+                'slug' => (string)($rel['slug'] ?? ''),
+                'subtitle' => (string)($rel['subtitle'] ?? ''),
+                'teaser' => (string)($rel['teaser'] ?? ''),
+                'description' => (string)($rel['description'] ?? ''),
+                'link' => '/product/' . (string)($rel['slug'] ?? ''),
+                'images' => $images,
+            ];
+        }
+
+        return $result;
+    }
+}
--- a/packages/vitec/Classes/UserFunc/ProductShowJsonRenderer.php
+++ b/packages/vitec/Classes/UserFunc/ProductShowJsonRenderer.php
@@ -14,25 +14,22 @@ use TYPO3\CMS\Core\Imaging\ImageService;
 use Doctrine\DBAL\ParameterType;

 /**
- * UserFunc to render single product data as JSON for headless output
+ * UserFunc to render a single product as JSON for headless output.
+ *
+ * `render()` performs page discovery (top-level plugin via TypoScript).
+ * `renderForRecord()` processes one specific tt_content row and is reused
+ * by ContainerChildrenProcessor for product-show plugins nested in a
+ * b13 container.
 */
 class ProductShowJsonRenderer
 {
    public function render(string $content, array $conf): string
    {
-        $pageId = (int)$GLOBALS['TSFE']->id;
-        
-        // DEBUG: Log that the UserFunc is being called
-        $debugInfo = [
-            'userFuncCalled' => true,
-            'pageId' => $pageId,
-            'requestUri' => $_SERVER['REQUEST_URI'] ?? 'unknown',
-        ];
-        
-        // Query tt_content for vitec_productshow on this page
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('tt_content');
-        
+
        $contentElements = $queryBuilder
            ->select('*')
            ->from('tt_content')
@@ -44,140 +41,161 @@ class ProductShowJsonRenderer
            )
            ->executeQuery()
            ->fetchAllAssociative();
-        
-        $debugInfo['contentElementsFound'] = count($contentElements);
-        
+
        if (empty($contentElements)) {
-            $debugInfo['error'] = 'No vitec_productshow on page';
-            return json_encode(['debug' => $debugInfo]);
+            return '';
        }
-        
-        // Take the first one
-        $contentElement = $contentElements[0];
-        
-        // Parse FlexForm
-        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
-        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
-        $settings = $flexFormData['settings'] ?? [];
-        
-        // Get product UID from FlexForm or route parameter
-        $productUid = (int)($settings['product'] ?? 0);
-        $layout = (int)($settings['layout'] ?? 0);
-        $debugMode = (bool)($settings['debug'] ?? false);
-        
-        // If no product selected in FlexForm, try to get from route parameter
-        if (!$productUid) {
-            // Get the product parameter from GET request
-            $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
-            $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
-            
-            if ($productParam) {
-                // If it's a slug, resolve it to UID
-                if (!is_numeric($productParam)) {
-                    $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
-                        ->getQueryBuilderForTable('tx_vitec_domain_model_product');
-                    
-                    $productBySlug = $slugQueryBuilder
-                        ->select('uid')
-                        ->from('tx_vitec_domain_model_product')
-                        ->where(
-                            $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
-                            $slugQueryBuilder->expr()->eq('deleted', 0),
-                            $slugQueryBuilder->expr()->eq('hidden', 0)
-                        )
-                        ->executeQuery()
-                        ->fetchAssociative();
-                    
-                    $productUid = (int)($productBySlug['uid'] ?? 0);
-                } else {
-                    $productUid = (int)$productParam;
+
+        return $this->renderForRecord($contentElements[0]);
+    }
+
+    /**
+     * Render exactly the given tt_content row (the product-show plugin element).
+     * Exception-safe: returns '' on any failure.
+     *
+     * @param array<string,mixed> $contentElement
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+
+            $productUid = (int)($settings['product'] ?? 0);
+            $layout = (int)($settings['layout'] ?? 0);
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            if (!$productUid) {
+                $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+                $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
+
+                if ($productParam) {
+                    if (!is_numeric($productParam)) {
+                        $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+                        $productBySlug = $slugQueryBuilder
+                            ->select('uid')
+                            ->from('tx_vitec_domain_model_product')
+                            ->where(
+                                $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
+                                $slugQueryBuilder->expr()->eq('deleted', 0),
+                                $slugQueryBuilder->expr()->eq('hidden', 0)
+                            )
+                            ->executeQuery()
+                            ->fetchAssociative();
+
+                        $productUid = (int)($productBySlug['uid'] ?? 0);
+                    } else {
+                        $productUid = (int)$productParam;
+                    }
                }
            }
-        }
-        
-        if (!$productUid) {
-            return json_encode([
-                'error' => 'No product selected or found',
-                'debug' => [
-                    'settings' => $settings, 
-                    'routeParams' => $routeParams ?? [],
-                    'allQueryParams' => $GLOBALS['TYPO3_REQUEST']->getQueryParams() ?? [],
-                    'requestUri' => $GLOBALS['TYPO3_REQUEST']->getUri()->getPath() ?? ''
-                ]
-            ]);
-        }
-        
-        // Query product
-        $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
-            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
-        
-        $product = $productQueryBuilder
-            ->select('*')
-            ->from('tx_vitec_domain_model_product')
-            ->where(
-                $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
-                $productQueryBuilder->expr()->eq('deleted', 0),
-                $productQueryBuilder->expr()->eq('hidden', 0)
-            )
-            ->executeQuery()
-            ->fetchAssociative();
-        
-        if (!$product) {
-            return json_encode([
-                'error' => 'Product not found',
-                'debug' => $debugMode ? ['productUid' => $productUid] : null
-            ]);
-        }
-        
-        // Get product images
-        $images = $this->getProductImages((int)$product['uid']);
-        
-        // Get categories
-        $categories = $this->getProductCategories((int)$product['uid']);
-        
-        // Get downloads
-        $downloads = $this->getProductDownloads((int)$product['uid']);
-        
-        // Build response
-        $response = [
-            'product' => [
-                'uid' => (int)$product['uid'],
-                'title' => $product['title'],
-                'subtitle' => $product['subtitle'],
-                'slug' => $product['slug'],
-                'teaser' => $product['teaser'],
-                'description' => $product['description'],
-                'seotitle' => $product['seotitle'],
-                'categories' => $categories,
-                'images' => $images,
-                'downloads' => $downloads,
-            ],
-            'layout' => $layout,
-            'settings' => [
+
+            if (!$productUid) {
+                return $debugMode
+                    ? json_encode(['error' => 'No product selected or found', 'debug' => ['settings' => $settings]])
+                    : '';
+            }
+
+            $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+            $product = $productQueryBuilder
+                ->select('*')
+                ->from('tx_vitec_domain_model_product')
+                ->where(
+                    $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                    $productQueryBuilder->expr()->eq('deleted', 0),
+                    $productQueryBuilder->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAssociative();
+
+            if (!$product) {
+                return $debugMode
+                    ? json_encode(['error' => 'Product not found', 'debug' => ['productUid' => $productUid]])
+                    : '';
+            }
+
+            $response = [
+                'product' => $this->serializeProduct($product),
                'layout' => $layout,
-            ],
-        ];
-        
-        if ($debugMode) {
-            $response['debug'] = [
-                'pageId' => $pageId,
-                'productUid' => $productUid,
-                'layout' => $layout,
-                'settings' => $settings,
+                'settings' => [
+                    'layout' => $layout,
+                ],
            ];
+
+            if ($debugMode) {
+                $response['debug'] = [
+                    'pageId' => $pageId,
+                    'productUid' => $productUid,
+                    'layout' => $layout,
+                    'settings' => $settings,
+                ];
+            }
+
+            return json_encode($response);
+        } catch (\Throwable $e) {
+            return '';
        }
-        
-        return json_encode($response);
    }
-    
+
    /**
-     * Get all images for a product with FAL and ImageService processing
+     * @param array<string,mixed> $product
+     * @return array<string,mixed>
     */
+    protected function serializeProduct(array $product): array
+    {
+        $uid = (int)$product['uid'];
+
+        return [
+            'uid' => $uid,
+
+            'title' => (string)($product['title'] ?? ''),
+            'slug' => (string)($product['slug'] ?? ''),
+            'urltitle' => (string)($product['urltitle'] ?? ''),
+            'seotitle' => (string)($product['seotitle'] ?? ''),
+            'seometa' => (string)($product['seometa'] ?? ''),
+            'keywords' => (string)($product['keywords'] ?? ''),
+            'structureddata' => (string)($product['structureddata'] ?? ''),
+            'teaser' => (string)($product['teaser'] ?? ''),
+            'subtitle' => (string)($product['subtitle'] ?? ''),
+            'video' => (string)($product['video'] ?? ''),
+            'applications' => (string)($product['applications'] ?? ''),
+            'description' => (string)($product['description'] ?? ''),
+            'highlights' => (string)($product['highlights'] ?? ''),
+            'shortcutpid' => (string)($product['shortcutpid'] ?? ''),
+            'contentelement' => (string)($product['contentelement'] ?? ''),
+            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),
+
+            'hideonapp' => (bool)($product['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
+            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
+            'hideonproducts' => (bool)($product['hideonproducts'] ?? false),
+            'shortcut' => (bool)($product['shortcut'] ?? false),
+            'legacy' => (bool)($product['legacy'] ?? false),
+            'supportproduct' => (bool)($product['supportproduct'] ?? false),
+            'subproduct' => (bool)($product['subproduct'] ?? false),
+
+            'link' => '/product/' . (string)($product['slug'] ?? ''),
+
+            'categories' => $this->getProductCategories($uid),
+            'images' => $this->getProductImages($uid),
+            'downloads' => $this->getProductDownloads($uid),
+            'ogimage' => $this->getProductOgImage($uid),
+            'relatedprodukt' => $this->getRelatedProducts($uid),
+        ];
+    }
+
    protected function getProductImages(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('sys_file_reference');
-        
+
        $fileReferences = $queryBuilder
            ->select('*')
            ->from('sys_file_reference')
@@ -191,27 +209,25 @@ class ProductShowJsonRenderer
            ->orderBy('sorting_foreign', 'ASC')
            ->executeQuery()
            ->fetchAllAssociative();
-        
+
        if (empty($fileReferences)) {
            return [];
        }
-        
+
        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
        $imageService = GeneralUtility::makeInstance(ImageService::class);
        $images = [];
-        
+
        foreach ($fileReferences as $fileRef) {
            try {
                $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
                $originalFile = $fileReference->getOriginalFile();
-                
-                // Process main image
+
                $processedImage = $imageService->applyProcessingInstructions(
                    $fileReference,
                    ['width' => '1874c', 'height' => '625c']
                );
-                
-                // Generate srcset
+
                $srcset = [];
                foreach ([400, 800, 1200, 1600] as $width) {
                    $processedVariant = $imageService->applyProcessingInstructions(
@@ -224,7 +240,7 @@ class ProductShowJsonRenderer
                        'descriptor' => $width . 'w',
                    ];
                }
-                
+
                $images[] = [
                    'uid' => $fileRef['uid'],
                    'url' => $imageService->getImageUri($processedImage),
@@ -239,22 +255,73 @@ class ProductShowJsonRenderer
                    ],
                ];
            } catch (\Exception $e) {
-                // Skip invalid file references
                continue;
            }
        }
-        
+
        return $images;
    }
-    
+
    /**
-     * Get categories for a product
+     * @return array<string,mixed>|null
     */
+    protected function getProductOgImage(int $productUid): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRef = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('ogimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRef) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+            $originalFile = $fileReference->getOriginalFile();
+
+            $processedImage = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 1200]
+            );
+
+            return [
+                'uid' => $fileRef['uid'],
+                'url' => $imageService->getImageUri($processedImage),
+                'title' => $fileReference->getTitle() ?: '',
+                'alternative' => $fileReference->getAlternative() ?: '',
+                'description' => $fileReference->getDescription() ?: '',
+                'properties' => [
+                    'width' => $originalFile->getProperty('width'),
+                    'height' => $originalFile->getProperty('height'),
+                    'mimeType' => $originalFile->getMimeType(),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
    protected function getProductCategories(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('sys_category');
-        
+
        $categories = $queryBuilder
            ->select('c.uid', 'c.title', 'c.description')
            ->from('sys_category', 'c')
@@ -262,9 +329,9 @@ class ProductShowJsonRenderer
                'c',
                'sys_category_record_mm',
                'mm',
-                'mm.uid_local = c.uid AND mm.tablenames = ' . 
-                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . 
-                ' AND mm.fieldname = ' . 
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
            )
            ->where(
@@ -275,7 +342,7 @@ class ProductShowJsonRenderer
            ->orderBy('mm.sorting', 'ASC')
            ->executeQuery()
            ->fetchAllAssociative();
-        
+
        return array_map(function ($cat) {
            return [
                'uid' => (int)$cat['uid'],
@@ -284,15 +351,12 @@ class ProductShowJsonRenderer
            ];
        }, $categories);
    }
-    
-    /**
-     * Get all downloads for a product
-     */
+
    protected function getProductDownloads(int $productUid): array
    {
        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
-        
+
        $downloads = $queryBuilder
            ->select('d.*')
            ->from('tx_vitec_domain_model_download', 'd')
@@ -311,16 +375,15 @@ class ProductShowJsonRenderer
            ->orderBy('mm.sorting', 'ASC')
            ->executeQuery()
            ->fetchAllAssociative();
-        
+
        $result = [];
        foreach ($downloads as $download) {
            $fileInfo = null;
-            
-            // Get file information from FAL if file reference exists
+
            if (!empty($download['file'])) {
                $fileQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
                    ->getQueryBuilderForTable('sys_file_reference');
-                
+
                $fileRef = $fileQueryBuilder
                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
                    ->from('sys_file_reference', 'fr')
@@ -336,7 +399,7 @@ class ProductShowJsonRenderer
                    ->setMaxResults(1)
                    ->executeQuery()
                    ->fetchAssociative();
-                
+
                if ($fileRef) {
                    $fileInfo = [
                        'uid' => (int)$fileRef['file_uid'],
@@ -348,7 +411,7 @@ class ProductShowJsonRenderer
                    ];
                }
            }
-            
+
            $result[] = [
                'uid' => (int)$download['uid'],
                'title' => $download['title'] ?? '',
@@ -360,7 +423,48 @@ class ProductShowJsonRenderer
                'file' => $fileInfo,
            ];
        }
-        
+
+        return $result;
+    }
+
+    protected function getRelatedProducts(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $related = $queryBuilder
+            ->select('p.uid', 'p.title', 'p.slug', 'p.subtitle', 'p.teaser', 'p.description')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->join(
+                'p',
+                'tx_vitec_product_related_mm',
+                'mm',
+                'mm.uid_foreign = p.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('p.deleted', 0),
+                $queryBuilder->expr()->eq('p.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($related as $rel) {
+            $relUid = (int)$rel['uid'];
+            $result[] = [
+                'uid' => $relUid,
+                'title' => (string)($rel['title'] ?? ''),
+                'slug' => (string)($rel['slug'] ?? ''),
+                'subtitle' => (string)($rel['subtitle'] ?? ''),
+                'teaser' => (string)($rel['teaser'] ?? ''),
+                'description' => (string)($rel['description'] ?? ''),
+                'link' => '/product/' . (string)($rel['slug'] ?? ''),
+                'images' => $this->getProductImages($relUid),
+            ];
+        }
+
        return $result;
    }
 }
--- a/packages/vitec/Classes/UserFunc/ProductShowJsonRenderer.php.bak.20260518145244
+++ b/packages/vitec/Classes/UserFunc/ProductShowJsonRenderer.php.bak.20260518145244
@@ -0,0 +1,366 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Imaging\ImageManipulation\CropVariantCollection;
+use TYPO3\CMS\Core\Resource\FileReference;
+use TYPO3\CMS\Core\Imaging\ImageService;
+use Doctrine\DBAL\ParameterType;
+
+/**
+ * UserFunc to render single product data as JSON for headless output
+ */
+class ProductShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)$GLOBALS['TSFE']->id;
+        
+        // DEBUG: Log that the UserFunc is being called
+        $debugInfo = [
+            'userFuncCalled' => true,
+            'pageId' => $pageId,
+            'requestUri' => $_SERVER['REQUEST_URI'] ?? 'unknown',
+        ];
+        
+        // Query tt_content for vitec_productshow on this page
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+        
+        $contentElements = $queryBuilder
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $queryBuilder->expr()->eq('pid', $queryBuilder->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('list_type', $queryBuilder->createNamedParameter('vitec_productshow', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        $debugInfo['contentElementsFound'] = count($contentElements);
+        
+        if (empty($contentElements)) {
+            $debugInfo['error'] = 'No vitec_productshow on page';
+            return json_encode(['debug' => $debugInfo]);
+        }
+        
+        // Take the first one
+        $contentElement = $contentElements[0];
+        
+        // Parse FlexForm
+        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+        $settings = $flexFormData['settings'] ?? [];
+        
+        // Get product UID from FlexForm or route parameter
+        $productUid = (int)($settings['product'] ?? 0);
+        $layout = (int)($settings['layout'] ?? 0);
+        $debugMode = (bool)($settings['debug'] ?? false);
+        
+        // If no product selected in FlexForm, try to get from route parameter
+        if (!$productUid) {
+            // Get the product parameter from GET request
+            $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+            $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
+            
+            if ($productParam) {
+                // If it's a slug, resolve it to UID
+                if (!is_numeric($productParam)) {
+                    $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                        ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+                    
+                    $productBySlug = $slugQueryBuilder
+                        ->select('uid')
+                        ->from('tx_vitec_domain_model_product')
+                        ->where(
+                            $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
+                            $slugQueryBuilder->expr()->eq('deleted', 0),
+                            $slugQueryBuilder->expr()->eq('hidden', 0)
+                        )
+                        ->executeQuery()
+                        ->fetchAssociative();
+                    
+                    $productUid = (int)($productBySlug['uid'] ?? 0);
+                } else {
+                    $productUid = (int)$productParam;
+                }
+            }
+        }
+        
+        if (!$productUid) {
+            return json_encode([
+                'error' => 'No product selected or found',
+                'debug' => [
+                    'settings' => $settings, 
+                    'routeParams' => $routeParams ?? [],
+                    'allQueryParams' => $GLOBALS['TYPO3_REQUEST']->getQueryParams() ?? [],
+                    'requestUri' => $GLOBALS['TYPO3_REQUEST']->getUri()->getPath() ?? ''
+                ]
+            ]);
+        }
+        
+        // Query product
+        $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+        
+        $product = $productQueryBuilder
+            ->select('*')
+            ->from('tx_vitec_domain_model_product')
+            ->where(
+                $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $productQueryBuilder->expr()->eq('deleted', 0),
+                $productQueryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAssociative();
+        
+        if (!$product) {
+            return json_encode([
+                'error' => 'Product not found',
+                'debug' => $debugMode ? ['productUid' => $productUid] : null
+            ]);
+        }
+        
+        // Get product images
+        $images = $this->getProductImages((int)$product['uid']);
+        
+        // Get categories
+        $categories = $this->getProductCategories((int)$product['uid']);
+        
+        // Get downloads
+        $downloads = $this->getProductDownloads((int)$product['uid']);
+        
+        // Build response
+        $response = [
+            'product' => [
+                'uid' => (int)$product['uid'],
+                'title' => $product['title'],
+                'subtitle' => $product['subtitle'],
+                'slug' => $product['slug'],
+                'teaser' => $product['teaser'],
+                'description' => $product['description'],
+                'seotitle' => $product['seotitle'],
+                'categories' => $categories,
+                'images' => $images,
+                'downloads' => $downloads,
+            ],
+            'layout' => $layout,
+            'settings' => [
+                'layout' => $layout,
+            ],
+        ];
+        
+        if ($debugMode) {
+            $response['debug'] = [
+                'pageId' => $pageId,
+                'productUid' => $productUid,
+                'layout' => $layout,
+                'settings' => $settings,
+            ];
+        }
+        
+        return json_encode($response);
+    }
+    
+    /**
+     * Get all images for a product with FAL and ImageService processing
+     */
+    protected function getProductImages(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+        
+        $fileReferences = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('productimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        if (empty($fileReferences)) {
+            return [];
+        }
+        
+        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+        $imageService = GeneralUtility::makeInstance(ImageService::class);
+        $images = [];
+        
+        foreach ($fileReferences as $fileRef) {
+            try {
+                $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+                $originalFile = $fileReference->getOriginalFile();
+                
+                // Process main image
+                $processedImage = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => '1874c', 'height' => '625c']
+                );
+                
+                // Generate srcset
+                $srcset = [];
+                foreach ([400, 800, 1200, 1600] as $width) {
+                    $processedVariant = $imageService->applyProcessingInstructions(
+                        $fileReference,
+                        ['width' => $width . 'c', 'height' => (int)($width / 3) . 'c']
+                    );
+                    $srcset[] = [
+                        'url' => $imageService->getImageUri($processedVariant),
+                        'width' => $width,
+                        'descriptor' => $width . 'w',
+                    ];
+                }
+                
+                $images[] = [
+                    'uid' => $fileRef['uid'],
+                    'url' => $imageService->getImageUri($processedImage),
+                    'title' => $fileReference->getTitle() ?: '',
+                    'alternative' => $fileReference->getAlternative() ?: '',
+                    'description' => $fileReference->getDescription() ?: '',
+                    'srcset' => $srcset,
+                    'properties' => [
+                        'width' => $originalFile->getProperty('width'),
+                        'height' => $originalFile->getProperty('height'),
+                        'mimeType' => $originalFile->getMimeType(),
+                    ],
+                ];
+            } catch (\Exception $e) {
+                // Skip invalid file references
+                continue;
+            }
+        }
+        
+        return $images;
+    }
+    
+    /**
+     * Get categories for a product
+     */
+    protected function getProductCategories(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+        
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' . 
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) . 
+                ' AND mm.fieldname = ' . 
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        return array_map(function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'],
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+    
+    /**
+     * Get all downloads for a product
+     */
+    protected function getProductDownloads(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
+        
+        $downloads = $queryBuilder
+            ->select('d.*')
+            ->from('tx_vitec_domain_model_download', 'd')
+            ->join(
+                'd',
+                'tx_vitec_product_download_mm',
+                'mm',
+                'mm.uid_foreign = d.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('d.deleted', 0),
+                $queryBuilder->expr()->eq('d.hidden', 0),
+                $queryBuilder->expr()->eq('d.hideonwebsite', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+        
+        $result = [];
+        foreach ($downloads as $download) {
+            $fileInfo = null;
+            
+            // Get file information from FAL if file reference exists
+            if (!empty($download['file'])) {
+                $fileQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                    ->getQueryBuilderForTable('sys_file_reference');
+                
+                $fileRef = $fileQueryBuilder
+                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
+                    ->from('sys_file_reference', 'fr')
+                    ->join('fr', 'sys_file', 'f', 'fr.uid_local = f.uid')
+                    ->where(
+                        $fileQueryBuilder->expr()->eq('fr.uid_foreign', $fileQueryBuilder->createNamedParameter((int)$download['uid'], ParameterType::INTEGER)),
+                        $fileQueryBuilder->expr()->eq('fr.tablenames', $fileQueryBuilder->createNamedParameter('tx_vitec_domain_model_download', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.fieldname', $fileQueryBuilder->createNamedParameter('file', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.deleted', 0),
+                        $fileQueryBuilder->expr()->eq('f.missing', 0)
+                    )
+                    ->orderBy('fr.sorting_foreign', 'ASC')
+                    ->setMaxResults(1)
+                    ->executeQuery()
+                    ->fetchAssociative();
+                
+                if ($fileRef) {
+                    $fileInfo = [
+                        'uid' => (int)$fileRef['file_uid'],
+                        'name' => $fileRef['name'],
+                        'url' => '/fileadmin' . $fileRef['identifier'],
+                        'size' => (int)$fileRef['size'],
+                        'extension' => $fileRef['extension'],
+                        'mimeType' => $fileRef['mime_type'] ?? '',
+                    ];
+                }
+            }
+            
+            $result[] = [
+                'uid' => (int)$download['uid'],
+                'title' => $download['title'] ?? '',
+                'slug' => $download['slug'] ?? '',
+                'teaser' => $download['teaser'] ?? '',
+                'description' => $download['description'] ?? '',
+                'keywords' => $download['keywords'] ?? '',
+                'icon' => $download['icon'] ?? '',
+                'file' => $fileInfo,
+            ];
+        }
+        
+        return $result;
+    }
+}
--- a/packages/vitec/Classes/UserFunc/ProductShowJsonRenderer.php.bak.20260518160048
+++ b/packages/vitec/Classes/UserFunc/ProductShowJsonRenderer.php.bak.20260518160048
@@ -0,0 +1,512 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Imaging\ImageManipulation\CropVariantCollection;
+use TYPO3\CMS\Core\Resource\FileReference;
+use TYPO3\CMS\Core\Imaging\ImageService;
+use Doctrine\DBAL\ParameterType;
+
+/**
+ * UserFunc to render single product data as JSON for headless output
+ */
+class ProductShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)$GLOBALS['TSFE']->id;
+
+        // DEBUG: Log that the UserFunc is being called
+        $debugInfo = [
+            'userFuncCalled' => true,
+            'pageId' => $pageId,
+            'requestUri' => $_SERVER['REQUEST_URI'] ?? 'unknown',
+        ];
+
+        // Query tt_content for vitec_productshow on this page
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $queryBuilder
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $queryBuilder->expr()->eq('pid', $queryBuilder->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('list_type', $queryBuilder->createNamedParameter('vitec_productshow', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $debugInfo['contentElementsFound'] = count($contentElements);
+
+        if (empty($contentElements)) {
+            $debugInfo['error'] = 'No vitec_productshow on page';
+            return json_encode(['debug' => $debugInfo]);
+        }
+
+        // Take the first one
+        $contentElement = $contentElements[0];
+
+        // Parse FlexForm
+        $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+        $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+        $settings = $flexFormData['settings'] ?? [];
+
+        // Get product UID from FlexForm or route parameter
+        $productUid = (int)($settings['product'] ?? 0);
+        $layout = (int)($settings['layout'] ?? 0);
+        $debugMode = (bool)($settings['debug'] ?? false);
+
+        // If no product selected in FlexForm, try to get from route parameter
+        if (!$productUid) {
+            // Get the product parameter from GET request
+            $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+            $productParam = $routeParams['tx_vitec_productshow']['product'] ?? null;
+
+            if ($productParam) {
+                // If it's a slug, resolve it to UID
+                if (!is_numeric($productParam)) {
+                    $slugQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                        ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+                    $productBySlug = $slugQueryBuilder
+                        ->select('uid')
+                        ->from('tx_vitec_domain_model_product')
+                        ->where(
+                            $slugQueryBuilder->expr()->eq('slug', $slugQueryBuilder->createNamedParameter($productParam)),
+                            $slugQueryBuilder->expr()->eq('deleted', 0),
+                            $slugQueryBuilder->expr()->eq('hidden', 0)
+                        )
+                        ->executeQuery()
+                        ->fetchAssociative();
+
+                    $productUid = (int)($productBySlug['uid'] ?? 0);
+                } else {
+                    $productUid = (int)$productParam;
+                }
+            }
+        }
+
+        if (!$productUid) {
+            return json_encode([
+                'error' => 'No product selected or found',
+                'debug' => [
+                    'settings' => $settings,
+                    'routeParams' => $routeParams ?? [],
+                    'allQueryParams' => $GLOBALS['TYPO3_REQUEST']->getQueryParams() ?? [],
+                    'requestUri' => $GLOBALS['TYPO3_REQUEST']->getUri()->getPath() ?? ''
+                ]
+            ]);
+        }
+
+        // Query product
+        $productQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $product = $productQueryBuilder
+            ->select('*')
+            ->from('tx_vitec_domain_model_product')
+            ->where(
+                $productQueryBuilder->expr()->eq('uid', $productQueryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $productQueryBuilder->expr()->eq('deleted', 0),
+                $productQueryBuilder->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$product) {
+            return json_encode([
+                'error' => 'Product not found',
+                'debug' => $debugMode ? ['productUid' => $productUid] : null
+            ]);
+        }
+
+        // Build response (full Product domain model + resolved relations)
+        $response = [
+            'product' => $this->serializeProduct($product),
+            'layout' => $layout,
+            'settings' => [
+                'layout' => $layout,
+            ],
+        ];
+
+        if ($debugMode) {
+            $response['debug'] = [
+                'pageId' => $pageId,
+                'productUid' => $productUid,
+                'layout' => $layout,
+                'settings' => $settings,
+            ];
+        }
+
+        return json_encode($response);
+    }
+
+    /**
+     * Serialize a single product DB row to the full headless JSON structure.
+     *
+     * Includes every field declared on the Product domain model
+     * (Evomedien\Vitec\Domain\Model\Product) plus all fully resolved
+     * relations (categories, productimage, downloads, ogimage, relatedprodukt).
+     *
+     * Kept structurally identical to ProductListJsonRenderer::serializeProduct()
+     * so list and detail endpoints expose the same product schema.
+     *
+     * @param array<string,mixed> $product Associative DB row of tx_vitec_domain_model_product
+     * @return array<string,mixed>
+     */
+    protected function serializeProduct(array $product): array
+    {
+        $uid = (int)$product['uid'];
+
+        return [
+            // --- identifier ---
+            'uid' => $uid,
+
+            // --- scalar string fields (Product domain model) ---
+            'title' => (string)($product['title'] ?? ''),
+            'slug' => (string)($product['slug'] ?? ''),
+            'urltitle' => (string)($product['urltitle'] ?? ''),
+            'seotitle' => (string)($product['seotitle'] ?? ''),
+            'seometa' => (string)($product['seometa'] ?? ''),
+            'keywords' => (string)($product['keywords'] ?? ''),
+            'structureddata' => (string)($product['structureddata'] ?? ''),
+            'teaser' => (string)($product['teaser'] ?? ''),
+            'subtitle' => (string)($product['subtitle'] ?? ''),
+            'video' => (string)($product['video'] ?? ''),
+            'applications' => (string)($product['applications'] ?? ''),
+            'description' => (string)($product['description'] ?? ''),
+            'highlights' => (string)($product['highlights'] ?? ''),
+            'shortcutpid' => (string)($product['shortcutpid'] ?? ''),
+            'contentelement' => (string)($product['contentelement'] ?? ''),
+            'contentelementcta' => (string)($product['contentelementcta'] ?? ''),
+
+            // --- boolean flags (Product domain model) ---
+            'hideonapp' => (bool)($product['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($product['hideonwebsite'] ?? false),
+            'hideondatasheets' => (bool)($product['hideondatasheets'] ?? false),
+            'hideonproducts' => (bool)($product['hideonproducts'] ?? false),
+            'shortcut' => (bool)($product['shortcut'] ?? false),
+            'legacy' => (bool)($product['legacy'] ?? false),
+            'supportproduct' => (bool)($product['supportproduct'] ?? false),
+            'subproduct' => (bool)($product['subproduct'] ?? false),
+
+            // --- convenience link (kept for backward compatibility) ---
+            'link' => '/product/' . (string)($product['slug'] ?? ''),
+
+            // --- fully resolved relations ---
+            'categories' => $this->getProductCategories($uid),
+            'images' => $this->getProductImages($uid),
+            'downloads' => $this->getProductDownloads($uid),
+            'ogimage' => $this->getProductOgImage($uid),
+            'relatedprodukt' => $this->getRelatedProducts($uid),
+        ];
+    }
+
+    /**
+     * Get all images for a product with FAL and ImageService processing
+     */
+    protected function getProductImages(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileReferences = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('productimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($fileReferences)) {
+            return [];
+        }
+
+        $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+        $imageService = GeneralUtility::makeInstance(ImageService::class);
+        $images = [];
+
+        foreach ($fileReferences as $fileRef) {
+            try {
+                $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+                $originalFile = $fileReference->getOriginalFile();
+
+                // Process main image
+                $processedImage = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => '1874c', 'height' => '625c']
+                );
+
+                // Generate srcset
+                $srcset = [];
+                foreach ([400, 800, 1200, 1600] as $width) {
+                    $processedVariant = $imageService->applyProcessingInstructions(
+                        $fileReference,
+                        ['width' => $width . 'c', 'height' => (int)($width / 3) . 'c']
+                    );
+                    $srcset[] = [
+                        'url' => $imageService->getImageUri($processedVariant),
+                        'width' => $width,
+                        'descriptor' => $width . 'w',
+                    ];
+                }
+
+                $images[] = [
+                    'uid' => $fileRef['uid'],
+                    'url' => $imageService->getImageUri($processedImage),
+                    'title' => $fileReference->getTitle() ?: '',
+                    'alternative' => $fileReference->getAlternative() ?: '',
+                    'description' => $fileReference->getDescription() ?: '',
+                    'srcset' => $srcset,
+                    'properties' => [
+                        'width' => $originalFile->getProperty('width'),
+                        'height' => $originalFile->getProperty('height'),
+                        'mimeType' => $originalFile->getMimeType(),
+                    ],
+                ];
+            } catch (\Exception $e) {
+                // Skip invalid file references
+                continue;
+            }
+        }
+
+        return $images;
+    }
+
+    /**
+     * Get the single Open Graph image (ogimage) for a product, or null.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getProductOgImage(int $productUid): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRef = $queryBuilder
+            ->select('*')
+            ->from('sys_file_reference')
+            ->where(
+                $queryBuilder->expr()->eq('uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('fieldname', $queryBuilder->createNamedParameter('ogimage', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('deleted', 0),
+                $queryBuilder->expr()->eq('hidden', 0)
+            )
+            ->orderBy('sorting_foreign', 'ASC')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRef) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject($fileRef['uid']);
+            $originalFile = $fileReference->getOriginalFile();
+
+            $processedImage = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 1200]
+            );
+
+            return [
+                'uid' => $fileRef['uid'],
+                'url' => $imageService->getImageUri($processedImage),
+                'title' => $fileReference->getTitle() ?: '',
+                'alternative' => $fileReference->getAlternative() ?: '',
+                'description' => $fileReference->getDescription() ?: '',
+                'properties' => [
+                    'width' => $originalFile->getProperty('width'),
+                    'height' => $originalFile->getProperty('height'),
+                    'mimeType' => $originalFile->getMimeType(),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a product
+     */
+    protected function getProductCategories(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_product', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'],
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+
+    /**
+     * Get all downloads for a product
+     */
+    protected function getProductDownloads(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_download');
+
+        $downloads = $queryBuilder
+            ->select('d.*')
+            ->from('tx_vitec_domain_model_download', 'd')
+            ->join(
+                'd',
+                'tx_vitec_product_download_mm',
+                'mm',
+                'mm.uid_foreign = d.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('d.deleted', 0),
+                $queryBuilder->expr()->eq('d.hidden', 0),
+                $queryBuilder->expr()->eq('d.hideonwebsite', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($downloads as $download) {
+            $fileInfo = null;
+
+            // Get file information from FAL if file reference exists
+            if (!empty($download['file'])) {
+                $fileQueryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+                    ->getQueryBuilderForTable('sys_file_reference');
+
+                $fileRef = $fileQueryBuilder
+                    ->select('fr.uid', 'f.uid as file_uid', 'f.identifier', 'f.name', 'f.size', 'f.extension', 'f.mime_type')
+                    ->from('sys_file_reference', 'fr')
+                    ->join('fr', 'sys_file', 'f', 'fr.uid_local = f.uid')
+                    ->where(
+                        $fileQueryBuilder->expr()->eq('fr.uid_foreign', $fileQueryBuilder->createNamedParameter((int)$download['uid'], ParameterType::INTEGER)),
+                        $fileQueryBuilder->expr()->eq('fr.tablenames', $fileQueryBuilder->createNamedParameter('tx_vitec_domain_model_download', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.fieldname', $fileQueryBuilder->createNamedParameter('file', ParameterType::STRING)),
+                        $fileQueryBuilder->expr()->eq('fr.deleted', 0),
+                        $fileQueryBuilder->expr()->eq('f.missing', 0)
+                    )
+                    ->orderBy('fr.sorting_foreign', 'ASC')
+                    ->setMaxResults(1)
+                    ->executeQuery()
+                    ->fetchAssociative();
+
+                if ($fileRef) {
+                    $fileInfo = [
+                        'uid' => (int)$fileRef['file_uid'],
+                        'name' => $fileRef['name'],
+                        'url' => '/fileadmin' . $fileRef['identifier'],
+                        'size' => (int)$fileRef['size'],
+                        'extension' => $fileRef['extension'],
+                        'mimeType' => $fileRef['mime_type'] ?? '',
+                    ];
+                }
+            }
+
+            $result[] = [
+                'uid' => (int)$download['uid'],
+                'title' => $download['title'] ?? '',
+                'slug' => $download['slug'] ?? '',
+                'teaser' => $download['teaser'] ?? '',
+                'description' => $download['description'] ?? '',
+                'keywords' => $download['keywords'] ?? '',
+                'icon' => $download['icon'] ?? '',
+                'file' => $fileInfo,
+            ];
+        }
+
+        return $result;
+    }
+
+    /**
+     * Get related products (resolved via tx_vitec_product_related_mm).
+     *
+     * Returns a shallow representation (no nested relations) to avoid
+     * infinite recursion between mutually related products.
+     */
+    protected function getRelatedProducts(int $productUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tx_vitec_domain_model_product');
+
+        $related = $queryBuilder
+            ->select('p.uid', 'p.title', 'p.slug', 'p.subtitle', 'p.teaser', 'p.description')
+            ->from('tx_vitec_domain_model_product', 'p')
+            ->join(
+                'p',
+                'tx_vitec_product_related_mm',
+                'mm',
+                'mm.uid_foreign = p.uid'
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_local', $queryBuilder->createNamedParameter($productUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('p.deleted', 0),
+                $queryBuilder->expr()->eq('p.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        $result = [];
+        foreach ($related as $rel) {
+            $relUid = (int)$rel['uid'];
+
+            $result[] = [
+                'uid' => $relUid,
+                'title' => (string)($rel['title'] ?? ''),
+                'slug' => (string)($rel['slug'] ?? ''),
+                'subtitle' => (string)($rel['subtitle'] ?? ''),
+                'teaser' => (string)($rel['teaser'] ?? ''),
+                'description' => (string)($rel['description'] ?? ''),
+                'link' => '/product/' . (string)($rel['slug'] ?? ''),
+                'images' => $this->getProductImages($relUid),
+            ];
+        }
+
+        return $result;
+    }
+}
--- a/packages/vitec/Classes/UserFunc/UsecaseListJsonRenderer.php
+++ b/packages/vitec/Classes/UserFunc/UsecaseListJsonRenderer.php
@@ -0,0 +1,223 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render the usecase list as JSON for headless output.
+ *
+ * `render()` = page discovery (top-level plugin). `renderForRecord()` =
+ * one specific tt_content row, reused by ContainerChildrenProcessor for
+ * usecase-list plugins nested in a b13 container. Exception-safe.
+ */
+class UsecaseListJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+        $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $ttContentQb
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaselist', ParameterType::STRING)),
+                $ttContentQb->expr()->eq('deleted', 0),
+                $ttContentQb->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($contentElements)) {
+            return '';
+        }
+
+        return $this->renderForRecord($contentElements[0]);
+    }
+
+    /**
+     * @param array<string,mixed> $contentElement
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecases = $usecaseQb
+                ->select('u.*')
+                ->from('tx_vitec_domain_model_usecase', 'u')
+                ->where(
+                    $usecaseQb->expr()->eq('u.deleted', 0),
+                    $usecaseQb->expr()->eq('u.hidden', 0),
+                    $usecaseQb->expr()->eq('u.hideonwebsite', 0)
+                )
+                ->orderBy('u.title', 'ASC')
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            $usecasesData = [];
+            foreach ($usecases as $usecase) {
+                $usecasesData[] = $this->serializeUsecase($usecase);
+            }
+
+            if ($debugMode) {
+                return json_encode([
+                    'usecases' => $usecasesData,
+                    'debug' => [
+                        'pageId' => (int)($GLOBALS['TSFE']->id ?? 0),
+                        'usecaseCount' => count($usecasesData),
+                        'settings' => $settings,
+                    ],
+                ]);
+            }
+
+            return json_encode($usecasesData);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            'uid' => $uid,
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $srcset = [];
+            foreach ([400, 800, 1200, 1600] as $width) {
+                $variant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($variant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}
--- a/packages/vitec/Classes/UserFunc/UsecaseListJsonRenderer.php.bak.20260518160048
+++ b/packages/vitec/Classes/UserFunc/UsecaseListJsonRenderer.php.bak.20260518160048
@@ -0,0 +1,244 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\Connection;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render the usecase list as JSON for headless output.
+ *
+ * Mirrors ProductListJsonRenderer: Extbase repositories don't work in a
+ * UserFunc context (framework not bootstrapped), so tt_content and the
+ * usecase records are queried directly. Exception-safe: returns an empty
+ * string on any failure so headless `ifEmptyUnsetKey` can drop the key.
+ */
+class UsecaseListJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            // Find the vitec_usecaselist plugin on this page
+            $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tt_content');
+
+            $contentElements = $ttContentQb
+                ->select('*')
+                ->from('tt_content')
+                ->where(
+                    $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                    $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaselist', ParameterType::STRING)),
+                    $ttContentQb->expr()->eq('deleted', 0),
+                    $ttContentQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            if (empty($contentElements)) {
+                // Not a usecase-list page (or none configured): emit nothing
+                // so headless removes the key entirely.
+                return '';
+            }
+
+            $contentElement = $contentElements[0];
+
+            // Parse FlexForm (debug flag only; the list shows all visible usecases)
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            // Query visible usecases directly (Extbase unavailable in UserFunc)
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecases = $usecaseQb
+                ->select('u.*')
+                ->from('tx_vitec_domain_model_usecase', 'u')
+                ->where(
+                    $usecaseQb->expr()->eq('u.deleted', 0),
+                    $usecaseQb->expr()->eq('u.hidden', 0),
+                    $usecaseQb->expr()->eq('u.hideonwebsite', 0)
+                )
+                ->orderBy('u.title', 'ASC')
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            $usecasesData = [];
+            foreach ($usecases as $usecase) {
+                $usecasesData[] = $this->serializeUsecase($usecase);
+            }
+
+            if ($debugMode) {
+                return json_encode([
+                    'usecases' => $usecasesData,
+                    'debug' => [
+                        'pageId' => $pageId,
+                        'usecaseCount' => count($usecasesData),
+                        'settings' => $settings,
+                    ],
+                ]);
+            }
+
+            return json_encode($usecasesData);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * Serialize a single usecase DB row to the full headless JSON structure.
+     *
+     * Includes every field declared on the Usecase domain model
+     * (Evomedien\Vitec\Domain\Model\Usecase) plus all resolved relations
+     * (categories, caseimage, logoimage). Kept structurally analogous to
+     * ProductListJsonRenderer::serializeProduct().
+     *
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            // --- identifier ---
+            'uid' => $uid,
+
+            // --- scalar string fields (Usecase domain model) ---
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+
+            // --- boolean flags (Usecase domain model) ---
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+
+            // --- fully resolved relations ---
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * Resolve a single FAL image field (caseimage / logoimage) with srcset.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $sizes = [400, 800, 1200, 1600];
+            $srcset = [];
+            foreach ($sizes as $width) {
+                $processedVariant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($processedVariant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a usecase (resolved sys_category records).
+     */
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}
--- a/packages/vitec/Classes/UserFunc/UsecaseShowJsonRenderer.php
+++ b/packages/vitec/Classes/UserFunc/UsecaseShowJsonRenderer.php
@@ -0,0 +1,265 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render a single usecase as JSON for headless output.
+ *
+ * `render()` = page discovery (top-level plugin). `renderForRecord()` =
+ * one specific tt_content row, reused by ContainerChildrenProcessor for
+ * usecase-show plugins nested in a b13 container. Exception-safe.
+ */
+class UsecaseShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+        $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('tt_content');
+
+        $contentElements = $ttContentQb
+            ->select('*')
+            ->from('tt_content')
+            ->where(
+                $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaseshow', ParameterType::STRING)),
+                $ttContentQb->expr()->eq('deleted', 0),
+                $ttContentQb->expr()->eq('hidden', 0)
+            )
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        if (empty($contentElements)) {
+            return '';
+        }
+
+        return $this->renderForRecord($contentElements[0]);
+    }
+
+    /**
+     * @param array<string,mixed> $contentElement
+     */
+    public function renderForRecord(array $contentElement): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+
+            $usecaseUid = (int)($settings['usecase'] ?? 0);
+            $layout = (string)($settings['layout'] ?? 'default');
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            if (!$usecaseUid) {
+                $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+                $usecaseParam = $routeParams['tx_vitec_usecaseshow']['usecase'] ?? null;
+
+                if ($usecaseParam) {
+                    if (!is_numeric($usecaseParam)) {
+                        $slugQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                            ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+                        $bySlug = $slugQb
+                            ->select('uid')
+                            ->from('tx_vitec_domain_model_usecase')
+                            ->where(
+                                $slugQb->expr()->eq('slug', $slugQb->createNamedParameter($usecaseParam)),
+                                $slugQb->expr()->eq('deleted', 0),
+                                $slugQb->expr()->eq('hidden', 0)
+                            )
+                            ->executeQuery()
+                            ->fetchAssociative();
+                        $usecaseUid = (int)($bySlug['uid'] ?? 0);
+                    } else {
+                        $usecaseUid = (int)$usecaseParam;
+                    }
+                }
+            }
+
+            if (!$usecaseUid) {
+                return $debugMode
+                    ? json_encode(['error' => 'No usecase selected or found', 'debug' => ['settings' => $settings]])
+                    : '';
+            }
+
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecase = $usecaseQb
+                ->select('*')
+                ->from('tx_vitec_domain_model_usecase')
+                ->where(
+                    $usecaseQb->expr()->eq('uid', $usecaseQb->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                    $usecaseQb->expr()->eq('deleted', 0),
+                    $usecaseQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAssociative();
+
+            if (!$usecase) {
+                return $debugMode
+                    ? json_encode(['error' => 'Usecase not found', 'debug' => ['usecaseUid' => $usecaseUid]])
+                    : '';
+            }
+
+            $response = [
+                'usecase' => $this->serializeUsecase($usecase),
+                'layout' => $layout,
+                'settings' => [
+                    'layout' => $layout,
+                ],
+            ];
+
+            if ($debugMode) {
+                $response['debug'] = [
+                    'pageId' => $pageId,
+                    'usecaseUid' => $usecaseUid,
+                    'layout' => $layout,
+                    'settings' => $settings,
+                ];
+            }
+
+            return json_encode($response);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            'uid' => $uid,
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $srcset = [];
+            foreach ([400, 800, 1200, 1600] as $width) {
+                $variant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($variant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}
--- a/packages/vitec/Classes/UserFunc/UsecaseShowJsonRenderer.php.bak.20260518160048
+++ b/packages/vitec/Classes/UserFunc/UsecaseShowJsonRenderer.php.bak.20260518160048
@@ -0,0 +1,271 @@
+<?php
+
+declare(strict_types=1);
+
+namespace Evomedien\Vitec\UserFunc;
+
+use Doctrine\DBAL\ParameterType;
+use TYPO3\CMS\Core\Database\ConnectionPool;
+use TYPO3\CMS\Core\Resource\ResourceFactory;
+use TYPO3\CMS\Core\Service\FlexFormService;
+use TYPO3\CMS\Core\Utility\GeneralUtility;
+use TYPO3\CMS\Extbase\Service\ImageService;
+
+/**
+ * UserFunc to render a single usecase as JSON for headless output.
+ *
+ * Mirrors ProductShowJsonRenderer. Extbase repositories are unavailable in a
+ * UserFunc context, so tt_content and the usecase record are queried directly.
+ * Exception-safe: returns '' on any failure / when not applicable so headless
+ * `ifEmptyUnsetKey` drops the key entirely.
+ */
+class UsecaseShowJsonRenderer
+{
+    public function render(string $content, array $conf): string
+    {
+        try {
+            $pageId = (int)($GLOBALS['TSFE']->id ?? 0);
+
+            // Find the vitec_usecaseshow plugin on this page
+            $ttContentQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tt_content');
+
+            $contentElements = $ttContentQb
+                ->select('*')
+                ->from('tt_content')
+                ->where(
+                    $ttContentQb->expr()->eq('pid', $ttContentQb->createNamedParameter($pageId, ParameterType::INTEGER)),
+                    $ttContentQb->expr()->eq('list_type', $ttContentQb->createNamedParameter('vitec_usecaseshow', ParameterType::STRING)),
+                    $ttContentQb->expr()->eq('deleted', 0),
+                    $ttContentQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAllAssociative();
+
+            if (empty($contentElements)) {
+                return '';
+            }
+
+            $contentElement = $contentElements[0];
+
+            // Parse FlexForm
+            $flexFormService = GeneralUtility::makeInstance(FlexFormService::class);
+            $flexFormData = $flexFormService->convertFlexFormContentToArray($contentElement['pi_flexform'] ?? '');
+            $settings = $flexFormData['settings'] ?? [];
+
+            $usecaseUid = (int)($settings['usecase'] ?? 0);
+            $layout = (string)($settings['layout'] ?? 'default');
+            $debugMode = (bool)($settings['debug'] ?? false);
+
+            // Fall back to route / query parameter (uid or slug)
+            if (!$usecaseUid) {
+                $routeParams = $GLOBALS['TYPO3_REQUEST']->getQueryParams();
+                $usecaseParam = $routeParams['tx_vitec_usecaseshow']['usecase'] ?? null;
+
+                if ($usecaseParam) {
+                    if (!is_numeric($usecaseParam)) {
+                        $slugQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                            ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+                        $bySlug = $slugQb
+                            ->select('uid')
+                            ->from('tx_vitec_domain_model_usecase')
+                            ->where(
+                                $slugQb->expr()->eq('slug', $slugQb->createNamedParameter($usecaseParam)),
+                                $slugQb->expr()->eq('deleted', 0),
+                                $slugQb->expr()->eq('hidden', 0)
+                            )
+                            ->executeQuery()
+                            ->fetchAssociative();
+                        $usecaseUid = (int)($bySlug['uid'] ?? 0);
+                    } else {
+                        $usecaseUid = (int)$usecaseParam;
+                    }
+                }
+            }
+
+            if (!$usecaseUid) {
+                return $debugMode
+                    ? json_encode(['error' => 'No usecase selected or found', 'debug' => ['settings' => $settings]])
+                    : '';
+            }
+
+            // Query the usecase
+            $usecaseQb = GeneralUtility::makeInstance(ConnectionPool::class)
+                ->getQueryBuilderForTable('tx_vitec_domain_model_usecase');
+
+            $usecase = $usecaseQb
+                ->select('*')
+                ->from('tx_vitec_domain_model_usecase')
+                ->where(
+                    $usecaseQb->expr()->eq('uid', $usecaseQb->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                    $usecaseQb->expr()->eq('deleted', 0),
+                    $usecaseQb->expr()->eq('hidden', 0)
+                )
+                ->executeQuery()
+                ->fetchAssociative();
+
+            if (!$usecase) {
+                return $debugMode
+                    ? json_encode(['error' => 'Usecase not found', 'debug' => ['usecaseUid' => $usecaseUid]])
+                    : '';
+            }
+
+            $response = [
+                'usecase' => $this->serializeUsecase($usecase),
+                'layout' => $layout,
+                'settings' => [
+                    'layout' => $layout,
+                ],
+            ];
+
+            if ($debugMode) {
+                $response['debug'] = [
+                    'pageId' => $pageId,
+                    'usecaseUid' => $usecaseUid,
+                    'layout' => $layout,
+                    'settings' => $settings,
+                ];
+            }
+
+            return json_encode($response);
+        } catch (\Throwable $e) {
+            return '';
+        }
+    }
+
+    /**
+     * Serialize a single usecase DB row. Structurally identical to
+     * UsecaseListJsonRenderer::serializeUsecase() so list and detail
+     * endpoints expose the same usecase schema.
+     *
+     * @param array<string,mixed> $usecase
+     * @return array<string,mixed>
+     */
+    protected function serializeUsecase(array $usecase): array
+    {
+        $uid = (int)$usecase['uid'];
+
+        return [
+            'uid' => $uid,
+            'title' => (string)($usecase['title'] ?? ''),
+            'slug' => (string)($usecase['slug'] ?? ''),
+            'subtitle' => (string)($usecase['subtitle'] ?? ''),
+            'teaser' => (string)($usecase['teaser'] ?? ''),
+            'description' => (string)($usecase['description'] ?? ''),
+            'singlepid' => (string)($usecase['singlepid'] ?? ''),
+            'hideonapp' => (bool)($usecase['hideonapp'] ?? false),
+            'hideonwebsite' => (bool)($usecase['hideonwebsite'] ?? false),
+            'categories' => $this->getUsecaseCategories($uid),
+            'caseimage' => $this->getUsecaseImage($uid, 'caseimage'),
+            'logoimage' => $this->getUsecaseImage($uid, 'logoimage'),
+        ];
+    }
+
+    /**
+     * Resolve a single FAL image field (caseimage / logoimage) with srcset.
+     *
+     * @return array<string,mixed>|null
+     */
+    protected function getUsecaseImage(int $usecaseUid, string $fieldName): ?array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_file_reference');
+
+        $fileRefData = $queryBuilder
+            ->select('sfr.uid', 'sfr.title', 'sfr.description', 'sfr.alternative', 'sfr.crop')
+            ->from('sys_file_reference', 'sfr')
+            ->where(
+                $queryBuilder->expr()->eq('sfr.tablenames', $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.fieldname', $queryBuilder->createNamedParameter($fieldName, ParameterType::STRING)),
+                $queryBuilder->expr()->eq('sfr.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('sfr.deleted', 0),
+                $queryBuilder->expr()->eq('sfr.hidden', 0)
+            )
+            ->orderBy('sfr.sorting_foreign')
+            ->setMaxResults(1)
+            ->executeQuery()
+            ->fetchAssociative();
+
+        if (!$fileRefData) {
+            return null;
+        }
+
+        try {
+            $resourceFactory = GeneralUtility::makeInstance(ResourceFactory::class);
+            $imageService = GeneralUtility::makeInstance(ImageService::class);
+            $fileReference = $resourceFactory->getFileReferenceObject((int)$fileRefData['uid']);
+
+            $srcset = [];
+            foreach ([400, 800, 1200, 1600] as $width) {
+                $variant = $imageService->applyProcessingInstructions(
+                    $fileReference,
+                    ['width' => $width, 'crop' => $fileRefData['crop'] ?? null]
+                );
+                $srcset[] = [
+                    'url' => $imageService->getImageUri($variant),
+                    'width' => $width,
+                    'descriptor' => $width . 'w',
+                ];
+            }
+
+            $default = $imageService->applyProcessingInstructions(
+                $fileReference,
+                ['width' => 800, 'crop' => $fileRefData['crop'] ?? null]
+            );
+
+            return [
+                'uid' => (int)$fileRefData['uid'],
+                'url' => $imageService->getImageUri($default),
+                'title' => $fileRefData['title'] ?? '',
+                'alternative' => $fileRefData['alternative'] ?? '',
+                'description' => $fileRefData['description'] ?? '',
+                'srcset' => $srcset,
+                'properties' => [
+                    'width' => $fileReference->getProperty('width'),
+                    'height' => $fileReference->getProperty('height'),
+                    'mimeType' => $fileReference->getProperty('mime_type'),
+                ],
+            ];
+        } catch (\Exception $e) {
+            return null;
+        }
+    }
+
+    /**
+     * Get categories for a usecase (resolved sys_category records).
+     */
+    protected function getUsecaseCategories(int $usecaseUid): array
+    {
+        $queryBuilder = GeneralUtility::makeInstance(ConnectionPool::class)
+            ->getQueryBuilderForTable('sys_category');
+
+        $categories = $queryBuilder
+            ->select('c.uid', 'c.title', 'c.description')
+            ->from('sys_category', 'c')
+            ->join(
+                'c',
+                'sys_category_record_mm',
+                'mm',
+                'mm.uid_local = c.uid AND mm.tablenames = ' .
+                $queryBuilder->createNamedParameter('tx_vitec_domain_model_usecase', ParameterType::STRING) .
+                ' AND mm.fieldname = ' .
+                $queryBuilder->createNamedParameter('categories', ParameterType::STRING)
+            )
+            ->where(
+                $queryBuilder->expr()->eq('mm.uid_foreign', $queryBuilder->createNamedParameter($usecaseUid, ParameterType::INTEGER)),
+                $queryBuilder->expr()->eq('c.deleted', 0),
+                $queryBuilder->expr()->eq('c.hidden', 0)
+            )
+            ->orderBy('mm.sorting', 'ASC')
+            ->executeQuery()
+            ->fetchAllAssociative();
+
+        return array_map(static function ($cat) {
+            return [
+                'uid' => (int)$cat['uid'],
+                'title' => $cat['title'] ?? '',
+                'description' => $cat['description'] ?? '',
+            ];
+        }, $categories);
+    }
+}