dbxShopAdmin.class.php

Go to the documentation of this file.

<?php
namespace dbx\dbxShop_admin;
 
class dbxShopAdmin {
 
   private function tpl() {
      return dbx()->get_system_obj('dbxTPL');
   }
 
   private function db() {
      return dbx()->get_system_obj('dbxDB');
   }
 
   private function h($value): string {
      return htmlspecialchars((string) $value, ENT_QUOTES, 'UTF-8');
   }
 
   private function openWinButton(string $url, string $title, string $content, string $class = 'btn btn-outline-primary', string $width = '88%', string $height = '88%'): string {
      $escUrl = $this->h($url);
      $escTitle = $this->h($title);
      $class = trim($class);
      if (strpos(' ' . $class . ' ', ' openWin ') === false) {
         $class .= ' openWin';
      }
      if (strpos(' ' . $class . ' ', ' dbx-win ') === false) {
         $class .= ' dbx-win';
      }
      return '<a class="' . $this->h($class) . '" href="' . $escUrl . '" data-url="' . $escUrl . '" data-title="' . $escTitle . '" data-width="' . $this->h($width) . '" data-height="' . $this->h($height) . '" title="' . $escTitle . '" role="button">' . $content . '</a>';
   }
 
   private function helpButton(int $helpId, string $title, string $class = 'btn btn-outline-secondary btn-sm me-1', string $width = '72%', string $height = '82%'): string {
      if ($helpId <= 0) {
         return '';
      }
      return $this->openWinButton(
         '?dbx_modul=dbxContent&dbx_run1=content&cid=' . $helpId . '&dbx_ajax=1',
         $title,
         '<i class="bi bi-question-circle"></i><span class="visually-hidden"> Hilfe</span>',
         $class,
         $width,
         $height
      );
   }
 
   private function money($value): string {
      return number_format((float) $value, 2, ',', '.') . ' EUR';
   }
 
   private function mediaUrl(string $path): string {
      $path = trim(str_replace('\\', '/', $path));
      if ($path === '') return '';
      if (preg_match('~^https?://~i', $path) || substr($path, 0, 1) === '/') return $path;
      return dbx()->get_base_url() . ltrim($path, '/');
   }
 
   private function mediaItemUrl(array $image, bool $thumb = true): string {
      $mediaId = (int)($image['media_id'] ?? 0);
      if ($mediaId > 0) {
         $url = 'index.php?dbx_modul=dbxContent&dbx_run1=media&dbx_mid=' . $mediaId;
         if ($thumb) {
            $url .= '&dbx_thumb=1';
         }
         return $url;
      }
      return $this->mediaUrl((string)($image['image_path'] ?? ''));
   }
 
   private function repo() {
      return dbx()->get_include_obj('dbxShopRepository', 'dbxShop');
   }
 
   private function ensureSeed(): void {
      $repo = $this->repo();
      $repo->install();
      if (count($repo->products(false)) === 0 || count($repo->shippingGroups()) === 0 || count($repo->channelGroups()) === 0 || count($repo->allImages()) === 0) {
         $repo->seedDemoProducts();
      }
   }
 
   private function shopMediaUsageContentId(): int {
      $configured = (int)dbx()->get_config('dbxShop', 'media_usage_content_id');
      if ($configured > 0 && $this->contentPageExists($configured)) {
         return $configured;
      }
 
      return $this->ensureShopMediaUsagePage();
   }
 
   private function contentDd(): string {
      return function_exists('dbx_lng_name') ? dbx_lng_name('content') : 'content_de';
   }
 
   private function folderDd(): string {
      return function_exists('dbx_lng_name') ? dbx_lng_name('content_folder') : 'content_folder_de';
   }
 
   private function contentPageExists(int $contentId): bool {
      if ($contentId <= 0) {
         return false;
      }
      try {
         $row = $this->db()->select1($this->contentDd(), $contentId, 'id', 0);
         return is_array($row) && (int)($row['id'] ?? 0) === $contentId;
      } catch (\Throwable $e) {
         return false;
      }
   }
 
   private function ensureShopHelpFolder(): int {
      $db = $this->db();
      $folderDd = $this->folderDd();
      $row = $db->select1($folderDd, array('name' => 'shop', 'parent_id' => 0), 'id', 0);
      if (is_array($row) && (int)($row['id'] ?? 0) > 0) {
         return (int)$row['id'];
      }
 
      $folderId = 0;
      $folderOk = (int)$db->insert($folderDd, array(
         'name' => 'shop',
         'parent_id' => 0,
         'sorter' => '9000',
         'group_read' => 'admin',
         'template' => 'c-content',
         'hero_template' => 'image-hero',
         'hero_image_id' => '',
         'hero_margin_top' => '',
         'hero_height' => '',
         'hero_variant' => '',
         'hero_sticky' => '',
         'hero_scroll_layer' => '',
      ));
      if ($folderOk === 1) {
         $folderId = (int)$db->get_insert_id();
      }
      if ($folderId > 0) {
         return $folderId;
      }
 
      return 0;
   }
 
   private function channelGroupsHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Channel-Gruppen</h2>'
         . '<p>Channel-Gruppen buendeln die Verkaufskanaele, auf denen ein Shop-Artikel angeboten werden soll. Sie werden spaeter Artikeln zugeordnet und steuern damit, ob ein Artikel nur im Shop, auf Marktplatzkanaelen oder in mehreren Kanaelen gefuehrt wird.</p>'
         . '<h3>Eingabefelder</h3>'
         . '<dl>'
         . '<dt>Key</dt><dd>Eindeutiger technischer Schluessel der Channel-Gruppe. Verwenden Sie kurze, stabile Werte wie <code>software-shop</code> oder <code>merch-marketplaces</code>. Der Key wird beim Neuanlegen gespeichert und danach nicht mehr direkt in der Liste geaendert.</dd>'
         . '<dt>Channel-Gruppe</dt><dd>Sichtbarer Name fuer die Verwaltung. Dieser Name sollte knapp beschreiben, fuer welche Artikel oder Verkaufssituation die Gruppe gedacht ist.</dd>'
         . '<dt>Beschreibung</dt><dd>Interne Erklaerung der Gruppe. Tragen Sie ein, welche Artikel in diese Gruppe gehoeren und warum die ausgewaehlten Channels passen.</dd>'
         . '<dt>Channels</dt><dd>Auswahl der aktiven Verkaufskanaele innerhalb dieser Gruppe. Aktivierte Checkboxen bedeuten: Artikel mit dieser Gruppe duerfen auf diesen Kanaelen gefuehrt oder exportiert werden.</dd>'
         . '<dt>Sort</dt><dd>Reihenfolge in Auswahllisten und Tabellen. Kleine Zahlen stehen weiter oben. Nutzen Sie Abstaende wie 10, 20, 30, damit spaeter Gruppen dazwischen einsortiert werden koennen.</dd>'
         . '<dt>Aktiv</dt><dd>Schaltet die Channel-Gruppe fuer die Nutzung ein oder aus. Inaktive Gruppen bleiben erhalten, werden aber nicht als aktive Option behandelt.</dd>'
         . '</dl>'
         . '<h3>Aktionen</h3>'
         . '<ul>'
         . '<li><strong>Plus in der Bar:</strong> fuegt oben eine leere Eingabezeile fuer eine neue Channel-Gruppe ein.</li>'
         . '<li><strong>Speichern:</strong> uebernimmt Name, Beschreibung, Channel-Auswahl, Sortierung und Aktiv-Status.</li>'
         . '<li><strong>Loeschen:</strong> verschiebt die Channel-Gruppe in den Papierkorb und deaktiviert ihre Channel-Zuordnungen. Bestehende Produktdaten bleiben dadurch nachvollziehbar, die Gruppe erscheint aber nicht mehr in der aktiven Liste.</li>'
         . '</ul>'
         . '<p><strong>Praxis:</strong> Legen Sie Gruppen nach Vertriebsszenarien an, nicht nach einzelnen Artikeln. Beispiele sind <code>software-shop</code>, <code>digital-marketplaces</code> oder <code>service-local</code>.</p>'
         . '</section>';
   }
 
   private function channelsHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Channels</h2>'
         . '<p>Channels beschreiben einzelne Verkaufskanaele wie Shop, eBay, Amazon, Kleinanzeigen oder eigene Marktplatz-Anbindungen. Ein aktiver Channel kann fuer Artikel-Export, Listing-Pflege und spaeter fuer Bestellrueckmeldungen genutzt werden.</p>'
         . '<h3>Eingabefelder</h3>'
         . '<dl>'
         . '<dt>Key</dt><dd>Eindeutiger technischer Schluessel des Channels, zum Beispiel <code>ebay</code> oder <code>amazon</code>. Der Key wird beim Neuanlegen vergeben und von Artikelzuordnungen und Bestellungen referenziert.</dd>'
         . '<dt>Channel</dt><dd>Sichtbarer Name in Verwaltung, Artikelliste und Channel-Gruppen.</dd>'
         . '<dt>Beschreibung</dt><dd>Interne Notiz, wofuer der Channel genutzt wird und welche Besonderheiten bei Angeboten gelten.</dd>'
         . '<dt>Plattform</dt><dd>Typ der Zielplattform. Vordefinierte Werte helfen spaeter beim Anschluss spezifischer API-Adapter; <code>custom</code> ist fuer eigene Integrationen gedacht.</dd>'
         . '<dt>Verbindung</dt><dd>Legt fest, ob der Channel intern, manuell, per API oder per Feed/Webhook betrieben wird.</dd>'
         . '<dt>Export</dt><dd>Erlaubt, Artikel aus dem Shop fuer diesen Channel vorzubereiten oder spaeter automatisiert als Listing zu uebertragen.</dd>'
         . '<dt>Order-Import</dt><dd>Erlaubt Bestellrueckmeldungen vom Channel in den Shop. Externe Plattformen benoetigen dafuer API-Zugriff oder einen Webhook.</dd>'
         . '<dt>API-Basis-URL</dt><dd>Basisadresse der Channel-API. Der Verbindungstest nutzt je nach Plattform den passenden Connector, z.B. eBay OAuth/Sell API, Amazon LWA/SP-API oder mobile.de Basic Auth.</dd>'
         . '<dt>Client-ID / Benutzer</dt><dd>Oeffentliche Kennung oder Login-Name der Integration.</dd>'
         . '<dt>Secret / Token / Passwort</dt><dd>Zugangsdaten fuer API-Aufrufe. Gespeicherte Werte werden im Feld angezeigt und koennen direkt ueberschrieben werden.</dd>'
         . '<dt>Marketplace-ID</dt><dd>Marktplatzkennung der Plattform, zum Beispiel <code>EBAY_DE</code> fuer eBay Deutschland oder <code>A1PA6795UKMFR9</code> fuer Amazon.de.</dd>'
         . '<dt>Seller-ID / Account-ID</dt><dd>Verkaeufer- oder Konto-ID der Plattform. Bei mobile.de ist hier insbesondere die <code>mobileSellerId</code> relevant.</dd>'
         . '<dt>Location-Key</dt><dd>Lager-, Standort- oder Versandortkennung. eBay benoetigt einen Merchant Location Key, bevor Angebote veroeffentlicht werden koennen.</dd>'
         . '<dt>Kategorie-ID</dt><dd>Standard-Kategorie fuer neue Listings, wenn der Adapter keine automatische Kategorieermittlung nutzt.</dd>'
         . '<dt>Payment-, Fulfillment- und Return-Policy</dt><dd>Policy-IDs der Plattform. Bei eBay sind das die Business Policies des Verkaeuferkontos: <strong>Payment Policy</strong> beschreibt Zahlungsarten und Zahlungsbedingungen, <strong>Fulfillment Policy</strong> beschreibt Versandservice, Bearbeitungszeit, Versandkosten und Versandregionen, <strong>Return Policy</strong> beschreibt Ruecknahmefrist, Kostentraeger und Rueckgabebedingungen. eBay-Angebote koennen ohne passende Policy-IDs oft nicht veroeffentlicht werden.</dd>'
         . '<dt>Notification-Ziel / Topic</dt><dd>Ziel fuer Rueckmeldungen, zum Beispiel eBay Notification Destination oder Amazon SQS ARN, plus Ereignis wie <code>ORDER_CHANGE</code>.</dd>'
         . '<dt>API-Scopes / Rollen</dt><dd>Dokumentation der erforderlichen Berechtigungen, etwa eBay OAuth Scopes oder Amazon SP-API Rollen. In der Maske am besten einen Wert pro Zeile eintragen. Wenn ein Anbieter technisch Leerzeichen erwartet, verbindet der spaetere Adapter diese Zeilen beim API-Aufruf passend.</dd>'
         . '<dt>Webhook-Secret</dt><dd>Geheimer Wert zur Pruefung eingehender Rueckmeldungen, zum Beispiel wenn ein Kauf auf eBay oder Amazon im Shop als Bestellung angelegt werden soll.</dd>'
         . '<dt>Sort / Aktiv</dt><dd>Sortierung und grundsaetzliche Freigabe des Channels.</dd>'
         . '</dl>'
         . '<h3>Aktionen</h3>'
         . '<ul>'
         . '<li><strong>Plus in der Bar:</strong> oeffnet ein Formular fuer einen neuen Channel.</li>'
         . '<li><strong>Speichern:</strong> uebernimmt Stammdaten, Integrationsmodus und Zugangsdaten.</li>'
         . '<li><strong>Test:</strong> prueft provider-spezifisch die Pflichtfelder und, soweit Zugangsdaten vorhanden sind, einen echten API-Zugriff ohne Daten zu veraendern.</li>'
         . '<li><strong>Loeschen:</strong> deaktiviert und verschiebt den Channel in den Papierkorb. Artikelzuordnungen werden deaktiviert.</li>'
         . '</ul>'
         . '<p><strong>Praxis:</strong> Erst Channel konfigurieren, dann in Channel-Gruppen auswaehlen und anschliessend Artikel diesen Gruppen oder einzelnen Channels zuordnen.</p>'
         . '</section>';
   }
 
   private function channelProviderHelpHtml(string $platform): string {
      $common = '<h3>Gemeinsame Eingabefelder</h3>'
         . '<dl>'
         . '<dt>Key</dt><dd>Technischer Schluessel des Channels. Er wird in Artikelzuordnungen, Channel-Gruppen, Webhook-URLs und Bestellungen gespeichert. Nach dem Anlegen nicht mehr aendern.</dd>'
         . '<dt>Channel</dt><dd>Sichtbarer Name in der Verwaltung.</dd>'
         . '<dt>Plattform</dt><dd>Legt fest, welcher Adapter oder welche Arbeitsweise spaeter verwendet wird.</dd>'
         . '<dt>Verbindung</dt><dd><code>Intern</code> fuer den Shop selbst, <code>Manuell</code> fuer Pflege ohne API, <code>API</code> fuer direkte Schnittstellen, <code>Feed</code> fuer Dateiuebergaben und <code>Webhook</code> fuer Rueckmeldungen.</dd>'
         . '<dt>Aktiv</dt><dd>Nur aktive Channels koennen Artikeln zugeordnet und fuer Importe verwendet werden.</dd>'
         . '<dt>Export</dt><dd>Erlaubt, Artikel fuer diesen Channel vorzubereiten oder spaeter automatisiert zur Plattform zu uebertragen.</dd>'
         . '<dt>Order-Import</dt><dd>Erlaubt, Bestellungen oder Kauf-/Lead-Rueckmeldungen vom Channel in dbxShop zu uebernehmen.</dd>'
         . '<dt>API-Basis-URL</dt><dd>Basisadresse der Anbieter-API. Der Verbindungstest nutzt den passenden Connector und macht nur lesende Pruefungen.</dd>'
         . '<dt>Client-ID</dt><dd>Oeffentliche App- oder Client-Kennung der Plattform.</dd>'
         . '<dt>Client-Secret</dt><dd>Geheimer App-Schluessel. Der gespeicherte Wert wird angezeigt und kann direkt ersetzt werden.</dd>'
         . '<dt>Access-Token</dt><dd>Kurzlebiger Zugriffstoken. Wird oft automatisch aus dem Refresh-Token erneuert.</dd>'
         . '<dt>Refresh-Token</dt><dd>Langfristiger Token, mit dem neue Access-Tokens erzeugt werden.</dd>'
         . '<dt>Benutzer / Passwort</dt><dd>Nur fuer Plattformen mit Basic Auth oder klassischem API-Login verwenden.</dd>'
         . '<dt>Marketplace-ID</dt><dd>Marktplatz- oder Laenderkennung, zum Beispiel <code>EBAY_DE</code> oder <code>A1PA6795UKMFR9</code>.</dd>'
         . '<dt>Seller-ID</dt><dd>Verkaeuferkennung der Plattform.</dd>'
         . '<dt>Account-ID / mobileSellerId</dt><dd>Konto-, Haendler- oder mobile.de Seller-ID.</dd>'
         . '<dt>Location-Key</dt><dd>Standort- oder Lagerkennung, relevant fuer eBay-Angebote.</dd>'
         . '<dt>Kategorie-ID</dt><dd>Plattformkategorie fuer Listings, falls keine automatische Zuordnung genutzt wird.</dd>'
         . '<dt>Payment-, Fulfillment-, Return-Policy</dt><dd>Policy-IDs fuer Zahlungs-, Versand- und Rueckgaberegeln. Fuer eBay sind diese Felder besonders wichtig; Details stehen im eBay-Hilfetext.</dd>'
         . '<dt>Notification-Ziel / SQS ARN</dt><dd>Zieladresse fuer Ereignisse: HTTPS-Destination bei eBay oder Amazon SQS ARN bei Amazon.</dd>'
         . '<dt>Notification-Topic</dt><dd>Ereignistyp, der abonniert wird, zum Beispiel <code>ORDER_CHANGE</code>.</dd>'
         . '<dt>API-Scopes / Rollen</dt><dd>Dokumentation der genehmigten Berechtigungen. Empfehlung fuer die Eingabe: ein Scope oder eine Rolle pro Zeile. eBay verlangt die Scopes im OAuth-Request technisch als leerzeichengetrennte Liste; beim Senden wird das dann URL-encodiert. Amazon verwendet hier eher Rollen/Berechtigungen, keine eBay-artige Scope-Liste.</dd>'
         . '<dt>Webhook-Secret</dt><dd>Geheimer Wert, mit dem dbxShop eingehende Channel-Webhooks pruefen kann.</dd>'
         . '<dt>dbxShop Webhook-URL</dt><dd>URL, die eine Plattform oder Middleware fuer Rueckmeldungen aufrufen kann.</dd>'
         . '</dl>';
 
      $linksTitle = '<h3>Beantragen / Bearbeiten</h3>';
      switch ($platform) {
         case 'ebay':
            return '<section class="dbx-shop-help">'
               . '<h2>Channel-Hilfe: eBay</h2>'
               . '<p>eBay ist ein API-faehiger Marktplatz-Channel. Fuer automatische Listings braucht dbxShop OAuth-Zugangsdaten, Marketplace, Location und Business-Policies. Fuer Bestellungen werden Fulfillment API oder Notification API genutzt.</p>'
               . $common
               . '<h3>eBay-spezifisch</h3><ol>'
               . '<li>Developer-Konto anlegen und Application Keyset erstellen. Daraus kommen Client-ID und Client-Secret.</li>'
               . '<li>OAuth User Consent fuer den eBay-Verkaeufer durchlaufen. Daraus kommt der Refresh-Token.</li>'
               . '<li>Scopes fuer Inventory, Fulfillment und Notifications eintragen.</li>'
               . '<li>Marketplace-ID setzen, fuer Deutschland meist <code>EBAY_DE</code>.</li>'
               . '<li>Merchant Location Key anlegen oder aus der Inventory API uebernehmen.</li>'
               . '<li>Payment-, Fulfillment- und Return-Policy in eBay Business Policies pflegen. Die IDs kommen aus dem eBay Seller-Konto oder aus der Account API. Ohne diese IDs kann ein Offer zwar vorbereitet sein, aber haeufig nicht erfolgreich published werden.</li>'
               . '<li><strong>Payment Policy ID:</strong> ID der Zahlungsregel, z.B. welche Zahlungsarten erlaubt sind und wann bezahlt werden muss.</li>'
               . '<li><strong>Fulfillment Policy ID:</strong> ID der Versandregel, z.B. Versanddienst, Bearbeitungszeit, Kosten, kostenlose Lieferung, internationale Versandzonen.</li>'
               . '<li><strong>Return Policy ID:</strong> ID der Rueckgaberegel, z.B. ob Rueckgabe akzeptiert wird, Frist und wer Ruecksendekosten traegt.</li>'
               . '<li>Notification Destination auf die dbxShop Webhook-URL setzen und Topic/Subscription fuer Order-Ereignisse konfigurieren.</li>'
               . '</ol>'
               . '<h3>eBay Scopes richtig eintragen</h3>'
               . '<p>eBay OAuth erwartet Scopes technisch im Parameter <code>scope</code> als durch Leerzeichen getrennte Liste. In diesem Formular ist es uebersichtlicher, jeden Scope in eine eigene Zeile zu schreiben. Ein spaeterer eBay-Adapter kann daraus automatisch die leerzeichengetrennte und URL-encodierte OAuth-Liste bauen.</p>'
               . '<p>Beispiel:</p>'
               . '<pre><code>https://api.ebay.com/oauth/api_scope/sell.inventory&#10;https://api.ebay.com/oauth/api_scope/sell.fulfillment&#10;https://api.ebay.com/oauth/api_scope/commerce.notification.subscription</code></pre>'
               . $linksTitle
               . '<ul>'
               . '<li><a href="https://developer.ebay.com/develop/guides-v2/get-started-with-ebay-apis" target="_blank" rel="noopener">eBay APIs starten und Application Keys</a></li>'
               . '<li><a href="https://developer.ebay.com/develop/guides-v2/authorization" target="_blank" rel="noopener">eBay OAuth und Scopes</a></li>'
               . '<li><a href="https://developer.ebay.com/api-docs/sell/inventory/overview.html" target="_blank" rel="noopener">eBay Inventory API</a></li>'
               . '<li><a href="https://developer.ebay.com/api-docs/sell/fulfillment/overview.html" target="_blank" rel="noopener">eBay Fulfillment API / Orders</a></li>'
               . '<li><a href="https://developer.ebay.com/api-docs/commerce/notification/overview.html" target="_blank" rel="noopener">eBay Notification API</a></li>'
               . '<li><a href="https://www.ebay.com/help/selling/business-policies/business-policies?id=4212" target="_blank" rel="noopener">eBay Business Policies</a></li>'
               . '</ul></section>';
 
         case 'amazon':
            return '<section class="dbx-shop-help">'
               . '<h2>Channel-Hilfe: Amazon</h2>'
               . '<p>Amazon nutzt die Selling Partner API. Fuer Listings und Orders braucht dbxShop eine registrierte SP-API App, LWA-Zugangsdaten, Seller-Autorisierung, Seller-ID, Marketplace-ID und passende Rollen.</p>'
               . $common
               . '<h3>Amazon-spezifisch</h3><ol>'
               . '<li>Professionelles Seller-Central-Konto und Entwicklerzugang vorbereiten.</li>'
               . '<li>SP-API Anwendung im Solution Provider Portal registrieren.</li>'
               . '<li>LWA Client-ID und Client-Secret aus der App-Registrierung uebernehmen.</li>'
               . '<li>Seller-Autorisierung durchlaufen und Refresh-Token speichern.</li>'
               . '<li>Marketplace-ID setzen, fuer Amazon.de <code>A1PA6795UKMFR9</code>.</li>'
               . '<li>Seller-ID aus Seller Central oder aus der Autorisierung uebernehmen.</li>'
               . '<li>Rollen fuer Product Listing, Orders und Notifications beantragen und im Feld API-Scopes/Rollen dokumentieren.</li>'
               . '<li>Fuer Rueckmeldungen Amazon Notifications API mit SQS Destination einrichten; die SQS ARN im Notification-Ziel speichern.</li>'
               . '</ol>'
               . '<h3>Amazon-Felder verstaendlich erklaert</h3><dl>'
               . '<dt>Client-ID und Client-Secret</dt><dd>Das sind die LWA-Zugangsdaten der registrierten SP-API Anwendung. Sie identifizieren die App, nicht den einzelnen Artikel.</dd>'
               . '<dt>Refresh-Token</dt><dd>Dieser Token entsteht, wenn der Seller die App autorisiert. Er ist der wichtigste gespeicherte Wert, weil daraus neue Access-Tokens erzeugt werden.</dd>'
               . '<dt>Marketplace-ID</dt><dd>Legt fest, auf welchem Amazon-Marktplatz gearbeitet wird. Fuer Deutschland ist das typischerweise <code>A1PA6795UKMFR9</code>.</dd>'
               . '<dt>Seller-ID</dt><dd>Identifiziert das Seller-Konto, fuer das Listings und Orders verarbeitet werden.</dd>'
               . '<dt>Kategorie-ID / Product Type</dt><dd>Amazon arbeitet nicht nur mit Kategorien, sondern stark mit Product Types und Pflichtattributen. Fuer Listings muss der Adapter wissen, welches Produktschema verwendet wird.</dd>'
               . '<dt>Notification-Ziel / SQS ARN</dt><dd>Amazon sendet Rueckmeldungen nicht direkt an irgendeine URL, sondern typischerweise an eine AWS SQS Queue. Die ARN dieser Queue gehoert in dieses Feld.</dd>'
               . '<dt>Notification-Topic</dt><dd>Fuer Bestellungen ist <code>ORDER_CHANGE</code> relevant. Damit koennen Statusaenderungen oder neue Bestellungen in dbxShop ankommen.</dd>'
               . '<dt>API-Scopes / Rollen</dt><dd>Hier dokumentieren, welche SP-API Rollen genehmigt wurden, zum Beispiel Listings, Orders und Notifications. Das sind keine eBay-OAuth-Scopes. Tragen Sie am besten eine Rolle pro Zeile ein, damit klar bleibt, welche Berechtigung vorhanden ist.</dd>'
               . '<dt>Payment/Fulfillment/Return Policies</dt><dd>Diese eBay-Felder sind fuer Amazon normalerweise nicht relevant. Amazon verwaltet Zahlungs- und Versandlogik anders ueber Seller Central, Fulfillment by Merchant oder FBA.</dd>'
               . '</dl>'
               . $linksTitle
               . '<ul>'
               . '<li><a href="https://developer-docs.amazon.com/sp-api/docs/registering-your-application" target="_blank" rel="noopener">Amazon SP-API App registrieren</a></li>'
               . '<li><a href="https://developer-docs.amazon.com/sp-api/docs/authorization-overview" target="_blank" rel="noopener">Amazon SP-API Autorisierung</a></li>'
               . '<li><a href="https://developer-docs.amazon.com/sp-api/docs/marketplace-ids" target="_blank" rel="noopener">Amazon Marketplace-IDs</a></li>'
               . '<li><a href="https://developer-docs.amazon.com/sp-api/docs/listings-items-api" target="_blank" rel="noopener">Amazon Listings Items API</a></li>'
               . '<li><a href="https://developer-docs.amazon.com/sp-api/docs/orders-api-v0-reference" target="_blank" rel="noopener">Amazon Orders API</a></li>'
               . '<li><a href="https://developer-docs.amazon.com/sp-api/docs/notifications-api" target="_blank" rel="noopener">Amazon Notifications API</a></li>'
               . '</ul></section>';
 
         case 'mobile':
            return '<section class="dbx-shop-help">'
               . '<h2>Channel-Hilfe: mobile.de</h2>'
               . '<p>mobile.de ist kein klassischer Warenkorb-Marktplatz, sondern vor allem ein Fahrzeuganzeigen- und Lead-Channel. Relevant sind Seller API fuer Anzeigen und Lead API fuer Rueckmeldungen.</p>'
               . $common
               . '<h3>mobile.de-spezifisch</h3><ol>'
               . '<li>Dealer- oder API-Account bei mobile.de verwenden.</li>'
               . '<li>API-Zugang im Dealer-Bereich oder ueber mobile.de Support aktivieren lassen.</li>'
               . '<li>Benutzer und Passwort fuer Basic Auth eintragen.</li>'
               . '<li>API-Basis-URL setzen, produktiv normalerweise <code>https://services.mobile.de</code> bzw. Seller-API-Pfad.</li>'
               . '<li>Account-ID/mobileSellerId oder Customer Number aus Dealer Area/API-Daten uebernehmen.</li>'
               . '<li>Fuer Rueckmeldungen Lead API nutzen; passende Lead-Events im Notification-Topic dokumentieren.</li>'
               . '</ol>'
               . '<h3>mobile.de-Felder verstaendlich erklaert</h3><dl>'
               . '<dt>API-Basis-URL</dt><dd>Adresse der mobile.de Seller API, zum Beispiel <code>https://services.mobile.de/seller-api</code>. Sandbox und Produktion koennen unterschiedliche URLs haben.</dd>'
               . '<dt>Benutzer / Passwort</dt><dd>mobile.de nutzt fuer viele API-Zugriffe Basic Auth. Deshalb sind API-Benutzer und API-Passwort wichtiger als Client-ID oder OAuth-Tokens.</dd>'
               . '<dt>Account-ID / mobileSellerId</dt><dd>Die mobileSellerId identifiziert den Haendlerbestand. Ohne diese Zuordnung kann ein System oft nicht wissen, zu welchem Haendler ein Inserat gehoert.</dd>'
               . '<dt>Seller-ID</dt><dd>Kann als Kundennummer oder interne Haendlerkennung dokumentiert werden.</dd>'
               . '<dt>Kategorie-ID</dt><dd>Beschreibt die Art des Inserats, zum Beispiel Auto, Motorrad oder Nutzfahrzeug. mobile.de ist stark fahrzeugorientiert, nicht allgemeiner Warenkorb-Shop.</dd>'
               . '<dt>Location-Key</dt><dd>Optionaler Standort oder Filialbezug, wenn ein Haendler mehrere Standorte hat.</dd>'
               . '<dt>Notification-Ziel / Topic</dt><dd>Rueckmeldungen sind eher Leads, Anfragen oder Direct Offers. Dokumentieren Sie hier, welche Middleware oder Lead-API angebunden ist.</dd>'
               . '<dt>Payment/Fulfillment/Return Policies</dt><dd>Diese eBay-Felder sind fuer mobile.de normalerweise nicht relevant, weil mobile.de keine klassischen Shop-Checkout-Regeln fuer diese Produkte verwaltet.</dd>'
               . '<dt>API-Scopes / Rollen</dt><dd>mobile.de nutzt in der Regel Basic Auth und API-Freischaltungen statt OAuth-Scopes. Das Feld kann zur Dokumentation genutzt werden, zum Beispiel <code>seller-api</code> und <code>lead-api</code> jeweils in einer eigenen Zeile.</dd>'
               . '</dl>'
               . $linksTitle
               . '<ul>'
               . '<li><a href="https://services.mobile.de/" target="_blank" rel="noopener">mobile.de API Uebersicht und Accounts</a></li>'
               . '<li><a href="https://services.mobile.de/manual/seller-api.html" target="_blank" rel="noopener">mobile.de Seller API</a></li>'
               . '<li><a href="https://services.sandbox.mobile.de/manual/lead-api.html" target="_blank" rel="noopener">mobile.de Lead API Sandbox</a></li>'
               . '<li><a href="https://services.mobile.de/manual/search-api.html" target="_blank" rel="noopener">mobile.de Search API / Customer IDs</a></li>'
               . '</ul></section>';
 
         case 'kleinanzeigen':
            return '<section class="dbx-shop-help">'
               . '<h2>Channel-Hilfe: Kleinanzeigen</h2>'
               . '<p>Kleinanzeigen ist hier als manueller oder vertraglicher Channel vorbereitet. Eine allgemein frei nutzbare offizielle Anzeigen-/Order-API fuer normale Shop-Artikel ist nicht hinterlegt. Keine Scraper-Zugangsdaten als offizielle API behandeln.</p>'
               . $common
               . '<h3>Kleinanzeigen-spezifisch</h3><ol>'
               . '<li>Wenn keine vertragliche Schnittstelle vorhanden ist, Verbindung auf <code>Manuell</code> lassen.</li>'
               . '<li>Export nur aktivieren, wenn eine rechtlich freigegebene Middleware oder Schnittstelle vorhanden ist.</li>'
               . '<li>API-Basis-URL, Benutzer, Token und Kategorie-ID nur aus dieser freigegebenen Schnittstelle uebernehmen.</li>'
               . '<li>Order-Import nur aktivieren, wenn Kauf-/Kontakt-Rueckmeldungen offiziell oder ueber eine eigene Middleware geliefert werden.</li>'
               . '<li>Fuer Immobilien gibt es offizielle Importschnittstellen; diese sind nicht automatisch eine allgemeine Artikel-API.</li>'
               . '</ol>'
               . '<h3>Kleinanzeigen-Felder verstaendlich erklaert</h3><dl>'
               . '<dt>Verbindung</dt><dd>Ohne freigegebene Schnittstelle sollte dieser Channel auf <code>Manuell</code> stehen. Das bedeutet: dbxShop dokumentiert den Channel, uebertraegt aber nicht automatisch.</dd>'
               . '<dt>API-Basis-URL / Client-ID / Secret / Token</dt><dd>Nur ausfuellen, wenn ein Vertrag, eine offizielle Importschnittstelle oder eine eigene Middleware diese Werte bereitstellt. Keine Login-Daten fuer Scraping eintragen.</dd>'
               . '<dt>Kategorie-ID</dt><dd>Falls eine freigegebene Schnittstelle Kategorien verwendet, kann hier die Zielkategorie dokumentiert werden.</dd>'
               . '<dt>Location-Key</dt><dd>Kann Ort, PLZ oder Standort-ID enthalten, wenn die Schnittstelle das erwartet.</dd>'
               . '<dt>Notification-Ziel / Topic</dt><dd>Bei Kleinanzeigen sind Rueckmeldungen eher Nachrichten, Leads oder Kontaktanfragen. Ein echter Kauf-Webhook ist nur sinnvoll, wenn eine Middleware solche Ereignisse liefert.</dd>'
               . '<dt>Order-Import</dt><dd>Nur aktivieren, wenn wirklich strukturierte Kauf-/Kontakt-Rueckmeldungen an dbxShop uebergeben werden koennen. Sonst bleibt die Pflege manuell.</dd>'
               . '<dt>Payment/Fulfillment/Return Policies</dt><dd>Diese eBay-Felder sind fuer Kleinanzeigen normalerweise nicht relevant.</dd>'
               . '<dt>API-Scopes / Rollen</dt><dd>Nur ausfuellen, wenn eine vertragliche Schnittstelle oder Middleware konkrete Berechtigungen nennt. Auch hier ist ein Wert pro Zeile am verstaendlichsten.</dd>'
               . '</dl>'
               . $linksTitle
               . '<ul>'
               . '<li><a href="https://hilfe-gewerblich.kleinanzeigen.de/artikel/schnittstellen" target="_blank" rel="noopener">Kleinanzeigen gewerbliche Schnittstellen</a></li>'
               . '<li><a href="https://business.kleinanzeigen.de/" target="_blank" rel="noopener">Kleinanzeigen fuer Gewerbliche</a></li>'
               . '</ul></section>';
 
         case 'shop':
            return '<section class="dbx-shop-help">'
               . '<h2>Channel-Hilfe: Shop</h2>'
               . '<p>Der Shop-Channel ist der interne Verkaufskanal. Er braucht keine externen API-Zugangsdaten.</p>'
               . $common
               . '<h3>Shop-spezifisch</h3><ol>'
               . '<li>Verbindung auf <code>Intern</code> lassen.</li>'
               . '<li>Export aktiv lassen, wenn Artikel im eigenen Shop sichtbar sein duerfen.</li>'
               . '<li>Order-Import bleibt aus, weil Bestellungen direkt im Shop entstehen.</li>'
               . '<li>API-Felder, Token, Marketplace-ID und Policies sind fuer den internen Shop nicht benoetigt.</li>'
               . '</ol></section>';
 
         default:
            return '<section class="dbx-shop-help">'
               . '<h2>Channel-Hilfe: Eigener Channel</h2>'
               . '<p>Eigene Channels koennen an individuelle APIs, Feed-Exporte oder Middleware angebunden werden. Die konkreten Pflichtwerte haengen vom Adapter ab.</p>'
               . $common
               . '<h3>Vorgehen</h3><ol>'
               . '<li>Beim Anbieter API-Zugang, Dokumentation und Testumgebung beantragen.</li>'
               . '<li>API-Basis-URL, Authentifizierung und erforderliche IDs in die Felder uebernehmen.</li>'
               . '<li>Webhook-Secret setzen und den dbxShop Webhook in der Middleware hinterlegen.</li>'
               . '<li>Verbindung testen und erst danach Export oder Order-Import produktiv nutzen.</li>'
               . '</ol></section>';
      }
   }
 
   private function productGroupsHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Artikelgruppen</h2>'
         . '<p>Artikelgruppen beschreiben fachliche Produktfamilien. Sie steuern Standardwerte wie Mehrwertsteuer, Darstellung, Detailansicht, Galerieverhalten und Hinweise zu Artikelattributen.</p>'
         . '<h3>Eingabefelder</h3>'
         . '<dl>'
         . '<dt>Key</dt><dd>Eindeutiger technischer Schluessel der Artikelgruppe. Nutzen Sie kurze stabile Werte wie <code>software</code>, <code>merch</code> oder <code>service</code>. Der Key wird beim Neuanlegen vergeben und bleibt danach stabil.</dd>'
         . '<dt>Obergruppe</dt><dd>Optionaler Platz in der Gruppenstruktur. Ohne Obergruppe erscheint die Gruppe als oberste Kachel im Katalog. Mit Obergruppe wird sie erst angezeigt, wenn der Kunde die uebergeordnete Gruppe anklickt, zum Beispiel <code>Kleidung / T-Shirts / male</code>.</dd>'
         . '<dt>Gruppe</dt><dd>Sichtbarer Name der Artikelgruppe in Verwaltung und Auswahllisten.</dd>'
         . '<dt>Beschreibung</dt><dd>Interne Beschreibung, welche Artikel in diese Gruppe gehoeren und wie sie im Shop verwendet wird.</dd>'
         . '<dt>Gruppenbild</dt><dd>Bild fuer die Gruppenkachel im Katalog. Pro Artikelgruppe gibt es genau ein aktives Gruppenbild. Eine neue Auswahl ersetzt das bisherige Gruppenbild; die Datei im CMS-Medienbrowser bleibt erhalten.</dd>'
         . '<dt>MwSt.</dt><dd>Standard-Mehrwertsteuersatz fuer Artikel dieser Gruppe. Einzelne Artikel koennen abweichen, wenn sie eigene Steuerwerte verwenden.</dd>'
         . '<dt>Karte</dt><dd>Template fuer Produktkarten in Listen, Katalogen oder Teasern.</dd>'
         . '<dt>Detail</dt><dd>Template fuer die Detailseite eines Artikels aus dieser Gruppe.</dd>'
         . '<dt>Gallery</dt><dd>Template fuer die Bild- oder Mediengalerie der Gruppe.</dd>'
         . '<dt>Bilder</dt><dd>Anzahl der initial sichtbaren Galeriebilder. Weitere Bilder koennen je nach Overflow-Einstellung sichtbar, scrollbar oder per Galerie erreichbar sein.</dd>'
         . '<dt>Bildgroesse</dt><dd>Steuert, wie Bilder in der Galerie eingepasst werden: Original, Cover oder Contain.</dd>'
         . '<dt>Lightbox</dt><dd>Breite der Lightbox-Ansicht, zum Beispiel <code>100vw</code> fuer volle Viewport-Breite.</dd>'
         . '<dt>Overflow</dt><dd>Verhalten bei vielen Bildern, zum Beispiel Grid, Slider, Scroll, Laufband oder Tutorial.</dd>'
         . '<dt>Klick</dt><dd>Definiert, was beim Klick auf ein Bild passiert: Lightbox, kein Klick, neuer Tab, ViewerJS oder PhotoSwipe.</dd>'
         . '<dt>Artikelattribute</dt><dd>Interne Hinweise fuer Attribute dieser Gruppe, zum Beispiel welche technischen Daten, Varianten oder Filter erwartet werden.</dd>'
         . '<dt>Channel-Vorgaben</dt><dd>Optionale Standardwerte fuer externe Verkaufskanaele. eBay Kategorie, Amazon Product Type, Kleinanzeigen Kategorie und mobile.de Kategorie werden bei Artikeln dieser Gruppe als Vorschlag im Channel-Mapping verwendet. Pro Artikel kann der Wert dort ueberschrieben werden. Wenn Channels in der Shop-Konfiguration deaktiviert sind, werden diese Eingaben ausgeblendet.</dd>'
         . '<dt>Sort</dt><dd>Reihenfolge in Listen und Auswahlfeldern. Kleine Zahlen stehen weiter oben; Schritte von 10 lassen Platz fuer spaetere Gruppen.</dd>'
         . '<dt>Aktiv</dt><dd>Schaltet die Artikelgruppe fuer die Verwendung ein oder aus. Inaktive Gruppen bleiben erhalten, werden aber nicht als aktive Option behandelt.</dd>'
         . '</dl>'
         . '<h3>Aktionen</h3>'
         . '<ul>'
         . '<li><strong>Plus in der Bar:</strong> legt oben eine neue Eingabezeile fuer eine Artikelgruppe an.</li>'
         . '<li><strong>Speichern:</strong> uebernimmt alle sichtbaren Einstellungen der Zeile.</li>'
         . '<li><strong>Loeschen:</strong> verschiebt die Artikelgruppe in den Papierkorb und deaktiviert sie. Bestehende Produktzuordnungen bleiben technisch nachvollziehbar, die Gruppe erscheint aber nicht mehr in der aktiven Liste.</li>'
         . '</ul>'
         . '<p><strong>Praxis:</strong> Verwenden Sie Artikelgruppen fuer wiederkehrende Produktlogik, nicht fuer einzelne Produkte. Beispiele sind Software, Merchandise, Service oder Zubehoer.</p>'
         . '<p><strong>Katalog:</strong> Kunden sehen zunaechst die obersten Gruppenbilder. Ein Klick oeffnet die Untergruppen und die direkten Artikel dieser Gruppe. Ohne Gruppenauswahl zeigt der Katalog alle aktiven Artikel und kann weiterhin per Suche und Attributen gefiltert werden.</p>'
         . '</section>';
   }
 
   private function shippingGroupsHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Versandgruppen</h2>'
         . '<p>Versandgruppen definieren Versandweg, Lieferzeit, Standardkosten und Freigrenzen. Artikel koennen diese Werte aus der Gruppe uebernehmen oder eigene Versandwerte verwenden.</p>'
         . '<h3>Eingabefelder</h3>'
         . '<dl>'
         . '<dt>Key</dt><dd>Eindeutiger technischer Schluessel der Versandgruppe. Beispiele sind <code>digital-free</code>, <code>service-remote</code> oder <code>merch-package</code>. Der Key wird beim Neuanlegen vergeben und bleibt danach stabil.</dd>'
         . '<dt>Versandgruppe</dt><dd>Sichtbarer Name fuer Verwaltung und Auswahlfelder.</dd>'
         . '<dt>Beschreibung</dt><dd>Interne Erklaerung, fuer welche Artikel und Liefersituationen diese Versandgruppe gedacht ist.</dd>'
         . '<dt>Versandweg</dt><dd>Bezeichnung des Versand- oder Bereitstellungswegs, zum Beispiel Download, Remote-Termin, DHL Paket oder Spedition.</dd>'
         . '<dt>Lieferzeit</dt><dd>Text fuer die erwartete Bereitstellung oder Lieferzeit, zum Beispiel <code>Sofort nach Freischaltung</code> oder <code>2-4 Werktage</code>.</dd>'
         . '<dt>Kosten</dt><dd>Standard-Versandkosten brutto. Verwenden Sie <code>0</code> fuer kostenfreie Lieferung oder digitale Bereitstellung.</dd>'
         . '<dt>Frei ab</dt><dd>Brutto-Warenwert, ab dem die Versandkosten entfallen. Der Wert <code>-1</code> bedeutet: keine Freigrenze.</dd>'
         . '<dt>Sort</dt><dd>Reihenfolge in Listen und Auswahlfeldern. Kleine Zahlen stehen weiter oben.</dd>'
         . '<dt>Aktiv</dt><dd>Schaltet die Versandgruppe fuer die Nutzung ein oder aus. Inaktive Gruppen bleiben erhalten, werden aber nicht als aktive Option behandelt.</dd>'
         . '</dl>'
         . '<h3>Aktionen</h3>'
         . '<ul>'
         . '<li><strong>Plus in der Bar:</strong> legt oben eine neue Eingabezeile fuer eine Versandgruppe an.</li>'
         . '<li><strong>Speichern:</strong> uebernimmt Versandweg, Lieferzeit, Kosten, Freigrenze, Sortierung und Aktiv-Status.</li>'
         . '<li><strong>Loeschen:</strong> verschiebt die Versandgruppe in den Papierkorb und deaktiviert sie. Bestehende Produktdaten bleiben nachvollziehbar, die Gruppe erscheint aber nicht mehr in der aktiven Liste.</li>'
         . '</ul>'
         . '<p><strong>Praxis:</strong> Trennen Sie digitale Bereitstellung, Remote-Leistungen und physische Paketlieferungen in eigene Versandgruppen.</p>'
         . '</section>';
   }
 
   private function settingsHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Shop-Einstellungen</h2>'
         . '<p>Diese Seite verwaltet globale dbxShop-Einstellungen. Artikel, Artikelgruppen, Versandgruppen und Channels nutzen diese Werte als gemeinsame Grundlage. Besonders wichtig ist die MwSt.-Logik: Artikel speichern keine eigenen Prozentwerte mehr, sondern Artikelgruppen waehlen eine MwSt.-Klasse wie <code>mwst1</code> oder <code>mwst2</code>. Der tatsaechliche Prozentwert wird hier gepflegt.</p>'
         . '<h3>Shop</h3><dl>'
         . '<dt>Shop aktiv</dt><dd>Schaltet den Shop grundsaetzlich ein oder aus. Wenn der Shop spaeter gesperrt werden soll, kann diese Einstellung fuer Frontend-Pruefungen genutzt werden.</dd>'
         . '<dt>Standard-Channel</dt><dd>Technischer Standard-Verkaufskanal fuer normale Shop-Bestellungen. Fuer den eigenen Shop ist typischerweise <code>web</code> oder <code>shop</code> sinnvoll. Externe Plattformen wie eBay oder Amazon werden als eigene Channels gepflegt.</dd>'
         . '<dt>Standard-Waehrung</dt><dd>ISO-Waehrungscode fuer Preise und Bestellungen, z.B. <code>EUR</code>. Der Wert sollte aus drei Buchstaben bestehen.</dd>'
         . '<dt>Preisanzeige</dt><dd>Legt fest, ob Preise als Brutto- oder Netto-Anzeige interpretiert werden sollen. Fuer einen deutschen Verbraucher-Shop ist Brutto in der Regel die passende Anzeige. B2B-Szenarien koennen Netto verwenden, benoetigen aber klare Steuer- und Rechtstexte.</dd>'
         . '<dt>B2B-Modus</dt><dd>Vorbereitung fuer Geschaeftskundenlogik. Diese Einstellung dokumentiert die Absicht, z.B. spaeter Netto-Preise, USt-ID-Pruefung oder andere Checkout-Regeln zu aktivieren.</dd>'
         . '<dt>Lagerbestand nutzen</dt><dd>Aktiviert die Beruecksichtigung des Lagerbestands. Wenn aus, koennen Artikel unabhaengig vom Feld Lagerbestand angezeigt werden.</dd>'
         . '<dt>Channels nutzen</dt><dd>Globaler Schalter fuer externe Verkaufskanaele wie eBay, Amazon, Kleinanzeigen oder mobile.de. Wenn deaktiviert, werden Channel-Funktionen im Shop-Admin ausgeblendet bzw. nicht verwendet. Welche externen Channels konkret aktiv sind, wird in der Channel-Verwaltung gepflegt und in den Einstellungen als Statusuebersicht angezeigt.</dd>'
         . '</dl>'
         . '<h3>MwSt.</h3><dl>'
         . '<dt>Standard-MwSt.-Klasse</dt><dd>Standardklasse fuer neue Artikelgruppen oder Faelle ohne eindeutige Zuordnung. Ueblich ist <code>mwst1</code> fuer den regulaeren Satz.</dd>'
         . '<dt>MwSt.-Anzeige</dt><dd>Legt fest, ob bei Preisen im Shop der Hinweis mit dem MwSt.-Satz angezeigt wird. Wenn deaktiviert, bleibt die steuerliche Berechnung intern erhalten, der sichtbare Preistext zeigt aber nur noch die Versandinformation. Fuer Sonderfaelle wie Kleinunternehmerregelung muessen passende Rechtstexte gepflegt werden.</dd>'
         . '<dt>mwst1 - Name</dt><dd>Bezeichnung der ersten Steuerklasse, z.B. <code>MwSt. normal</code>. Diese Klasse wird normalerweise fuer den regulaeren deutschen Umsatzsteuersatz verwendet.</dd>'
         . '<dt>mwst1 - Prozent</dt><dd>Prozentwert der ersten Steuerklasse, aktuell typischerweise <code>19</code>. Wenn sich der gesetzliche Satz aendert, wird dieser Wert hier zentral angepasst.</dd>'
         . '<dt>mwst2 - Name</dt><dd>Bezeichnung der zweiten Steuerklasse, z.B. <code>MwSt. ermaessigt</code>. Diese Klasse ist fuer Artikel mit ermaessigtem Steuersatz gedacht.</dd>'
         . '<dt>mwst2 - Prozent</dt><dd>Prozentwert der zweiten Steuerklasse, aktuell typischerweise <code>7</code>.</dd>'
         . '<dt>mwst3 - Name</dt><dd>Dritte vorbereitete Steuerklasse. Sie kann fuer kuenftige Steuersaetze, Sonderfaelle oder Uebergangsregeln genutzt werden.</dd>'
         . '<dt>mwst3 - Prozent</dt><dd>Prozentwert der dritten Steuerklasse, z.B. vorbereitet mit <code>22</code>. Solange Artikelgruppen diese Klasse nicht verwenden, wirkt sie sich nicht auf Artikelpreise aus.</dd>'
         . '<dd><strong>Workflow:</strong> Prozentwerte hier pflegen, danach in <strong>Artikelgruppen</strong> nur die passende Klasse auswaehlen. Artikel erben den Steuersatz aus ihrer primaeren Artikelgruppe.</dd>'
         . '</dl>'
         . '<h3>Checkout und Rechtstexte</h3><dl>'
         . '<dt>Gastbestellung erlauben</dt><dd>Erlaubt Bestellungen ohne vorheriges Kundenkonto. Wenn deaktiviert, verlangt der Checkout ein angemeldetes Benutzerkonto.</dd>'
         . '<dt>Rechtstext-Snapshot speichern</dt><dd>Speichert bei Bestellungen den Stand von Rechtstexten und Widerrufsbelehrung als Snapshot. So bleibt nachvollziehbar, welche Texte zum Kaufzeitpunkt galten.</dd>'
         . '<dt>Widerruf anzeigen</dt><dd>Steuert, ob der Widerrufsbereich im Shop sichtbar bzw. verwendbar sein soll. Der eigentliche Widerrufstext kommt aus der CMS-Seite <code>/shop/widerruf</code>.</dd>'
         . '<dt>Kunden-Mail senden</dt><dd>Sendet nach Bestellung und Widerruf eine kurze Bestaetigung an die beim Checkout bzw. Widerruf angegebene E-Mail-Adresse.</dd>'
         . '<dt>Admin-Mail senden</dt><dd>Sendet bei neuen Bestellungen und Widerrufen eine interne Benachrichtigung an die Admin-E-Mail-Adresse.</dd>'
         . '<dt>Mail-Absender</dt><dd>Absenderadresse fuer Shop-Mails. Verwenden Sie eine echte Domain-Adresse, die in der Mail-Konfiguration erlaubt ist, z.B. <code>shop@example.org</code>.</dd>'
         . '<dt>Admin-E-Mail</dt><dd>Empfaengeradresse fuer interne Shop-Benachrichtigungen, z.B. <code>admin@example.org</code>.</dd>'
         . '</dl>'
         . '<h3>Zahlungsarten</h3><dl>'
         . '<dt>Vorkasse aktiv</dt><dd>Aktiviert Vorkasse per Bankueberweisung. Die Bestellung wird gespeichert, die Zahlung bleibt offen, bis der Zahlungseingang im Admin bestaetigt wird.</dd>'
         . '<dt>Kontoinhaber</dt><dd>Name des Zahlungsempfaengers fuer Vorkasse, z.B. Firmenname oder Shop-Betreiber.</dd>'
         . '<dt>IBAN</dt><dd>Bankverbindung fuer Vorkasse. Dieser Wert wird Kunden nach der Bestellung und in der Bestellmail als Zahlungsinformation angezeigt.</dd>'
         . '<dt>BIC</dt><dd>BIC/SWIFT der Bank. Innerhalb Deutschlands oft nicht zwingend, fuer internationale Kunden aber hilfreich.</dd>'
         . '<dt>Bank</dt><dd>Name der Bank fuer die Vorkasse-Zahlungsinformation.</dd>'
         . '<dt>Vorkasse-Hinweis</dt><dd>Text, der Kunden erklaert, wann und wie sie ueberweisen sollen. Die Bestellnummer wird zusaetzlich als Verwendungszweck angezeigt.</dd>'
         . '<dt>Rechnung aktiv</dt><dd>Aktiviert Rechnung als Zahlungsart. Das ist meist nur fuer bestimmte Kunden oder B2B sinnvoll und sollte bei Bedarf mit Freigabelogik verbunden werden.</dd>'
         . '<dt>Rechnungs-Hinweis</dt><dd>Text fuer Zahlungsziel oder interne Hinweise, z.B. <code>Bitte zahlen Sie innerhalb von 14 Tagen nach Rechnungserhalt.</code></dd>'
         . '<dt>PayPal aktiv</dt><dd>Schaltet PayPal im Checkout frei. PayPal funktioniert erst, wenn Modus, Client-ID und Client-Secret korrekt eingetragen sind.</dd>'
         . '<dt>PayPal Modus</dt><dd><code>Sandbox</code> nutzt die PayPal-Testumgebung. <code>Live</code> nutzt echte Zahlungen. Vor Livebetrieb immer zuerst Sandbox testen.</dd>'
         . '<dt>PayPal Brand Name</dt><dd>Name, der bei PayPal im Zahlungsfenster erscheinen soll, z.B. der Shop- oder Firmenname.</dd>'
         . '<dt>PayPal Client-ID</dt><dd>Oeffentliche App-Kennung aus dem PayPal Developer Dashboard. Fuer Sandbox und Live gibt es getrennte Zugangsdaten.</dd>'
         . '<dt>PayPal Client-Secret</dt><dd>Geheimer App-Schluessel aus dem PayPal Developer Dashboard. Dieser Wert darf nicht oeffentlich angezeigt oder weitergegeben werden.</dd>'
         . '<dd>PayPal-Zugangsdaten werden im PayPal Developer Dashboard unter <a href="https://developer.paypal.com/dashboard/applications/" target="_blank" rel="noopener">developer.paypal.com/dashboard/applications</a> erstellt und verwaltet. Sandbox-Testkonten und Testkaeufer finden Sie unter <a href="https://developer.paypal.com/tools/sandbox/" target="_blank" rel="noopener">developer.paypal.com/tools/sandbox</a>.</dd>'
         . '<dt>Payment testen</dt><dd>Der Stecker-Button in der Bar prueft PayPal per OAuth-Token gegen Sandbox oder Live. Amazon Pay prueft vollstaendige Zugangsdaten und die lokale RSA-PSS-Signatur. Eine echte Amazon-Pay-Autorisierung wird beim Checkout mit einer echten Checkout Session ausgefuehrt.</dd>'
         . '<dt>Amazon Pay aktiv</dt><dd>Schaltet Amazon Pay als auswaehlbare Zahlungsart frei. Beim Checkout wird eine Amazon-Pay-Checkout-Session erzeugt, der Kunde zu Amazon Pay weitergeleitet und die Zahlung nach Rueckkehr ueber Complete Checkout Session abgeschlossen.</dd>'
         . '<dt>Amazon Pay Modus</dt><dd><code>Sandbox</code> fuer Tests, <code>Live</code> fuer echte Zahlungen. Die Zugangsdaten muessen zur jeweiligen Umgebung passen.</dd>'
         . '<dt>Amazon Pay Region</dt><dd>Region des Amazon-Pay-Kontos. Fuer Deutschland typischerweise <code>EU</code>.</dd>'
         . '<dt>Amazon Merchant-ID</dt><dd>Haendlerkennung aus der Amazon-Pay-/Seller-Central-Konfiguration.</dd>'
         . '<dt>Amazon Store-ID</dt><dd>Store-/Checkout-Konfiguration aus Amazon Pay. Sie identifiziert, welche Store-Konfiguration fuer den Checkout genutzt werden soll.</dd>'
         . '<dt>Public-Key-ID</dt><dd>Kennung des oeffentlichen Schluessels, der bei Amazon Pay hinterlegt wurde.</dd>'
         . '<dt>Private Key</dt><dd>Privater Signaturschluessel fuer Amazon Pay. Dieser Wert ist geheim und darf nicht oeffentlich angezeigt werden.</dd>'
         . '<dt>Sandbox Simulation</dt><dd>Optionaler Amazon-Pay-Simulationscode fuer Sandbox-Tests, z.B. <code>AmazonCanceled</code>. Leer lassen fuer normale Sandbox-Tests ohne erzwungene Fehlersimulation.</dd>'
         . '<dd>Amazon-Pay-Zugangsdaten werden in Seller Central bzw. Amazon Pay Integration Central verwaltet: <a href="https://sellercentral.amazon.de/" target="_blank" rel="noopener">sellercentral.amazon.de</a>. Die technische API-v2-Dokumentation steht unter <a href="https://developer.amazon.com/docs/amazon-pay-api-v2/introduction.html" target="_blank" rel="noopener">developer.amazon.com/docs/amazon-pay-api-v2</a>.</dd>'
         . '</dl>'
         . '<h3>Channels</h3><dl>'
         . '<dt>Aktive externe Channels</dt><dd>Zeigt alle aktiven Channels ausser dem internen <code>shop</code>-Channel. Aktiv, Export, Order-Import und Teststatus kommen aus der Channel-Verwaltung.</dd>'
         . '<dt>Channels bearbeiten</dt><dd>Oeffnet die Channel-Verwaltung. Dort werden API-Zugangsdaten, Marketplace-, Seller-, Location- und Policy-Werte gepflegt.</dd>'
         . '</dl>'
         . '<h3>Versand</h3><dl>'
         . '<dt>Digitale Downloads aktiv</dt><dd>Erlaubt digitale Bereitstellung fuer passende Produkte. Digitale Produkte koennen andere Widerrufsregeln haben; die Rechtstexte muessen dazu passen.</dd>'
         . '<dt>Pauschalversand aktiv</dt><dd>Aktiviert einen einfachen globalen Versandkostenwert als Fallback. Detailliertere Versandlogik wird weiterhin ueber Versandgruppen gepflegt.</dd>'
         . '<dt>Pauschalversand brutto</dt><dd>Globaler Bruttobetrag fuer Versandkosten, wenn keine spezifischere Versandgruppe greift. Beispiel: <code>5.90</code>.</dd>'
         . '<dt>CMS-Media Slot</dt><dd>Technischer Slotname fuer Shop-Medien im CMS-Medienbrowser. Normalerweise <code>shop</code>. Nur aendern, wenn Shop-Bilder bewusst in einem anderen CMS-Slot verwaltet werden sollen.</dd>'
         . '</dl>'
         . '<h3>Speichern</h3>'
         . '<p>Nach dem Speichern werden die Werte in der Modul-Konfiguration <code>dbxShop</code> abgelegt. Aenderungen an MwSt.-Prozentwerten wirken sofort auf Artikel, die ihre MwSt. aus Artikelgruppen erben.</p>'
         . '</section>';
   }
 
   private function ordersHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Bestellungen</h2>'
         . '<p>Die Bestellverwaltung zeigt Shop-, PayPal- und Channel-Bestellungen als Snapshots. Eine Bestellung soll nicht aus aktuellen Artikeldaten rekonstruiert werden, sondern behält Artikel, Preise, MwSt., Versand und Zahlungsdaten aus dem Zeitpunkt der Bestellung.</p>'
         . '<h3>Liste</h3><dl>'
         . '<dt>Bestellung</dt><dd>Bestellnummer, Datum und Herkunft. Die Bestellnummer bleibt stabil und dient fuer Kundensuche, Zahlungsabgleich und Channel-Zuordnung.</dd>'
         . '<dt>Kunde</dt><dd>Name und E-Mail-Adresse, soweit beim Checkout oder beim Channel-Import vorhanden. Bei importierten Marktplatzbestellungen kann die Plattform je nach Datenschutz nur eingeschraenkte Kundendaten liefern.</dd>'
         . '<dt>Status</dt><dd>Interner Bearbeitungsstatus: neu, Zahlung offen, bezahlt, in Bearbeitung, versendet, abgeschlossen oder storniert. Dieser Status steuert die Arbeit im Shop-Admin.</dd>'
         . '<dt>Zahlung</dt><dd>Zahlungsanbieter, Zahlungsstatus und Referenz, z.B. PayPal-ID oder externe Channel-Bestellnummer.</dd>'
         . '<dt>Positionen</dt><dd>Artikelpositionen als Snapshot mit SKU, Titel und Menge.</dd>'
         . '<dt>Summe</dt><dd>Bruttosumme der Bestellung in der gespeicherten Waehrung.</dd>'
         . '</dl>'
         . '<h3>Filter</h3><dl>'
         . '<dt>Suche</dt><dd>Sucht nach Bestellnummer, Kunde, E-Mail, Channel und Zahlungsreferenz.</dd>'
         . '<dt>Status</dt><dd>Filtert nach internem Bearbeitungsstatus.</dd>'
         . '<dt>Zahlung</dt><dd>Filtert nach Zahlungsstatus.</dd>'
         . '<dt>Versand</dt><dd>Filtert nach operativem Versandstatus, zum Beispiel offen, versendet oder zugestellt.</dd>'
         . '<dt>Channel</dt><dd>Filtert nach Herkunft, z.B. Shop, eBay, Amazon oder mobile.de.</dd>'
         . '</dl>'
         . '<h3>Detail bearbeiten</h3><dl>'
         . '<dt>Schnellaktionen</dt><dd>Setzen haeufige Arbeitsschritte mit einem Klick: bezahlt, in Bearbeitung, versandbereit, versendet, zugestellt/abgeschlossen, storniert oder erstattet. Jede Aktion schreibt die passenden Statusfelder und einen Historieneintrag.</dd>'
         . '<dt>Kundenmail senden</dt><dd>Der Umschlag-Button in der Bar sendet den aktuell gespeicherten Status an die Kunden-E-Mail-Adresse. Speichern Sie geaenderte Felder zuerst. Voraussetzung ist ein Mail-Absender in den Shop-Einstellungen.</dd>'
         . '<dt>Status</dt><dd>Setzt den internen Bearbeitungsstand. Typischer Ablauf: neu -> bezahlt -> in Bearbeitung -> versendet -> abgeschlossen.</dd>'
         . '<dt>Zahlungsstatus</dt><dd>Dokumentiert den Stand der Zahlung. PayPal und Channel-Import koennen diesen Wert automatisch setzen; manuelle Korrektur ist fuer Abgleich und Sonderfaelle moeglich.</dd>'
         . '<dt>Zahlungsreferenz</dt><dd>Externe Referenz wie PayPal Order ID, eBay Order ID, Amazon Order ID oder interne Buchungsnummer.</dd>'
         . '<dt>Rechnungsnummer / Rechnungsdatum</dt><dd>Werden manuell gepflegt oder beim Wechsel in einen bezahlten Bearbeitungsstatus automatisch vorgeschlagen. Fuer echten Livebetrieb muss ein rechtssicherer Nummernkreis definiert werden.</dd>'
         . '<dt>Versandstatus</dt><dd>Operativer Lieferstatus: offen, bereit, versendet, zugestellt oder Retoure.</dd>'
         . '<dt>Versanddienstleister</dt><dd>Name des Dienstleisters oder der Versandart, z.B. DHL, UPS, Deutsche Post oder Download/Freischaltung.</dd>'
         . '<dt>Trackingnummer / Tracking-URL</dt><dd>Trackingdaten fuer physische Sendungen. Wenn DHL, UPS, DPD oder Hermes als Versanddienstleister eingetragen ist und die Tracking-URL leer bleibt, wird beim Speichern eine passende Tracking-URL erzeugt.</dd>'
         . '<dt>Versendet am</dt><dd>Zeitpunkt des Versands. Wird beim Wechsel auf <code>Versendet</code> automatisch gesetzt, wenn noch leer.</dd>'
         . '<dt>Admin-Notiz</dt><dd>Interne Notizen fuer Rueckfragen, Versandhinweise, Sonderabsprachen oder Channel-Probleme.</dd>'
         . '<dt>Rechnung anzeigen / PDF</dt><dd>Der Beleg-Button zeigt eine Rechnungsvorschau. Der PDF-Button erzeugt bei Bedarf Rechnungsnummer, Datum und PDF-Datei und archiviert den Dateipfad an der Bestellung.</dd>'
         . '<dt>Positionen</dt><dd>Nicht direkt editierbare Snapshot-Positionen. Aenderungen an Artikeln sollen alte Bestellungen nicht veraendern.</dd>'
         . '<dt>Payload</dt><dd>Rohdaten aus Zahlung oder Channel-Import. Diese helfen bei technischer Pruefung und Supportfaellen.</dd>'
         . '<dt>Historie</dt><dd>Protokolliert wichtige Status-, Zahlungs-, Versand-, Rechnungs- und Widerrufsereignisse.</dd>'
         . '<dt>Widerrufe</dt><dd>Zeigt eingegangene Widerrufe, die anhand der Bestellnummer zugeordnet wurden.</dd>'
         . '</dl>'
         . '<h3>Loeschen</h3>'
         . '<p>Loeschen verschiebt Bestellungen in den Papierkorb. Es loescht keine Artikel und keine Channel-Daten. Fuer echte kaufmaennische Loesch-/Aufbewahrungsregeln muss vor Livebetrieb entschieden werden, was archiviert werden muss.</p>'
         . '</section>';
   }
 
   private function productsHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Produkte und Artikel-Formular</h2>'
         . '<p>Das Produktformular pflegt die Stammdaten eines Artikels. Gruppen, Attribute, Bilder und Channel-Zuordnungen sind getrennte Bereiche, damit ein Artikel sauber im Shop angezeigt, verkauft und optional zu externen Plattformen exportiert werden kann.</p>'
         . '<h3>Produktliste</h3><dl>'
         . '<dt>Suche / Filter</dt><dd>Sucht nach Artikelnummer, Titel, Beschreibung, Gruppe, Channel und weiteren Produktwerten. Die Anzahl pro Seite steuert die Tabellenlaenge; <code>Alle</code> zeigt alle passenden Artikel.</dd>'
         . '<dt>Bearbeiten</dt><dd>Oeffnet das Artikel-Formular im Fenster.</dd>'
         . '<dt>Ansehen</dt><dd>Oeffnet die Shop-Ansicht des Artikels.</dd>'
         . '<dt>Loeschen</dt><dd>Verschiebt den Artikel nach Confirm in den Papierkorb.</dd>'
         . '<dt>Mehrfachaktion</dt><dd>Fuer markierte Artikel koennen Channel hinzugefuegt, entfernt, exportiert oder Produktgruppen gesetzt werden.</dd>'
         . '</dl>'
         . '<h3>Grunddaten</h3><dl>'
         . '<dt>Artikelnummer</dt><dd>Interne und externe Artikelnummer. Sie entspricht praktisch der SKU und sollte eindeutig, stabil und kanalgeeignet sein.</dd>'
         . '<dt>URL-Name</dt><dd>Technischer URL-Teil fuer die Shop-Detailseite. Verwenden Sie kurze, sprechende Kleinbuchstaben ohne Sonderzeichen.</dd>'
         . '<dt>Titel</dt><dd>Sichtbarer Produktname im Shop, in Listen und beim Export.</dd>'
         . '<dt>Kategorie</dt><dd>Freie Kategoriebezeichnung fuer Darstellung und Verwaltung.</dd>'
         . '<dt>Produkttyp</dt><dd>Unterscheidet digitale Produkte, physische Produkte und Dienstleistungen. Das wirkt auf Versand, Checkout und spaetere Channel-Logik.</dd>'
         . '<dt>Aktiv</dt><dd>Nur aktive Produkte werden regulaer angeboten.</dd>'
         . '<dt>Sortierung</dt><dd>Reihenfolge in Listen und Katalogen. Kleine Werte stehen weiter vorne.</dd>'
         . '</dl>'
         . '<h3>Beschreibung</h3><dl>'
         . '<dt>Kurzbeschreibung</dt><dd>Kompakter Text fuer Karten, Listen und Suchergebnisse.</dd>'
         . '<dt>Beschreibung</dt><dd>Ausfuehrlicher Produkttext fuer Detailseite und Channel-Export.</dd>'
         . '</dl>'
         . '<h3>Preis, Versand und Darstellung</h3><dl>'
         . '<dt>Bruttopreis</dt><dd>Artikelpreis inklusive MwSt. Die MwSt.-Prozentwerte kommen aus den Shop-Einstellungen und der Artikelgruppe.</dd>'
         . '<dt>Versand-Quelle</dt><dd><code>Aus Gruppe</code> nutzt die Versandgruppe. Individuelle Werte ueberschreiben die Gruppe fuer diesen Artikel.</dd>'
         . '<dt>Versand brutto individuell</dt><dd>Artikelbezogener Versandwert. <code>-1</code> bedeutet: aus Gruppe oder globalem Fallback berechnen.</dd>'
         . '<dt>Lagerbestand</dt><dd>Interner Bestand. Fuer digitale Produkte kann 0 trotzdem verkaufbar sein, wenn der Ablauf das erlaubt.</dd>'
         . '<dt>Badge</dt><dd>Kurzer Hervorhebungs-Text auf Karten, z.B. <code>Neu</code> oder <code>Business</code>.</dd>'
         . '<dt>Icon</dt><dd>Bootstrap-Icon-Klasse fuer fallbackartige Darstellung ohne Bild.</dd>'
         . '<dt>Logo-Variante</dt><dd>Optionaler Darstellungswert fuer Templates.</dd>'
         . '<dt>MwSt.-Quelle</dt><dd>Normalfall ist <code>Aus Gruppe</code>. Die Gruppe referenziert <code>mwst1</code>, <code>mwst2</code> oder <code>mwst3</code>; die echten Prozentwerte stehen in den Shop-Einstellungen.</dd>'
         . '</dl>'
         . '<h3>Bilder</h3><dl>'
         . '<dt>Auswahl</dt><dd>Oeffnet den CMS-Medienbrowser fuer Shop-Bilder. Dateien bleiben im Medienbrowser; im Shop wird nur die Zuordnung gespeichert.</dd>'
         . '<dt>Primaerbild</dt><dd>Markiert das neu zugeordnete Bild als Hauptbild.</dd>'
         . '<dt>Papierkorb am Bild</dt><dd>Hebt nur die Shop-Zuordnung auf. Die Mediendatei wird nicht geloescht.</dd>'
         . '</dl>'
         . '<h3>Channels</h3><dl>'
         . '<dt>Checkbox</dt><dd>Setzt eine direkte Artikel-Channel-Zuordnung. Diese hat Vorrang vor Channel-Gruppen.</dd>'
         . '<dt>Status</dt><dd>Zeigt, ob der Channel direkt aktiv, direkt deaktiviert, aus einer Gruppe geerbt oder nicht gesetzt ist.</dd>'
         . '<dt>Mapping</dt><dd>Oeffnet das produktbezogene Channel-Mapping fuer Kategorie, Pflichtattribute, externe IDs und provider-spezifische Werte.</dd>'
         . '<dt>Export</dt><dd>Startet den Export fuer diesen Artikel und Channel, wenn der Channel Export erlaubt und ausreichend konfiguriert ist.</dd>'
         . '</dl>'
         . '<h3>Bar-Aktionen</h3><dl>'
         . '<dt>Speichern</dt><dd>Speichert Stammdaten und direkte Channel-Auswahl.</dd>'
         . '<dt>Artikel ansehen</dt><dd>Oeffnet die Shop-Vorschau.</dd>'
         . '<dt>Artikelattribute</dt><dd>Oeffnet die Werte der gruppenspezifischen Attribute fuer diesen Artikel.</dd>'
         . '<dt>Loeschen</dt><dd>Loescht nach Confirm den Artikel.</dd>'
         . '<dt>Hilfe</dt><dd>Oeffnet diese CMS-Hilfeseite.</dd>'
         . '<dt>Produktliste</dt><dd>Zurueck zur Produktuebersicht.</dd>'
         . '</dl>'
         . '</section>';
   }
 
   private function productChannelMappingHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Channel-Mapping je Artikel</h2>'
         . '<p>Das Channel-Mapping speichert produktbezogene Werte fuer genau einen Artikel und genau einen Channel. Globale Zugangsdaten bleiben im Channel-Formular; hier stehen die Werte, die sich pro Artikel unterscheiden.</p>'
         . '<h3>Channel-Werte</h3><dl>'
         . '<dt>Aktiv</dt><dd>Schaltet die direkte Artikelzuordnung fuer diesen Channel ein. Diese Einstellung hat Vorrang vor Channel-Gruppen.</dd>'
         . '<dt>Channel-SKU</dt><dd>Artikelnummer, die fuer diesen Channel verwendet wird. Meist identisch mit der Shop-Artikelnummer; bei Plattformen kann sie aber abweichen.</dd>'
         . '<dt>Channel-Preis</dt><dd>Brutto-Preis, der fuer diesen Channel verwendet wird. Wenn kein eigener Channel-Preis gespeichert ist, zeigt das Feld den aktuellen Shop-Artikelpreis an. Wird dieser Wert unveraendert gespeichert, bleibt intern die Vererbung aktiv. Aendern Sie den Wert nur, wenn dieser Channel bewusst einen abweichenden Preis bekommen soll.</dd>'
         . '<dt>Channel-Versand</dt><dd>Versandwert, der fuer diesen Channel verwendet wird. Ohne eigenen Channel-Wert wird der wirksame Artikel-/Gruppenversand angezeigt und intern weiter geerbt. Ein abweichender Wert wird nur gespeichert, wenn Sie ihn hier bewusst aendern.</dd>'
         . '<dt>Listing-ID</dt><dd>Externe ID des sichtbaren Angebots auf der Plattform. Bei eBay entsteht sie normalerweise erst nach dem Publish des Offers. Dieses Feld wird im Normalfall vom Connector nach erfolgreichem Export/Rueckmeldung gefuellt. Manuell eintragen sollten Sie sie nur, wenn ein bereits extern vorhandenes Angebot mit diesem Shop-Artikel verknuepft oder eine Zuordnung repariert werden muss.</dd>'
         . '<dt>Offer-ID</dt><dd>Externe Angebots-/Offer-ID der Plattform. Bei eBay ist das Offer der Zwischenschritt zwischen Inventory Item/SKU und dem veroeffentlichten Listing. Die Offer-ID braucht der Connector spaeter zum Aktualisieren, Publishen, Beenden oder Pruefen genau dieses Offers. Bei neuen Artikeln bleibt das Feld leer; nach erfolgreicher Erstellung speichert der Connector die ID automatisch.</dd>'
         . '</dl>'
         . '<h3>Provider-Mapping</h3><dl>'
         . '<dt>Shop / Custom Aktion</dt><dd>Interner oder Middleware-Endpunkt, an den der Export uebergeben werden soll.</dd>'
         . '<dt>eBay Kategorie-ID</dt><dd>eBay Kategorie fuer das Angebot. Sie muss zum Produkt passen, sonst lehnt eBay Pflichtattribute oder das Listing ab.</dd>'
         . '<dt>eBay Location-Key</dt><dd>Merchant Location Key des eBay-Verkaeuferkontos. Dieser Wert kommt aus der eBay-Channel-Konfiguration und wird nicht pro Artikel gepflegt. Wenn sich Lager- oder Versandort aendert, wird der Wert in der Channel-Verwaltung geaendert und gilt dann fuer alle eBay-Mappings ohne eigene Sonderlogik.</dd>'
         . '<dt>eBay Zustand</dt><dd>Condition-Code oder Zustand des Artikels, z.B. neu oder gebraucht.</dd>'
         . '<dt>eBay Policies</dt><dd>Payment-, Fulfillment- und Return-Policy-IDs. Sie bestimmen Zahlung, Versand und Rueckgabe fuer genau dieses Listing.</dd>'
         . '<dt>eBay Aspekte</dt><dd>Pflicht- und Zusatzattribute als <code>key=value</code>, z.B. <code>Marke=dbxApp</code>. Ein Wert pro Zeile.</dd>'
         . '<dt>Amazon Product Type</dt><dd>Amazon Produkttyp fuer die Listings Items API, z.B. <code>PRODUCT</code> oder eine spezifische Kategorie.</dd>'
         . '<dt>Amazon Requirements</dt><dd>Steuert, welche Anforderungen Amazon beim Listing erwartet, z.B. <code>LISTING</code> oder <code>LISTING_PRODUCT_ONLY</code>.</dd>'
         . '<dt>Amazon Brand / Attribute</dt><dd>Marke und weitere Attribute als <code>key=value</code>. Welche Werte Pflicht sind, haengt vom Product Type ab.</dd>'
         . '<dt>mobile.de Fahrzeugdaten</dt><dd>mobile.de ist fuer Fahrzeuge gedacht. Marke, Modell, Erstzulassung, Kilometer, Kraftstoff und Leistung muessen zum Fahrzeug passen.</dd>'
         . '<dt>Kleinanzeigen</dt><dd>Offiziell nur ueber Partner-/Middleware-Schnittstelle sinnvoll. Kategorie, Ort, Kontakt und Attribute werden an die Middleware gegeben.</dd>'
         . '</dl>'
         . '<h3>Exportstatus</h3><dl>'
         . '<dt>Status</dt><dd>Letzter technischer Exportzustand, z.B. veroeffentlicht, bereit, manuell bereit oder Fehler.</dd>'
         . '<dt>Meldung</dt><dd>Antwort oder Fehlermeldung des Connectors.</dd>'
         . '<dt>Payload</dt><dd>Gespeicherte technische Antwortdaten zur Fehlersuche.</dd>'
         . '</dl>'
         . '<h3>Bar-Aktionen</h3><dl>'
         . '<dt>Speichern</dt><dd>Speichert Mapping und Channel-Werte.</dd>'
         . '<dt>Exportieren</dt><dd>Startet den Export dieses Artikels fuer diesen Channel.</dd>'
         . '<dt>Hilfe</dt><dd>Oeffnet diese CMS-Hilfeseite.</dd>'
         . '</dl>'
         . '</section>';
   }
 
   private function productAttributesHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Artikelattribute</h2>'
         . '<p>Artikelattribute beschreiben gruppenspezifische Merkmale wie Groesse, Farbe, Material oder technische Daten. Die Definition entsteht bei der Artikelgruppe; im Artikel werden nur die Werte gepflegt.</p>'
         . '<h3>Attribut-Definition</h3><dl>'
         . '<dt>Gruppe</dt><dd>Artikelgruppe, fuer die das Attribut gilt.</dd>'
         . '<dt>Key</dt><dd>Technischer Schluessel, z.B. <code>farbe</code>. Er sollte stabil bleiben.</dd>'
         . '<dt>Titel</dt><dd>Sichtbarer Name des Attributs.</dd>'
         . '<dt>Typ</dt><dd>Text, Zahl oder Auswahlliste.</dd>'
         . '<dt>Einheit</dt><dd>Optionale Einheit, z.B. cm, kg, Watt.</dd>'
         . '<dt>Optionen</dt><dd>Werte fuer Auswahllisten, getrennt durch <code>|</code>.</dd>'
         . '<dt>Pflicht</dt><dd>Markiert Werte, die fuer vollstaendige Produktdaten erwartet werden.</dd>'
         . '<dt>Filter</dt><dd>Kann spaeter fuer Katalogfilter verwendet werden.</dd>'
         . '<dt>Vergleich</dt><dd>Kann spaeter fuer Produktvergleiche verwendet werden.</dd>'
         . '<dt>Sort / Aktiv</dt><dd>Reihenfolge und Freigabe des Attributs.</dd>'
         . '</dl>'
         . '<h3>Artikelwert</h3><dl>'
         . '<dt>Wert</dt><dd>Konkreter Wert dieses Artikels fuer das Attribut.</dd>'
         . '<dt>Einheit</dt><dd>Wird aus der Definition angezeigt.</dd>'
         . '<dt>Eigenschaft</dt><dd>Zeigt Pflicht-/Filter-Hinweise aus der Definition.</dd>'
         . '</dl>'
         . '<h3>Aktionen</h3><dl>'
         . '<dt>Speichern</dt><dd>Speichert die Attributdefinition oder die Artikelwerte.</dd>'
         . '<dt>Zurueck</dt><dd>Fuehrt zur Produktliste zurueck.</dd>'
         . '<dt>Hilfe</dt><dd>Oeffnet diese CMS-Hilfeseite.</dd>'
         . '</dl>'
         . '</section>';
   }
 
   private function shopMediaHelpHtml(): string {
      return '<section class="dbx-shop-help">'
         . '<h2>Shop-Medien</h2>'
         . '<p>Shop-Medien ordnen vorhandene CMS-Medien Artikeln oder Artikelgruppen zu. Die Datei bleibt im CMS-Medienbrowser; dbxShop speichert nur die Verwendung im Shop.</p>'
         . '<h3>Felder</h3><dl>'
         . '<dt>Artikel</dt><dd>Optionaler einzelner Artikel, dem neue Bildzuordnungen hinzugefuegt werden.</dd>'
         . '<dt>Artikelgruppe</dt><dd>Optionale Gruppe. Gruppenbilder koennen bei Artikeln dieser Gruppe als Fallback erscheinen.</dd>'
         . '<dt>Sortierung</dt><dd>Reihenfolge der Bilder.</dd>'
         . '<dt>Primaerbild</dt><dd>Markiert die neue Zuordnung als Hauptbild.</dd>'
         . '</dl>'
         . '<h3>Aktionen</h3><dl>'
         . '<dt>Auswahl laden</dt><dd>Laedt die aktuell gewaehlt Artikel-/Gruppenauswahl neu.</dd>'
         . '<dt>Auswahl</dt><dd>Oeffnet den CMS-Medienbrowser fuer Upload, Auswahl, Zuschneiden, Resize, Batch und Wartung.</dd>'
         . '<dt>Zugeordnete Shop-Bilder</dt><dd>Zeigt vorhandene Artikel- und Gruppenbild-Zuordnungen.</dd>'
         . '<dt>Hilfe</dt><dd>Oeffnet diese CMS-Hilfeseite.</dd>'
         . '</dl>'
         . '</section>';
   }
 
   private function loadShopHelpContentCacheSupport(): void {
      $bootstrap = dirname(__DIR__, 2) . '/dbxContent/include/dbxContent_bootstrap.php';
      if (is_file($bootstrap)) {
         require_once $bootstrap;
      }
      $cacheFile = dirname(__DIR__, 2) . '/dbxContent/include/dbxContentPageCache.class.php';
      if (is_file($cacheFile)) {
         require_once $cacheFile;
      }
      $indexFile = dirname(__DIR__, 2) . '/dbxContent/include/dbxContentPermalinkIndex.class.php';
      if (is_file($indexFile)) {
         require_once $indexFile;
      }
   }
 
   private function invalidateShopHelpCache(int $cid): void {
      if ($cid <= 0) {
         return;
      }
      $this->loadShopHelpContentCacheSupport();
      if (class_exists('\\dbx\\dbxContent\\dbxContentPageCache')) {
         \dbx\dbxContent\dbxContentPageCache::invalidateContent($cid);
      }
   }
 
   private function syncShopHelpPermalinkIndex(int $cid, string $permalink, string $rights = 'admin'): void {
      if ($cid <= 0 || $permalink === '') {
         return;
      }
      $this->loadShopHelpContentCacheSupport();
      if (class_exists('\\dbx\\dbxContent\\dbxContentPermalinkIndex')) {
         \dbx\dbxContent\dbxContentPermalinkIndex::upsertPage($cid, $permalink, $rights, 1);
      }
   }
 
   private function removeShopHelpPermalinkIndex(string $permalink): void {
      $permalink = trim($permalink);
      if ($permalink === '') {
         return;
      }
      $this->loadShopHelpContentCacheSupport();
      if (class_exists('\\dbx\\dbxContent\\dbxContentPermalinkIndex')) {
         \dbx\dbxContent\dbxContentPermalinkIndex::removeByPermalink($permalink);
      }
   }
 
   private function ensureShopChannelHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-channel-groups', 'Hilfe: Channel-Gruppen', 'Hilfe zur Pflege von Shop Channel-Gruppen.', 'shop,channel,channel-gruppen,hilfe', $this->channelGroupsHelpHtml(), '9010', array('shop/channel'));
   }
 
   private function ensureShopChannelsHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-channels', 'Hilfe: Channels', 'Hilfe zur Pflege von Shop Channels und Marktplatz-Anbindungen.', 'shop,channels,api,marktplatz,hilfe', $this->channelsHelpHtml(), '9015', array('shop/channels'));
   }
 
   private function ensureShopChannelProviderHelpPage(string $platform): int {
      $allowed = array('shop', 'amazon', 'ebay', 'kleinanzeigen', 'mobile', 'custom');
      if (!in_array($platform, $allowed, true)) {
         $platform = 'custom';
      }
      $titles = array(
         'shop' => 'Hilfe: Channel Shop',
         'amazon' => 'Hilfe: Channel Amazon',
         'ebay' => 'Hilfe: Channel eBay',
         'kleinanzeigen' => 'Hilfe: Channel Kleinanzeigen',
         'mobile' => 'Hilfe: Channel mobile.de',
         'custom' => 'Hilfe: Eigener Channel',
      );
      $sort = array('shop' => '9016', 'amazon' => '9017', 'ebay' => '9018', 'kleinanzeigen' => '9019', 'mobile' => '9024', 'custom' => '9025');
      return $this->ensureShopAdminHelpPage(
         'shop/help-channel-' . $platform,
         $titles[$platform],
         'Hilfe zu API-Daten und Rueckmeldungen fuer ' . $titles[$platform] . '.',
         'shop,channels,' . $platform . ',api,hilfe',
         $this->channelProviderHelpHtml($platform),
         $sort[$platform],
         array('shop/channels/' . $platform)
      );
   }
 
   private function ensureShopProductGroupsHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-groups', 'Hilfe: Artikelgruppen', 'Hilfe zur Pflege von Shop Artikelgruppen.', 'shop,artikelgruppen,produktgruppen,hilfe', $this->productGroupsHelpHtml(), '9020', array('shop/groups'));
   }
 
   private function ensureShopShippingGroupsHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-shipping-groups', 'Hilfe: Versandgruppen', 'Hilfe zur Pflege von Shop Versandgruppen.', 'shop,versandgruppen,shipping,hilfe', $this->shippingGroupsHelpHtml(), '9030', array('shop/shipping-groups'));
   }
 
   private function ensureShopSettingsHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-settings', 'Hilfe: Shop-Einstellungen', 'Hilfe zur Pflege der globalen Shop-Einstellungen.', 'shop,einstellungen,mwst,zahlung,versand,hilfe', $this->settingsHelpHtml(), '9040', array('shop/settings'));
   }
 
   private function ensureShopOrdersHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-orders', 'Hilfe: Bestellungen', 'Hilfe zur Bearbeitung von Shop- und Channel-Bestellungen.', 'shop,bestellungen,orders,zahlung,channel,hilfe', $this->ordersHelpHtml(), '9050', array('shop/orders'));
   }
 
   private function ensureShopProductsHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-products', 'Hilfe: Produkte', 'Hilfe zur Produktliste und zum Artikel-Formular.', 'shop,produkte,artikel,formular,hilfe', $this->productsHelpHtml(), '9005', array('shop/products'));
   }
 
   private function ensureShopProductChannelMappingHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-product-channel-mapping', 'Hilfe: Channel-Mapping je Artikel', 'Hilfe zur produktbezogenen Channel-Mapping-Maske.', 'shop,produkte,channels,mapping,hilfe', $this->productChannelMappingHelpHtml(), '9014', array('shop/product-channel-mapping'));
   }
 
   private function ensureShopProductAttributesHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-product-attributes', 'Hilfe: Artikelattribute', 'Hilfe zu Attributdefinitionen und Artikelwerten.', 'shop,produkte,attribute,hilfe', $this->productAttributesHelpHtml(), '9028', array('shop/product-attributes'));
   }
 
   private function ensureShopMediaHelpPage(): int {
      return $this->ensureShopAdminHelpPage('shop/help-media', 'Hilfe: Shop-Medien', 'Hilfe zur Medienzuordnung fuer Shop-Artikel und Artikelgruppen.', 'shop,medien,bilder,hilfe', $this->shopMediaHelpHtml(), '9035', array('shop/media-help'));
   }
 
   private function ensureShopAdminHelpPage(string $permalink, string $title, string $description, string $keywords, string $content, string $sorter, array $oldPermalinks = array()): int {
      $db = $this->db();
      $contentDd = $this->contentDd();
      try {
         $permalinks = array_values(array_unique(array_merge(array($permalink), $oldPermalinks)));
         foreach ($permalinks as $candidatePermalink) {
            $candidatePermalink = trim((string)$candidatePermalink);
            if ($candidatePermalink === '') {
               continue;
            }
            $row = $db->select1($contentDd, array('permalink' => $candidatePermalink), 'id,content,permalink,title,description,keywords,sorter', 0);
            if (is_array($row) && (int)($row['id'] ?? 0) > 0) {
               $id = (int)$row['id'];
               $needsUpdate = trim((string)($row['content'] ?? '')) !== trim($content)
                  || trim((string)($row['permalink'] ?? '')) !== $permalink
                  || trim((string)($row['title'] ?? '')) !== $title
                  || trim((string)($row['description'] ?? '')) !== $description
                  || trim((string)($row['keywords'] ?? '')) !== $keywords
                  || trim((string)($row['sorter'] ?? '')) !== $sorter
                  || $candidatePermalink !== $permalink;
               if ($needsUpdate) {
                  $this->invalidateShopHelpCache($id);
                  $db->update($contentDd, array(
                     'permalink' => $permalink,
                     'title' => $title,
                     'description' => $description,
                     'keywords' => $keywords,
                     'sorter' => $sorter,
                     'content' => $content,
                     'group_read' => 'admin',
                     'activ' => 1,
                     'addmenu' => 0,
                     'meta_robots' => 'noindex,nofollow',
                  ), $id);
               }
               foreach ($oldPermalinks as $oldPermalink) {
                  $this->removeShopHelpPermalinkIndex((string)$oldPermalink);
               }
               $this->syncShopHelpPermalinkIndex($id, $permalink, 'admin');
               return $id;
            }
         }
 
         $folderId = $this->ensureShopHelpFolder();
         $insert = array(
            'activ' => 1,
            'addmenu' => 0,
            'folder' => $folderId,
            'group_read' => 'admin',
            'sorter' => $sorter,
            'title' => $title,
            'permalink' => $permalink,
            'description' => $description,
            'keywords' => $keywords,
            'template' => 'c-body1-footer',
            'content' => $content,
            'meta_robots' => 'noindex,nofollow',
         );
         $ok = (int)$db->insert($contentDd, $insert);
         if ($ok === 1) {
            $id = (int)$db->get_insert_id();
            $this->invalidateShopHelpCache($id);
            $this->syncShopHelpPermalinkIndex($id, $permalink, 'admin');
            return $id;
         }
      } catch (\Throwable $e) {
         if (function_exists('dbx')) {
            dbx()->debug('dbxShop help page failed', $e->getMessage());
         }
      }
 
      return 0;
   }
 
   private function ensureShopMediaUsagePage(): int {
      $db = $this->db();
      $contentDd = $this->contentDd();
      try {
         $row = $db->select1($contentDd, array('permalink' => 'outside/shop-media-usage'), 'id', 0);
         if (is_array($row) && (int)($row['id'] ?? 0) > 0) {
            return (int)$row['id'];
         }
 
         $folderId = 0;
         $folder = $db->select1($this->folderDd(), array('name' => 'outside'), 'id', 0);
         if (is_array($folder)) {
            $folderId = (int)($folder['id'] ?? 0);
         }
 
         $insert = array(
            'activ' => 0,
            'addmenu' => 0,
            'folder' => $folderId,
            'group_read' => 'admin',
            'sorter' => '9999',
            'title' => 'Shop Medienverwendung',
            'permalink' => 'outside/shop-media-usage',
            'description' => 'Interne Seite fuer Shop-Medienverwendung.',
            'keywords' => '',
            'template' => 'c-body1-footer',
            'content' => '<p>Interne Seite fuer Shop-Medienverwendung.</p>',
            'meta_robots' => 'noindex,nofollow',
         );
         $ok = (int)$db->insert($contentDd, $insert);
         if ($ok === 1) {
            $id = (int)$db->get_insert_id();
            return $id;
         }
      } catch (\Throwable $e) {
         if (function_exists('dbx')) {
            dbx()->debug('dbxShop media_usage page failed', $e->getMessage());
         }
      }
 
      return 0;
   }
 
   private function shopMediaUsageSlot(): string {
      $slot = strtolower(trim((string)dbx()->get_config('dbxShop', 'media_usage_slot')));
      $allowed = array('shop','hero','gallery','inline','header','teaser','footer');
      return in_array($slot, $allowed, true) ? $slot : 'shop';
   }
 
   private function shopMediaUsageSorter($db, int $contentId, string $slot): string {
      $where = 'content_id = ' . $contentId . " AND slot = '" . str_replace("'", "''", $slot) . "' AND active = 1";
      $rows = $db->select('dbxMediaUsage', $where, 'sorter,id', 'sorter,id', 'DESC', '', 1, 0, 0);
      $max = 0;
      if (is_array($rows) && isset($rows[0]) && is_array($rows[0])) {
         $max = (int)($rows[0]['sorter'] ?? 0);
      }
      return sprintf('%04d', $max + 10);
   }
 
   private function shopMediaFolderPath(): string {
      $base = function_exists('dbx_get_file_dir') ? (string)dbx_get_file_dir() : 'files';
      return rtrim($base, '/\\') . '/media/img/shop';
   }
 
   private function normalizeShopSourceImagePath(string $path): string {
      $path = trim(str_replace('\\', '/', $path));
      $path = preg_replace('~^https?://[^/]+/~i', '', $path) ?: $path;
      $path = preg_replace('~^/?dbxapp/~i', '', $path) ?: $path;
      return ltrim($path, '/');
   }
 
   private function filePathForShopImage(string $path): string {
      $path = $this->normalizeShopSourceImagePath($path);
      if ($path === '' || strpos($path, '..') !== false || preg_match('~(^|/)\.~', $path)) {
         return '';
      }
      if (!function_exists('dbx_get_file_dir')) {
         return '';
      }
 
      if (preg_match('~^files/(.+)$~i', $path, $m)) {
         return rtrim((string)dbx_get_file_dir(), '/\\') . '/' . $m[1];
      }
      if (preg_match('~^(media|shop)/~i', $path)) {
         return rtrim((string)dbx_get_file_dir(), '/\\') . '/' . $path;
      }
      return '';
   }
 
   private function mediaMime(string $file): string {
      $mime = function_exists('mime_content_type') ? (string)@mime_content_type($file) : '';
      if ($mime !== '') {
         return $mime;
      }
 
      $ext = strtolower(pathinfo($file, PATHINFO_EXTENSION));
      $map = array(
         'jpg' => 'image/jpeg',
         'jpeg' => 'image/jpeg',
         'png' => 'image/png',
         'gif' => 'image/gif',
         'webp' => 'image/webp',
         'svg' => 'image/svg+xml',
      );
      return $map[$ext] ?? 'application/octet-stream';
   }
 
   private function ensureMediaRecordForShopImage(array $image): int {
      $mediaId = (int)($image['media_id'] ?? 0);
      if ($mediaId > 0) {
         return $mediaId;
      }
 
      $sourcePath = $this->normalizeShopSourceImagePath((string)($image['image_path'] ?? ''));
      if ($sourcePath === '' || stripos($sourcePath, 'dbxmedia:') === 0) {
         return 0;
      }
 
      $sourceFile = $this->filePathForShopImage($sourcePath);
      if ($sourceFile === '' || !is_file($sourceFile) || !is_readable($sourceFile)) {
         return 0;
      }
 
      $name = basename($sourceFile);
      $name = preg_replace('/[^A-Za-z0-9_.-]+/', '-', $name) ?: ('shop-image-' . (int)($image['id'] ?? 0));
      $targetDir = $this->shopMediaFolderPath();
      if (!is_dir($targetDir)) {
         @mkdir($targetDir, 0775, true);
      }
      $targetFile = rtrim($targetDir, '/\\') . '/' . $name;
      if (!is_file($targetFile)) {
         @copy($sourceFile, $targetFile);
      }
      if (!is_file($targetFile)) {
         return 0;
      }
 
      $rel = 'media/img/shop/' . $name;
      $db = $this->db();
      $existing = $db->select1('dbxMedia', array('file_path' => $rel), 'id,active', 0);
      if (is_array($existing) && (int)($existing['id'] ?? 0) > 0) {
         $mediaId = (int)$existing['id'];
         if ((int)($existing['active'] ?? 0) !== 1) {
            $db->update('dbxMedia', array('active' => 1), $mediaId);
         }
         $this->repo()->updateImageMediaReference((int)($image['id'] ?? 0), $mediaId, 'dbxmedia:' . $mediaId);
         return $mediaId;
      }
 
      $width = 0;
      $height = 0;
      $size = @getimagesize($targetFile);
      if (is_array($size)) {
         $width = (int)($size[0] ?? 0);
         $height = (int)($size[1] ?? 0);
      }
      $title = trim((string)($image['title'] ?? ''));
      if ($title === '') {
         $title = pathinfo($name, PATHINFO_FILENAME);
      }
      $mime = $this->mediaMime($targetFile);
      $insert = array(
         'active' => 1,
         'content_id' => 0,
         'folder_id' => 0,
         'slot' => 'shop',
         'usage' => 'shop',
         'sorter' => '',
         'template' => '',
         'title' => $title,
         'alt' => (string)($image['alt'] ?? $title),
         'caption' => '',
         'file_name' => $name,
         'file_path' => $rel,
         'mime' => $mime,
         'size' => (int)@filesize($targetFile),
         'width' => $width,
         'height' => $height,
         'tags' => 'shop',
         'media_type' => 'image',
         'storage_type' => 'local',
         'media_folder' => 'img/shop',
      );
      $ok = (int)$db->insert('dbxMedia', $insert);
      if ($ok !== 1) {
         return 0;
      }
      $mediaId = (int)$db->get_insert_id();
      if ($mediaId <= 0) {
         return 0;
      }
      if ($mediaId > 0) {
         $this->repo()->updateImageMediaReference((int)($image['id'] ?? 0), $mediaId, 'dbxmedia:' . $mediaId);
      }
      return $mediaId;
   }
 
   private function migrateExistingShopImagesToMedia(): void {
      foreach ($this->repo()->allImages() as $image) {
         if ((int)($image['active'] ?? 0) !== 1) {
            continue;
         }
         $this->ensureMediaRecordForShopImage($image);
      }
   }
 
   private function syncShopMediaUsage(): void {
      $db = $this->db();
      $contentId = $this->shopMediaUsageContentId();
      if ($contentId <= 0) {
         return;
      }
 
      $slot = $this->shopMediaUsageSlot();
      $sourceNeedle = '%"source":"dbxShop"%';
      try {
         $this->migrateExistingShopImagesToMedia();
 
         $db->update(
            'dbxMediaUsage',
            array('active' => 0),
            "content_id = " . $contentId . " AND settings LIKE '" . str_replace("'", "''", $sourceNeedle) . "' AND active = 1",
            0,
            1,
            1,
            0
         );
 
         $byMedia = array();
         foreach ($this->repo()->allImages() as $image) {
            if ((int)($image['active'] ?? 0) !== 1) {
               continue;
            }
            $mediaId = (int)($image['media_id'] ?? 0);
            if ($mediaId <= 0) {
               continue;
            }
            if (!isset($byMedia[$mediaId])) {
               $byMedia[$mediaId] = array(
                  'media_id' => $mediaId,
                  'title' => (string)($image['title'] ?? ''),
                  'product_ids' => array(),
                  'group_ids' => array(),
               );
            }
            $productId = (int)($image['product_id'] ?? 0);
            $groupId = (int)($image['group_id'] ?? 0);
            if ($productId > 0) {
               $byMedia[$mediaId]['product_ids'][$productId] = $productId;
            }
            if ($groupId > 0) {
               $byMedia[$mediaId]['group_ids'][$groupId] = $groupId;
            }
         }
 
         foreach ($byMedia as $mediaId => $info) {
            $settings = json_encode(array(
               'source' => 'dbxShop',
               'product_ids' => array_values($info['product_ids']),
               'group_ids' => array_values($info['group_ids']),
            ), JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
            $db->insert('dbxMediaUsage', array(
               'active' => 1,
               'media_id' => (int)$mediaId,
               'content_id' => $contentId,
               'folder_id' => 0,
               'slot' => $slot,
               'sorter' => $this->shopMediaUsageSorter($db, $contentId, $slot),
               'template' => 'image-gallery',
               'caption' => (string)($info['title'] ?? ''),
               'settings' => $settings ?: '{"source":"dbxShop"}',
            ));
         }
      } catch (\Throwable $e) {
         if (function_exists('dbx')) {
            dbx()->debug('dbxShop media_usage sync failed', $e->getMessage());
         }
      }
   }
 
   private function chips(array $items, string $key = 'title', string $class = ''): string {
      $html = '';
      foreach ($items as $item) {
         $value = trim((string)($item[$key] ?? ''));
         if ($value === '') continue;
         $html .= '<span class="badge text-bg-light border">' . $this->h($value) . '</span>';
      }
      if ($html === '') {
         return '<span class="text-muted small">keine Werte</span>';
      }
      $class = trim('dbx-shop-report-chip-grid ' . $class);
      return '<div class="' . $this->h($class) . '">' . $html . '</div>';
   }
 
   private function attributeBadges(array $product): string {
      $html = '';
      foreach (($product['attributes'] ?? array()) as $attribute) {
         $value = trim((string)($attribute['display_value'] ?? $attribute['value_text'] ?? ''));
         if ($value === '') continue;
         $html .= '<span class="badge text-bg-info text-start text-wrap">' . $this->h($attribute['title'] ?? '') . ': ' . $this->h($value) . '</span>';
      }
      return $html !== '' ? '<div class="dbx-shop-report-chip-grid dbx-shop-report-chip-grid-attributes">' . $html . '</div>' : '<span class="text-muted small">keine Werte</span>';
   }
 
   private function attributeOptions(string $options): array {
      $items = preg_split('~[|;\r\n]+~', $options) ?: array();
      return array_values(array_filter(array_map('trim', $items), fn($item) => $item !== ''));
   }
 
   private function optionsHtml(array $options, string $selected): string {
      $html = '';
      foreach ($options as $value => $label) {
         $value = (string)$value;
         $html .= '<option value="' . $this->h($value) . '"' . ($value === $selected ? ' selected' : '') . '>' . $this->h($label) . '</option>';
      }
      return $html;
   }
 
   private function shopConfig(): array {
      $cfg = dbx()->get_config('dbxShop');
      return is_array($cfg) ? $cfg : array();
   }
 
   private function channelsEnabled(): bool {
      $value = strtolower(trim((string)dbx()->get_config('dbxShop', 'channels_enabled')));
      return !in_array($value, array('0', 'false', 'off', 'no', 'nein'), true);
   }
 
   private function taxRatesConfig(): array {
      $cfg = $this->shopConfig();
      $rates = $cfg['tax_rates'] ?? array();
      if (!is_array($rates) || !count($rates)) {
         $rates = array(
            'mwst1' => array('title' => 'MwSt. normal', 'rate' => '19'),
            'mwst2' => array('title' => 'MwSt. ermaessigt', 'rate' => '7'),
            'mwst3' => array('title' => 'MwSt. vorbereitet', 'rate' => '22'),
         );
      }
      foreach (array('mwst1' => 'MwSt. normal', 'mwst2' => 'MwSt. ermaessigt', 'mwst3' => 'MwSt. vorbereitet') as $key => $title) {
         if (!isset($rates[$key]) || !is_array($rates[$key])) {
            $rates[$key] = array('title' => $title, 'rate' => $key === 'mwst2' ? '7' : ($key === 'mwst3' ? '22' : '19'));
         }
      }
      return $rates;
   }
 
   private function taxClassOptions(string $selected): string {
      $options = array();
      foreach ($this->taxRatesConfig() as $key => $rate) {
         if (!is_array($rate)) continue;
         $label = trim((string)($rate['title'] ?? $key));
         $value = number_format((float)($rate['rate'] ?? 0), 2, ',', '.');
         $options[$key] = $label . ' (' . $value . '%)';
      }
      return $this->optionsHtml($options, $selected !== '' ? $selected : (string)($this->shopConfig()['default_tax_class'] ?? 'mwst1'));
   }
 
   private function normalizedText(string $value): string {
      $value = strtolower($value);
      $value = strtr($value, array('ä' => 'ae', 'ö' => 'oe', 'ü' => 'ue', 'ß' => 'ss'));
      $value = preg_replace('~[^a-z0-9]+~', ' ', $value) ?: '';
      return preg_replace('~\\s+~', ' ', trim($value)) ?: '';
   }
 
   private function searchTerms(string $query): array {
      $terms = preg_split('~\\s+~', $this->normalizedText($query)) ?: array();
      $stopWords = array_flip(array('der','die','das','den','dem','des','ein','eine','einer','einem','und','oder','mit','ohne','fuer','fur','von','im','in','am','an','auf','zu'));
      $out = array();
      foreach ($terms as $term) {
         $term = trim($term);
         if ($term === '' || isset($stopWords[$term])) {
            continue;
         }
         if (strlen($term) < 2 && !ctype_digit($term)) {
            continue;
         }
         $out[$term] = true;
      }
      return array_keys($out);
   }
 
   private function productAttributeText(array $product): string {
      $parts = array();
      foreach (($product['attributes'] ?? array()) as $attribute) {
         $value = trim((string)($attribute['display_value'] ?? $attribute['value_text'] ?? ''));
         $parts[] = (string)($attribute['title'] ?? '');
         $parts[] = (string)($attribute['attr_key'] ?? '');
         if ($value !== '') {
            $parts[] = $value;
         }
      }
      return implode(' ', $parts);
   }
 
   private function productGroupText(array $product): string {
      $parts = array();
      foreach (($product['groups'] ?? array()) as $group) {
         $parts[] = (string)($group['title'] ?? '');
         $parts[] = (string)($group['group_key'] ?? '');
         $parts[] = (string)($group['description'] ?? '');
         $parts[] = (string)($group['attribute_notes'] ?? '');
      }
      foreach (($product['shipping_groups'] ?? array()) as $group) {
         $parts[] = (string)($group['title'] ?? '');
         $parts[] = (string)($group['group_key'] ?? '');
      }
      foreach (($product['channel_groups'] ?? array()) as $group) {
         $parts[] = (string)($group['title'] ?? '');
         $parts[] = (string)($group['group_key'] ?? '');
      }
      foreach (($product['channels'] ?? array()) as $channel) {
         $parts[] = (string)($channel['title'] ?? '');
         $parts[] = (string)($channel['channel_key'] ?? '');
      }
      return implode(' ', $parts);
   }
 
   private function searchFieldScore(string $text, string $term, int $weight): int {
      if ($text === '' || $term === '') {
         return 0;
      }
      if ($text === $term) {
         return $weight * 8;
      }
      $termLength = strlen($term);
      $compactText = str_replace(' ', '', $text);
      $compactTerm = str_replace(' ', '', $term);
      if (strpos($text, $term) !== false || strpos($compactText, $compactTerm) !== false) {
         return $weight * 5;
      }
      $best = 0;
      foreach (preg_split('~\\s+~', $text) ?: array() as $token) {
         $token = trim($token);
         if ($token === '') {
            continue;
         }
         if ($token === $term) {
            $best = max($best, $weight * 6);
            continue;
         }
         if ($termLength < 3) {
            continue;
         }
         if (strlen($token) >= $termLength && strpos($token, $term) === 0) {
            $best = max($best, $weight * 4);
            continue;
         }
         if (
            $termLength >= 4
            && strlen($token) >= 4
            && substr($token, 0, 3) === substr($term, 0, 3)
            && abs(strlen($token) - $termLength) <= ($termLength >= 7 ? 2 : 1)
            && levenshtein($token, $term) <= ($termLength >= 7 ? 2 : 1)
         ) {
            $best = max($best, $weight * 2);
         }
      }
      return $best;
   }
 
   private function productSearchScore(array $product, string $query): int {
      $terms = $this->searchTerms($query);
      if ($terms === array()) {
         return 1;
      }
 
      $primary = $this->normalizedText(implode(' ', array(
         (string)($product['sku'] ?? ''),
         (string)($product['title'] ?? ''),
         (string)($product['category'] ?? ''),
         (string)($product['badge'] ?? ''),
         (string)($product['product_type'] ?? ''),
      )));
      $secondary = $this->normalizedText(implode(' ', array(
         (string)($product['summary'] ?? ''),
         (string)($product['description'] ?? ''),
      )));
      $attributes = $this->normalizedText($this->productAttributeText($product));
      $groups = $this->normalizedText($this->productGroupText($product));
 
      $score = 0;
      $matched = 0;
      $firstTermPrimaryScore = 0;
      $termCount = count($terms);
 
      foreach ($terms as $idx => $term) {
         $primaryScore = $this->searchFieldScore($primary, $term, 10);
         $termScore = max(
            $primaryScore,
            $this->searchFieldScore($attributes, $term, 7),
            $this->searchFieldScore($secondary, $term, 4),
            $this->searchFieldScore($groups, $term, 3)
         );
 
         if ($idx === 0) {
            $firstTermPrimaryScore = $primaryScore;
         }
         if ($termScore > 0) {
            $matched++;
            $score += $termScore;
         }
      }
 
      if ($matched === 0) {
         return 0;
      }
      if ($termCount === 1) {
         return $score;
      }
      if ($matched === $termCount || $firstTermPrimaryScore > 0 || $score >= 20) {
         return $score + ($matched * 3);
      }
      return 0;
   }
 
   private function productSortValue(array $product, string $sort) {
      switch ($sort) {
         case 'sku':
         case 'title':
            return $this->normalizedText((string)($product[$sort] ?? ''));
         case 'price_gross':
         case 'effective_tax_rate':
         case 'effective_shipping_gross':
            return (float)($product[$sort] ?? 0);
         case 'active':
            return (int)($product['active'] ?? 0);
         case 'sorter':
         default:
            return (int)($product['sorter'] ?? 100);
      }
   }
 
   private function sortProductsForReport(array $products, string $query, string $sort, string $direction): array {
      $hasQuery = $this->searchTerms($query) !== array();
      $direction = strtoupper($direction) === 'DESC' ? 'DESC' : 'ASC';
      usort($products, function(array $a, array $b) use ($hasQuery, $sort, $direction): int {
         if ($hasQuery && (int)($a['_search_score'] ?? 0) !== (int)($b['_search_score'] ?? 0)) {
            return (int)($b['_search_score'] ?? 0) <=> (int)($a['_search_score'] ?? 0);
         }
 
         $av = $this->productSortValue($a, $sort);
         $bv = $this->productSortValue($b, $sort);
         if ($av == $bv) {
            return strcasecmp((string)($a['title'] ?? ''), (string)($b['title'] ?? ''));
         }
         $cmp = is_numeric($av) && is_numeric($bv) ? ($av <=> $bv) : strcasecmp((string)$av, (string)$bv);
         return $direction === 'DESC' ? -$cmp : $cmp;
      });
      return $products;
   }
 
   public function product_report_next_record($report, $record) {
      if (!is_array($record)) {
         return $record;
      }
 
      $sku = (string)($record['sku'] ?? '');
      $productId = (int)($record['id'] ?? 0);
      $productTitle = trim((string)($record['title'] ?? $sku));
      $summary = trim((string)($record['summary'] ?? ''));
      $image = $record['images'][0] ?? array();
      $imgUrl = is_array($image) ? $this->mediaItemUrl($image, true) : '';
 
      $record['image_view'] = $imgUrl !== ''
         ? '<span class="dbx-shop-report-image"><img src="' . $this->h($imgUrl) . '" alt="" loading="lazy"></span>'
         : '<span class="text-muted small">kein Bild</span>';
      $record['article_view'] = '<div class="dbx-shop-report-article-scroll"><code class="dbx-shop-report-sku">' . $this->h($sku) . '</code>'
         . '<br><strong>' . $this->h($productTitle) . '</strong>'
         . ($summary !== '' ? '<br><small class="text-muted">' . $this->h($summary) . '</small>' : '')
         . '</div>';
      $record['groups_view'] = $this->chips($record['groups'] ?? array());
      $record['attributes_view'] = $this->attributeBadges($record);
      $record['shipping_groups_view'] = $this->chips($record['shipping_groups'] ?? array());
      $record['channel_groups_view'] = $this->chips($record['channel_groups'] ?? array());
      $record['channels_view'] = $this->chips($record['channels'] ?? array(), 'title', 'dbx-shop-report-chip-grid-channels');
      $record['price_view'] = '<span class="text-nowrap">' . $this->money($record['price_gross'] ?? 0) . '</span>';
      $record['tax_view'] = number_format((float)($record['effective_tax_rate'] ?? 0), 2, ',', '.') . '%';
      $record['shipping_view'] = '<span class="text-nowrap">' . $this->money($record['effective_shipping_gross'] ?? 0) . '</span>';
      $record['status_view'] = ((int)($record['active'] ?? 0) === 1)
         ? '<span class="badge text-bg-success">Aktiv</span>'
         : '<span class="badge text-bg-secondary">Inaktiv</span>';
 
      return $record;
   }
 
   public function product_report_row_action_data($report, $data) {
      if (!is_array($data) || !isset($data['data']) || !is_array($data['data'])) {
         return $data;
      }
 
      $type = (string)($data['type'] ?? '');
      $record = is_array($data['record'] ?? null) ? $data['record'] : array();
      $rid = (int)($data['data']['rid'] ?? $record['id'] ?? 0);
      $sku = (string)($record['sku'] ?? '');
      $title = trim((string)($record['title'] ?? $sku));
 
      if ($type === 'edit') {
         $url = '?dbx_modul=dbxShop_admin&dbx_run1=product_edit&id=' . $rid . '&dbx_ajax=1';
         $data['data']['action'] = $url;
         $data['data']['class'] = 'openWin dbx-win';
         $data['data']['tooltip'] = 'Artikel bearbeiten: ' . $title;
      } elseif ($type === 'show') {
         $url = '?dbx_modul=dbxShop&dbx_run1=product&sku=' . rawurlencode($sku) . '&dbx_ajax=1';
         $data['data']['action'] = $url;
         $data['data']['class'] = 'openWin dbx-win';
         $data['data']['tooltip'] = 'Artikel ansehen: ' . $title;
      } elseif ($type === 'delete') {
         $data['data']['action'] = '?dbx_modul=dbxShop_admin&dbx_run1=products';
         $data['data']['confirm'] = 'Artikel "' . $this->h($title) . '" wirklich loeschen?';
      }
 
      return $data;
   }
 
   private function productTreePanel(array $products): string {
      $groups = $this->repo()->groups();
      $groupsByParent = array();
      foreach ($groups as $group) {
         $parentId = (int)($group['parent_id'] ?? 0);
         $groupsByParent[$parentId][] = $group;
      }
 
      $productsByGroup = array();
      foreach ($products as $product) {
         $groupId = (int)($product['product_group_id'] ?? 0);
         if ($groupId <= 0 && isset($product['groups'][0])) {
            $groupId = (int)($product['groups'][0]['id'] ?? 0);
         }
         $productsByGroup[$groupId][] = $product;
      }
 
      $renderProducts = function(int $groupId, bool $asListItem = false) use (&$productsByGroup): string {
         $items = '';
         foreach (($productsByGroup[$groupId] ?? array()) as $product) {
            $id = (int)($product['id'] ?? 0);
            $title = trim((string)($product['title'] ?? 'Artikel'));
            $sku = trim((string)($product['sku'] ?? ''));
            if ($id <= 0) continue;
            $searchText = trim($title . ' ' . $sku);
            $items .= '<li class="dbx-shop-tree-product" draggable="true" data-shop-tree-node="product" data-shop-tree-product="' . $id . '" data-shop-tree-search-text="' . $this->h($searchText) . '">';
            $items .= '<span class="dbx-shop-tree-product-main"><i class="bi bi-box-seam"></i><span><strong>' . $this->h($title) . '</strong>' . ($sku !== '' ? '<small>' . $this->h($sku) . '</small>' : '') . '</span></span>';
            $items .= '<a class="btn btn-outline-primary btn-sm openWin dbx-win" href="?dbx_modul=dbxShop_admin&amp;dbx_run1=product_edit&amp;id=' . $id . '&amp;dbx_ajax=1" title="Artikel bearbeiten"><i class="bi bi-pencil"></i></a>';
            $items .= '</li>';
         }
         if ($items === '') {
            return '';
         }
         $html = '<ul class="dbx-shop-tree-products">' . $items . '</ul>';
         return $asListItem ? '<li class="dbx-shop-tree-product-list">' . $html . '</li>' : $html;
      };
 
      $renderGroup = function(array $group) use (&$renderGroup, &$groupsByParent, $renderProducts): string {
         $id = (int)($group['id'] ?? 0);
         if ($id <= 0) return '';
         $title = trim((string)($group['title'] ?? 'Artikelgruppe'));
         $childHtml = '';
         foreach (($groupsByParent[$id] ?? array()) as $child) {
            $childHtml .= $renderGroup($child);
         }
         $productsHtml = $renderProducts($id, true);
         $countChildren = count($groupsByParent[$id] ?? array());
         $countProducts = substr_count($productsHtml, 'data-shop-tree-node="product"');
         $hasChildren = $childHtml !== '' || $productsHtml !== '';
         $html = '<li class="dbx-shop-tree-group" data-shop-tree-group-wrap data-shop-tree-search-text="' . $this->h($title) . '">';
         $html .= '<div class="dbx-shop-tree-group-head" draggable="true" data-shop-tree-node="group" data-shop-tree-group="' . $id . '" data-shop-tree-drop="' . $id . '">';
         $html .= '<span class="dbx-shop-tree-group-main">';
         if ($hasChildren) {
            $html .= '<button type="button" class="dbx-shop-tree-group-toggle" data-shop-tree-group-toggle title="Gruppe ein- oder ausklappen" aria-label="Gruppe ein- oder ausklappen" aria-expanded="true"><i class="bi bi-chevron-down"></i></button>';
         } else {
            $html .= '<span class="dbx-shop-tree-toggle-spacer"></span>';
         }
         $html .= '<i class="bi bi-folder2"></i><span><strong>' . $this->h($title) . '</strong><small>' . $countChildren . ' Gruppen, ' . $countProducts . ' Artikel</small></span></span>';
         $html .= '<a class="btn btn-outline-secondary btn-sm openWin dbx-win" href="?dbx_modul=dbxShop_admin&amp;dbx_run1=groups&amp;dbx_ajax=1" data-url="?dbx_modul=dbxShop_admin&amp;dbx_run1=groups&amp;dbx_ajax=1" data-title="Artikelgruppen bearbeiten" data-width="54%" data-height="84%" title="Artikelgruppen bearbeiten"><i class="bi bi-diagram-3"></i></a>';
         $html .= '</div>';
         if ($hasChildren) {
            $html .= '<ul class="dbx-shop-tree-children">' . $childHtml . $productsHtml . '</ul>';
         }
         $html .= '</li>';
         return $html;
      };
 
      $rootGroups = '';
      foreach (($groupsByParent[0] ?? array()) as $group) {
         $rootGroups .= $renderGroup($group);
      }
      $ungrouped = $renderProducts(0, false);
      $search = dbx()->search_html(dbx()->search_defaults(array(
         'name' => 'shop_tree_search',
         'placeholder' => 'Artikelgruppe oder Artikel suchen',
         'title' => 'Tree durchsuchen',
         'wrap_class' => 'dbx-shop-tree-search-wrap',
         'extra_attrs' => 'data-shop-tree-search',
         'i' => 1,
      )));
      $html = '<section class="dbx-shop-product-tree-panel" data-shop-tree-panel data-shop-tree-moveurl="?dbx_modul=dbxShop_admin&amp;dbx_run1=product_tree_move" aria-label="Artikelgruppen-Baum">';
      $html .= '<div class="dbx-shop-product-tree-head"><div><h3>Artikelgruppen-Baum</h3><p>Artikel zuordnen, Gruppen verschieben.</p></div><div class="dbx-shop-product-tree-actions"><a class="btn btn-outline-primary btn-sm openWin dbx-win" href="?dbx_modul=dbxShop_admin&amp;dbx_run1=groups&amp;dbx_ajax=1" data-url="?dbx_modul=dbxShop_admin&amp;dbx_run1=groups&amp;dbx_ajax=1" data-title="Artikelgruppen bearbeiten" data-width="54%" data-height="84%"><i class="bi bi-diagram-3"></i> Gruppen bearbeiten</a><button type="button" class="btn btn-outline-secondary btn-sm" data-shop-tree-close title="Tree schliessen" aria-label="Tree schliessen"><i class="bi bi-x-lg"></i></button></div></div>';
      $html .= '<div class="dbx-shop-tree-tools">' . $search . '</div>';
      $html .= '<ul class="dbx-shop-tree-list">' . $rootGroups . '</ul>';
      if ($ungrouped !== '') {
         $html .= '<div class="dbx-shop-tree-ungrouped"><strong>Ohne Artikelgruppe</strong>' . $ungrouped . '</div>';
      }
      $html .= '</section>';
      return $html;
   }
 
   private function productTreeToggleButton(): string {
      return '<button type="button" class="btn btn-outline-secondary btn-sm dbx-shop-product-tree-toggle" data-dbx="lib=shopAdmin" data-shop-tree-toggle title="Artikelgruppen-Baum anzeigen" aria-label="Artikelgruppen-Baum anzeigen" aria-expanded="false"><i class="bi bi-diagram-3"></i></button>';
   }
 
   private function selectedProductIds($report): array {
      $ids = array();
      foreach (array_keys($report->get_multi_selects()) as $id) {
         $id = (int)$id;
         if ($id > 0) {
            $ids[$id] = $id;
         }
      }
      return array_values($ids);
   }
 
   private function productReportActionControls(string $baseAction): string {
      $channels = '<option value="">Channel</option>';
      foreach ($this->repo()->channels() as $channel) {
         $key = (string)($channel['channel_key'] ?? '');
         if ($key === '') {
            continue;
         }
         $channels .= '<option value="' . $this->h($key) . '">' . $this->h($channel['title'] ?? $key) . '</option>';
      }
 
      $groups = '<option value="0">Produktgruppe</option>';
      foreach ($this->repo()->groups() as $group) {
         $id = (int)($group['id'] ?? 0);
         if ($id <= 0) {
            continue;
         }
         $groups .= '<option value="' . $id . '">' . $this->h($group['title'] ?? '') . '</option>';
      }
 
      $url = function(string $do, array $params = array()) use ($baseAction): string {
         $query = $baseAction . '&dbx_do=' . rawurlencode($do);
         foreach ($params as $key => $value) {
            $query .= '&' . rawurlencode((string)$key) . '=' . rawurlencode((string)$value);
         }
         return $this->h($query);
      };
 
      $actions = '<option value="">Aktion waehlen</option>'
         . '<option value="shop_products_delete">Ausgewaehlte Produkte loeschen</option>'
         . '<option value="shop_products_channel_add">Channel hinzufuegen</option>'
         . '<option value="shop_products_channel_remove">Channel entfernen</option>'
         . '<option value="shop_products_channel_export">Channel exportieren</option>'
         . '<option value="shop_products_group_set">Produktgruppe setzen</option>';
 
      return '<div class="dbx-shop-products-bulk-actions">'
         . '<select class="form-select form-select-sm" name="dbx_products_bulk_action" title="Mehrfachaktion">' . $actions . '</select>'
         . '<select class="form-select form-select-sm" name="dbx_action_channel" title="Channel fuer Mehrfachaktion">' . $channels . '</select>'
         . '<select class="form-select form-select-sm" name="dbx_action_group" title="Produktgruppe fuer Mehrfachaktion">' . $groups . '</select>'
         . '<a class="btn btn-primary btn-sm dbxAjaxFormAction dbxConfirm" href="' . $url('shop_products_apply') . '" data-confirm-title="<i class=\'bi bi-lightning-fill\'></i> Mehrfachaktion ausfuehren" data-confirm="Aktion auf die ausgewaehlten Produkte anwenden?" data-confirm-hint="<small>Bei Loeschen werden die Produkte in den Papierkorb verschoben. Fuer Channel- und Gruppenaktionen bitte das passende Auswahlfeld setzen.</small>" data-confirm-buttons="yesno" role="button"><i class="bi bi-check2-circle"></i> Ausfuehren</a>'
         . '</div>';
   }
 
   private function handleProductReportAction($report): void {
      $do = (string)dbx()->get_modul_var('dbx_do', '', 'parameter');
      $rid = (int)dbx()->get_modul_var('rid', 0, 'int');
      if ($do === 'row_delete') {
         if ($rid <= 0) {
            $report->_msg_error = 'Artikel konnte nicht geloescht werden.';
            return;
         }
         $count = $this->repo()->deleteProducts(array($rid));
         $report->del_multi_select($rid);
         $report->_msg_success = $count === 1 ? 'Artikel geloescht.' : '';
         $report->_msg_error = $count === 1 ? '' : 'Artikel konnte nicht geloescht werden.';
         return;
      }
 
      if ($do === 'shop_products_apply') {
         $do = (string)dbx()->get_modul_var('dbx_products_bulk_action', '', 'parameter');
      }
 
      if (!in_array($do, array('shop_products_delete', 'shop_products_channel_add', 'shop_products_channel_remove', 'shop_products_channel_export', 'shop_products_group_set'), true)) {
         if ((string)dbx()->get_modul_var('dbx_do', '', 'parameter') === 'shop_products_apply') {
            $report->_msg_error = 'Bitte eine Aktion auswaehlen.';
         }
         return;
      }
 
      $ids = $this->selectedProductIds($report);
      if ($ids === array()) {
         $report->_msg_error = 'Bitte zuerst Produkte auswaehlen.';
         return;
      }
 
      if ($do === 'shop_products_delete') {
         $count = $this->repo()->deleteProducts($ids);
         foreach ($ids as $id) {
            $report->del_multi_select($id);
         }
         $report->_msg_success = $count === 1 ? '1 Produkt geloescht.' : $count . ' Produkte geloescht.';
         return;
      }
 
      if ($do === 'shop_products_channel_add') {
         $channel = trim((string)dbx()->get_modul_var('dbx_action_channel', '', 'parameter'));
         if ($channel === '') {
            $report->_msg_error = 'Bitte einen Channel auswaehlen.';
            return;
         }
         $count = $this->repo()->addChannelToProducts($ids, $channel);
         $report->_msg_success = $count . ' Produkte fuer Channel ' . $this->h($channel) . ' aktiviert.';
         return;
      }
 
      if ($do === 'shop_products_channel_remove') {
         $channel = trim((string)dbx()->get_modul_var('dbx_action_channel', '', 'parameter'));
         if ($channel === '') {
            $report->_msg_error = 'Bitte einen Channel auswaehlen.';
            return;
         }
         $count = $this->repo()->removeChannelFromProducts($ids, $channel);
         $report->_msg_success = $count . ' Produkte aus Channel ' . $this->h($channel) . ' entfernt.';
         return;
      }
 
      if ($do === 'shop_products_channel_export') {
         $channel = trim((string)dbx()->get_modul_var('dbx_action_channel', '', 'parameter'));
         if ($channel === '') {
            $report->_msg_error = 'Bitte einen Channel auswaehlen.';
            return;
         }
         $summary = $this->repo()->exportProductsToChannel($ids, $channel);
         $report->_msg_success = (int)($summary['ok'] ?? 0) . ' Export(e) erfolgreich, ' . (int)($summary['failed'] ?? 0) . ' fehlgeschlagen.';
         if (!empty($summary['messages'])) {
            $report->_msg_info = implode('<br>', array_map(fn($msg) => $this->h($msg), array_slice((array)$summary['messages'], 0, 8)));
         }
         return;
      }
 
      if ($do === 'shop_products_group_set') {
         $groupId = (int)dbx()->get_modul_var('dbx_action_group', 0, 'int');
         if ($groupId <= 0) {
            $report->_msg_error = 'Bitte eine Produktgruppe auswaehlen.';
            return;
         }
         $count = $this->repo()->setProductGroupForProducts($ids, $groupId);
         $report->_msg_success = $count . ' Produkte der Produktgruppe zugeordnet.';
      }
   }
 
   private function cardTemplateOptions(string $selected): string {
      return $this->optionsHtml(array(
         'product-card-default' => 'Standardkarte',
         'product-card-compact' => 'Kompaktkarte',
      ), $selected);
   }
 
   private function detailTemplateOptions(string $selected): string {
      return $this->optionsHtml(array(
         'product-detail-default' => 'Standarddetail',
         'product-detail-technical' => 'Technische Ansicht',
      ), $selected);
   }
 
   private function galleryTemplateOptions(string $selected): string {
      return $this->optionsHtml(array(
         'image-gallery' => 'Bild Gallery',
         'file-gallery' => 'Datei Gallery',
      ), $selected);
   }
 
   private function galleryOverflowOptions(string $selected): string {
      return $this->optionsHtml(array(
         'grid' => 'Grid',
         'slider' => 'Slider',
         'scroll' => 'Scroll',
         'laufband' => 'Laufband',
         'tutorial' => 'Tutorial',
      ), $selected);
   }
 
   private function galleryClickOptions(string $selected): string {
      return $this->optionsHtml(array(
         'lightbox' => 'Lightbox',
         'none' => 'Kein Klick',
         'newtab' => 'Neuer Tab',
         'viewerjs' => 'ViewerJS',
         'photoswipe' => 'PhotoSwipe',
      ), $selected);
   }
 
   private function shopAdminStyle(): string {
      $file = dirname(__DIR__) . '/design/css/shop-admin.css';
      if (!is_file($file)) {
         return '';
      }
      return '<style>' . file_get_contents($file) . '</style>';
   }
 
   private function frame(string $content, string $title = 'Shop Administration', string $barActions = ''): string {
      return $this->tpl()->get_tpl('dbxShop_admin|admin-shell', array(
         'shop_admin_style' => $this->shopAdminStyle(),
         'bar_title' => $this->h($title),
         'bar_icon' => 'bi-bag-check',
         'bar_subtitle' => 'Produkte, Bestellungen, Rechtstexte und Widerrufe',
         'bar_title_pre' => '',
         'bar_title_heading_attrs' => '',
         'bar_middle' => '',
         'bar_extra' => '',
         'bar_actions' => $barActions,
         'content' => $content,
      ));
   }
 
   private function productBarActions(): string {
      return '<a class="btn btn-outline-primary btn-sm me-1" href="?dbx_modul=dbxShop_admin&dbx_run1=product_edit&id=0" title="Neuen Artikel anlegen"><i class="bi bi-plus-square"></i><span class="visually-hidden"> Neuer Artikel</span></a>'
         . $this->helpButton($this->ensureShopProductsHelpPage(), 'Hilfe: Produkte');
   }
 
   private function productShellActions(): string {
      return $this->productBarActions();
   }
 
   private function productFormDefaults(int $id): array {
      $now = date('Y-m-d H:i:s');
      $uid = (int)dbx()->user();
      $defaults = array(
         'update_date' => $now,
         'update_uid' => $uid,
      );
      if ($id <= 0) {
         $defaults['create_date'] = $now;
         $defaults['create_uid'] = $uid;
         $defaults['owner'] = $uid;
         $defaults['trash'] = 0;
         $defaults['currency'] = 'EUR';
      }
      return $defaults;
   }
 
   private function newProductDefaults(): array {
      return array(
         'sku' => '',
         'slug' => '',
         'title' => '',
         'category' => 'Merchandise',
         'product_type' => 'physical',
         'summary' => '',
         'description' => '',
         'price_gross' => '0.00',
         'currency' => 'EUR',
         'tax_mode' => 'group',
         'tax_rate' => '-1',
         'shipping_mode' => 'group',
         'shipping_gross' => '-1',
         'stock' => '0',
         'active' => 1,
         'sorter' => 100,
         'badge' => '',
         'image_icon' => 'bi-box-seam',
         'logo_variant' => '',
      );
   }
 
   private function applyProductPreset(array $data): array {
      $preset = trim((string)dbx()->get_modul_var('workflow_preset', '', 'parameter'));
      if ($preset === 'shop_article_publish') {
         $data['category'] = $data['category'] ?: 'Merchandise';
         $data['product_type'] = $data['product_type'] ?: 'physical';
         $data['active'] = 1;
      }
 
      $map = array(
         'preset_sku' => 'sku',
         'preset_slug' => 'slug',
         'preset_title' => 'title',
         'preset_category' => 'category',
         'preset_product_type' => 'product_type',
         'preset_summary' => 'summary',
         'preset_price_gross' => 'price_gross',
         'preset_group_id' => 'product_group_id',
      );
      foreach ($map as $param => $field) {
         $value = trim((string)dbx()->get_modul_var($param, '', '*'));
         if ($value !== '') {
            $data[$field] = $value;
         }
      }
 
      return $data;
   }
 
   private function productFormActions(int $id): string {
      $html = $this->helpButton($this->ensureShopProductsHelpPage(), 'Hilfe: Artikel bearbeiten', 'btn btn-outline-secondary btn-sm ms-1')
         . '<button class="btn btn-primary btn-sm" type="submit" title="Artikel speichern"><i class="bi bi-save"></i><span class="visually-hidden"> Speichern</span></button>';
 
      if ($id > 0) {
         $product = $this->repo()->productById($id);
         $previewUrl = '?dbx_modul=dbxShop&dbx_run1=product&sku=' . rawurlencode((string)($product['sku'] ?? ''));
         $deleteUrl = '?dbx_modul=dbxShop_admin&dbx_run1=products&dbx_do=row_delete&rid=' . $id . '&dbx_ajax=1';
         $html .= $this->openWinButton($previewUrl, 'Artikel ansehen', '<i class="bi bi-search"></i><span class="visually-hidden"> Vorschau</span>', 'btn btn-outline-primary btn-sm ms-1', '82%', '82%');
         $html .= $this->openWinButton('?dbx_modul=dbxShop_admin&dbx_run1=product_attributes&id=' . $id . '&dbx_ajax=1', 'Artikelattribute', '<i class="bi bi-sliders"></i><span class="visually-hidden"> Attribute</span>', 'btn btn-outline-primary btn-sm ms-1', '76%', '78%');
         $html .= '<a class="btn btn-outline-danger btn-sm ms-1 dbxConfirm" href="' . $this->h($deleteUrl) . '" data-confirm-title="Artikel loeschen" data-confirm="Diesen Artikel wirklich loeschen?" data-confirm-buttons="yesno" title="Artikel loeschen"><i class="bi bi-trash"></i><span class="visually-hidden"> Loeschen</span></a>';
      }
 
      $html .= '<a class="btn btn-outline-secondary btn-sm ms-1" href="?dbx_modul=dbxShop_admin&dbx_run1=products" title="Zur Produktliste"><i class="bi bi-table"></i><span class="visually-hidden"> Produktliste</span></a>';
 
      return $html;
   }
 
   private function productGroupOptions(int $excludeId = 0, bool $withNone = false): array {
      $groups = $this->repo()->groups();
      $byParent = array();
      foreach ($groups as $group) {
         $parentId = (int)($group['parent_id'] ?? 0);
         $byParent[$parentId][] = $group;
      }
 
      $options = $withNone ? array('0' => 'Keine Obergruppe') : array();
      $walk = function(int $parentId, string $prefix) use (&$walk, &$options, $byParent, $excludeId): void {
         foreach (($byParent[$parentId] ?? array()) as $group) {
            $id = (int)($group['id'] ?? 0);
            if ($id <= 0 || $id === $excludeId) {
               continue;
            }
            $title = trim((string)($group['title'] ?? ''));
            if ($title === '') {
               $title = (string)($group['group_key'] ?? $id);
            }
            $label = $prefix !== '' ? $prefix . ' / ' . $title : $title;
            $options[(string)$id] = $label;
            $walk($id, $label);
         }
      };
      $walk(0, '');
      return $options;
   }
 
   private function shopMediaConfig(): array {
      return array(
         'media' => $this->cmsEndpoint('cms_media', array('images' => 1, 'media_type' => 'image')),
         'uploadmediafolder' => 'img/shop',
         'upload' => $this->cmsEndpoint('cms_upload'),
         'externalvideo' => $this->cmsEndpoint('cms_external_video'),
         'mediafolders' => $this->cmsEndpoint('cms_media_folders'),
         'mediafoldercreate' => $this->cmsEndpoint('cms_media_folder_create'),
         'mediafolderdelete' => $this->cmsEndpoint('cms_media_folder_delete'),
         'mediafolderrename' => $this->cmsEndpoint('cms_media_folder_rename'),
         'mediamove' => $this->cmsEndpoint('cms_media_move'),
         'mediaunused' => $this->cmsEndpoint('cms_media_unused'),
         'mediaprocess' => $this->cmsEndpoint('cms_media_process'),
         'deletemedia' => $this->cmsEndpoint('cms_delete_media'),
         'editmedia' => $this->cmsEndpoint('cms_edit_media'),
         'assignurl' => $this->shopEndpoint('assign_media'),
      );
   }
 
   private function shopMediaAttrs(array $mediaCfg): string {
      $attrs = ' data-dbx="lib=shopAdmin"';
      foreach ($mediaCfg as $key => $value) {
         $attrs .= ' data-shop-' . $this->h($key) . '="' . $this->h($value) . '"';
      }
      return $attrs;
   }
 
   private function productImagesPanel(array $product, bool $isNew): string {
      if ($isNew) {
         return '<aside class="border rounded bg-light p-3"><h6 class="mb-3">Artikelbilder</h6><div class="alert alert-info mb-0">Artikel erst speichern, danach koennen Bilder zugeordnet werden.</div></aside>';
      }
 
      $productId = (int)($product['id'] ?? 0);
      $this->ensureCmsShopMediaFolder();
      $mediaCfg = $this->shopMediaConfig();
      $html = '<aside class="border rounded bg-light p-3 dbx-shop-media-manager dbx-shop-product-image-panel"' . $this->shopMediaAttrs($mediaCfg) . '>';
      $html .= '<input type="hidden" value="' . $productId . '" data-shop-product-select>';
      $html .= '<input type="hidden" value="0" data-shop-group-select>';
      $html .= '<input type="hidden" value="100" data-shop-sorter>';
      $html .= '<div class="d-flex justify-content-between align-items-center gap-2 mb-3">';
      $html .= '<h6 class="mb-0">Artikelbilder</h6>';
      $html .= '<button type="button" class="btn btn-outline-primary btn-sm dbx-shop-media-pick" data-shop-media-folder="img/shop" title="Bilder aus dem Medienbrowser zum Artikel hinzufuegen"><i class="bi bi-images"></i><i class="bi bi-camera-video"></i><i class="bi bi-upload"></i><span>Auswahl</span></button>';
      $html .= '</div>';
      $html .= '<label class="form-check mb-3"><input class="form-check-input" type="checkbox" value="1" data-shop-primary> <span class="form-check-label">neues Bild als Primaerbild</span></label>';
 
      $images = (array)($product['images'] ?? array());
      if ($images === array()) {
         $html .= '<div class="text-muted small">Noch keine Bilder zugeordnet.</div>';
      } else {
         $html .= '<div class="dbx-shop-image-list">';
         foreach ($images as $image) {
            $imageId = (int)($image['id'] ?? 0);
            $source = (int)($image['product_id'] ?? 0) === $productId ? 'Artikelbild' : 'Gruppenbild';
            $primary = (int)($image['is_primary'] ?? 0) === 1 ? '<span class="badge text-bg-primary ms-1">Primaer</span>' : '';
            $title = trim((string)($image['title'] ?? ''));
            if ($title === '') {
               $title = basename((string)($image['image_path'] ?? 'Bild'));
            }
            $removeUrl = '?dbx_modul=dbxShop_admin&dbx_run1=product_edit&id=' . $productId . '&remove_image=' . $imageId . '&dbx_ajax=1';
            $html .= '<figure class="dbx-shop-image-card">';
            if ($imageId > 0) {
               $html .= '<a class="btn btn-outline-danger btn-sm dbxAjax dbxConfirm dbx-shop-image-unassign" href="' . $this->h($removeUrl) . '" data-confirm-title="<i class=\'bi bi-trash\'></i> Bild-Zuordnung aufheben" data-confirm="Diese Bild-Zuordnung wirklich aufheben?" data-confirm-hint="<small>Die Datei im Medienbrowser bleibt erhalten. Entfernt wird nur die Shop-Zuordnung. Bei Gruppenbildern betrifft das die Gruppe und damit auch andere Artikel dieser Gruppe.</small>" data-confirm-buttons="yesno" title="Bild-Zuordnung aufheben"><i class="bi bi-trash"></i><span class="visually-hidden"> Zuordnung aufheben</span></a>';
            }
            $html .= '<img src="' . $this->h($this->mediaItemUrl($image, true)) . '" alt="' . $this->h($image['alt'] ?? $title) . '">';
            $html .= '<figcaption><strong>' . $this->h($title) . '</strong><br><span class="text-muted">' . $this->h($source) . '</span>' . $primary . '</figcaption>';
            $html .= '</figure>';
         }
         $html .= '</div>';
      }
 
      $html .= '<div class="form-text mt-3">Upload, Auswahl, Zuschneiden, Resize, Batch und Wartung laufen ueber den vorhandenen Medienbrowser.</div>';
      $html .= '</aside>';
      return $html;
   }
 
   private function productGroupImagePanel(array $group, bool $isNew): string {
      if ($isNew) {
         return '<div class="dbx-shop-group-image-panel dbx-shop-group-image-empty"><div class="form-text">Gruppe erst speichern, danach kann ein Gruppenbild ausgewaehlt werden.</div></div>';
      }
 
      $groupId = (int)($group['id'] ?? 0);
      if ($groupId <= 0) {
         return '';
      }
 
      $this->ensureCmsShopMediaFolder();
      $mediaCfg = $this->shopMediaConfig();
      $image = $this->repo()->primaryImageForGroup($groupId);
      $html = '<div class="dbx-shop-media-manager dbx-shop-group-image-panel"' . $this->shopMediaAttrs($mediaCfg) . '>';
      $html .= '<input type="hidden" value="0" data-shop-product-select>';
      $html .= '<input type="hidden" value="' . $groupId . '" data-shop-group-select>';
      $html .= '<input type="hidden" value="10" data-shop-sorter>';
      $html .= '<input type="hidden" value="1" data-shop-primary>';
      $html .= '<div class="dbx-shop-group-image-head">';
      $html .= '<span>Gruppenbild</span>';
      $html .= '<button type="button" class="btn btn-outline-primary btn-sm dbx-shop-media-pick" data-shop-media-folder="img/shop" title="Gruppenbild aus dem Medienbrowser auswaehlen"><i class="bi bi-images"></i><span>Auswahl</span></button>';
      $html .= '</div>';
      if (is_array($image)) {
         $title = trim((string)($image['title'] ?? ''));
         if ($title === '') {
            $title = basename((string)($image['image_path'] ?? 'Gruppenbild'));
         }
         $html .= '<figure class="dbx-shop-group-image-preview"><img src="' . $this->h($this->mediaItemUrl($image, true)) . '" alt="' . $this->h($image['alt'] ?? $title) . '"><figcaption>' . $this->h($title) . '</figcaption></figure>';
      } else {
         $html .= '<div class="dbx-shop-group-image-placeholder"><i class="bi bi-image"></i><span>Kein Gruppenbild</span></div>';
      }
      $html .= '<div class="form-text">Ein neues Bild ersetzt das bisherige Gruppenbild. Die CMS-Datei bleibt erhalten.</div>';
      $html .= '</div>';
      return $html;
   }
 
   private function productChannelsPanel(array $product, bool $isNew): string {
      if (!$this->channelsEnabled()) {
         return '';
      }
      if ($isNew) {
         return '<aside class="border rounded bg-light p-3 mt-3"><h6 class="mb-3">Channels</h6><div class="alert alert-info mb-0">Artikel erst speichern, danach koennen Channels individuell gesetzt werden.</div></aside>';
      }
 
      $productId = (int)($product['id'] ?? 0);
      $overrides = $this->repo()->productChannelOverrides($productId);
      $inherited = $this->repo()->inheritedChannelsForProduct($productId);
      $html = '<aside class="border rounded bg-light p-3 mt-3 dbx-shop-product-channel-panel">';
      $html .= '<h6 class="mb-2">Channels</h6>';
      $html .= '<p class="form-text mb-3">Direkte Artikel-Auswahl. Diese Einstellung hat Vorrang vor Channel-Gruppen.</p>';
      $html .= '<input type="hidden" name="product_channel_editor" value="1">';
 
      $channels = $this->repo()->channels();
      if ($channels === array()) {
         $html .= '<div class="text-muted small">Noch keine Channels angelegt.</div>';
      } else {
         $html .= '<div class="table-responsive dbx-shop-product-channel-table-wrap">';
         $html .= '<table class="table table-sm align-middle mb-0 dbx-shop-product-channel-table">';
         $html .= '<thead><tr><th>Channel</th><th>Status</th><th>Export</th><th class="text-end">Aktion</th></tr></thead><tbody>';
         foreach ($channels as $channel) {
            $key = trim((string)($channel['channel_key'] ?? ''));
            if ($key === '') {
               continue;
            }
 
            $hasOverride = isset($overrides[$key]);
            $isInherited = isset($inherited[$key]);
            $checked = $hasOverride
               ? (int)($overrides[$key]['active'] ?? 0) === 1
               : $isInherited;
            $source = $hasOverride
               ? ((int)($overrides[$key]['active'] ?? 0) === 1 ? 'direkt aktiv' : 'direkt deaktiviert')
               : ($isInherited ? 'aus Gruppe: ' . implode(', ', array_values($inherited[$key]['group_titles'] ?? array())) : 'nicht gesetzt');
            $sourceText = (!$hasOverride && $isInherited) ? 'aus Gruppe' : $source;
            $statusClass = $checked ? 'text-bg-success' : 'text-bg-secondary';
            $export = $overrides[$key] ?? array();
            $exportStatus = trim((string)($export['export_status'] ?? ''));
            $exportMessage = trim((string)($export['export_message'] ?? ''));
            $listingId = trim((string)($export['external_listing_id'] ?? ''));
            $exportBadgeClass = match ($exportStatus) {
               'published', 'exported', 'ready', 'manual_ready' => 'text-bg-info',
               'failed' => 'text-bg-danger',
               default => 'text-bg-light text-dark',
            };
            $exportText = $exportStatus !== '' ? $exportStatus : 'nicht exportiert';
            $exportUrl = '?dbx_modul=dbxShop_admin&dbx_run1=product_edit&id=' . $productId . '&export_channel=' . rawurlencode($key) . '&dbx_ajax=1';
            $mappingUrl = '?dbx_modul=dbxShop_admin&dbx_run1=product_channel_mapping&id=' . $productId . '&channel=' . rawurlencode($key) . '&dbx_ajax=1';
 
            $html .= '<tr class="dbx-shop-product-channel-row">';
            $html .= '<td class="dbx-shop-product-channel-name">';
            $html .= '<label class="d-flex align-items-start gap-2 mb-0">';
            $html .= '<input class="form-check-input" type="checkbox" name="product_channels[]" value="' . $this->h($key) . '"' . ($checked ? ' checked' : '') . '>';
            $html .= '<span class="dbx-shop-product-channel-copy"><strong>' . $this->h($channel['title'] ?? $key) . '</strong><code>' . $this->h($key) . '</code></span>';
            $html .= '</label>';
            $html .= '</td>';
            $html .= '<td><span class="badge ' . $statusClass . '" title="' . $this->h($source) . '">' . $this->h($sourceText) . '</span></td>';
            $html .= '<td><span class="badge ' . $exportBadgeClass . '" title="' . $this->h($exportMessage) . '">' . $this->h($exportText) . '</span>';
            if ($listingId !== '') {
               $html .= '<code class="small d-block mt-1">' . $this->h($listingId) . '</code>';
            }
            $html .= '</td>';
            $html .= '<td class="text-end"><span class="dbx-shop-product-channel-actions">';
            $html .= $this->openWinButton($mappingUrl, 'Channel-Mapping: ' . (string)($channel['title'] ?? $key), '<i class="bi bi-sliders2"></i><span class="visually-hidden"> Mapping</span>', 'btn btn-outline-secondary btn-sm', '68%', '84%');
            if ($checked && (int)($channel['export_enabled'] ?? 0) === 1) {
               $html .= '<a class="btn btn-outline-primary btn-sm dbxConfirm" href="' . $this->h($exportUrl) . '" data-confirm-title="<i class=\'bi bi-broadcast\'></i> Channel exportieren" data-confirm="Artikel jetzt zu ' . $this->h($channel['title'] ?? $key) . ' exportieren?" data-confirm-hint="<small>Der Connector sendet nur, wenn die fuer den Anbieter notwendigen Zugangsdaten und Pflichtfelder vorhanden sind. Status und Antwort werden am Artikel gespeichert.</small>" data-confirm-buttons="yesno" title="Zu diesem Channel exportieren"><i class="bi bi-broadcast"></i></a>';
            }
            $html .= '</span></td>';
            $html .= '</tr>';
         }
         $html .= '</tbody></table></div>';
      }
 
      $html .= '</aside>';
      return $html;
   }
 
   private function mappingLinesToMap(string $lines): array {
      $map = array();
      foreach (preg_split('/\R/', $lines) ?: array() as $line) {
         $line = trim((string)$line);
         if ($line === '' || strpos($line, '=') === false) {
            continue;
         }
         [$key, $value] = array_map('trim', explode('=', $line, 2));
         if ($key !== '' && $value !== '') {
            $map[$key] = $value;
         }
      }
      return $map;
   }
 
   private function mappingMapToLines(array $map): string {
      $lines = array();
      foreach ($map as $key => $value) {
         if (is_array($value)) {
            $value = implode('|', array_map('strval', $value));
         }
         $lines[] = (string)$key . '=' . (string)$value;
      }
      return implode("\n", $lines);
   }
 
   private function ebayCategoryOptions(array $mapping, array $channel, array $product): array {
      $options = array();
      $add = function(string $value, string $label) use (&$options) {
         $value = trim($value);
         if ($value === '' || isset($options[$value])) {
            return;
         }
         $options[$value] = $label;
      };
 
      $current = (string)($mapping['category_id'] ?? '');
      $channelDefault = (string)($channel['category_id'] ?? '');
      $groupDefault = (string)($this->productGroupChannelMappingDefaults('ebay', $product)['category_id'] ?? '');
      $add($current, 'Aktuelle Auswahl: ' . $current);
      $add($groupDefault, 'Artikelgruppen-Vorgabe: ' . $groupDefault);
      $add($channelDefault, 'Channel-Vorgabe: ' . $channelDefault);
 
      $configured = dbx()->get_config('dbxShop', 'ebay_category_options');
      if (is_array($configured)) {
         foreach ($configured as $value => $label) {
            $add((string)$value, (string)$label);
         }
      } else {
         foreach (preg_split('/\R/', (string)$configured) ?: array() as $line) {
            $line = trim($line);
            if ($line === '') {
               continue;
            }
            if (strpos($line, '=') !== false) {
               [$value, $label] = array_map('trim', explode('=', $line, 2));
               $add($value, $label !== '' ? $label : $value);
            } else {
               $add($line, $line);
            }
         }
      }
 
      $productCategory = strtolower((string)($product['category'] ?? '') . ' ' . (string)($product['product_type'] ?? ''));
      if (strpos($productCategory, 'software') !== false || strpos($productCategory, 'digital') !== false) {
         $add('58058', '58058 - Software / digitale Produkte');
      }
 
      $add('58058', '58058 - Software / digitale Produkte');
      $add('11450', '11450 - Kleidung & Accessoires');
      $add('293', '293 - Elektronik');
      $add('220', '220 - Haus & Garten');
      $add('12576', '12576 - Business & Industrie');
 
      return $options;
   }
 
   private function ebayCategoryInput(array $mapping, array $channel, array $product): string {
      $value = (string)($mapping['category_id'] ?? $channel['category_id'] ?? '');
      $html = '<div class="col-md-4"><label class="form-label">eBay Kategorie</label>'
         . '<select class="form-select form-select-sm" name="mapping_category_id">';
      foreach ($this->ebayCategoryOptions($mapping, $channel, $product) as $optionValue => $label) {
         $html .= '<option value="' . $this->h($optionValue) . '"' . ((string)$optionValue === $value ? ' selected' : '') . '>' . $this->h($label) . '</option>';
      }
      $html .= '</select>'
         . '<div class="form-text">Die Liste ist eine Vorgabe. Fuer weitere IDs koennen Shop-Settings oder spaeter die eBay-Taxonomy-Anbindung genutzt werden.</div>'
         . '</div>';
      return $html;
   }
 
   private function productGroupChannelMappingDefaults(string $platform, array $product): array {
      $groupId = (int)($product['product_group_id'] ?? 0);
      if ($groupId <= 0) {
         return array();
      }
      $group = $this->repo()->groupById($groupId);
      if (!is_array($group)) {
         return array();
      }
 
      if ($platform === 'ebay') {
         $category = trim((string)($group['ebay_category_id'] ?? ''));
         return $category !== '' ? array('category_id' => $category) : array();
      }
      if ($platform === 'amazon') {
         $productType = trim((string)($group['amazon_product_type'] ?? ''));
         return $productType !== '' ? array('productType' => $productType) : array();
      }
      if ($platform === 'kleinanzeigen') {
         $category = trim((string)($group['kleinanzeigen_category_id'] ?? ''));
         return $category !== '' ? array('category_id' => $category) : array();
      }
      if ($platform === 'mobile') {
         $category = trim((string)($group['mobile_category_id'] ?? ''));
         return $category !== '' ? array('mobile_vehicle' => array('category' => $category)) : array();
      }
 
      return array();
   }
 
   private function channelMappingInheritedDefaults(string $platform, array $channel, array $product): array {
      $defaults = array();
      if ($platform === 'ebay') {
         $defaults = array(
            'category_id' => trim((string)($channel['category_id'] ?? '')),
            'payment_policy_id' => trim((string)($channel['payment_policy_id'] ?? '')),
            'fulfillment_policy_id' => trim((string)($channel['fulfillment_policy_id'] ?? '')),
            'return_policy_id' => trim((string)($channel['return_policy_id'] ?? '')),
         );
      } elseif ($platform === 'amazon') {
         $category = trim((string)($channel['category_id'] ?? ''));
         if (stripos($category, 'productType:') === 0) {
            $category = trim(substr($category, strlen('productType:')));
         }
         if (strpos($category, '/') !== false) {
            $category = trim((string)explode('/', $category)[0]);
         }
         $defaults = array('productType' => strtoupper($category));
      } elseif ($platform === 'kleinanzeigen') {
         $defaults = array(
            'category_id' => trim((string)($channel['category_id'] ?? '')),
            'location' => trim((string)($channel['location_key'] ?? '')),
         );
      } elseif ($platform === 'mobile') {
         $category = trim((string)($channel['category_id'] ?? ''));
         $defaults = array('mobile_vehicle' => array('category' => $category));
      }
 
      $defaults = $this->mergeMappingDefaults($defaults, $this->productGroupChannelMappingDefaults($platform, $product));
      return $this->cleanEmptyMappingValues($defaults);
   }
 
   private function mergeMappingDefaults(array $defaults, array $mapping): array {
      foreach ($defaults as $key => $value) {
         if (is_array($value)) {
            $current = is_array($mapping[$key] ?? null) ? $mapping[$key] : array();
            $mapping[$key] = $this->mergeMappingDefaults($value, $current);
            continue;
         }
         if (!array_key_exists($key, $mapping) || trim((string)$mapping[$key]) === '') {
            $mapping[$key] = $value;
         }
      }
      return $mapping;
   }
 
   private function cleanEmptyMappingValues(array $mapping): array {
      foreach ($mapping as $key => $value) {
         if (is_array($value)) {
            $value = $this->cleanEmptyMappingValues($value);
            if ($value === array()) {
               unset($mapping[$key]);
            } else {
               $mapping[$key] = $value;
            }
            continue;
         }
         if (trim((string)$value) === '') {
            unset($mapping[$key]);
         }
      }
      return $mapping;
   }
 
   private function removeInheritedMappingDefaults(array $mapping, array $defaults): array {
      foreach ($defaults as $key => $defaultValue) {
         if (!array_key_exists($key, $mapping)) {
            continue;
         }
         if (is_array($defaultValue)) {
            $current = is_array($mapping[$key]) ? $mapping[$key] : array();
            $mapping[$key] = $this->removeInheritedMappingDefaults($current, $defaultValue);
            if ($mapping[$key] === array()) {
               unset($mapping[$key]);
            }
            continue;
         }
         if (trim((string)$mapping[$key]) === trim((string)$defaultValue)) {
            unset($mapping[$key]);
         }
      }
      return $this->cleanEmptyMappingValues($mapping);
   }
 
   private function providerMappingHtml(string $platform, array $mapping, array $channel, array $product): string {
      $input = function(string $name, string $label, string $value = '', string $placeholder = '', string $class = 'col-md-4'): string {
         return '<div class="' . $class . '"><label class="form-label">' . $this->h($label) . '</label><input class="form-control form-control-sm" name="mapping_' . $this->h($name) . '" value="' . $this->h($value) . '" placeholder="' . $this->h($placeholder) . '"></div>';
      };
      $textarea = function(string $name, string $label, string $value = '', string $placeholder = '', int $rows = 4, string $class = 'col-12'): string {
         return '<div class="' . $class . '"><label class="form-label">' . $this->h($label) . '</label><textarea class="form-control form-control-sm" rows="' . $rows . '" name="mapping_' . $this->h($name) . '" placeholder="' . $this->h($placeholder) . '">' . $this->h($value) . '</textarea></div>';
      };
 
      $html = '<div class="row g-3">';
      if ($platform === 'ebay') {
         $condition = (string)($mapping['condition'] ?? 'NEW');
         $aspects = is_array($mapping['aspects'] ?? null) ? $this->mappingMapToLines($mapping['aspects']) : '';
         $locationKey = trim((string)($channel['location_key'] ?? ''));
         $html .= $this->ebayCategoryInput($mapping, $channel, $product);
         $html .= '<div class="col-md-4"><label class="form-label">Location-Key</label>'
            . '<input class="form-control form-control-sm" value="' . $this->h($locationKey) . '" placeholder="in Channel-Konfiguration setzen" readonly>'
            . '<div class="form-text">Kommt aus der eBay-Channel-Konfiguration.</div></div>';
         $html .= '<div class="col-md-4"><label class="form-label">Zustand</label><select class="form-select form-select-sm" name="mapping_condition">'
            . '<option value="NEW"' . ($condition === 'NEW' ? ' selected' : '') . '>Neu</option>'
            . '<option value="USED_EXCELLENT"' . ($condition === 'USED_EXCELLENT' ? ' selected' : '') . '>Gebraucht sehr gut</option>'
            . '<option value="USED_GOOD"' . ($condition === 'USED_GOOD' ? ' selected' : '') . '>Gebraucht gut</option>'
            . '</select></div>';
         $html .= $input('payment_policy_id', 'Payment-Policy-ID', (string)($mapping['payment_policy_id'] ?? $channel['payment_policy_id'] ?? ''), 'policy_payment_1234567890');
         $html .= $input('fulfillment_policy_id', 'Fulfillment-Policy-ID', (string)($mapping['fulfillment_policy_id'] ?? $channel['fulfillment_policy_id'] ?? ''), 'policy_fulfillment_1234567890');
         $html .= $input('return_policy_id', 'Return-Policy-ID', (string)($mapping['return_policy_id'] ?? $channel['return_policy_id'] ?? ''), 'policy_return_1234567890');
         $html .= $textarea('aspects', 'eBay Aspekte', $aspects, "Marke=dbxApp\nFarbe=Schwarz\nGroesse=L", 5);
      } elseif ($platform === 'amazon') {
         $simple = is_array($mapping['simple_attributes'] ?? null) ? $this->mappingMapToLines($mapping['simple_attributes']) : '';
         $html .= $input('productType', 'Amazon Product Type', (string)($mapping['productType'] ?? $mapping['product_type'] ?? ''), 'SOFTWARE / PRODUCT / SHIRT');
         $html .= '<div class="col-md-4"><label class="form-label">Requirements</label><select class="form-select form-select-sm" name="mapping_requirements">'
            . '<option value="LISTING"' . ((string)($mapping['requirements'] ?? 'LISTING') === 'LISTING' ? ' selected' : '') . '>Listing</option>'
            . '<option value="LISTING_PRODUCT_ONLY"' . ((string)($mapping['requirements'] ?? '') === 'LISTING_PRODUCT_ONLY' ? ' selected' : '') . '>Produktdaten</option>'
            . '<option value="LISTING_OFFER_ONLY"' . ((string)($mapping['requirements'] ?? '') === 'LISTING_OFFER_ONLY' ? ' selected' : '') . '>Offer</option>'
            . '</select></div>';
         $html .= $input('brand', 'Marke', (string)($mapping['simple_attributes']['brand'] ?? 'dbxApp'), 'dbxApp');
         $html .= $textarea('simple_attributes', 'Amazon Attribute', $simple, "manufacturer=dbxApp\nitem_type_keyword=software\nrecommended_browse_nodes=123456", 6);
         $html .= '<div class="col-12"><div class="form-text">Amazon verlangt je Product Type unterschiedliche Pflichtattribute. Diese Maske speichert einfache <code>key=value</code>-Werte und der Connector wandelt sie in SP-API Attribute um.</div></div>';
      } elseif ($platform === 'mobile') {
         $vehicle = is_array($mapping['mobile_vehicle'] ?? null) ? $mapping['mobile_vehicle'] : array();
         $html .= $input('vehicle_make', 'Marke', (string)($vehicle['make'] ?? ''), 'Volkswagen');
         $html .= $input('vehicle_model', 'Modell', (string)($vehicle['model'] ?? ''), 'Golf');
         $html .= $input('vehicle_first_registration', 'Erstzulassung', (string)($vehicle['firstRegistration'] ?? ''), '2023-05');
         $html .= $input('vehicle_mileage', 'Kilometer', (string)($vehicle['mileage'] ?? ''), '25000');
         $html .= $input('vehicle_fuel', 'Kraftstoff', (string)($vehicle['fuel'] ?? ''), 'PETROL');
         $html .= $input('vehicle_power', 'Leistung kW', (string)($vehicle['power'] ?? ''), '110');
         $html .= $input('vehicle_category', 'Fahrzeugart', (string)($vehicle['category'] ?? $channel['category_id'] ?? ''), 'car');
         $html .= $textarea('vehicle_extra', 'Weitere mobile.de Fahrzeugfelder', is_array($mapping['vehicle_extra'] ?? null) ? $this->mappingMapToLines($mapping['vehicle_extra']) : '', "gearbox=MANUAL\nemissionClass=EURO6", 5);
         $html .= '<div class="col-12"><div class="form-text">mobile.de ist nur fuer Fahrzeuganzeigen gedacht. Normale Shop-Artikel werden vom Connector bewusst blockiert.</div></div>';
      } elseif ($platform === 'kleinanzeigen') {
         $attrs = is_array($mapping['attributes'] ?? null) ? $this->mappingMapToLines($mapping['attributes']) : '';
         $html .= $input('category_id', 'Kategorie/Partner-Kategorie', (string)($mapping['category_id'] ?? $channel['category_id'] ?? ''), 'category_12345');
         $html .= $input('location', 'Ort/Standort', (string)($mapping['location'] ?? ''), '10115 Berlin');
         $html .= $input('contact_name', 'Kontaktname', (string)($mapping['contact_name'] ?? ''), 'Muster GmbH');
         $html .= $input('phone', 'Telefon', (string)($mapping['phone'] ?? ''), '+49...');
         $html .= $textarea('attributes', 'Kleinanzeigen/Middleware Attribute', $attrs, "zustand=neu\nversand=ja\nfarbe=schwarz", 5);
         $html .= '<div class="col-12"><div class="form-text">Ohne freigegebene Partner- oder Middleware-API wird kein automatischer Upload zu kleinanzeigen.de ausgefuehrt. Die Daten sind dann fuer manuelle Uebergabe vorbereitet.</div></div>';
      } else {
         $attrs = is_array($mapping['attributes'] ?? null) ? $this->mappingMapToLines($mapping['attributes']) : '';
         $html .= $input('endpoint_action', 'Aktion/Endpoint', (string)($mapping['endpoint_action'] ?? ''), 'products.upsert');
         $html .= $textarea('attributes', 'Middleware Attribute', $attrs, "external_category=123\nbrand=dbxApp", 6);
      }
      $html .= '</div>';
      return $html;
   }
 
   private function collectProductChannelMapping(string $platform, array $defaults = array()): array {
      if ($platform === 'ebay') {
         return array(
            'category_id' => trim((string)($_POST['mapping_category_id'] ?? '')),
            'condition' => trim((string)($_POST['mapping_condition'] ?? 'NEW')),
            'payment_policy_id' => trim((string)($_POST['mapping_payment_policy_id'] ?? '')),
            'fulfillment_policy_id' => trim((string)($_POST['mapping_fulfillment_policy_id'] ?? '')),
            'return_policy_id' => trim((string)($_POST['mapping_return_policy_id'] ?? '')),
            'aspects' => $this->mappingLinesToMap((string)($_POST['mapping_aspects'] ?? '')),
         );
      }
      if ($platform === 'amazon') {
         $simple = $this->mappingLinesToMap((string)($_POST['mapping_simple_attributes'] ?? ''));
         $brand = trim((string)($_POST['mapping_brand'] ?? ''));
         if ($brand !== '') {
            $simple['brand'] = $brand;
         }
         return array(
            'productType' => trim((string)($_POST['mapping_productType'] ?? '')),
            'requirements' => trim((string)($_POST['mapping_requirements'] ?? 'LISTING')),
            'simple_attributes' => $simple,
         );
      }
      if ($platform === 'mobile') {
         $vehicle = array(
            'make' => trim((string)($_POST['mapping_vehicle_make'] ?? '')),
            'model' => trim((string)($_POST['mapping_vehicle_model'] ?? '')),
            'firstRegistration' => trim((string)($_POST['mapping_vehicle_first_registration'] ?? '')),
            'mileage' => trim((string)($_POST['mapping_vehicle_mileage'] ?? '')),
            'fuel' => trim((string)($_POST['mapping_vehicle_fuel'] ?? '')),
            'power' => trim((string)($_POST['mapping_vehicle_power'] ?? '')),
            'category' => trim((string)($_POST['mapping_vehicle_category'] ?? '')),
         );
         $vehicle = array_filter($vehicle, fn($value) => trim((string)$value) !== '');
         return array(
            'mobile_vehicle' => $vehicle,
            'vehicle_extra' => $this->mappingLinesToMap((string)($_POST['mapping_vehicle_extra'] ?? '')),
         );
      }
      if ($platform === 'kleinanzeigen') {
         return array(
            'category_id' => trim((string)($_POST['mapping_category_id'] ?? '')),
            'location' => trim((string)($_POST['mapping_location'] ?? '')),
            'contact_name' => trim((string)($_POST['mapping_contact_name'] ?? '')),
            'phone' => trim((string)($_POST['mapping_phone'] ?? '')),
            'attributes' => $this->mappingLinesToMap((string)($_POST['mapping_attributes'] ?? '')),
         );
      }
      return array(
         'endpoint_action' => trim((string)($_POST['mapping_endpoint_action'] ?? '')),
         'attributes' => $this->mappingLinesToMap((string)($_POST['mapping_attributes'] ?? '')),
      );
   }
 
   private function normalizeDecimalInput($value): string {
      $value = str_replace(',', '.', trim((string)$value));
      if ($value === '') {
         return '';
      }
      return number_format((float)$value, 2, '.', '');
   }
 
   private function channelInheritedDecimalValue(string $postedName): string {
      $value = $this->normalizeDecimalInput($_POST[$postedName] ?? '');
      $inherited = (string)($_POST[$postedName . '_inherited'] ?? '') === '1';
      $inheritedValue = $this->normalizeDecimalInput($_POST[$postedName . '_inherited_value'] ?? '');
      if ($value === '') {
         return '-1';
      }
      if ($inherited && $inheritedValue !== '' && $value === $inheritedValue) {
         return '-1';
      }
      return $value;
   }
 
   private function channelMappingDisplayValues(array $product, array $productChannel): array {
      $storedPrice = (float)($productChannel['price_gross'] ?? -1);
      $storedShipping = (float)($productChannel['shipping_gross'] ?? -1);
      $inheritedPrice = number_format((float)($product['price_gross'] ?? 0), 2, '.', '');
      $inheritedShipping = number_format((float)($product['effective_shipping_gross'] ?? $product['shipping_gross'] ?? 0), 2, '.', '');
      $priceInherited = $storedPrice < 0;
      $shippingInherited = $storedShipping < 0;
 
      return array(
         'price_gross' => $priceInherited ? $inheritedPrice : number_format($storedPrice, 2, '.', ''),
         'shipping_gross' => $shippingInherited ? $inheritedShipping : number_format($storedShipping, 2, '.', ''),
         'price_gross_inherited' => $priceInherited ? '1' : '0',
         'price_gross_inherited_value' => $inheritedPrice,
         'shipping_gross_inherited' => $shippingInherited ? '1' : '0',
         'shipping_gross_inherited_value' => $inheritedShipping,
      );
   }
 
   private function productChannelMapping(): string {
      $this->ensureSeed();
      $productId = (int)dbx()->get_modul_var('id', 0, 'int');
      $channelKey = trim((string)dbx()->get_modul_var('channel', '', 'parameter'));
      if ($productId <= 0 || $channelKey === '') {
         return $this->frame('<div class="alert alert-warning m-3">Artikel oder Channel fehlt.</div>', 'Channel-Mapping');
      }
 
      $state = $this->repo()->productChannelMapping($productId, $channelKey);
      if (!$state) {
         return $this->frame('<div class="alert alert-warning m-3">Artikel oder Channel wurde nicht gefunden.</div>', 'Channel-Mapping');
      }
 
      $product = (array)$state['product'];
      $channel = (array)$state['channel'];
      $productChannel = (array)$state['product_channel'];
      $mapping = (array)$state['mapping'];
      $platform = (string)($channel['platform_type'] ?? 'custom');
      $mappingDefaults = $this->channelMappingInheritedDefaults($platform, $channel, $product);
      $mapping = $this->mergeMappingDefaults($mappingDefaults, $mapping);
      $message = '';
 
      if ($this->posted('save_channel_mapping')) {
         $saveProductId = (int)($_POST['product_id'] ?? $productId);
         $saveChannelKey = trim((string)($_POST['channel_key_ref'] ?? $channelKey));
         if ($saveProductId === $productId && $saveChannelKey === $channelKey) {
            $this->repo()->saveProductChannelMapping($productId, $channelKey, array(
               'active' => !empty($_POST['active']) ? 1 : 0,
               'channel_sku' => (string)($_POST['channel_sku'] ?? ''),
               'price_gross' => $this->channelInheritedDecimalValue('price_gross'),
               'shipping_gross' => $this->channelInheritedDecimalValue('shipping_gross'),
               'external_listing_id' => (string)($_POST['external_listing_id'] ?? ''),
               'external_offer_id' => (string)($_POST['external_offer_id'] ?? ''),
               'mapping' => $this->removeInheritedMappingDefaults($this->collectProductChannelMapping($platform, $mappingDefaults), $mappingDefaults),
            ));
            $message = 'Channel-Mapping gespeichert.';
            $state = $this->repo()->productChannelMapping($productId, $channelKey) ?: $state;
            $productChannel = (array)$state['product_channel'];
            $mapping = (array)$state['mapping'];
            $mappingDefaults = $this->channelMappingInheritedDefaults($platform, $channel, $product);
            $mapping = $this->mergeMappingDefaults($mappingDefaults, $mapping);
         }
      }
 
      $displayValues = $this->channelMappingDisplayValues($product, $productChannel);
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('shop-product-channel-mapping-' . $productId . '-' . $channelKey, 'shop-product-channel-mapping');
      $form->_dd = 'dbxShop|shopProductChannel';
      $form->_fd = 'dbxShop|shop-product-channel';
      $form->_data = array_merge($productChannel + array(
         'product_id' => $productId,
         'channel_key' => $channelKey,
         'active' => 1,
         'channel_sku' => (string)($product['sku'] ?? ''),
         'price_gross' => -1,
         'shipping_gross' => -1,
      ), array(
         'price_gross' => $displayValues['price_gross'],
         'shipping_gross' => $displayValues['shipping_gross'],
      ));
      $form->_rid = (int)($productChannel['id'] ?? 0);
      $form->_action = '?dbx_modul=dbxShop_admin&dbx_run1=product_channel_mapping&id=' . $productId . '&channel=' . rawurlencode($channelKey);
      if ((int)dbx()->get_modul_var('dbx_ajax', 0, 'int') === 1) {
         $form->_action .= '&dbx_ajax=1';
      }
      $form->set_activ_id((int)($productChannel['id'] ?? 0));
      $form->add_rep('shop_admin_style', $this->shopAdminStyle());
      $form->add_rep('bar_class', 'dbx-module-bar');
      $form->add_rep('bar_title_class', 'dbx-module-bar-titleblock');
      $form->add_rep('bar_actions_class', 'dbx-module-bar-actions');
      $form->add_rep('bar_icon', 'bi-sliders2');
      $form->add_rep('bar_title', 'Channel-Mapping');
      $form->add_rep('bar_subtitle', $this->h((string)($product['sku'] ?? '') . ' - ' . (string)($channel['title'] ?? $channelKey)));
      $form->add_rep('bar_actions', $this->helpButton($this->ensureShopProductChannelMappingHelpPage(), 'Hilfe: Channel-Mapping je Artikel', 'btn btn-outline-secondary btn-sm')
         . '<button class="btn btn-primary btn-sm" type="submit" title="Speichern"><i class="bi bi-save"></i> Speichern</button>'
         . '<a class="btn btn-outline-primary btn-sm dbxConfirm" href="?dbx_modul=dbxShop_admin&dbx_run1=product_edit&id=' . $productId . '&export_channel=' . rawurlencode($channelKey) . '&dbx_ajax=1" data-confirm-title="<i class=\'bi bi-broadcast\'></i> Channel exportieren" data-confirm="Artikel jetzt exportieren?" data-confirm-buttons="yesno" title="Exportieren"><i class="bi bi-broadcast"></i></a>');
      $form->add_rep('product_id', (string)$productId);
      $form->add_rep('channel_key', $this->h($channelKey));
      $form->add_rep('price_gross_inherited', $displayValues['price_gross_inherited']);
      $form->add_rep('price_gross_inherited_value', $displayValues['price_gross_inherited_value']);
      $form->add_rep('shipping_gross_inherited', $displayValues['shipping_gross_inherited']);
      $form->add_rep('shipping_gross_inherited_value', $displayValues['shipping_gross_inherited_value']);
      $form->add_rep('mapping_message', $message !== '' ? '<div class="alert alert-success mb-3">' . $this->h($message) . '</div>' : '');
      $form->add_rep('mapping_intro', $this->h('Hier werden die produktbezogenen Werte fuer diesen Channel gepflegt. Globale API-Zugangsdaten bleiben in der Channel-Verwaltung.'));
      $form->add_rep('provider_title', $this->h(($channel['title'] ?? $channelKey) . ' Mapping'));
      $form->add_rep('export_status_view', $this->productChannelExportStatusHtml($productChannel));
      $form->add_fld('active', label: 'Aktiv');
      $form->add_fld('channel_sku', label: 'Channel-SKU', placeholder: (string)($product['sku'] ?? ''));
      $form->add_fld('price_gross', label: 'Channel-Preis', placeholder: $displayValues['price_gross']);
      $form->add_fld('shipping_gross', label: 'Channel-Versand', placeholder: $displayValues['shipping_gross']);
      $form->add_fld('external_listing_id', label: 'Listing-ID');
      $form->add_fld('external_offer_id', label: 'Offer-ID');
      $form->add_obj('provider_mapping', 'obj-value', $this->providerMappingHtml($platform, $mapping, $channel, $product));
      return $form->run();
   }
 
   private function productChannelExportStatusHtml(array $productChannel): string {
      $status = trim((string)($productChannel['export_status'] ?? ''));
      $message = trim((string)($productChannel['export_message'] ?? ''));
      $listing = trim((string)($productChannel['external_listing_id'] ?? ''));
      $offer = trim((string)($productChannel['external_offer_id'] ?? ''));
      $date = trim((string)($productChannel['last_export_date'] ?? ''));
      $html = '<div class="d-flex flex-wrap gap-2 align-items-center">';
      $html .= '<span class="badge text-bg-' . ($status === 'failed' ? 'danger' : ($status !== '' ? 'info' : 'secondary')) . '">' . $this->h($status !== '' ? $status : 'nicht exportiert') . '</span>';
      if ($date !== '') $html .= '<span class="text-muted small">' . $this->h($date) . '</span>';
      if ($listing !== '') $html .= '<code>Listing: ' . $this->h($listing) . '</code>';
      if ($offer !== '') $html .= '<code>Offer: ' . $this->h($offer) . '</code>';
      $html .= '</div>';
      if ($message !== '') {
         $html .= '<div class="alert alert-secondary py-2 mt-2 mb-0">' . $this->h($message) . '</div>';
      }
      return $html;
   }
 
   private function posted(string $action): bool {
      return ($_SERVER['REQUEST_METHOD'] ?? '') === 'POST' && (string)($_POST['shop_action'] ?? '') === $action;
   }
 
   private function cmsEndpoint(string $run1, array $params = array()): string {
      $url = '?dbx_modul=dbxContent_admin&dbx_run1=' . rawurlencode($run1);
      foreach ($params as $key => $value) {
         $url .= '&' . rawurlencode((string)$key) . '=' . rawurlencode((string)$value);
      }
      return $url;
   }
 
   private function shopEndpoint(string $run1, array $params = array()): string {
      $url = '?dbx_modul=dbxShop_admin&dbx_run1=' . rawurlencode($run1);
      foreach ($params as $key => $value) {
         $url .= '&' . rawurlencode((string)$key) . '=' . rawurlencode((string)$value);
      }
      return $url;
   }
 
   private function readJsonPayload(): array {
      $raw = (string)file_get_contents('php://input');
      $data = $raw !== '' ? json_decode($raw, true) : null;
      if (is_array($data)) {
         return $data;
      }
      return $_POST;
   }
 
   private function ensureCmsShopMediaFolder(): void {
      if (!function_exists('dbx_get_file_dir')) {
         return;
      }
      $dir = rtrim((string)dbx_get_file_dir(), '/\\') . '/media/img/shop';
      if (!is_dir($dir)) {
         @mkdir($dir, 0775, true);
      }
   }
 
   private function jsonExit(array $data): string {
      if (!headers_sent()) {
         header('Content-Type: application/json; charset=utf-8');
      }
      echo json_encode($data, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES);
      exit;
   }
 
   private function assignMedia(): string {
      $payload = $this->readJsonPayload();
      $productId = (int)($payload['product_id'] ?? 0);
      $groupId = (int)($payload['group_id'] ?? 0);
      $mediaId = (int)($payload['media_id'] ?? $payload['id'] ?? 0);
      if ($mediaId <= 0 || ($productId <= 0 && $groupId <= 0)) {
         return $this->jsonExit(array('ok' => 0, 'msg' => 'Bitte Artikel oder Artikelgruppe und ein Medium auswaehlen.'));
      }
 
      $row = $this->repo()->saveMediaImage(
         $productId,
         $groupId,
         $mediaId,
         (string)($payload['title'] ?? ''),
         (string)($payload['alt'] ?? $payload['title'] ?? ''),
         !empty($payload['is_primary']) ? 1 : 0,
         (int)($payload['sorter'] ?? 100)
      );
      if (!$row) {
         return $this->jsonExit(array('ok' => 0, 'msg' => 'Bild konnte nicht zugeordnet werden.'));
      }
      $this->syncShopMediaUsage();
      return $this->jsonExit(array(
         'ok' => 1,
         'image' => $row,
         'url' => $this->mediaItemUrl($row, true),
      ));
   }
 
   private function productTreeMove(): string {
      $this->ensureSeed();
      $payload = $this->readJsonPayload();
      $type = (string)($payload['type'] ?? '');
      $targetGroupId = (int)($payload['target_group_id'] ?? 0);
 
      if ($type === 'product') {
         $productId = (int)($payload['product_id'] ?? 0);
         if ($productId <= 0 || $targetGroupId <= 0) {
            return $this->jsonExit(array('ok' => 0, 'msg' => 'Artikel und Zielgruppe sind erforderlich.'));
         }
         $count = $this->repo()->setProductGroupForProducts(array($productId), $targetGroupId);
         if ($count <= 0) {
            return $this->jsonExit(array('ok' => 0, 'msg' => 'Artikel konnte nicht verschoben werden.'));
         }
         return $this->jsonExit(array('ok' => 1, 'msg' => 'Artikelgruppe wurde zugeordnet.'));
      }
 
      if ($type === 'group') {
         $groupId = (int)($payload['group_id'] ?? 0);
         if ($groupId <= 0) {
            return $this->jsonExit(array('ok' => 0, 'msg' => 'Artikelgruppe ist erforderlich.'));
         }
         if (!$this->repo()->moveProductGroupParent($groupId, $targetGroupId)) {
            return $this->jsonExit(array('ok' => 0, 'msg' => 'Artikelgruppe konnte nicht verschoben werden. Pruefen Sie, ob dadurch ein Kreis entstehen wuerde.'));
         }
         return $this->jsonExit(array('ok' => 1, 'msg' => 'Artikelgruppe wurde verschoben.'));
      }
 
      return $this->jsonExit(array('ok' => 0, 'msg' => 'Unbekannte Drag-Drop-Aktion.'));
   }
 
   private function dashboard(): string {
      $stats = $this->repo()->dashboardStats();
      return $this->frame($this->tpl()->get_tpl('dbxShop_admin|admin-dashboard', array(
         'orders_open' => (string)($stats['orders_open'] ?? 0),
         'payments_open' => (string)($stats['payments_open'] ?? 0),
         'shipping_open' => (string)($stats['shipping_open'] ?? 0),
         'withdrawals_open' => (string)($stats['withdrawals_open'] ?? 0),
         'stock_low' => (string)($stats['stock_low'] ?? 0),
         'products_active' => (string)($stats['products_active'] ?? 0),
         'product_url' => '?dbx_modul=dbxShop_admin&dbx_run1=products',
         'order_url' => '?dbx_modul=dbxShop_admin&dbx_run1=orders',
         'group_url' => '?dbx_modul=dbxShop_admin&dbx_run1=groups',
         'attribute_url' => '?dbx_modul=dbxShop_admin&dbx_run1=attributes',
         'shipping_group_url' => '?dbx_modul=dbxShop_admin&dbx_run1=shipping_groups',
         'channel_group_url' => '?dbx_modul=dbxShop_admin&dbx_run1=channel_groups',
         'channel_url' => '?dbx_modul=dbxShop_admin&dbx_run1=channels',
         'media_url' => '?dbx_modul=dbxShop_admin&dbx_run1=media',
         'legal_url' => '?dbx_modul=dbxShop_admin&dbx_run1=legal',
         'return_url' => '?dbx_modul=dbxShop_admin&dbx_run1=returns',
      )));
   }
 
   private function placeholder(string $title, string $text): string {
      return $this->frame(
         '<div class="alert alert-info m-3"><strong>' . $this->h($title) . '</strong><br>' . $this->h($text) . '</div>',
         $title
      );
   }
 
   private function shopLegalCmsPage(string $key, string $title, string $intro, string $shopRun): string {
      $service = dbx()->get_include_obj('dbxShopService', 'dbxShop');
      $pages = is_object($service) && method_exists($service, 'ensureShopLegalPages')
         ? $service->ensureShopLegalPages()
         : array();
      $cid = (int)($pages[$key] ?? 0);
      if ($cid <= 0) {
         return $this->placeholder($title, 'Die CMS-Seite konnte nicht angelegt oder gefunden werden.');
      }
 
      $row = $this->db()->select1($this->contentDd(), $cid, 'id,title,permalink,content,group_read,template,activ', 0);
      if (!is_array($row) || (int)($row['id'] ?? 0) <= 0) {
         return $this->placeholder($title, 'Die CMS-Seite konnte nicht geladen werden.');
      }
 
      $editUrl = '?dbx_modul=dbxContent_admin&dbx_run1=cms&cid=' . $cid . '&dbx_ajax=1';
      $cmsViewUrl = '?dbx_modul=dbxContent&dbx_run1=content&cid=' . $cid . '&dbx_ajax=1';
      $shopViewUrl = '?dbx_modul=dbxShop&dbx_run1=' . rawurlencode($shopRun) . '&dbx_ajax=1';
      $permalink = (string)($row['permalink'] ?? '');
 
      $actions = $this->openWinButton($editUrl, $title . ' bearbeiten', '<i class="bi bi-pencil-square"></i><span> Bearbeiten</span>', 'btn btn-primary btn-sm me-1', '94%', '92%')
         . $this->openWinButton($cmsViewUrl, $title . ' CMS-Ansicht', '<i class="bi bi-file-richtext"></i><span class="visually-hidden"> CMS-Ansicht</span>', 'btn btn-outline-primary btn-sm me-1', '82%', '86%')
         . $this->openWinButton($shopViewUrl, $title . ' im Shop ansehen', '<i class="bi bi-box-arrow-up-right"></i><span class="visually-hidden"> Shop-Ansicht</span>', 'btn btn-outline-primary btn-sm me-1', '82%', '86%');
 
      $renderer = dbx()->get_include_obj('dbxContentRenderer', 'dbxContent');
      $preview = is_object($renderer) && method_exists($renderer, 'renderStatic')
         ? (string)$renderer->renderStatic($cid, array('template' => 'c-body1-footer', 'skip_hits' => true))
         : trim((string)($row['content'] ?? ''));
      if (trim($preview) === '') {
         $preview = '<div class="alert alert-warning">Die CMS-Seite ist leer.</div>';
      }
 
      $meta = '<dl class="dbx-shop-admin-cms-meta">'
         . '<dt>CMS-ID</dt><dd>' . $cid . '</dd>'
         . '<dt>Permalink</dt><dd><code>' . $this->h($permalink) . '</code></dd>'
         . '<dt>Status</dt><dd>' . ((int)($row['activ'] ?? 0) === 1 ? 'Aktiv' : 'Inaktiv') . '</dd>'
         . '<dt>Leserechte</dt><dd><code>' . $this->h((string)($row['group_read'] ?? '')) . '</code></dd>'
         . '<dt>Template</dt><dd><code>' . $this->h((string)($row['template'] ?? '')) . '</code></dd>'
         . '</dl>';
 
      $html = '<section class="dbx-shop-admin-cms-page">'
         . '<div class="alert alert-info"><strong>' . $this->h($title) . '</strong><br>' . $this->h($intro) . '</div>'
         . $meta
         . '<div class="dbx-shop-admin-cms-preview">' . $preview . '</div>'
         . '</section>';
 
      return $this->frame($html, $title, $actions);
   }
 
   private function settingsBool(array $cfg, string $key, bool $default = false): bool {
      if (!array_key_exists($key, $cfg)) {
         return $default;
      }
      $value = $cfg[$key];
      if (is_bool($value)) return $value;
      return in_array(strtolower(trim((string)$value)), array('1', 'true', 'yes', 'on'), true);
   }
 
   private function saveSettings(): void {
      $cfg = $this->shopConfig();
      $cfg['enabled'] = !empty($_POST['enabled']);
      $cfg['activ'] = $cfg['enabled'] ? '1' : '0';
      $cfg['default_channel'] = trim((string)($_POST['default_channel'] ?? 'shop')) ?: 'shop';
      $cfg['default_currency'] = strtoupper(substr(preg_replace('~[^A-Z]~i', '', (string)($_POST['default_currency'] ?? 'EUR')) ?: 'EUR', 0, 3));
      $cfg['price_display'] = in_array((string)($_POST['price_display'] ?? 'gross'), array('gross', 'net'), true) ? (string)$_POST['price_display'] : 'gross';
      $cfg['default_tax_class'] = in_array((string)($_POST['default_tax_class'] ?? 'mwst1'), array('mwst1', 'mwst2', 'mwst3'), true) ? (string)$_POST['default_tax_class'] : 'mwst1';
      $cfg['tax_display_enabled'] = (string)($_POST['tax_display_enabled'] ?? '1') !== '0';
 
      $rates = array();
      foreach (array('mwst1', 'mwst2', 'mwst3') as $key) {
         $title = trim((string)($_POST['tax_title_' . $key] ?? $key));
         $rate = str_replace(',', '.', trim((string)($_POST['tax_rate_' . $key] ?? '0')));
         $rates[$key] = array(
            'title' => $title !== '' ? $title : $key,
            'rate' => number_format((float)$rate, 2, '.', ''),
         );
      }
      $cfg['tax_rates'] = $rates;
 
      foreach (array(
         'b2b_mode',
         'stock_enabled',
         'channels_enabled',
         'checkout_guest_allowed',
         'legal_snapshot_enabled',
         'withdrawal_button_enabled',
         'mail_customer_enabled',
         'mail_admin_enabled',
         'payment_bank_transfer_enabled',
         'payment_invoice_enabled',
         'payment_paypal_enabled',
         'payment_amazon_pay_enabled',
         'delivery_digital_download_enabled',
         'delivery_flat_shipping_enabled',
      ) as $key) {
         $cfg[$key] = !empty($_POST[$key]);
      }
 
      $cfg['payment_bank_transfer_account_owner'] = trim((string)($_POST['payment_bank_transfer_account_owner'] ?? ''));
      $cfg['payment_bank_transfer_iban'] = trim((string)($_POST['payment_bank_transfer_iban'] ?? ''));
      $cfg['payment_bank_transfer_bic'] = trim((string)($_POST['payment_bank_transfer_bic'] ?? ''));
      $cfg['payment_bank_transfer_bank_name'] = trim((string)($_POST['payment_bank_transfer_bank_name'] ?? ''));
      $cfg['payment_bank_transfer_instructions'] = trim((string)($_POST['payment_bank_transfer_instructions'] ?? ''));
      $cfg['payment_invoice_instructions'] = trim((string)($_POST['payment_invoice_instructions'] ?? ''));
      $cfg['payment_paypal_mode'] = (string)($_POST['payment_paypal_mode'] ?? 'sandbox') === 'live' ? 'live' : 'sandbox';
      $cfg['payment_paypal_client_id'] = trim((string)($_POST['payment_paypal_client_id'] ?? ''));
      $cfg['payment_paypal_client_secret'] = trim((string)($_POST['payment_paypal_client_secret'] ?? ''));
      $cfg['payment_paypal_brand_name'] = trim((string)($_POST['payment_paypal_brand_name'] ?? 'dbXapp')) ?: 'dbXapp';
      $cfg['payment_paypal_currency'] = $cfg['default_currency'];
      $cfg['payment_amazon_pay_mode'] = (string)($_POST['payment_amazon_pay_mode'] ?? 'sandbox') === 'live' ? 'live' : 'sandbox';
      $cfg['payment_amazon_pay_region'] = in_array((string)($_POST['payment_amazon_pay_region'] ?? 'EU'), array('EU', 'UK', 'US'), true) ? (string)$_POST['payment_amazon_pay_region'] : 'EU';
      $cfg['payment_amazon_pay_merchant_id'] = trim((string)($_POST['payment_amazon_pay_merchant_id'] ?? ''));
      $cfg['payment_amazon_pay_store_id'] = trim((string)($_POST['payment_amazon_pay_store_id'] ?? ''));
      $cfg['payment_amazon_pay_public_key_id'] = trim((string)($_POST['payment_amazon_pay_public_key_id'] ?? ''));
      $cfg['payment_amazon_pay_private_key'] = trim((string)($_POST['payment_amazon_pay_private_key'] ?? ''));
      $cfg['payment_amazon_pay_sandbox_simulation_code'] = trim((string)($_POST['payment_amazon_pay_sandbox_simulation_code'] ?? ''));
      $cfg['mail_from'] = trim((string)($_POST['mail_from'] ?? ''));
      $cfg['mail_admin_to'] = trim((string)($_POST['mail_admin_to'] ?? ''));
 
      $flatShipping = str_replace(',', '.', trim((string)($_POST['delivery_flat_shipping_gross_price'] ?? '0')));
      $cfg['delivery_flat_shipping_gross_price'] = number_format((float)$flatShipping, 2, '.', '');
      $cfg['media_usage_slot'] = preg_replace('~[^a-z0-9_-]+~i', '', (string)($_POST['media_usage_slot'] ?? 'shop')) ?: 'shop';
 
      dbx()->set_config('dbxShop', $cfg);
   }
 
   private function settingsFormData(array $cfg): array {
      $rates = $this->taxRatesConfig();
      $data = $cfg;
      foreach (array('mwst1', 'mwst2', 'mwst3') as $key) {
         $rate = is_array($rates[$key] ?? null) ? $rates[$key] : array();
         $data['tax_title_' . $key] = (string)($rate['title'] ?? $key);
         $data['tax_rate_' . $key] = (string)($rate['rate'] ?? '0');
      }
 
      foreach (array(
         'enabled',
         'b2b_mode',
         'stock_enabled',
         'channels_enabled',
         'checkout_guest_allowed',
         'legal_snapshot_enabled',
         'withdrawal_button_enabled',
         'mail_customer_enabled',
         'mail_admin_enabled',
         'payment_bank_transfer_enabled',
         'payment_invoice_enabled',
         'payment_paypal_enabled',
         'payment_amazon_pay_enabled',
         'delivery_digital_download_enabled',
         'delivery_flat_shipping_enabled',
      ) as $key) {
         $data[$key] = $this->settingsBool($cfg, $key, in_array($key, array(
            'enabled',
            'checkout_guest_allowed',
            'legal_snapshot_enabled',
            'withdrawal_button_enabled',
            'mail_customer_enabled',
            'mail_admin_enabled',
            'payment_bank_transfer_enabled',
            'delivery_digital_download_enabled',
            'delivery_flat_shipping_enabled',
         ), true)) ? 1 : 0;
      }
 
      $data['default_channel'] = (string)($cfg['default_channel'] ?? 'shop');
      $data['channels_enabled'] = array_key_exists('channels_enabled', $cfg) ? (int)((bool)$cfg['channels_enabled']) : 1;
      $data['default_currency'] = (string)($cfg['default_currency'] ?? 'EUR');
      $data['price_display'] = (string)($cfg['price_display'] ?? 'gross');
      $data['default_tax_class'] = (string)($cfg['default_tax_class'] ?? 'mwst1');
      $data['tax_display_enabled'] = $this->settingsBool($cfg, 'tax_display_enabled', true) ? 1 : 0;
      $data['payment_paypal_mode'] = (string)($cfg['payment_paypal_mode'] ?? 'sandbox');
      $data['payment_paypal_brand_name'] = (string)($cfg['payment_paypal_brand_name'] ?? 'dbXapp');
      $data['payment_paypal_client_id'] = (string)($cfg['payment_paypal_client_id'] ?? '');
      $data['payment_paypal_client_secret'] = (string)($cfg['payment_paypal_client_secret'] ?? '');
      $data['payment_bank_transfer_account_owner'] = (string)($cfg['payment_bank_transfer_account_owner'] ?? '');
      $data['payment_bank_transfer_iban'] = (string)($cfg['payment_bank_transfer_iban'] ?? '');
      $data['payment_bank_transfer_bic'] = (string)($cfg['payment_bank_transfer_bic'] ?? '');
      $data['payment_bank_transfer_bank_name'] = (string)($cfg['payment_bank_transfer_bank_name'] ?? '');
      $data['payment_bank_transfer_instructions'] = (string)($cfg['payment_bank_transfer_instructions'] ?? 'Bitte ueberweisen Sie den Rechnungsbetrag unter Angabe der Bestellnummer.');
      $data['payment_invoice_instructions'] = (string)($cfg['payment_invoice_instructions'] ?? 'Sie erhalten eine Rechnung. Bitte zahlen Sie innerhalb der angegebenen Frist.');
      $data['payment_amazon_pay_mode'] = (string)($cfg['payment_amazon_pay_mode'] ?? 'sandbox');
      $data['payment_amazon_pay_region'] = (string)($cfg['payment_amazon_pay_region'] ?? 'EU');
      $data['payment_amazon_pay_merchant_id'] = (string)($cfg['payment_amazon_pay_merchant_id'] ?? '');
      $data['payment_amazon_pay_store_id'] = (string)($cfg['payment_amazon_pay_store_id'] ?? '');
      $data['payment_amazon_pay_public_key_id'] = (string)($cfg['payment_amazon_pay_public_key_id'] ?? '');
      $data['payment_amazon_pay_private_key'] = (string)($cfg['payment_amazon_pay_private_key'] ?? '');
      $data['payment_amazon_pay_sandbox_simulation_code'] = (string)($cfg['payment_amazon_pay_sandbox_simulation_code'] ?? '');
      $data['mail_from'] = (string)($cfg['mail_from'] ?? '');
      $data['mail_admin_to'] = (string)($cfg['mail_admin_to'] ?? '');
      $data['delivery_flat_shipping_gross_price'] = (string)($cfg['delivery_flat_shipping_gross_price'] ?? '5.90');
      $data['media_usage_slot'] = (string)($cfg['media_usage_slot'] ?? 'shop');
 
      return $data;
   }
 
   private function settingsChannelsStatusHtml(array $cfg): string {
      $channelsEnabled = $this->settingsBool($cfg, 'channels_enabled', true);
      $channels = $this->repo()->channels();
      $external = array();
      foreach ($channels as $channel) {
         $key = strtolower(trim((string)($channel['channel_key'] ?? '')));
         if ($key === '' || $key === 'shop') {
            continue;
         }
         if ((int)($channel['active'] ?? 0) !== 1) {
            continue;
         }
         $external[] = $channel;
      }
 
      $html = '<div class="dbx-shop-settings-channel-status">';
      $html .= '<div class="dbx-shop-settings-channel-head">';
      $html .= '<div><strong>Externe Channels</strong><span>' . ($channelsEnabled ? 'global aktiv' : 'global deaktiviert') . '</span></div>';
      $html .= $this->openWinButton('?dbx_modul=dbxShop_admin&dbx_run1=channels&dbx_ajax=1', 'Channels bearbeiten', '<i class="bi bi-broadcast"></i> Channels', 'btn btn-outline-primary btn-sm', '92%', '88%');
      $html .= '</div>';
 
      if (!$channelsEnabled) {
         $html .= '<div class="alert alert-warning py-2 mb-0">Channels sind global ausgeschaltet. Externe Channels werden dadurch nicht aktiv genutzt.</div>';
      }
 
      if ($external === array()) {
         $html .= '<div class="dbx-shop-settings-channel-empty">Keine aktiven externen Channels eingerichtet.</div>';
         return $html . '</div>';
      }
 
      $html .= '<div class="dbx-shop-settings-channel-grid">';
      $html .= '<div class="dbx-shop-settings-channel-grid-head"><span>Channel</span><span>Plattform</span><span>Verbindung</span><span>Export</span><span>Import</span><span>Test</span></div>';
      foreach ($external as $channel) {
         $test = trim((string)($channel['test_status'] ?? ''));
         $testClass = $test === 'ok' ? 'success' : ($test !== '' ? 'warning' : 'secondary');
         $html .= '<div class="dbx-shop-settings-channel-grid-row">';
         $html .= '<span class="dbx-shop-settings-channel-name"><strong>' . $this->h((string)($channel['title'] ?? $channel['channel_key'] ?? '')) . '</strong><code>' . $this->h((string)($channel['channel_key'] ?? '')) . '</code></span>';
         $html .= '<span>' . $this->h((string)($channel['platform_type'] ?? '')) . '</span>';
         $html .= '<span>' . $this->h((string)($channel['connection_mode'] ?? '')) . '</span>';
         $html .= ((int)($channel['export_enabled'] ?? 0) === 1 ? '<span class="badge text-bg-success">Export</span>' : '<span class="badge text-bg-secondary">Export aus</span>');
         $html .= ((int)($channel['order_import_enabled'] ?? 0) === 1 ? '<span class="badge text-bg-primary">Import</span>' : '<span class="badge text-bg-secondary">Import aus</span>');
         $html .= '<span class="badge text-bg-' . $testClass . '">' . $this->h($test !== '' ? $test : 'nicht getestet') . '</span>';
         $html .= '</div>';
      }
      $html .= '</div>';
      return $html . '</div>';
   }
 
   private function settings(): string {
      $helpId = $this->ensureShopSettingsHelpPage();
      $helpButton = $helpId > 0
         ? $this->openWinButton('?dbx_modul=dbxContent&dbx_run1=content&cid=' . $helpId . '&dbx_ajax=1', 'Hilfe: Shop-Einstellungen', '<i class="bi bi-question-circle"></i><span class="visually-hidden"> Hilfe</span>', 'btn btn-outline-secondary btn-sm me-1', '72%', '82%')
         : '';
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('shop-settings-form', 'shop-settings-form');
      $form->_fd = 'dbxShop_admin|shop-settings';
      $form->_action = '?dbx_modul=dbxShop_admin&dbx_run1=settings';
      $form->_data = $this->settingsFormData($this->shopConfig());
      $form->add_rep('shop_admin_style', $this->shopAdminStyle());
      $form->add_rep('form_class', 'dbx-shop-settings-dbXForm');
      $form->add_rep('bar_title', 'Einstellungen');
      $form->add_rep('bar_icon', 'bi-sliders');
      $form->add_rep('bar_subtitle', 'MwSt., Checkout, Zahlungsarten, Versand und Medien');
      $form->add_rep('bar_class', 'dbx-module-bar');
      $form->add_rep('bar_title_class', 'dbx-module-bar-titleblock');
      $form->add_rep('bar_title_pre', '');
      $form->add_rep('bar_title_heading_attrs', '');
      $form->add_rep('bar_middle', '');
      $form->add_rep('bar_actions_class', 'dbx-module-bar-actions');
      $form->add_rep('bar_extra', '');
      $form->add_obj('channels_status', 'obj-value', $this->settingsChannelsStatusHtml($this->shopConfig()));
      $paymentTestButton = $this->openWinButton('?dbx_modul=dbxShop_admin&dbx_run1=payment_test&dbx_ajax=1', 'Payment testen', '<i class="bi bi-plug"></i><span class="visually-hidden"> Payment testen</span>', 'btn btn-outline-primary btn-sm me-1', '64%', '58%');
      $form->add_rep('bar_actions', $paymentTestButton . '<button class="btn btn-primary btn-sm" type="submit" name="shop_action" value="save_settings" title="Speichern"><i class="bi bi-save"></i><span class="visually-hidden"> Speichern</span></button>' . $helpButton);
      $form->_msg_info = '';
      $form->_msg_success = 'Einstellungen gespeichert.';
      $form->_msg_error = 'Bitte Eingaben pruefen.';
      $form->add_flds();
 
      if ($form->submit()) {
         if (!$form->errors() && !$form->warnings()) {
            $this->saveSettings();
            $form->_data = $this->settingsFormData($this->shopConfig());
            $form->add_obj('channels_status', 'obj-value', $this->settingsChannelsStatusHtml($this->shopConfig()));
         }
      }
 
      return $form->run();
   }
 
   private function paymentTest(): string {
      $paypal = dbx()->get_include_obj('dbxShopPayPal', 'dbxShop');
      $amazonPay = dbx()->get_include_obj('dbxShopAmazonPay', 'dbxShop');
      $paypalResult = is_object($paypal) && method_exists($paypal, 'testConnection')
         ? $paypal->testConnection()
         : array('ok' => false, 'mode' => '', 'message' => 'PayPal-Connector konnte nicht geladen werden.');
      $amazonResult = is_object($amazonPay) && method_exists($amazonPay, 'testConnection')
         ? $amazonPay->testConnection()
         : array('ok' => false, 'mode' => '', 'region' => '', 'message' => 'Amazon-Pay-Connector konnte nicht geladen werden.');
 
      $card = function(string $title, string $icon, array $result): string {
         $ok = !empty($result['ok']);
         $badge = $ok
            ? '<span class="badge text-bg-success">OK</span>'
            : '<span class="badge text-bg-warning">Pruefen</span>';
         $meta = array();
         if (trim((string)($result['mode'] ?? '')) !== '') {
            $meta[] = 'Modus: ' . $this->h((string)$result['mode']);
         }
         if (trim((string)($result['region'] ?? '')) !== '') {
            $meta[] = 'Region: ' . $this->h((string)$result['region']);
         }
         return '<article class="dbx-shop-payment-test-card">'
            . '<header><h4><i class="bi ' . $this->h($icon) . '"></i> ' . $this->h($title) . '</h4>' . $badge . '</header>'
            . ($meta !== array() ? '<p class="dbx-shop-payment-test-meta">' . implode(' · ', $meta) . '</p>' : '')
            . '<p>' . $this->h((string)($result['message'] ?? 'Keine Rueckmeldung.')) . '</p>'
            . '</article>';
      };
 
      $body = '<section class="dbx-shop-payment-test">'
         . '<div class="alert alert-info mb-3"><strong>Payment-Test</strong><br>PayPal prueft die OAuth-Verbindung gegen Sandbox oder Live. Amazon Pay prueft lokal die Zugangsdaten und die RSA-PSS-Signatur; ein echter API-Checkout wird erst mit einer echten Amazon-Pay-Session ausgefuehrt.</div>'
         . $card('PayPal', 'bi-paypal', $paypalResult)
         . $card('Amazon Pay', 'bi-amazon', $amazonResult)
         . '<div class="dbx-shop-payment-test-links">'
         . '<a href="https://developer.paypal.com/dashboard/applications/" target="_blank" rel="noopener">PayPal Apps & Credentials</a>'
         . '<a href="https://developer.paypal.com/tools/sandbox/" target="_blank" rel="noopener">PayPal Sandbox</a>'
         . '<a href="https://sellercentral.amazon.de/" target="_blank" rel="noopener">Amazon Seller Central</a>'
         . '<a href="https://developer.amazon.com/docs/amazon-pay-api-v2/introduction.html" target="_blank" rel="noopener">Amazon Pay API v2</a>'
         . '</div>'
         . '</section>';
      return $this->frame($body, 'Payment testen');
   }
 
   private function install(): string {
      $this->repo()->seedDemoProducts();
      return $this->placeholder(
         'Shop-Installation ausgefuehrt',
         'dbxShop.db3 wurde angelegt bzw. aktualisiert. Deutsche Testartikel, Gruppen und Channel-Zuordnungen sind vorhanden.'
      );
   }
 
   private function products(): string {
      $this->ensureSeed();
      $this->syncShopMediaUsage();
      $report = dbx()->get_system_obj('dbxReport');
      $report->init('shop-products-report');
      $report->_action = '?dbx_modul=dbxShop_admin&dbx_run1=products';
      $report->_mode = 'table';
      $report->_pages = true;
      $report->_multi_page_select = 1;
      $report->_create_row_select = true;
      $report->_create_row_delete = true;
      $report->_create_row_edit = true;
      $report->_create_row_show = true;
      $report->_create_sel_flds = true;
      $report->_but_pagination = 7;
      $report->_fld_id = 'id';
      $report->_msg_confirm_delete = 'Diesen Artikel wirklich loeschen?';
      $report->_msg_info = 'Produkte suchen, pruefen und ueber Fenster bearbeiten.';
      $report->add_rep('bar_title', 'Produkte');
      $report->add_rep('bar_icon', 'bi-bag-check');
      $report->add_rep('bar_subtitle', 'Produkte, Bestellungen, Rechtstexte und Widerrufe');
      $report->add_rep('bar_class', 'dbx-module-bar');
      $report->add_rep('bar_title_class', 'dbx-module-bar-titleblock');
      $report->add_rep('bar_actions_class', 'dbx-module-bar-actions');
      $report->add_rep('bar_title_pre', $this->productTreeToggleButton());
      $report->add_rep('bar_title_heading_attrs', '');
      $report->add_rep('bar_middle', '');
      $report->add_rep('bar_extra', '');
      $report->add_rep('bar_actions', $this->productShellActions());
      $report->add_rep('shop_admin_style', $this->shopAdminStyle());
      $report->add_rep('report_form_class', 'dbx-shop-products-form is-shop-tree-collapsed');
      $report->add_rep('report_form_attrs', 'data-dbx="lib=shopAdmin" data-shop-tree-shell');
      $channelsEnabled = $this->channelsEnabled();
      $columnClasses = array(
         'image_view' => 'dbx-shop-col-image',
         'article_view' => 'dbx-shop-col-article',
         'groups_view' => 'dbx-shop-col-groups',
         'attributes_view' => 'dbx-shop-col-attributes',
         'shipping_groups_view' => 'dbx-shop-col-shipping-groups',
         'price_view' => 'dbx-shop-col-money',
         'tax_view' => 'dbx-shop-col-tax',
         'shipping_view' => 'dbx-shop-col-money',
         'status_view' => 'dbx-shop-col-status',
      );
      if ($channelsEnabled) {
         $columnClasses['channel_groups_view'] = 'dbx-shop-col-channel-groups';
         $columnClasses['channels_view'] = 'dbx-shop-col-channels';
      }
      foreach ($columnClasses as $field => $class) {
         $report->set_class_haeder($field, $class);
         $report->_class_body[$field] = $class;
      }
      $report->set_callback_owner($this);
      $report->set_callback('next_record', 'product_report_next_record');
      $report->set_callback('row_action_data', 'product_report_row_action_data');
      $report->add_rep('report_products_actions', $this->productReportActionControls($report->_action));
      $report->create_selection_fields('dbxShop_admin|rpt-products-selection');
      $this->handleProductReportAction($report);
 
      $query = trim((string)$report->get_fld_val('dbx_rwhere', '', 'parameter|max=100'));
      $requestedRowsPerPage = (int)$report->get_fld_val('dbx_rrows', 30, 'int');
      $rowsPerPage = $requestedRowsPerPage === 0 ? 0 : max(10, min(100, $requestedRowsPerPage));
      $position = $rowsPerPage === 0 ? 0 : max(0, (int)$report->get_fld_val('dbx_rpos', 0, 'int'));
      $sort = (string)$report->get_fld_val('dbx_rsort', 'sorter', 'parameter');
      $direction = strtoupper((string)$report->get_fld_val('dbx_rdesc', 'ASC', 'parameter')) === 'DESC' ? 'DESC' : 'ASC';
      $selectedOnly = (int)$report->get_fld_val('dbx_rselect', 0, 'int') === 1;
      if (!in_array($sort, array('sorter', 'sku', 'title', 'price_gross', 'effective_tax_rate', 'effective_shipping_gross', 'active'), true)) {
         $sort = 'sorter';
      }
 
      $allProducts = $this->repo()->products(false);
      $matchedProducts = array();
      $selectedIds = $selectedOnly ? $report->get_multi_selects() : array();
      foreach ($allProducts as $product) {
         if ($selectedOnly && !isset($selectedIds[(string)(int)($product['id'] ?? 0)])) {
            continue;
         }
         $score = $this->productSearchScore($product, $query);
         if ($score <= 0) {
            continue;
         }
         $product['_search_score'] = $score;
         $matchedProducts[] = $product;
      }
      $matchedProducts = $this->sortProductsForReport($matchedProducts, $query, $sort, $direction);
      $filteredCount = count($matchedProducts);
      if ($rowsPerPage > 0 && $position >= $filteredCount && $filteredCount > 0) {
         $position = max(0, (int)(floor(($filteredCount - 1) / $rowsPerPage) * $rowsPerPage));
      }
      $visibleProducts = $rowsPerPage === 0
         ? $matchedProducts
         : array_slice($matchedProducts, $position, $rowsPerPage);
 
      $report->_rflds = array(
         'image_view' => 'Bild',
         'article_view' => 'Artikel',
         'groups_view' => 'Artikelgruppen',
         'attributes_view' => 'Attribute',
         'shipping_groups_view' => 'Versandgruppen',
         'price_view' => 'Preis',
         'tax_view' => 'MwSt.',
         'shipping_view' => 'Versand',
         'status_view' => 'Status',
      );
      if ($channelsEnabled) {
         $report->_rflds = array_slice($report->_rflds, 0, 5, true)
            + array('channel_groups_view' => 'Channel-Gruppen', 'channels_view' => 'Channels')
            + array_slice($report->_rflds, 5, null, true);
      }
      $report->_rpt_format = array(
         'image_view' => 'html',
         'article_view' => 'html',
         'groups_view' => 'html',
         'attributes_view' => 'html',
         'shipping_groups_view' => 'html',
         'price_view' => 'html',
         'tax_view' => 'html',
         'shipping_view' => 'html',
         'status_view' => 'html',
      );
      if ($channelsEnabled) {
         $report->_rpt_format['channel_groups_view'] = 'html';
         $report->_rpt_format['channels_view'] = 'html';
      }
      $report->_rrows = $rowsPerPage;
      $report->_rpos = $position;
      $report->_count_all = count($allProducts);
      $report->_rcount = $filteredCount;
      $report->_rdata = $visibleProducts;
 
      $report->add_rep('product_tree_panel', $this->productTreePanel($allProducts));
      $content = $report->run();
      if ($filteredCount === 0) {
         $content .= '<div class="alert alert-info mx-3">Keine Produkte fuer diese Suche gefunden.</div>';
      }
 
      return $content;
   }
 
   private function productEdit(): string {
      $this->ensureSeed();
      $id = (int)dbx()->get_modul_var('id', 0, 'int');
      $isNew = $id <= 0;
      $exportNotice = '';
      $exportOk = false;
      $removeImageId = (int)dbx()->get_modul_var('remove_image', 0, 'int');
      if (!$isNew && $removeImageId > 0) {
         $this->repo()->removeProductImageAssociation($removeImageId, $id);
         $this->syncShopMediaUsage();
      }
      $exportChannel = trim((string)dbx()->get_modul_var('export_channel', '', 'parameter'));
      if (!$isNew && $exportChannel !== '') {
         $result = $this->repo()->exportProductToChannel($id, $exportChannel);
         $exportOk = !empty($result['ok']);
         $exportNotice = (string)($result['message'] ?? '');
      }
      $data = $isNew ? $this->applyProductPreset($this->newProductDefaults()) : $this->repo()->productById($id);
 
      if (!$isNew && !is_array($data)) {
         return $this->frame('<div class="alert alert-warning m-3">Artikel nicht gefunden.</div>', 'Artikel bearbeiten', $this->productBarActions());
      }
 
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('shop-product-form', 'shop-product-form');
      $form->_dd = 'dbxShop|shopProduct';
      $form->_fd = 'dbxShop|shop-product';
      $form->_data = $data;
      $form->_rid = $isNew ? 0 : $id;
      $form->_action = '?dbx_modul=dbxShop_admin&dbx_run1=product_edit&id=' . ($isNew ? 0 : $id);
      if ((int)dbx()->get_modul_var('dbx_ajax', 0, 'int') === 1) {
         $form->_action .= '&dbx_ajax=1';
      }
      $form->set_activ_id($isNew ? 0 : $id);
      $form->add_rep('bar_title', $isNew ? 'Neuer Artikel' : 'Artikel bearbeiten');
      $form->add_rep('bar_icon', 'bi-bag-check');
      $form->add_rep('bar_subtitle', $isNew ? 'Stammdaten anlegen' : trim((string)($data['sku'] ?? '') . ' - ' . (string)($data['title'] ?? '')));
      $form->add_rep('bar_class', 'dbx-module-bar');
      $form->add_rep('bar_title_class', 'dbx-module-bar-titleblock');
      $form->add_rep('bar_title_pre', '');
      $form->add_rep('bar_title_heading_attrs', '');
      $form->add_rep('bar_middle', '');
      $form->add_rep('bar_actions_class', 'dbx-module-bar-actions');
      $form->add_rep('bar_actions', $this->productFormActions($id));
      $form->add_rep('bar_extra', '');
      $form->add_rep('shop_admin_style', $this->shopAdminStyle());
      $form->_msg_info = 'Artikel-Stammdaten bearbeiten. Gruppen, Attribute und Bilder werden ueber die jeweiligen Shop-Admin-Funktionen gepflegt.';
      if ($exportNotice !== '') {
         if ($exportOk) {
            $form->_msg_success = $exportNotice;
         } else {
            $form->_msg_error = $exportNotice;
         }
      }
      $form->add_flds();
      $form->add_fld('product_group_id', tpl: 'select-single-label', label: 'Artikelgruppe', options: $this->productGroupOptions(0, false), rules: 'int');
 
      if ($form->submit()) {
         if (!$form->errors()) {
            $ok = $form->save_post('dbxShop|shopProduct', $isNew ? 'new' : $id, $this->productFormDefaults($id));
            if ($ok) {
               $savedId = (int)$form->_rid;
               $groupId = (int)($_POST['product_group_id'] ?? 0);
               if ($savedId > 0 && $groupId > 0) {
                  $this->repo()->setProductGroupForProducts(array($savedId), $groupId);
               }
               if ($savedId > 0 && isset($_POST['product_channel_editor'])) {
                  $this->repo()->saveProductChannelOverrides($savedId, (array)($_POST['product_channels'] ?? array()));
               }
               $form->_msg_success = 'Artikel gespeichert.';
               if ($savedId > 0) {
                  $id = $savedId;
                  $isNew = false;
                  $data = $this->repo()->productById($savedId) ?: $form->_data;
                  $form->_action = '?dbx_modul=dbxShop_admin&dbx_run1=product_edit&id=' . $savedId;
                  if ((int)dbx()->get_modul_var('dbx_ajax', 0, 'int') === 1) {
                     $form->_action .= '&dbx_ajax=1';
                  }
               }
            } else {
               $form->_msg_error = 'Artikel konnte nicht gespeichert werden. Bitte pruefen Sie insbesondere SKU und URL-Name.';
            }
         } else {
            $form->_msg_error = 'Bitte Eingaben pruefen.';
         }
      }
 
      $form->add_obj('product_images', 'obj-value', $this->productImagesPanel(is_array($data) ? $data : array(), $isNew));
      $form->add_obj('product_channels', 'obj-value', $this->productChannelsPanel(is_array($data) ? $data : array(), $isNew));
 
      return $form->run();
   }
 
   private function productsHelp(): string {
      $helpId = $this->ensureShopProductsHelpPage();
      if ($helpId > 0) {
         return $this->frame('<div class="m-3">' . $this->productsHelpHtml() . '</div>', 'Produkte Hilfe', $this->productBarActions());
      }
      return $this->frame('<div class="alert alert-warning m-3">Hilfe konnte nicht angelegt werden.</div>', 'Produkte Hilfe', $this->productBarActions());
   }
 
   private function orderStatusOptions(): array {
      return array(
         'new' => 'Neu',
         'payment_pending' => 'Zahlung offen',
         'paid' => 'Bezahlt',
         'processing' => 'In Bearbeitung',
         'shipped' => 'Versendet',
         'done' => 'Abgeschlossen',
         'cancelled' => 'Storniert',
      );
   }
 
   private function paymentStatusOptions(): array {
      return array(
         'open' => 'Offen',
         'created' => 'Erstellt',
         'pending' => 'In Pruefung',
         'completed' => 'Abgeschlossen',
         'paid' => 'Bezahlt',
         'failed' => 'Fehlgeschlagen',
         'cancelled' => 'Abgebrochen',
         'refunded' => 'Erstattet',
      );
   }
 
   private function shippingStatusOptions(): array {
      return array(
         'open' => 'Offen',
         'ready' => 'Bereit',
         'shipped' => 'Versendet',
         'delivered' => 'Zugestellt',
         'returned' => 'Retoure',
      );
   }
 
   private function orderStatusBadge(string $status): string {
      $labels = $this->orderStatusOptions();
      $classes = array(
         'new' => 'text-bg-secondary',
         'payment_pending' => 'text-bg-warning',
         'paid' => 'text-bg-success',
         'processing' => 'text-bg-info',
         'shipped' => 'text-bg-primary',
         'done' => 'text-bg-success',
         'cancelled' => 'text-bg-danger',
      );
      return '<span class="badge ' . $this->h($classes[$status] ?? 'text-bg-secondary') . '">' . $this->h($labels[$status] ?? $status) . '</span>';
   }
 
   private function paymentStatusBadge(string $status): string {
      $labels = $this->paymentStatusOptions();
      $classes = array(
         'open' => 'text-bg-secondary',
         'created' => 'text-bg-info',
         'pending' => 'text-bg-warning',
         'completed' => 'text-bg-success',
         'paid' => 'text-bg-success',
         'failed' => 'text-bg-danger',
         'cancelled' => 'text-bg-danger',
         'refunded' => 'text-bg-dark',
      );
      return '<span class="badge ' . $this->h($classes[$status] ?? 'text-bg-secondary') . '">' . $this->h($labels[$status] ?? $status) . '</span>';
   }
 
   private function shippingStatusBadge(string $status): string {
      $labels = $this->shippingStatusOptions();
      $classes = array(
         'open' => 'text-bg-secondary',
         'ready' => 'text-bg-info',
         'shipped' => 'text-bg-primary',
         'delivered' => 'text-bg-success',
         'returned' => 'text-bg-warning',
      );
      return '<span class="badge ' . $this->h($classes[$status] ?? 'text-bg-secondary') . '">' . $this->h($labels[$status] ?? $status) . '</span>';
   }
 
   private function channelLabel(string $channel): string {
      $labels = array(
         'shop' => 'Shop',
         'web' => 'Web',
         'amazon' => 'Amazon',
         'ebay' => 'eBay',
         'kleinanzeigen' => 'Kleinanzeigen',
         'mobile' => 'mobile.de',
      );
      return $labels[$channel] ?? $channel;
   }
 
   private function paymentProviderLabel(string $provider): string {
      $labels = array(
         'bank_transfer' => 'Vorkasse / Ueberweisung',
         'invoice' => 'Rechnung',
         'paypal' => 'PayPal',
         'amazon_pay' => 'Amazon Pay',
      );
      return $labels[$provider] ?? $this->channelLabel($provider);
   }
 
   private function channelBadge(string $channel): string {
      $class = in_array($channel, array('shop', 'web', ''), true) ? 'text-bg-secondary' : 'text-bg-info';
      $text = $channel === '' ? 'Shop' : $this->channelLabel($channel);
      return '<span class="badge ' . $class . '">' . $this->h($text) . '</span>';
   }
 
   private function orderActions(): string {
      $helpId = $this->ensureShopOrdersHelpPage();
      $helpButton = $helpId > 0
         ? $this->openWinButton('?dbx_modul=dbxContent&dbx_run1=content&cid=' . $helpId . '&dbx_ajax=1', 'Hilfe: Bestellungen', '<i class="bi bi-question-circle"></i><span class="visually-hidden"> Hilfe</span>', 'btn btn-outline-secondary btn-sm me-1', '72%', '82%')
         : '';
      return $helpButton;
   }
 
   private function handleOrderAction($report): void {
      $deleteId = (int)dbx()->get_modul_var('delete_order', 0, 'int');
      if ($deleteId <= 0) {
         return;
      }
      if ($this->repo()->deleteOrder($deleteId)) {
         $report->_msg_success = 'Bestellung wurde in den Papierkorb verschoben.';
      } else {
         $report->_msg_error = 'Bestellung konnte nicht geloescht werden.';
      }
   }
 
   public function order_report_next_record($report, $record) {
      $id = (int)($record['id'] ?? 0);
      $orderNo = (string)($record['order_no'] ?? '');
      $created = (string)($record['create_date'] ?? '');
      $channel = (string)($record['channel_key'] ?? 'shop');
      $items = (array)($record['items'] ?? array());
      $itemLines = '';
      foreach ($items as $item) {
         $itemLines .= '<div>' . (int)($item['qty'] ?? 0) . 'x <strong>' . $this->h($item['title'] ?? '') . '</strong> <code>' . $this->h($item['sku'] ?? '') . '</code></div>';
      }
      if ($itemLines === '') {
         $itemLines = '<span class="text-muted">Keine Positionen</span>';
      }
      $detailUrl = '?dbx_modul=dbxShop_admin&dbx_run1=order_detail&id=' . $id . '&dbx_ajax=1';
      $deleteUrl = '?dbx_modul=dbxShop_admin&dbx_run1=orders&delete_order=' . $id;
 
      $externalId = trim((string)($record['payment_reference'] ?? ''));
      $sourceText = in_array($channel, array('', 'shop', 'web'), true) ? 'Shop-Bestellung' : 'Channel-Bestellung';
      $record['order_view'] = '<div class="dbx-shop-order-main"><strong>' . $this->h($orderNo) . '</strong><small>' . $this->h($created) . '</small><span class="dbx-shop-order-source">' . $this->channelBadge($channel) . '<small>' . $this->h($sourceText) . '</small></span>' . ($externalId !== '' ? '<small>Extern: ' . $this->h($externalId) . '</small>' : '') . '</div>';
      $record['customer_view'] = '<div class="dbx-shop-order-customer"><strong>' . $this->h($record['customer_name'] ?? '') . '</strong><small>' . $this->h($record['customer_email'] ?? '') . '</small></div>';
      $record['items_view'] = '<div class="dbx-shop-order-items-small">' . $itemLines . '</div>';
      $record['status_view'] = '<div class="dbx-shop-order-status-stack">'
         . '<span><small>Bestellung</small>' . $this->orderStatusBadge((string)($record['status'] ?? 'new')) . '</span>'
         . '<span><small>Versand</small>' . $this->shippingStatusBadge((string)($record['shipping_status'] ?? 'open')) . '</span>'
         . '</div>';
      $record['payment_view'] = '<div class="dbx-shop-order-payment">' . $this->paymentStatusBadge((string)($record['payment_status'] ?? 'open')) . '<small>' . $this->h($this->paymentProviderLabel((string)($record['payment_provider'] ?? ''))) . '</small><small>' . $this->h($record['payment_reference'] ?? '') . '</small></div>';
      $record['total_view'] = $this->money($record['total_gross'] ?? 0);
      $record['actions_view'] = '<span class="dbx-shop-order-actions">'
         . $this->openWinButton($detailUrl, 'Bestellung bearbeiten: ' . $orderNo, '<i class="bi bi-pencil-square"></i><span class="visually-hidden"> Bearbeiten</span>', 'btn btn-outline-primary btn-sm', '86%', '88%')
         . '<a class="btn btn-outline-danger btn-sm dbxConfirm" href="' . $this->h($deleteUrl) . '" data-confirm-title="<i class=\'bi bi-trash\'></i> Bestellung loeschen" data-confirm="Diese Bestellung wirklich in den Papierkorb verschieben?" data-confirm-hint="<small>Die Bestellung wird nicht physisch entfernt, sondern nur ausgeblendet.</small>" data-confirm-buttons="yesno" title="Bestellung loeschen"><i class="bi bi-trash"></i><span class="visually-hidden"> Loeschen</span></a>'
         . '</span>';
      return $record;
   }
 
   private function orders(): string {
      $this->ensureSeed();
      $report = dbx()->get_system_obj('dbxReport');
      $report->init('shop-orders-report');
      $report->_action = '?dbx_modul=dbxShop_admin&dbx_run1=orders';
      $report->_mode = 'table';
      $report->_pages = true;
      $report->_create_sel_flds = true;
      $report->_but_pagination = 7;
      $report->_fld_id = 'id';
      $report->_msg_info = 'Bestellungen suchen, pruefen und Status bearbeiten.';
      $report->add_rep('bar_title', 'Bestellungen');
      $report->add_rep('bar_icon', 'bi-receipt');
      $report->add_rep('bar_subtitle', 'Shop- und Channel-Bestellungen');
      $report->add_rep('bar_class', 'dbx-module-bar');
      $report->add_rep('bar_title_class', 'dbx-module-bar-titleblock');
      $report->add_rep('bar_actions_class', 'dbx-module-bar-actions');
      $report->add_rep('bar_title_pre', '');
      $report->add_rep('bar_title_heading_attrs', '');
      $report->add_rep('bar_middle', '');
      $report->add_rep('bar_extra', '');
      $report->add_rep('bar_actions', $this->orderActions());
      $report->add_rep('shop_admin_style', $this->shopAdminStyle());
      foreach (array(
         'order_view' => 'dbx-shop-col-order',
         'customer_view' => 'dbx-shop-col-customer',
         'items_view' => 'dbx-shop-col-items',
         'status_view' => 'dbx-shop-col-status',
         'payment_view' => 'dbx-shop-col-payment',
         'total_view' => 'dbx-shop-col-total',
         'actions_view' => 'dbx-shop-col-actions',
      ) as $field => $class) {
         $report->set_class_haeder($field, $class);
         $report->_class_body[$field] = $class;
      }
      $report->set_callback_owner($this);
      $report->set_callback('next_record', 'order_report_next_record');
      $report->create_selection_fields('dbxShop_admin|rpt-orders-selection');
      $this->handleOrderAction($report);
 
      $query = trim((string)$report->get_fld_val('dbx_rwhere', '', 'parameter|max=120'));
      $requestedRowsPerPage = (int)$report->get_fld_val('dbx_rrows', 30, 'int');
      $rowsPerPage = $requestedRowsPerPage === 0 ? 0 : max(10, min(100, $requestedRowsPerPage));
      $position = $rowsPerPage === 0 ? 0 : max(0, (int)$report->get_fld_val('dbx_rpos', 0, 'int'));
      $sort = (string)$report->get_fld_val('dbx_rsort', 'create_date', 'parameter');
      $direction = strtoupper((string)$report->get_fld_val('dbx_rdesc', 'DESC', 'parameter')) === 'ASC' ? 'ASC' : 'DESC';
      $filters = array(
         'query' => $query,
         'status' => trim((string)$report->get_fld_val('status', '', 'parameter')),
         'payment_status' => trim((string)$report->get_fld_val('payment_status', '', 'parameter')),
         'shipping_status' => trim((string)$report->get_fld_val('shipping_status', '', 'parameter')),
         'channel_key' => trim((string)$report->get_fld_val('channel_key', '', 'parameter')),
      );
 
      $filteredCount = $this->repo()->orderCount($filters);
      if ($rowsPerPage > 0 && $position >= $filteredCount && $filteredCount > 0) {
         $position = max(0, (int)(floor(($filteredCount - 1) / $rowsPerPage) * $rowsPerPage));
      }
      $orders = $this->repo()->orders($filters, $rowsPerPage, $position, $sort, $direction);
 
      $report->_rflds = array(
         'order_view' => 'Bestellung',
         'customer_view' => 'Kunde',
         'items_view' => 'Positionen',
         'status_view' => 'Status',
         'payment_view' => 'Zahlung',
         'total_view' => 'Summe',
         'actions_view' => 'Aktion',
      );
      $report->_rpt_format = array(
         'order_view' => 'html',
         'customer_view' => 'html',
         'items_view' => 'html',
         'status_view' => 'html',
         'payment_view' => 'html',
         'total_view' => 'html',
         'actions_view' => 'html',
      );
      $report->_rrows = $rowsPerPage;
      $report->_rpos = $position;
      $report->_count_all = $this->repo()->orderCount(array());
      $report->_rcount = $filteredCount;
      $report->_rdata = $orders;
 
      $content = $report->run();
      if ($filteredCount === 0) {
         $content .= '<div class="alert alert-info mx-3">Keine Bestellungen fuer diese Suche gefunden.</div>';
      }
      return $content;
   }
 
   public function withdrawal_report_next_record($report, $record) {
      if (!is_array($record)) {
         return $record;
      }
      $record['request_view'] = '<div><strong>' . $this->h($record['order_no'] ?? 'Ohne Bestellnummer') . '</strong><br><small>' . $this->h($record['create_date'] ?? '') . '</small></div>';
      $record['customer_view'] = '<div><strong>' . $this->h($record['customer_name'] ?? '') . '</strong><br><small>' . $this->h($record['customer_email'] ?? '') . '</small></div>';
      $record['message_view'] = '<div class="small">' . nl2br($this->h($record['reason'] ?? '')) . '</div>';
      $status = (string)($record['status'] ?? '');
      $badge = in_array($status, array('accepted', 'refunded', 'closed'), true) ? 'text-bg-success' : (in_array($status, array('rejected'), true) ? 'text-bg-danger' : 'text-bg-warning');
      $record['status_view'] = '<span class="badge ' . $badge . '">' . $this->h($status) . '</span>';
      $id = (int)($record['id'] ?? 0);
      $base = '?dbx_modul=dbxShop_admin&dbx_run1=returns&withdrawal_id=' . $id . '&withdrawal_status=';
      $record['actions_view'] =
         '<div class="btn-group btn-group-sm" role="group">'
         . '<a class="btn btn-outline-secondary" href="' . $base . 'processing" title="In Bearbeitung"><i class="bi bi-hourglass-split"></i></a>'
         . '<a class="btn btn-outline-success dbxConfirm" href="' . $base . 'accepted" data-confirm-title="Widerruf annehmen" data-confirm="Widerruf annehmen und reservierten Bestand zurueckbuchen?" data-confirm-buttons="yesno" title="Annehmen"><i class="bi bi-check2"></i></a>'
         . '<a class="btn btn-outline-primary dbxConfirm" href="' . $base . 'refunded" data-confirm-title="Widerruf erstatten" data-confirm="Widerruf als erstattet markieren und reservierten Bestand zurueckbuchen?" data-confirm-buttons="yesno" title="Erstattet"><i class="bi bi-cash-coin"></i></a>'
         . '<a class="btn btn-outline-danger" href="' . $base . 'rejected" title="Ablehnen"><i class="bi bi-x-lg"></i></a>'
         . '<a class="btn btn-outline-secondary" href="' . $base . 'closed" title="Schliessen"><i class="bi bi-archive"></i></a>'
         . '</div>';
      return $record;
   }
 
   private function returns(): string {
      $this->ensureSeed();
      $withdrawalId = (int)dbx()->get_modul_var('withdrawal_id', 0, 'int');
      $withdrawalStatus = (string)dbx()->get_modul_var('withdrawal_status', '', 'parameter');
      if ($withdrawalId > 0 && $withdrawalStatus !== '') {
         $this->repo()->updateWithdrawalAdmin($withdrawalId, $withdrawalStatus);
      }
      $report = dbx()->get_system_obj('dbxReport');
      $report->init('shop-orders-report');
      $report->_action = '?dbx_modul=dbxShop_admin&dbx_run1=returns';
      $report->_mode = 'table';
      $report->_pages = true;
      $report->_create_sel_flds = true;
      $report->_but_pagination = 7;
      $report->_fld_id = 'id';
      $report->_msg_info = 'Eingegangene Widerrufe suchen und bearbeiten.';
      $report->add_rep('bar_title', 'Widerrufe');
      $report->add_rep('bar_icon', 'bi-arrow-counterclockwise');
      $report->add_rep('bar_subtitle', 'Widerrufe und Retouren aus dem Shop');
      $report->add_rep('bar_class', 'dbx-module-bar');
      $report->add_rep('bar_title_class', 'dbx-module-bar-titleblock');
      $report->add_rep('bar_actions_class', 'dbx-module-bar-actions');
      $report->add_rep('bar_title_pre', '');
      $report->add_rep('bar_title_heading_attrs', '');
      $report->add_rep('bar_middle', '');
      $report->add_rep('bar_extra', '');
      $shopService = dbx()->get_include_obj('dbxShopService', 'dbxShop');
      $pages = is_object($shopService) && method_exists($shopService, 'ensureShopLegalPages') ? $shopService->ensureShopLegalPages() : array();
      $withdrawalCid = (int)($pages['withdrawal'] ?? 0);
      $cmsButton = $withdrawalCid > 0
         ? $this->openWinButton('?dbx_modul=dbxContent_admin&dbx_run1=cms&cid=' . $withdrawalCid . '&dbx_ajax=1', 'Widerrufstext bearbeiten', '<i class="bi bi-pencil-square"></i><span class="visually-hidden"> CMS bearbeiten</span>', 'btn btn-outline-primary btn-sm me-1', '94%', '92%')
         : '';
      $report->add_rep('bar_actions',
         $cmsButton
         . $this->openWinButton('?dbx_modul=dbxShop&dbx_run1=withdrawal&dbx_ajax=1', 'Widerrufsseite ansehen', '<i class="bi bi-box-arrow-up-right"></i><span class="visually-hidden"> Shop-Ansicht</span>', 'btn btn-outline-primary btn-sm me-1', '82%', '86%')
      );
      $report->add_rep('shop_admin_style', $this->shopAdminStyle());
      $report->set_callback_owner($this);
      $report->set_callback('next_record', 'withdrawal_report_next_record');
      $report->create_selection_fields('dbxShop_admin|rpt-withdrawals-selection');
 
      $query = trim((string)$report->get_fld_val('dbx_rwhere', '', 'parameter|max=120'));
      $rowsPerPage = (int)$report->get_fld_val('dbx_rrows', 30, 'int');
      $rowsPerPage = $rowsPerPage === 0 ? 0 : max(10, min(100, $rowsPerPage));
      $position = $rowsPerPage === 0 ? 0 : max(0, (int)$report->get_fld_val('dbx_rpos', 0, 'int'));
      $filters = array(
         'query' => $query,
         'status' => trim((string)$report->get_fld_val('status', '', 'parameter')),
      );
      $filteredCount = $this->repo()->withdrawalCount($filters);
      $rows = $this->repo()->withdrawals($filters, $rowsPerPage, $position);
 
      $report->_rflds = array(
         'request_view' => 'Widerruf',
         'customer_view' => 'Kunde',
         'message_view' => 'Nachricht',
         'status_view' => 'Status',
         'actions_view' => 'Aktion',
      );
      $report->_rpt_format = array(
         'request_view' => 'html',
         'customer_view' => 'html',
         'message_view' => 'html',
         'status_view' => 'html',
         'actions_view' => 'html',
      );
      $report->_rrows = $rowsPerPage;
      $report->_rpos = $position;
      $report->_count_all = $this->repo()->withdrawalCount(array());
      $report->_rcount = $filteredCount;
      $report->_rdata = $rows;
 
      $content = $report->run();
      if ($filteredCount === 0) {
         $content .= '<div class="alert alert-info mx-3">Keine Widerrufe fuer diese Suche gefunden.</div>';
      }
      return $content;
   }
 
   private function orderMetaHtml(array $order): string {
      $rows = array(
         'Bestellnummer' => $order['order_no'] ?? '',
         'Erstellt' => $order['create_date'] ?? '',
         'Kunde' => trim((string)($order['customer_name'] ?? '') . ' <' . (string)($order['customer_email'] ?? '') . '>'),
         'Telefon' => $order['customer_phone'] ?? '',
         'Lieferadresse' => $order['shipping_address'] ?? '',
         'Herkunft' => $this->channelLabel((string)($order['channel_key'] ?? 'shop')) . (in_array((string)($order['channel_key'] ?? 'shop'), array('shop', 'web', ''), true) ? ' Bestellung' : ' Channel-Bestellung'),
         'Externe Bestellnummer' => $order['payment_reference'] ?? '',
         'Zahlungsart' => $this->paymentProviderLabel((string)($order['payment_provider'] ?? '')),
         'Zahlungsstatus' => $order['payment_status'] ?? '',
         'Rechnungsnummer' => $order['invoice_no'] ?? '',
         'Rechnungsdatum' => $order['invoice_date'] ?? '',
         'Rechnungs-PDF' => trim((string)($order['invoice_pdf_path'] ?? '')) !== '' ? (string)$order['invoice_pdf_path'] : 'noch nicht erzeugt',
         'Bestand reserviert' => !empty($order['stock_reserved']) ? 'Ja' : 'Nein',
         'Bestand zurueckgebucht' => !empty($order['stock_released']) ? 'Ja, ' . (string)($order['stock_released_date'] ?? '') : 'Nein',
         'Versandstatus' => $order['shipping_status'] ?? '',
         'Versanddienstleister' => $order['shipping_provider'] ?? '',
         'Trackingnummer' => $order['tracking_no'] ?? '',
         'Summe' => $this->money($order['total_gross'] ?? 0),
      );
      $html = '<dl class="dbx-shop-order-meta">';
      foreach ($rows as $label => $value) {
         $html .= '<dt>' . $this->h($label) . '</dt><dd>' . $this->h($value) . '</dd>';
      }
      $html .= '</dl>';
      return $html;
   }
 
   private function orderHistoryHtml(array $order): string {
      $rows = (array)($order['history'] ?? array());
      if ($rows === array()) {
         return '<div class="text-muted small">Noch keine Historie gespeichert.</div>';
      }
      $html = '<div class="dbx-shop-order-history">';
      foreach ($rows as $row) {
         $event = (string)($row['event_type'] ?? '');
         $old = (string)($row['old_value'] ?? '');
         $new = (string)($row['new_value'] ?? '');
         $msg = (string)($row['message'] ?? '');
         $html .= '<div class="dbx-shop-order-history-item">'
            . '<strong>' . $this->h($event) . '</strong>'
            . '<small>' . $this->h($row['create_date'] ?? '') . '</small>'
            . ($old !== '' || $new !== '' ? '<code>' . $this->h($old) . ' -> ' . $this->h($new) . '</code>' : '')
            . ($msg !== '' ? '<span>' . $this->h($msg) . '</span>' : '')
            . '</div>';
      }
      $html .= '</div>';
      return $html;
   }
 
   private function orderWithdrawalsHtml(array $order): string {
      $rows = (array)($order['withdrawals'] ?? array());
      if ($rows === array()) {
         return '<div class="text-muted small">Kein Widerruf zu dieser Bestellung.</div>';
      }
      $html = '<div class="dbx-shop-order-withdrawals">';
      foreach ($rows as $row) {
         $html .= '<div class="alert alert-warning py-2 mb-2">'
            . '<strong>' . $this->h($row['customer_name'] ?? '') . '</strong> '
            . '<span class="badge text-bg-warning">' . $this->h($row['status'] ?? '') . '</span>'
            . '<br><small>' . $this->h($row['create_date'] ?? '') . ' · ' . $this->h($row['customer_email'] ?? '') . '</small>'
            . '<div class="mt-1">' . nl2br($this->h($row['reason'] ?? '')) . '</div>'
            . '</div>';
      }
      $html .= '</div>';
      return $html;
   }
 
   private function orderItemsHtml(array $order): string {
      $items = (array)($order['items'] ?? array());
      if ($items === array()) {
         return '<div class="text-muted small">Keine Positionen gespeichert.</div>';
      }
      $html = '<div class="table-responsive"><table class="table table-sm table-bordered dbx-shop-order-items-table"><thead><tr>'
         . '<th>Artikel</th><th class="text-end">Menge</th><th class="text-end">Einzelpreis</th><th class="text-end">MwSt.</th><th class="text-end">Versand</th><th class="text-end">Summe</th>'
         . '</tr></thead><tbody>';
      foreach ($items as $item) {
         $html .= '<tr>'
            . '<td><strong>' . $this->h($item['title'] ?? '') . '</strong><br><code>' . $this->h($item['sku'] ?? '') . '</code></td>'
            . '<td class="text-end">' . (int)($item['qty'] ?? 0) . '</td>'
            . '<td class="text-end">' . $this->money($item['price_gross'] ?? 0) . '</td>'
            . '<td class="text-end">' . $this->h(number_format((float)($item['tax_rate'] ?? 0), 2, ',', '.')) . ' %</td>'
            . '<td class="text-end">' . $this->money($item['shipping_gross'] ?? 0) . '</td>'
            . '<td class="text-end">' . $this->money($item['total_gross'] ?? 0) . '</td>'
            . '</tr>';
      }
      $html .= '</tbody></table></div>';
      return $html;
   }
 
   private function orderPayloadHtml(array $order): string {
      $blocks = array(
         'Zahlungs-/Channel-Payload' => trim((string)($order['payment_payload'] ?? '')),
         'Rechtstext-Snapshot' => trim((string)($order['legal_snapshot'] ?? '')),
         'Widerruf-Snapshot' => trim((string)($order['withdrawal_snapshot'] ?? '')),
      );
      $html = '';
      foreach ($blocks as $title => $payload) {
         if ($payload === '') {
            continue;
         }
         $decoded = json_decode($payload, true);
         if (is_array($decoded)) {
            $payload = json_encode($decoded, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES | JSON_UNESCAPED_UNICODE);
         }
         $html .= '<details class="mb-2"><summary>' . $this->h($title) . '</summary><pre>' . $this->h($payload) . '</pre></details>';
      }
      if ($html === '') {
         return '<div class="text-muted small">Keine technische Rueckmeldung und kein Rechtstext-Snapshot gespeichert.</div>';
      }
      return $html;
   }
 
   private function statusMailChangesHtml(array $before, array $order): string {
      $rows = array(
         'Bestellstatus' => array($this->orderStatusOptions(), 'status'),
         'Zahlungsstatus' => array($this->paymentStatusOptions(), 'payment_status'),
         'Versandstatus' => array($this->shippingStatusOptions(), 'shipping_status'),
      );
      $html = '';
      foreach ($rows as $label => $cfg) {
         [$options, $field] = $cfg;
         $old = (string)($before[$field] ?? '');
         $new = (string)($order[$field] ?? '');
         if ($old === $new) {
            continue;
         }
         $html .= '<tr><th align="left">' . $this->h($label) . '</th><td>' . $this->h($options[$old] ?? $old) . '</td><td>' . $this->h($options[$new] ?? $new) . '</td></tr>';
      }
      if ($html === '') {
         return '<dl>'
            . '<dt>Bestellstatus</dt><dd>' . $this->h($this->orderStatusOptions()[(string)($order['status'] ?? '')] ?? (string)($order['status'] ?? '')) . '</dd>'
            . '<dt>Zahlungsstatus</dt><dd>' . $this->h($this->paymentStatusOptions()[(string)($order['payment_status'] ?? '')] ?? (string)($order['payment_status'] ?? '')) . '</dd>'
            . '<dt>Versandstatus</dt><dd>' . $this->h($this->shippingStatusOptions()[(string)($order['shipping_status'] ?? '')] ?? (string)($order['shipping_status'] ?? '')) . '</dd>'
            . '</dl>';
      }
      return '<table border="0" cellpadding="6" cellspacing="0">'
         . '<thead><tr><th align="left">Feld</th><th align="left">Vorher</th><th align="left">Jetzt</th></tr></thead>'
         . '<tbody>' . $html . '</tbody></table>';
   }
 
   private function sendOrderStatusMail(array $before, array $order): array {
      $cfg = $this->shopConfig();
      $from = trim((string)($cfg['mail_from'] ?? ''));
      $to = trim((string)($order['customer_email'] ?? ''));
      if ($from === '') {
         return array(false, 'Kundenmail wurde nicht gesendet: Mail-Absender fehlt in den Shop-Einstellungen.');
      }
      if ($to === '' || !filter_var($to, FILTER_VALIDATE_EMAIL)) {
         return array(false, 'Kundenmail wurde nicht gesendet: Die Bestellung hat keine gueltige Kunden-E-Mail.');
      }
 
      $orderNo = (string)($order['order_no'] ?? '');
      $subject = 'Aktualisierung Ihrer Bestellung ' . $orderNo;
      $trackingNo = trim((string)($order['tracking_no'] ?? ''));
      $trackingUrl = trim((string)($order['tracking_url'] ?? ''));
      $invoiceNo = trim((string)($order['invoice_no'] ?? ''));
      $extra = '';
      if ($trackingNo !== '') {
         $extra .= '<p><strong>Trackingnummer:</strong> ' . $this->h($trackingNo) . '</p>';
      }
      if ($trackingUrl !== '') {
         $extra .= '<p><a href="' . $this->h($trackingUrl) . '">Sendung verfolgen</a></p>';
      }
      if ($invoiceNo !== '') {
         $extra .= '<p><strong>Rechnung:</strong> ' . $this->h($invoiceNo) . '</p>';
      }
      $html = '<h2>Ihre Bestellung wurde aktualisiert</h2>'
         . '<p>Bestellnummer: <strong>' . $this->h($orderNo) . '</strong></p>'
         . $this->statusMailChangesHtml($before, $order)
         . $extra
         . '<p>Viele Gruesse<br>Ihr Shop-Team</p>';
 
      try {
         dbx()->send_mail($from, $to, $subject, $html, 'html');
         $this->repo()->addOrderHistory((int)($order['id'] ?? 0), 'customer_mail', '', $to, 'Statusbenachrichtigung wurde an den Kunden gesendet.');
         return array(true, 'Kundenmail wurde gesendet.');
      } catch (\Throwable $e) {
         dbx()->sys_msg('error', 'dbxShop_admin', (string)($order['id'] ?? ''), 'order status mail failed', $e->getMessage());
         return array(false, 'Kundenmail konnte nicht gesendet werden: ' . $e->getMessage());
      }
   }
 
   private function notifyCustomerHint(array $order): string {
      $email = trim((string)($order['customer_email'] ?? ''));
      return $email === ''
         ? 'Keine Kunden-E-Mail vorhanden. Es kann keine Statusmail gesendet werden.'
         : 'Status erst speichern. Danach kann ueber den Mail-Button in der Bar eine kurze Statusaktualisierung an ' . $email . ' gesendet werden.';
   }
 
   private function orderQuickActionsHtml(array $order): string {
      $id = (int)($order['id'] ?? 0);
      if ($id <= 0) {
         return '';
      }
      $base = '?dbx_modul=dbxShop_admin&dbx_run1=order_detail&dbx_run2=quick_action&id=' . $id . '&dbx_ajax=1&order_action=';
      $actions = array(
         'mark_paid' => array('bi-cash-coin', 'Bezahlt', 'Bestellung als bezahlt markieren?'),
         'processing' => array('bi-tools', 'Bearbeitung', 'Bestellung in Bearbeitung setzen?'),
         'ready' => array('bi-box-seam', 'Versandbereit', 'Bestellung als versandbereit markieren?'),
         'shipped' => array('bi-truck', 'Versendet', 'Bestellung als versendet markieren?'),
         'delivered' => array('bi-check2-circle', 'Abgeschlossen', 'Bestellung als zugestellt und abgeschlossen markieren?'),
         'cancel' => array('bi-x-circle', 'Stornieren', 'Bestellung stornieren? Reservierter Bestand wird bei Bedarf freigegeben.'),
         'refund' => array('bi-arrow-counterclockwise', 'Erstattet', 'Bestellung als erstattet markieren? Reservierter Bestand wird bei Bedarf freigegeben.'),
      );
      $html = '<div class="dbx-shop-order-quick-actions" data-dbx="lib=confirm|class=dbxConfirm|bind=link">'
         . '<strong>Schnellaktionen</strong><div class="dbx-shop-order-quick-action-buttons">';
      foreach ($actions as $action => $cfg) {
         [$icon, $label, $confirm] = $cfg;
         $btnClass = in_array($action, array('cancel', 'refund'), true) ? 'btn-outline-danger' : 'btn-outline-primary';
         $html .= '<a class="btn btn-sm ' . $btnClass . ' dbxConfirm" href="' . $this->h($base . rawurlencode($action)) . '"'
            . ' data-confirm-title="<i class=\'bi ' . $this->h($icon) . '\'></i> ' . $this->h($label) . '"'
            . ' data-confirm="' . $this->h($confirm) . '"'
            . ' data-confirm-buttons="yesno"'
            . ' title="' . $this->h($label) . '">'
            . '<i class="bi ' . $this->h($icon) . '"></i> ' . $this->h($label) . '</a>';
      }
      $html .= '</div></div>';
      return $html;
   }
 
   private function orderDetailActions(int $id): string {
      $helpId = $this->ensureShopOrdersHelpPage();
      $helpButton = $helpId > 0
         ? $this->openWinButton('?dbx_modul=dbxContent&dbx_run1=content&cid=' . $helpId . '&dbx_ajax=1', 'Hilfe: Bestellungen', '<i class="bi bi-question-circle"></i><span class="visually-hidden"> Hilfe</span>', 'btn btn-outline-secondary btn-sm ms-1', '72%', '82%')
         : '';
      $deleteUrl = '?dbx_modul=dbxShop_admin&dbx_run1=orders&delete_order=' . $id;
      $mailUrl = '?dbx_modul=dbxShop_admin&dbx_run1=order_detail&dbx_run2=send_status_mail&id=' . $id . '&dbx_ajax=1';
      return '<button class="btn btn-primary btn-sm" type="submit" title="Bestellung speichern"><i class="bi bi-save"></i><span class="visually-hidden"> Speichern</span></button>'
         . $this->openWinButton('?dbx_modul=dbxShop_admin&dbx_run1=order_invoice&id=' . $id . '&dbx_ajax=1', 'Rechnung anzeigen', '<i class="bi bi-file-earmark-text"></i><span class="visually-hidden"> Rechnung</span>', 'btn btn-outline-primary btn-sm ms-1', '82%', '86%')
         . '<a class="btn btn-outline-danger btn-sm ms-1" href="?dbx_modul=dbxShop_admin&dbx_run1=order_invoice_pdf&id=' . $id . '" target="_blank" rel="noopener" title="Rechnung als PDF erzeugen/oeffnen"><i class="bi bi-file-earmark-pdf"></i><span class="visually-hidden"> PDF</span></a>'
         . '<a class="btn btn-outline-primary btn-sm ms-1 dbxConfirm" href="' . $this->h($mailUrl) . '" data-confirm-title="<i class=\'bi bi-envelope\'></i> Kundenmail senden" data-confirm="Aktuellen Bestellstatus per E-Mail an den Kunden senden?" data-confirm-buttons="yesno" title="Kundenmail senden"><i class="bi bi-envelope"></i><span class="visually-hidden"> Kundenmail</span></a>'
         . '<a class="btn btn-outline-danger btn-sm ms-1 dbxConfirm" href="' . $this->h($deleteUrl) . '" data-confirm-title="<i class=\'bi bi-trash\'></i> Bestellung loeschen" data-confirm="Diese Bestellung wirklich in den Papierkorb verschieben?" data-confirm-buttons="yesno" title="Bestellung loeschen"><i class="bi bi-trash"></i><span class="visually-hidden"> Loeschen</span></a>'
         . $helpButton
         . $this->openWinButton('?dbx_modul=dbxShop_admin&dbx_run1=orders&dbx_ajax=1', 'Bestellungen', '<i class="bi bi-table"></i><span class="visually-hidden"> Bestellliste</span>', 'btn btn-outline-secondary btn-sm ms-1', '92%', '88%');
   }
 
   private function orderDetail(): string {
      $id = (int)dbx()->get_modul_var('id', 0, 'int');
      $order = $id > 0 ? $this->repo()->orderById($id) : null;
      if (!is_array($order)) {
         return $this->frame('<div class="alert alert-warning m-3">Bestellung nicht gefunden.</div>', 'Bestellung bearbeiten', $this->orderActions());
      }
      $quickMessage = '';
      $quickError = '';
      $quickAction = (string)dbx()->get_modul_var('order_action', '', 'parameter');
      if ((string)dbx()->get_modul_var('dbx_run2', '', 'parameter') === 'quick_action' && $quickAction !== '') {
         [$quickOk, $quickMsg] = $this->repo()->updateOrderQuickAction($id, $quickAction);
         if ($quickOk) {
            $quickMessage = $quickMsg;
            $order = $this->repo()->orderById($id) ?: $order;
         } else {
            $quickError = $quickMsg;
         }
      }
      $mailMessage = '';
      $mailError = '';
      $sendStatusMail = (string)dbx()->get_modul_var('dbx_run2', '', 'parameter') === 'send_status_mail'
         || (string)($_GET['dbx_run2'] ?? '') === 'send_status_mail';
      if ($sendStatusMail) {
         [$mailOk, $mailMsg] = $this->sendOrderStatusMail($order, $order);
         if ($mailOk) {
            $mailMessage = $mailMsg;
            $order = $this->repo()->orderById($id) ?: $order;
         } else {
            $mailError = $mailMsg;
         }
      }
 
      $form = dbx()->get_system_obj('dbxForm');
      $form->init('shop-order-form', 'shop-order-form');
      $form->_dd = 'dbxShop|shopOrder';
      $form->_data = $order;
      $form->_rid = $id;
      $form->_action = '?dbx_modul=dbxShop_admin&dbx_run1=order_detail&id=' . $id;
      if ((int)dbx()->get_modul_var('dbx_ajax', 0, 'int') === 1) {
         $form->_action .= '&dbx_ajax=1';
      }
      $form->set_activ_id($id);
      $form->add_rep('bar_title', 'Bestellung bearbeiten');
      $form->add_rep('bar_icon', 'bi-receipt');
      $form->add_rep('bar_subtitle', (string)($order['order_no'] ?? ''));
      $form->add_rep('bar_class', 'dbx-module-bar');
      $form->add_rep('bar_title_class', 'dbx-module-bar-titleblock');
      $form->add_rep('bar_title_pre', '');
      $form->add_rep('bar_title_heading_attrs', '');
      $form->add_rep('bar_middle', '');
      $form->add_rep('bar_actions_class', 'dbx-module-bar-actions');
      $form->add_rep('bar_actions', $this->orderDetailActions($id));
      $form->add_rep('bar_extra', '');
      $form->add_rep('shop_admin_style', $this->shopAdminStyle());
      $form->_msg_info = 'Status, Zahlungsstatus, Zahlungsreferenz und interne Notiz bearbeiten.';
      $form->add_fld('status', tpl: 'select-single-label', label: 'Bestellstatus', options: $this->orderStatusOptions());
      $form->add_fld('payment_status', tpl: 'select-single-label', label: 'Zahlungsstatus', options: $this->paymentStatusOptions());
      $form->add_fld('payment_reference', tpl: 'text-label', label: 'Zahlungsreferenz', rules: '*|max=180', placeholder: 'PAYID-xxxx oder Channel-Order-ID');
      $form->add_fld('invoice_no', tpl: 'text-label', label: 'Rechnungsnummer', rules: '*|max=60', placeholder: 'R2026-00001');
      $form->add_fld('invoice_date', tpl: 'text-label', label: 'Rechnungsdatum', rules: '*|date', placeholder: date('Y-m-d'));
      $form->add_fld('shipping_status', tpl: 'select-single-label', label: 'Versandstatus', options: $this->shippingStatusOptions());
      $form->add_fld('shipping_provider', tpl: 'text-label', label: 'Versanddienstleister', rules: '*|max=120', placeholder: 'DHL, UPS, Deutsche Post');
      $form->add_fld('tracking_no', tpl: 'text-label', label: 'Trackingnummer', rules: '*|max=180', placeholder: '00340434123456789012');
      $form->add_fld('tracking_url', tpl: 'text-label', label: 'Tracking-URL', rules: '*|max=255', placeholder: 'https://www.dhl.de/de/privatkunden.html?piececode=...');
      $form->add_fld('shipped_date', tpl: 'text-label', label: 'Versendet am', rules: '*|datetime', placeholder: date('Y-m-d H:i:s'));
      $form->add_fld('note', tpl: 'textarea-label', label: 'Interne Notiz', rules: '*|max=5000', data: 'rows=5', placeholder: 'Rueckfrage, Versandhinweis oder interner Bearbeitungsvermerk');
      $form->add_rep('order_notice', '');
 
      if ($form->submit()) {
         if (!$form->errors()) {
            if ($this->repo()->updateOrderAdmin($id, $_POST)) {
               $form->_msg_success = 'Bestellung gespeichert.';
               $order = $this->repo()->orderById($id) ?: $order;
               $form->_data = $order;
            } else {
               $form->_msg_error = 'Bestellung konnte nicht gespeichert werden.';
            }
         } else {
            $form->_msg_error = 'Bitte Eingaben pruefen.';
         }
      }
 
      $actionMessage = $quickMessage !== '' ? $quickMessage : $mailMessage;
      $actionError = $quickError !== '' ? $quickError : $mailError;
      if ($actionMessage !== '' || $actionError !== '') {
         $form->_form_submit = 1;
         $form->_msg_info = '';
         if ($actionError !== '') {
            $form->_msg_error = $actionError;
            $form->add_fld_error('general', $actionError);
         } else {
            $form->_msg_success = $actionMessage;
         }
      }
 
      $form->add_rep('notify_customer_hint', $this->h($this->notifyCustomerHint($order)));
      $form->add_rep('order_quick_actions', $this->orderQuickActionsHtml($order));
      $form->add_obj('order_meta', 'obj-value', $this->orderMetaHtml($order));
      $form->add_obj('order_items', 'obj-value', $this->orderItemsHtml($order));
      $form->add_obj('order_payload', 'obj-value', $this->orderPayloadHtml($order));
      $form->add_obj('order_history', 'obj-value', $this->orderHistoryHtml($order));
      $form->add_obj('order_withdrawals', 'obj-value', $this->orderWithdrawalsHtml($order));
      return $form->run();
   }
 
   private function orderInvoice(): string {
      $id = (int)dbx()->get_modul_var('id', 0, 'int');
      $order = $id > 0 ? $this->repo()->orderById($id) : null;
      if (!is_array($order)) {
         return $this->frame('<div class="alert alert-warning m-3">Bestellung nicht gefunden.</div>', 'Rechnung');
      }
      $invoiceNo = trim((string)($order['invoice_no'] ?? ''));
      if ($invoiceNo === '') {
         $invoiceNo = 'Entwurf';
      }
      $rows = '';
      foreach ((array)($order['items'] ?? array()) as $item) {
         $rows .= '<tr>'
            . '<td><strong>' . $this->h($item['title'] ?? '') . '</strong><br><code>' . $this->h($item['sku'] ?? '') . '</code></td>'
            . '<td class="text-end">' . (int)($item['qty'] ?? 0) . '</td>'
            . '<td class="text-end">' . $this->money($item['price_gross'] ?? 0) . '</td>'
            . '<td class="text-end">' . $this->h(number_format((float)($item['tax_rate'] ?? 0), 2, ',', '.')) . ' %</td>'
            . '<td class="text-end">' . $this->money($item['total_gross'] ?? 0) . '</td>'
            . '</tr>';
      }
      $html = '<section class="dbx-shop-invoice p-4 bg-white">'
         . '<div class="d-flex justify-content-between align-items-start mb-4"><div><h2>Rechnung</h2><strong>' . $this->h($invoiceNo) . '</strong><br><small>' . $this->h($order['invoice_date'] ?? date('Y-m-d')) . '</small></div><button class="btn btn-outline-primary btn-sm" onclick="window.print()"><i class="bi bi-printer"></i> Drucken</button></div>'
         . '<dl class="dbx-shop-order-meta mb-4">'
         . '<dt>Bestellung</dt><dd>' . $this->h($order['order_no'] ?? '') . '</dd>'
         . '<dt>Kunde</dt><dd>' . $this->h($order['customer_name'] ?? '') . '<br>' . $this->h($order['customer_email'] ?? '') . '</dd>'
         . '<dt>Lieferadresse</dt><dd>' . nl2br($this->h($order['shipping_address'] ?? '')) . '</dd>'
         . '</dl>'
         . '<div class="table-responsive"><table class="table table-sm table-bordered"><thead><tr><th>Artikel</th><th class="text-end">Menge</th><th class="text-end">Einzelpreis</th><th class="text-end">MwSt.</th><th class="text-end">Summe</th></tr></thead><tbody>'
         . $rows
         . '</tbody><tfoot><tr><th colspan="4" class="text-end">Gesamt</th><th class="text-end">' . $this->money($order['total_gross'] ?? 0) . '</th></tr></tfoot></table></div>'
         . '<p class="text-muted small">Dieser Beleg basiert auf dem gespeicherten Bestell-Snapshot. Rechtliche Pflichtangaben und Nummernkreis bitte vor Livebetrieb final pruefen.</p>'
         . '</section>';
      return $this->frame($html, 'Rechnung ' . $invoiceNo, '');
   }
 
   private function orderInvoicePdf(): string {
      $id = (int)dbx()->get_modul_var('id', 0, 'int');
      $order = $id > 0 ? $this->repo()->ensureOrderInvoicePdf($id) : null;
      if (!is_array($order)) {
         return $this->frame('<div class="alert alert-warning m-3">Rechnungs-PDF konnte nicht erzeugt werden.</div>', 'Rechnung');
      }
      $file = $this->repo()->invoicePdfAbsolutePath($order);
      if ($file === '') {
         return $this->frame('<div class="alert alert-warning m-3">Rechnungs-PDF ist nicht verfuegbar.</div>', 'Rechnung');
      }
      if (!headers_sent()) {
         header('Content-Type: application/pdf');
         header('Content-Disposition: inline; filename="' . basename($file) . '"');
         header('Content-Length: ' . filesize($file));
      }
      readfile($file);
      exit;
   }
 
   private function shopAdminCardForm(string $fid, string $dd, array $data, int $id, string $action, string $shopAction, string $saveAction, string $titleHtml, string $subtitle = '', string $cardClass = '') {
      $form = dbx()->get_system_obj('dbxForm');
      $form->init($fid, 'shop-admin-card-form');
      $form->_dd = $dd;
      $form->_data = $data + array('id' => $id);
      $form->_rid = $id;
      $form->_action = $action;
      $form->set_activ_id($id);
      $form->add_rep('form_class', 'dbx-shop-admin-card-dbXForm');
      $form->add_rep('form_attrs', 'data-target="dbxForm_{i}" data-dbx="lib=confirm|class=dbxConfirm|bind=button"');
      $form->add_rep('shop_action', $this->h($shopAction));
      $form->add_rep('save_action', $this->h($saveAction));
      $form->add_rep('record_id', (string)$id);
      $form->add_rep('extra_hidden', '');
      $form->add_rep('card_title', $titleHtml);
      $form->add_rep('card_subtitle', $this->h($subtitle));
      $form->add_rep('card_badges', '');
      $form->add_rep('card_class', $this->h($cardClass));
      $form->add_rep('form_body', '');
      $form->add_rep('delete_button', '');
      $form->_msg_info = '';
      return $form;
   }
 
   private function shopAdminCardDeleteButton(string $action, string $title, string $message): string {
      return '<button class="btn btn-outline-danger btn-sm dbxConfirm" name="shop_action" value="' . $this->h($action) . '" title="' . $this->h($title) . '" data-confirm-title="' . $this->h($title) . '" data-confirm="' . $this->h($message) . '" data-confirm-buttons="yesno"><i class="bi bi-trash"></i></button>';
   }
 
   private function activeBadge(array $row): string {
      return ((int)($row['active'] ?? 0) === 1)
         ? '<span class="badge text-bg-success">Aktiv</span>'
         : '<span class="badge text-bg-secondary">Inaktiv</span>';
   }
 
   private function groups(): string {
      $this->ensureSeed();
      if ($this->posted('delete_product_group')) {
         $this->repo()->deleteProductGroup((int)($_POST['id'] ?? 0));
      } elseif ($this->posted('save_product_group')) {
         $this->repo()->updateProductGroup((int)($_POST['id'] ?? 0), $_POST);
      }
 
      $cardHtml = function (array $group, bool $isNew = false): string {
         $id = (int)($group['id'] ?? 0);
         if ($isNew) {
            $title = '<span>Neue Artikelgruppe</span>';
            $subtitle = 'Key, Name, MwSt.-Klasse und Darstellung festlegen.';
         } else {
            $title = '<code>' . $this->h($group['group_key'] ?? '') . '</code><span>' . $this->h($group['title'] ?? '') . '</span>';
            $subtitle = trim((string)($group['description'] ?? ''));
         }
 
         $form = $this->shopAdminCardForm(
            'shop-product-group-' . ($isNew ? 'new' : $id),
            'dbxShop|shopProductGroup',
            $group,
            $id,
            '?dbx_modul=dbxShop_admin&dbx_run1=groups' . ($isNew ? '&new=1' : ''),
            'save_product_group',
            'save_product_group',
            $title,
            $subtitle,
            'dbx-shop-product-group-card'
         );
         $form->add_rep('card_badges', $isNew ? '<span class="badge text-bg-primary">Neu</span>' : $this->activeBadge($group));
         $form->add_rep('extra_hidden', '<input type="hidden" name="display_variant" value="' . $this->h($group['display_variant'] ?? 'gallery_grid') . '">');
         if (!$isNew) {
            $form->add_rep('delete_button', $this->shopAdminCardDeleteButton('delete_product_group', 'Artikelgruppe loeschen', 'Diese Artikelgruppe wirklich loeschen?'));
         }
         if ($isNew) {
            $form->add_fld('group_key', tpl: 'text-label', label: 'Key', placeholder: 'artikelgruppe-key', rules: '*|parameter|max=80');
         }
         $form->add_fld('parent_id', tpl: 'select-single-label', label: 'Obergruppe', options: $this->productGroupOptions($id, true), rules: 'int');
         $form->add_fld('title', tpl: 'text-label', label: 'Gruppe', placeholder: 'Neue Artikelgruppe', rules: '*|max=160');
         $form->add_fld('description', tpl: 'textarea-label', label: 'Beschreibung', placeholder: 'Beschreibung', data: 'rows=2');
         $form->add_fld('tax_class', tpl: 'select-single-label', label: 'MwSt.-Klasse', options: 'mwst1=mwst1&mwst2=mwst2&mwst3=mwst3');
         $form->add_fld('card_template', tpl: 'select-single-label', label: 'Karte', options: 'product-card-default=Standardkarte&product-card-compact=Kompaktkarte');
         $form->add_fld('detail_template', tpl: 'select-single-label', label: 'Detail', options: 'product-detail-default=Standarddetail&product-detail-technical=Technische Ansicht');
         $form->add_fld('gallery_template', tpl: 'select-single-label', label: 'Gallery', options: 'image-gallery=Bild Gallery&file-gallery=Datei Gallery');
         $form->add_fld('gallery_visible_count', tpl: 'text-label', label: 'Bilder', rules: 'int');
         $form->add_fld('gallery_image_size', tpl: 'select-single-label', label: 'Bildgroesse', options: 'original=Original&cover=Cover&contain=Contain');
         $form->add_fld('gallery_lightbox_width', tpl: 'text-label', label: 'Lightbox', placeholder: '100vw');
         $form->add_fld('gallery_overflow', tpl: 'select-single-label', label: 'Overflow', options: 'grid=Grid&slider=Slider&scroll=Scroll&laufband=Laufband&tutorial=Tutorial');
         $form->add_fld('gallery_click', tpl: 'select-single-label', label: 'Klick', options: 'lightbox=Lightbox&none=Kein Klick&newtab=Neuer Tab&viewerjs=ViewerJS&photoswipe=PhotoSwipe');
         $form->add_fld('attribute_notes', tpl: 'textarea-label', label: 'Artikelattribute', placeholder: 'Attribut-Hinweise', data: 'rows=2');
         $channelDefaults = '';
         if ($this->channelsEnabled()) {
            $form->add_fld('ebay_category_id', tpl: 'text-label', label: 'eBay Kategorie', placeholder: '58058');
            $form->add_fld('amazon_product_type', tpl: 'text-label', label: 'Amazon Product Type', placeholder: 'SOFTWARE / PRODUCT / SHIRT');
            $form->add_fld('kleinanzeigen_category_id', tpl: 'text-label', label: 'Kleinanzeigen Kategorie', placeholder: 'category_12345');
            $form->add_fld('mobile_category_id', tpl: 'text-label', label: 'mobile.de Kategorie', placeholder: 'car');
            $channelDefaults = '<div class="wide dbx-shop-channel-defaults">'
               . '<h6>Channel-Vorgaben</h6>'
               . '<p>Diese Werte dienen als Standard fuer Artikel dieser Gruppe. In der Artikel-Channel-Maske koennen sie pro Artikel ueberschrieben werden.</p>'
               . '<div class="dbx-shop-admin-card-grid dbx-shop-channel-default-grid">'
               . '<div>{obj:ebay_category_id}</div>'
               . '<div>{obj:amazon_product_type}</div>'
               . '<div>{obj:kleinanzeigen_category_id}</div>'
               . '<div>{obj:mobile_category_id}</div>'
               . '</div>'
               . '</div>';
         }
         $form->add_fld('sorter', tpl: 'text-label', label: 'Sort', rules: 'int');
         $form->add_fld('active', tpl: 'checkbox-label', label: 'Aktiv', rules: 'int');
         $groupImagePanel = $this->productGroupImagePanel($group, $isNew);
         $form->add_rep('form_body',
            '<div class="dbx-shop-admin-card-grid">'
            . ($isNew ? '<div>{obj:group_key}</div>' : '')
            . '<div>{obj:parent_id}</div>'
            . '<div>{obj:title}</div>'
            . '<div>{obj:tax_class}</div>'
            . '<div>{obj:sorter}</div>'
            . '<div>{obj:active}</div>'
            . '<div class="wide">' . $groupImagePanel . '</div>'
            . '<div class="wide">{obj:description}</div>'
            . '<div>{obj:card_template}</div>'
            . '<div>{obj:detail_template}</div>'
            . '<div>{obj:gallery_template}</div>'
            . '<div>{obj:gallery_visible_count}</div>'
            . '<div>{obj:gallery_image_size}</div>'
            . '<div>{obj:gallery_lightbox_width}</div>'
            . '<div>{obj:gallery_overflow}</div>'
            . '<div>{obj:gallery_click}</div>'
            . '<div class="wide">{obj:attribute_notes}</div>'
            . $channelDefaults
            . '</div>'
         );
         return $form->run();
      };
 
      $groups = $this->repo()->groups();
      $cards = '';
      if ((int)($_GET['new'] ?? 0) === 1) {
         $sorter = 10;
         foreach ($groups as $group) {
            $sorter = max($sorter, (int)($group['sorter'] ?? 0) + 10);
         }
         $cards .= $cardHtml(array(
            'tax_class' => (string)($this->shopConfig()['default_tax_class'] ?? 'mwst1'),
            'default_tax_rate' => 19,
            'parent_id' => 0,
            'display_variant' => 'gallery_grid',
            'card_template' => 'product-card-default',
            'detail_template' => 'product-detail-default',
            'gallery_template' => 'image-gallery',
            'gallery_visible_count' => 3,
            'gallery_image_size' => 'original',
            'gallery_lightbox_width' => '100vw',
            'gallery_overflow' => 'grid',
            'gallery_click' => 'lightbox',
            'active' => 1,
            'sorter' => $sorter,
         ), true);
      }
      foreach ($groups as $group) {
         $cards .= $cardHtml($group);
      }
      $helpButton = $this->helpButton($this->ensureShopProductGroupsHelpPage(), 'Hilfe: Artikelgruppen');
      $barActions = '<a class="btn btn-outline-primary btn-sm me-1" href="?dbx_modul=dbxShop_admin&dbx_run1=groups&new=1" title="Neue Artikelgruppe anlegen"><i class="bi bi-plus-square"></i><span class="visually-hidden"> Neue Artikelgruppe</span></a>' . $helpButton;
      return $this->frame('<div class="alert alert-info mx-3 mt-3 mb-0">Artikelgruppen steuern MwSt.-Klasse, Darstellung, Gallery und Attribute. Artikel waehlen nur die Gruppe.</div><div class="dbx-shop-admin-card-list">' . $cards . '</div>', 'Artikelgruppen', $barActions);
   }
 
   private function attributes(): string {
      $this->ensureSeed();
      if ($this->posted('save_attribute_definition')) {
         $this->repo()->saveAttributeDefinition($_POST);
      }
 
      $groupOptions = array();
      foreach ($this->repo()->groups() as $group) {
         $groupOptions[(string)(int)($group['id'] ?? 0)] = (string)($group['title'] ?? '');
      }
 
      $cardHelpButton = $this->helpButton($this->ensureShopProductAttributesHelpPage(), 'Hilfe: Artikelattribute', 'btn btn-outline-secondary btn-sm me-1');
      $cardHtml = function (array $attribute, bool $isNew = false) use ($groupOptions, $cardHelpButton): string {
         $id = (int)($attribute['id'] ?? 0);
         $type = (string)($attribute['input_type'] ?? 'text');
         $title = $isNew
            ? '<span>Neues Attribut</span>'
            : '<code>' . $this->h($attribute['attr_key'] ?? '') . '</code><span>' . $this->h($attribute['title'] ?? '') . '</span>';
         $subtitle = $isNew ? 'Attribut fuer eine Artikelgruppe anlegen.' : (string)($attribute['group_title'] ?? '');
 
         $form = $this->shopAdminCardForm(
            'shop-attribute-definition-' . ($isNew ? 'new' : $id),
            'dbxShop|shopAttributeDefinition',
            $attribute,
            $id,
            '?dbx_modul=dbxShop_admin&dbx_run1=attributes',
            'save_attribute_definition',
            'save_attribute_definition',
            $title,
            $subtitle,
            'dbx-shop-attribute-card'
         );
         $form->add_rep('card_badges', $cardHelpButton . ($isNew ? '<span class="badge text-bg-primary">Neu</span>' : $this->activeBadge($attribute)));
         $form->add_fld('group_id', tpl: 'select-single-label', label: 'Gruppe', options: $groupOptions, rules: 'int');
         $form->add_fld('attr_key', tpl: 'text-label', label: 'Key', placeholder: 'farbe', rules: '*|parameter|max=80');
         $form->add_fld('title', tpl: 'text-label', label: 'Titel', placeholder: 'Farbe', rules: '*|max=160');
         $form->add_fld('input_type', tpl: 'select-single-label', label: 'Typ', options: 'text=Text&select=Auswahlliste&number=Zahl');
         $form->add_fld('unit', tpl: 'text-label', label: 'Einheit', placeholder: 'cm');
         $form->add_fld('options', tpl: 'textarea-label', label: 'Optionen', placeholder: 'S|M|L|XL', data: 'rows=2');
         $form->add_fld('required', tpl: 'checkbox-label', label: 'Pflicht', rules: 'int');
         $form->add_fld('filterable', tpl: 'checkbox-label', label: 'Filter', rules: 'int');
         $form->add_fld('comparable', tpl: 'checkbox-label', label: 'Vergleich', rules: 'int');
         $form->add_fld('sorter', tpl: 'text-label', label: 'Sort', rules: 'int');
         $form->add_fld('active', tpl: 'checkbox-label', label: 'Aktiv', rules: 'int');
         $form->add_rep('form_body',
            '<div class="dbx-shop-admin-card-grid">'
            . '<div>{obj:group_id}</div>'
            . '<div>{obj:attr_key}</div>'
            . '<div>{obj:title}</div>'
            . '<div>{obj:input_type}</div>'
            . '<div>{obj:unit}</div>'
            . '<div>{obj:sorter}</div>'
            . '<div class="wide">{obj:options}</div>'
            . '<div class="wide dbx-shop-admin-check-grid">{obj:required}{obj:filterable}{obj:comparable}{obj:active}</div>'
            . '</div>'
         );
         return $form->run();
      };
 
      $cards = $cardHtml(array(
         'group_id' => (int)array_key_first($groupOptions),
         'input_type' => 'text',
         'required' => 0,
         'filterable' => 1,
         'comparable' => 0,
         'active' => 1,
         'sorter' => 100,
      ), true);
      foreach ($this->repo()->allAttributeDefinitions() as $attribute) {
         $cards .= $cardHtml($attribute);
      }
 
      $barActions = $this->helpButton($this->ensureShopProductAttributesHelpPage(), 'Hilfe: Artikelattribute');
      return $this->frame('<div class="alert alert-info mx-3 mt-3 mb-0">Artikelattribute definieren gruppenspezifische Eingabefelder wie Farbe, Groesse, Material oder technische Werte.</div><div class="dbx-shop-admin-card-list">' . $cards . '</div>', 'Artikelattribute', $barActions);
   }
 
   private function productAttributes(): string {
      $this->ensureSeed();
      $productId = (int)dbx()->get_modul_var('id', '0', 'int');
      if ($this->posted('save_product_attributes')) {
         $productId = (int)($_POST['product_id'] ?? $productId);
         $this->repo()->saveProductAttributeValues($productId, $_POST['attr_value'] ?? array());
      }
      $product = $this->repo()->productById($productId);
      if (!$product) {
         return $this->placeholder('Artikelattribute', 'Artikel wurde nicht gefunden.');
      }
 
      $valueMap = array();
      foreach (($product['attributes'] ?? array()) as $attribute) {
         $valueMap[(int)($attribute['id'] ?? 0)] = (string)($attribute['value_text'] ?? '');
      }
 
      $rows = '';
      foreach ($this->repo()->attributeDefinitionsForProduct($productId, true) as $definition) {
         $id = (int)($definition['id'] ?? 0);
         $value = $valueMap[$id] ?? '';
         $type = (string)($definition['input_type'] ?? 'text');
         $input = '';
         if ($type === 'select') {
            $input = '<select class="form-select form-select-sm" name="attr_value[' . $id . ']"><option value="">-</option>';
            foreach ($this->attributeOptions((string)($definition['options'] ?? '')) as $option) {
               $input .= '<option value="' . $this->h($option) . '"' . ($option === $value ? ' selected' : '') . '>' . $this->h($option) . '</option>';
            }
            if ($value !== '' && strpos((string)($definition['options'] ?? ''), $value) === false) {
               $input .= '<option value="' . $this->h($value) . '" selected>' . $this->h($value) . '</option>';
            }
            $input .= '</select>';
         } else {
            $inputType = $type === 'number' ? 'number' : 'text';
            $step = $type === 'number' ? ' step="0.01"' : '';
            $input = '<input class="form-control form-control-sm" type="' . $inputType . '"' . $step . ' name="attr_value[' . $id . ']" value="' . $this->h($value) . '">';
         }
         $rows .= '<tr>';
         $rows .= '<td><strong>' . $this->h($definition['title'] ?? '') . '</strong><br><small><code>' . $this->h($definition['attr_key'] ?? '') . '</code></small></td>';
         $rows .= '<td>' . $input . '</td>';
         $rows .= '<td>' . $this->h($definition['unit'] ?? '') . '</td>';
         $rows .= '<td>' . ((int)($definition['required'] ?? 0) === 1 ? '<span class="badge text-bg-warning">Pflicht</span>' : '') . ' ' . ((int)($definition['filterable'] ?? 0) === 1 ? '<span class="badge text-bg-info">Filter</span>' : '') . '</td>';
         $rows .= '</tr>';
      }
 
      if ($rows === '') {
         $rows = '<tr><td colspan="4" class="text-muted">Fuer die Artikelgruppe sind noch keine Attribute definiert.</td></tr>';
      }
 
      $form = $this->shopAdminCardForm(
         'shop-product-attributes-' . $productId,
         'dbxShop|shopProductAttributeValue',
         array('id' => $productId),
         $productId,
         '?dbx_modul=dbxShop_admin&dbx_run1=product_attributes&id=' . $productId,
         'save_product_attributes',
         'save_product_attributes',
         '<code>' . $this->h($product['sku'] ?? '') . '</code><span>' . $this->h($product['title'] ?? '') . '</span>',
         'Attributwerte dieses Artikels bearbeiten.',
         'dbx-shop-product-attributes-card'
      );
      $form->add_rep('extra_hidden', '<input type="hidden" name="product_id" value="' . $productId . '">');
      $form->add_rep('card_badges', $this->helpButton($this->ensureShopProductAttributesHelpPage(), 'Hilfe: Artikelattribute', 'btn btn-outline-secondary btn-sm me-1') . '<a class="btn btn-outline-secondary btn-sm" href="?dbx_modul=dbxShop_admin&dbx_run1=products">Zurueck</a>');
      $form->add_rep('form_body', '<div class="table-responsive"><table class="table table-sm align-middle mb-0"><thead><tr><th>Attribut</th><th>Wert</th><th>Einheit</th><th>Eigenschaft</th></tr></thead><tbody>' . $rows . '</tbody></table></div>');
      return $this->frame('<div class="dbx-shop-admin-card-list">' . $form->run() . '</div>', 'Artikelattribute bearbeiten');
   }
 
   private function shippingGroups(): string {
      $this->ensureSeed();
      if ($this->posted('delete_shipping_group')) {
         $this->repo()->deleteShippingGroup((int)($_POST['id'] ?? 0));
      } elseif ($this->posted('save_shipping_group')) {
         $this->repo()->updateShippingGroup((int)($_POST['id'] ?? 0), $_POST);
      }
 
      $cardHelpButton = $this->helpButton($this->ensureShopShippingGroupsHelpPage(), 'Hilfe: Versandgruppen', 'btn btn-outline-secondary btn-sm me-1');
      $cardHtml = function (array $group, bool $isNew = false) use ($cardHelpButton): string {
         $id = (int)($group['id'] ?? 0);
         if ($isNew) {
            $title = '<span>Neue Versandgruppe</span>';
            $subtitle = 'Versandweg, Lieferzeit, Kosten und Sortierung festlegen.';
         } else {
            $title = '<code>' . $this->h($group['group_key'] ?? '') . '</code><span>' . $this->h($group['title'] ?? '') . '</span>';
            $subtitle = trim((string)($group['description'] ?? ''));
         }
 
         $form = $this->shopAdminCardForm(
            'shop-shipping-group-' . ($isNew ? 'new' : $id),
            'dbxShop|shopShippingGroup',
            $group,
            $id,
            '?dbx_modul=dbxShop_admin&dbx_run1=shipping_groups' . ($isNew ? '&new=1' : ''),
            'save_shipping_group',
            'save_shipping_group',
            $title,
            $subtitle,
            'dbx-shop-shipping-group-card'
         );
         $form->add_rep('card_badges', $cardHelpButton . ($isNew ? '<span class="badge text-bg-primary">Neu</span>' : $this->activeBadge($group)));
         if (!$isNew) {
            $form->add_rep('delete_button', $this->shopAdminCardDeleteButton('delete_shipping_group', 'Versandgruppe loeschen', 'Diese Versandgruppe wirklich loeschen?'));
         }
         if ($isNew) {
            $form->add_fld('group_key', tpl: 'text-label', label: 'Key', placeholder: 'versandgruppe-key', rules: '*|parameter|max=80');
         }
         $form->add_fld('title', tpl: 'text-label', label: 'Versandgruppe', placeholder: 'Neue Versandgruppe', rules: '*|max=160');
         $form->add_fld('description', tpl: 'textarea-label', label: 'Beschreibung', placeholder: 'Beschreibung', data: 'rows=2');
         $form->add_fld('shipping_way', tpl: 'text-label', label: 'Versandweg', placeholder: 'Paketdienst');
         $form->add_fld('delivery_time', tpl: 'text-label', label: 'Lieferzeit', placeholder: '1-3 Werktage');
         $form->add_fld('shipping_gross', tpl: 'text-label', label: 'Kosten brutto', placeholder: '5.90', rules: 'decimal');
         $form->add_fld('free_from_gross', tpl: 'text-label', label: 'Frei ab brutto', placeholder: '-1', rules: 'decimal');
         $form->add_fld('sorter', tpl: 'text-label', label: 'Sort', rules: 'int');
         $form->add_fld('active', tpl: 'checkbox-label', label: 'Aktiv', rules: 'int');
         $form->add_rep('form_body',
            '<div class="dbx-shop-admin-card-grid">'
            . ($isNew ? '<div>{obj:group_key}</div>' : '')
            . '<div>{obj:title}</div>'
            . '<div>{obj:shipping_way}</div>'
            . '<div>{obj:delivery_time}</div>'
            . '<div>{obj:shipping_gross}</div>'
            . '<div>{obj:free_from_gross}</div>'
            . '<div>{obj:sorter}</div>'
            . '<div>{obj:active}</div>'
            . '<div class="wide">{obj:description}</div>'
            . '</div>'
         );
         return $form->run();
      };
 
      $groups = $this->repo()->shippingGroups();
      $cards = '';
      if ((int)($_GET['new'] ?? 0) === 1) {
         $sorter = 10;
         foreach ($groups as $group) {
            $sorter = max($sorter, (int)($group['sorter'] ?? 0) + 10);
         }
         $cards .= $cardHtml(array(
            'shipping_gross' => 0,
            'free_from_gross' => -1,
            'active' => 1,
            'sorter' => $sorter,
         ), true);
      }
      foreach ($groups as $group) {
         $cards .= $cardHtml($group);
      }
      $helpButton = $this->helpButton($this->ensureShopShippingGroupsHelpPage(), 'Hilfe: Versandgruppen');
      $barActions = '<a class="btn btn-outline-primary btn-sm me-1" href="?dbx_modul=dbxShop_admin&dbx_run1=shipping_groups&new=1" title="Neue Versandgruppe anlegen"><i class="bi bi-plus-square"></i><span class="visually-hidden"> Neue Versandgruppe</span></a>' . $helpButton;
      return $this->frame('<div class="alert alert-info mx-3 mt-3 mb-0">Versandgruppen beschreiben Lieferart, Lieferzeit und Kosten. Artikel koennen diese Gruppe nutzen oder eigene Versandwerte ueberschreiben.</div><div class="dbx-shop-admin-card-list">' . $cards . '</div>', 'Versandgruppen', $barActions);
   }
 
   private function channelGroups(): string {
      $this->ensureSeed();
      if ($this->posted('delete_channel_group')) {
         $this->repo()->deleteChannelGroup((int)($_POST['id'] ?? 0));
      } elseif ($this->posted('save_channel_group')) {
         $this->repo()->updateChannelGroup((int)($_POST['id'] ?? 0), $_POST, array_map('strval', $_POST['channels'] ?? array()));
      }
      $channels = $this->repo()->channels();
      $groups = $this->repo()->channelGroups();
      $cardHelpButton = $this->helpButton($this->ensureShopChannelHelpPage(), 'Hilfe: Channel-Gruppen', 'btn btn-outline-secondary btn-sm me-1');
      $cardHtml = function (array $group, bool $isNew = false) use ($channels, $cardHelpButton): string {
         $id = (int)($group['id'] ?? 0);
         $active = array();
         foreach (($group['channels'] ?? array()) as $channel) {
            if ((int)($channel['active'] ?? 0) === 1) {
               $active[] = (string)$channel['channel_key'];
            }
         }
         $checks = '<div class="dbx-shop-admin-check-grid">';
         foreach ($channels as $channel) {
            $key = (string)($channel['channel_key'] ?? '');
            if ($key === '') {
               continue;
            }
            $checks .= '<label><input type="checkbox" name="channels[]" value="' . $this->h($key) . '"' . (in_array($key, $active, true) ? ' checked' : '') . '> <span>' . $this->h($channel['title'] ?? $key) . '</span></label>';
         }
         $checks .= '</div>';
 
         if ($isNew) {
            $title = '<span>Neue Channel-Gruppe</span>';
            $subtitle = 'Channels zusammenfassen, damit Artikel sie als Gruppe nutzen koennen.';
         } else {
            $title = '<code>' . $this->h($group['group_key'] ?? '') . '</code><span>' . $this->h($group['title'] ?? '') . '</span>';
            $subtitle = trim((string)($group['description'] ?? ''));
         }
 
         $form = $this->shopAdminCardForm(
            'shop-channel-group-' . ($isNew ? 'new' : $id),
            'dbxShop|shopChannelGroup',
            $group,
            $id,
            '?dbx_modul=dbxShop_admin&dbx_run1=channel_groups' . ($isNew ? '&new=1' : ''),
            'save_channel_group',
            'save_channel_group',
            $title,
            $subtitle,
            'dbx-shop-channel-group-card'
         );
         $form->add_rep('card_badges', $cardHelpButton . ($isNew ? '<span class="badge text-bg-primary">Neu</span>' : $this->activeBadge($group)));
         if (!$isNew) {
            $form->add_rep('delete_button', $this->shopAdminCardDeleteButton('delete_channel_group', 'Channel-Gruppe loeschen', 'Diese Channel-Gruppe wirklich loeschen?'));
         }
         if ($isNew) {
            $form->add_fld('group_key', tpl: 'text-label', label: 'Key', placeholder: 'neue-channel-gruppe', rules: '*|parameter|max=80');
         }
         $form->add_fld('title', tpl: 'text-label', label: 'Channel-Gruppe', placeholder: 'Neue Channel-Gruppe', rules: '*|max=160');
         $form->add_fld('description', tpl: 'textarea-label', label: 'Beschreibung', placeholder: 'Beschreibung', data: 'rows=2');
         $form->add_fld('sorter', tpl: 'text-label', label: 'Sort', rules: 'int');
         $form->add_fld('active', tpl: 'checkbox-label', label: 'Aktiv', rules: 'int');
         $form->add_obj('channel_checks', 'obj-value', $checks);
         $form->add_rep('form_body',
            '<div class="dbx-shop-admin-card-grid">'
            . ($isNew ? '<div>{obj:group_key}</div>' : '')
            . '<div>{obj:title}</div>'
            . '<div>{obj:sorter}</div>'
            . '<div>{obj:active}</div>'
            . '<div class="wide">{obj:description}</div>'
            . '<div class="wide"><label class="form-label">Channels</label>{obj:channel_checks}</div>'
            . '</div>'
         );
         return $form->run();
      };
 
      $cards = '';
      if ((int)($_GET['new'] ?? 0) === 1) {
         $sorter = 10;
         foreach ($groups as $group) {
            $sorter = max($sorter, (int)($group['sorter'] ?? 0) + 10);
         }
         $cards .= $cardHtml(array(
            'title' => '',
            'description' => '',
            'active' => 1,
            'sorter' => $sorter,
            'channels' => array(),
         ), true);
      }
      foreach ($groups as $group) {
         $cards .= $cardHtml($group);
      }
      $helpButton = $this->helpButton($this->ensureShopChannelHelpPage(), 'Hilfe: Channel-Gruppen');
      $barActions = '<a class="btn btn-outline-primary btn-sm me-1" href="?dbx_modul=dbxShop_admin&dbx_run1=channel_groups&new=1" title="Neue Channel-Gruppe anlegen"><i class="bi bi-plus-square"></i><span class="visually-hidden"> Neue Channel-Gruppe</span></a>' . $helpButton;
      return $this->frame('<div class="alert alert-info mx-3 mt-3 mb-0">Channel-Gruppen buendeln Verkaufskanaele. Artikel koennen diese Gruppe erben und bei Bedarf eigene Channel-Ausnahmen setzen.</div><div class="dbx-shop-admin-card-list">' . $cards . '</div>', 'Channel-Gruppen', $barActions);
   }
 
   private function shopMediaDir(): string {
      $dir = dirname(__DIR__, 4) . '/files/shop/img';
      if (!is_dir($dir)) {
         mkdir($dir, 0775, true);
      }
      return $dir;
   }
 
   private function safeFileName(string $name): string {
      $name = strtolower(trim($name));
      $name = preg_replace('~[^a-z0-9._-]+~', '-', $name);
      $name = trim((string)$name, '-.');
      return $name !== '' ? $name : 'shop-image';
   }
 
   private function handleMediaUpload(): string {
      if (!$this->posted('upload_media')) {
         return '';
      }
      if (empty($_FILES['shop_image']['tmp_name']) || !is_uploaded_file($_FILES['shop_image']['tmp_name'])) {
         return '<div class="alert alert-warning m-3">Keine Datei ausgewaehlt.</div>';
      }
      $original = (string)($_FILES['shop_image']['name'] ?? 'shop-image');
      $ext = strtolower(pathinfo($original, PATHINFO_EXTENSION));
      $allowed = array('jpg','jpeg','png','gif','webp','svg');
      if (!in_array($ext, $allowed, true)) {
         return '<div class="alert alert-danger m-3">Dieser Bildtyp ist fuer Shop-Medien nicht erlaubt.</div>';
      }
 
      $base = $this->safeFileName(pathinfo($original, PATHINFO_FILENAME));
      $name = $base . '.' . $ext;
      $target = $this->shopMediaDir() . '/' . $name;
      $i = 2;
      while (is_file($target)) {
         $name = $base . '-' . $i . '.' . $ext;
         $target = $this->shopMediaDir() . '/' . $name;
         $i++;
      }
      if (!move_uploaded_file($_FILES['shop_image']['tmp_name'], $target)) {
         return '<div class="alert alert-danger m-3">Upload konnte nicht gespeichert werden.</div>';
      }
 
      $rel = 'files/shop/img/' . $name;
      $productId = (int)($_POST['product_id'] ?? 0);
      $groupId = (int)($_POST['group_id'] ?? 0);
      if ($productId > 0 || $groupId > 0) {
         $this->repo()->saveImage($productId, $groupId, $rel, (string)($_POST['title'] ?? $base), (string)($_POST['alt'] ?? $base), !empty($_POST['is_primary']) ? 1 : 0, (int)($_POST['sorter'] ?? 100));
      }
      return '<div class="alert alert-success m-3">Bild wurde hochgeladen: ' . $this->h($name) . '</div>';
   }
 
   private function media(): string {
      $this->ensureSeed();
      $this->ensureCmsShopMediaFolder();
      $this->syncShopMediaUsage();
      $selectedProduct = (int)dbx()->get_modul_var('product_id', '0', 'int');
      $selectedGroup = (int)dbx()->get_modul_var('group_id', '0', 'int');
 
      $productOptions = '<option value="0">Kein einzelner Artikel</option>';
      foreach ($this->repo()->products(false) as $product) {
         $sel = (int)($product['id'] ?? 0) === $selectedProduct ? ' selected' : '';
         $productOptions .= '<option value="' . (int)($product['id'] ?? 0) . '"' . $sel . '>' . $this->h($product['title'] ?? '') . '</option>';
      }
      $groupOptions = '<option value="0">Keine Artikelgruppe</option>';
      foreach ($this->repo()->groups() as $group) {
         $sel = (int)($group['id'] ?? 0) === $selectedGroup ? ' selected' : '';
         $groupOptions .= '<option value="' . (int)($group['id'] ?? 0) . '"' . $sel . '>' . $this->h($group['title'] ?? '') . '</option>';
      }
 
      $mediaCfg = $this->shopMediaConfig();
      $attrs = $this->shopMediaAttrs($mediaCfg);
 
      $html = '<div class="dbx-shop-media-manager m-3"' . $attrs . '>';
      $targetForm = dbx()->get_system_obj('dbxForm');
      $targetForm->init('shop-media-target-form', 'shop-media-target-form');
      $targetForm->_action = '?dbx_modul=dbxShop_admin&dbx_run1=media';
      $targetForm->add_rep('frame_skip_form_wrap', '1');
      $targetForm->add_rep('frame_form_open', '<form action="?dbx_modul=dbxShop_admin&dbx_run1=media" method="get" class="dbx-shop-media-target-filter">');
      $targetForm->add_rep('frame_form_close', '</form>');
      $targetForm->add_rep('form_body',
         '<div class="row g-2 align-items-end">'
         . '<div class="col-md-4"><label class="form-label">Artikel</label><select class="form-select form-select-sm" name="product_id" data-shop-product-select>' . $productOptions . '</select></div>'
         . '<div class="col-md-4"><label class="form-label">Artikelgruppe</label><select class="form-select form-select-sm" name="group_id" data-shop-group-select>' . $groupOptions . '</select></div>'
         . '<div class="col-md-2"><label class="form-label">Sortierung</label><input class="form-control form-control-sm" name="sorter" value="100" data-shop-sorter></div>'
         . '<div class="col-md-2 form-check pb-1"><input class="form-check-input" type="checkbox" name="is_primary" value="1" id="shop_img_primary" data-shop-primary><label class="form-check-label" for="shop_img_primary">Primaerbild</label></div>'
         . '<div class="col-md-8"><div class="form-text">Bilder werden im vorhandenen CMS-Medienbrowser unter <code>files/media/img/shop/</code> verwaltet. Dort sind Upload, Zuschneiden, Resize, Batch und Wartung verfuegbar.</div></div>'
         . '<div class="col-md-2"><button class="btn btn-outline-secondary btn-sm w-100"><i class="bi bi-filter"></i> Auswahl laden</button></div>'
         . '<div class="col-md-2"><button type="button" class="btn btn-outline-primary btn-sm w-100 dbx-shop-media-pick" data-shop-media-folder="img/shop" title="Bilder aus dem Medienbrowser zuordnen"><i class="bi bi-images"></i><i class="bi bi-camera-video"></i><i class="bi bi-upload"></i><span>Auswahl</span></button></div>'
         . '</div>'
      );
      $html .= $targetForm->run();
 
      $assigned = '';
      foreach ($this->repo()->allImages() as $image) {
         $assigned .= '<div class="col"><div class="card h-100"><img src="' . $this->h($this->mediaItemUrl($image, true)) . '" class="card-img-top" alt="" style="height:120px;object-fit:cover;"><div class="card-body p-2"><strong>' . $this->h($image['title'] ?? '') . '</strong><br><small>' . $this->h($image['product_title'] ?: $image['group_title'] ?: 'nicht zugeordnet') . '</small></div></div></div>';
      }
      $html .= '<div class="m-3"><h5>Zugeordnete Shop-Bilder</h5><div class="row row-cols-2 row-cols-md-4 row-cols-xl-6 g-2">' . $assigned . '</div></div>';
 
      $files = glob($this->shopMediaDir() . '/*.{jpg,jpeg,png,gif,webp,svg}', GLOB_BRACE) ?: array();
      $fileCards = '';
      foreach ($files as $file) {
         $rel = 'files/shop/img/' . basename($file);
         $fileCards .= '<div class="col"><div class="card h-100"><img src="' . $this->h($this->mediaUrl($rel)) . '" class="card-img-top" alt="" style="height:120px;object-fit:cover;"><div class="card-body p-2"><small>' . $this->h(basename($file)) . '</small></div></div></div>';
      }
      $html .= '<div class="m-3"><h5>Alte Fallback-Dateien in files/shop/img</h5><div class="row row-cols-2 row-cols-md-4 row-cols-xl-6 g-2">' . $fileCards . '</div></div>';
      $html .= '</div>';
 
      $barActions = $this->helpButton($this->ensureShopMediaHelpPage(), 'Hilfe: Shop-Medien');
      return $this->frame($html, 'Shop-Medien', $barActions);
   }
 
   private function channels(): string {
      $this->ensureSeed();
      $notice = '';
      if ($this->posted('delete_channel')) {
         $this->repo()->deleteChannel((int)($_POST['id'] ?? 0));
      } elseif ($this->posted('save_channel')) {
         $this->repo()->updateChannel((int)($_POST['id'] ?? 0), $_POST);
      } elseif ($this->posted('test_channel')) {
         $id = (int)($_POST['id'] ?? 0);
         if ($id > 0) {
            $this->repo()->updateChannel($id, $_POST);
            $result = $this->repo()->testChannelConnection($id);
            $notice = '<div class="alert ' . (!empty($result['ok']) ? 'alert-success' : 'alert-warning') . ' m-3">' . $this->h($result['message'] ?? '') . '</div>';
         } else {
            $notice = '<div class="alert alert-warning m-3">Neuen Channel bitte zuerst speichern, danach kann die Verbindung getestet werden.</div>';
         }
      }
 
      $platformOptions = array(
         'shop' => 'Shop',
         'amazon' => 'Amazon',
         'ebay' => 'eBay',
         'kleinanzeigen' => 'Kleinanzeigen',
         'mobile' => 'mobile.de',
         'custom' => 'Eigener Channel',
      );
      $modeOptions = array(
         'internal' => 'Intern',
         'manual' => 'Manuell',
         'api' => 'API',
         'feed' => 'Feed',
         'webhook' => 'Webhook',
      );
 
      $platformHints = array(
         'shop' => array('Interner Shop-Channel ohne externe API.', 'Keine externen Zugangsdaten notwendig.', 'Bestellungen entstehen direkt im Shop.'),
         'amazon' => array('Amazon SP-API Zugangsdaten und Seller-Kontext pflegen.', 'Listings laufen ueber Amazon Produktschemas und Marketplace-Daten.', 'Rueckmeldungen kommen ueber Orders/Notifications, meist per SQS.'),
         'ebay' => array('eBay Sell API Zugangsdaten und OAuth-Scopes pflegen.', 'Listings brauchen Marketplace, Kategorie, Standort und Business Policy IDs.', 'Rueckmeldungen kommen ueber Fulfillment API oder Notification API.'),
         'kleinanzeigen' => array('Kleinanzeigen ist hier als manueller oder vertraglicher Channel vorbereitet.', 'Eine allgemein frei nutzbare offizielle Anzeigen-/Order-API ist nicht hinterlegt.', 'Order-Import nur nutzen, wenn eine freigegebene Schnittstelle oder Middleware vorhanden ist.'),
         'mobile' => array('mobile.de API-Zugang und Haendlerkennung pflegen.', 'Anzeigen sind Fahrzeug-/Inseratsdaten, nicht klassische Shop-Produkte.', 'Rueckmeldungen kommen eher ueber Lead API oder Direct Offers.'),
         'custom' => array('Eigener Channel fuer individuelle Schnittstellen.', 'API-URL, Zugangsdaten und Payload-Mapping muessen zum Adapter passen.', 'Rueckmeldungen koennen den generischen dbxShop-Webhook nutzen.'),
      );
 
      $rowHtml = function (array $channel, bool $isNew = false) use ($platformOptions, $modeOptions, $platformHints): string {
         $id = (int)($channel['id'] ?? 0);
         $key = (string)($channel['channel_key'] ?? '');
         $platform = (string)($channel['platform_type'] ?? 'custom');
         $hint = $platformHints[$platform] ?? $platformHints['custom'];
         $placeholderMap = array(
            'shop' => array(
               'channel_key' => 'shop',
               'api_base_url' => 'nicht benoetigt',
               'api_client_id' => 'nicht benoetigt',
               'api_username' => 'nicht benoetigt',
               'api_client_secret' => 'nicht benoetigt',
               'api_access_token' => 'nicht benoetigt',
               'api_refresh_token' => 'nicht benoetigt',
               'api_password' => 'nicht benoetigt',
               'marketplace_id' => 'nicht benoetigt',
               'seller_id' => 'nicht benoetigt',
               'account_id' => 'nicht benoetigt',
               'location_key' => 'nicht benoetigt',
               'category_id' => 'nicht benoetigt',
               'payment_policy_id' => 'nicht benoetigt',
               'fulfillment_policy_id' => 'nicht benoetigt',
               'return_policy_id' => 'nicht benoetigt',
               'notification_destination' => 'nicht benoetigt',
               'notification_topic' => 'nicht benoetigt',
               'webhook_secret' => 'nicht benoetigt',
               'webhook_url' => 'nicht benoetigt',
               'api_scope' => 'nicht benoetigt',
            ),
            'amazon' => array(
               'channel_key' => 'amazon',
               'api_base_url' => 'https://sellingpartnerapi-eu.amazon.com',
               'api_client_id' => 'amzn1.application-oa2-client.keyxxxx',
               'api_username' => 'nicht benoetigt bei OAuth',
               'api_client_secret' => 'amzn1.oa2-cs.v1.secretxxxx',
               'api_access_token' => 'Atza|access_token_xxxx',
               'api_refresh_token' => 'Atzr|refresh_token_xxxx',
               'api_password' => 'nicht benoetigt bei SP-API',
               'marketplace_id' => 'A1PA6795UKMFR9',
               'seller_id' => 'A1SELLERIDXXXX',
               'account_id' => 'account_xxxx',
               'location_key' => 'nicht benoetigt',
               'category_id' => 'productType: SOFTWARE / PRODUCT',
               'payment_policy_id' => 'nicht benoetigt',
               'fulfillment_policy_id' => 'nicht benoetigt',
               'return_policy_id' => 'nicht benoetigt',
               'notification_destination' => 'arn:aws:sqs:eu-central-1:123456789012:amazon-orders',
               'notification_topic' => 'ORDER_CHANGE',
               'webhook_secret' => 'secret_64zeichen_xxxx',
               'webhook_url' => 'wird von dbxShop erzeugt',
               'api_scope' => "Listings Items\nOrders\nNotifications",
            ),
            'ebay' => array(
               'channel_key' => 'ebay',
               'api_base_url' => 'https://api.ebay.com',
               'api_client_id' => 'keyxxxx-appid',
               'api_username' => 'nicht benoetigt bei OAuth',
               'api_client_secret' => 'certid-secretxxxx',
               'api_access_token' => 'v^1.1#i^1#p^3#access_token_xxxx',
               'api_refresh_token' => 'v^1.1#r^1#p^3#refresh_token_xxxx',
               'api_password' => 'nicht benoetigt bei OAuth',
               'marketplace_id' => 'EBAY_DE',
               'seller_id' => 'sellername_xxxx',
               'account_id' => 'account_xxxx',
               'location_key' => 'default',
               'category_id' => '58058',
               'payment_policy_id' => 'policy_payment_1234567890',
               'fulfillment_policy_id' => 'policy_fulfillment_1234567890',
               'return_policy_id' => 'policy_return_1234567890',
               'notification_destination' => 'https://domain.de/?dbx_modul=dbxShop&dbx_run1=channel_webhook&channel=ebay',
               'notification_topic' => 'ORDER',
               'webhook_secret' => 'verification_token_xxxx',
               'webhook_url' => 'wird von dbxShop erzeugt',
               'api_scope' => "https://api.ebay.com/oauth/api_scope/sell.inventory\nhttps://api.ebay.com/oauth/api_scope/sell.fulfillment\nhttps://api.ebay.com/oauth/api_scope/commerce.notification.subscription",
            ),
            'kleinanzeigen' => array(
               'channel_key' => 'kleinanzeigen',
               'api_base_url' => 'nur bei freigegebener Schnittstelle',
               'api_client_id' => 'partner_key_xxxx',
               'api_username' => 'api-user@example.de',
               'api_client_secret' => 'partner_secret_xxxx',
               'api_access_token' => 'access_token_xxxx',
               'api_refresh_token' => 'refresh_token_xxxx',
               'api_password' => 'password_xxxx',
               'marketplace_id' => 'DE',
               'seller_id' => 'seller_xxxx',
               'account_id' => 'account_xxxx',
               'location_key' => 'standort_10115_berlin',
               'category_id' => 'category_12345',
               'payment_policy_id' => 'nicht benoetigt',
               'fulfillment_policy_id' => 'nicht benoetigt',
               'return_policy_id' => 'nicht benoetigt',
               'notification_destination' => 'https://middleware.example.de/webhook',
               'notification_topic' => 'lead / message / sale',
               'webhook_secret' => 'middleware_secret_xxxx',
               'webhook_url' => 'wird von dbxShop erzeugt',
               'api_scope' => "laut Vertrag\nMiddleware-Berechtigung",
            ),
            'mobile' => array(
               'channel_key' => 'mobile',
               'api_base_url' => 'https://services.mobile.de/seller-api',
               'api_client_id' => 'nicht benoetigt bei Basic Auth',
               'api_username' => 'dealer_api_user_xxxx',
               'api_client_secret' => 'nicht benoetigt bei Basic Auth',
               'api_access_token' => 'nicht benoetigt bei Basic Auth',
               'api_refresh_token' => 'nicht benoetigt bei Basic Auth',
               'api_password' => 'dealer_api_password_xxxx',
               'marketplace_id' => 'DE',
               'seller_id' => 'customer_123456',
               'account_id' => 'mobileSellerId_123456',
               'location_key' => 'location_123456',
               'category_id' => 'car / motorbike / commercial',
               'payment_policy_id' => 'nicht benoetigt',
               'fulfillment_policy_id' => 'nicht benoetigt',
               'return_policy_id' => 'nicht benoetigt',
               'notification_destination' => 'https://middleware.example.de/mobile-leads',
               'notification_topic' => 'lead-api',
               'webhook_secret' => 'lead_secret_xxxx',
               'webhook_url' => 'wird von dbxShop erzeugt',
               'api_scope' => "seller-api\nbasic-auth\nlead-api",
            ),
            'custom' => array(
               'channel_key' => 'mein-channel',
               'api_base_url' => 'https://api.anbieter.de/v1',
               'api_client_id' => 'client_123456',
               'api_username' => 'api-user@example.de',
               'api_client_secret' => 'client_secret_xxxxx',
               'api_access_token' => 'access_token_xxxxx',
               'api_refresh_token' => 'refresh_token_xxxxx',
               'api_password' => 'API-Passwort',
               'marketplace_id' => 'DE',
               'seller_id' => 'seller_123456',
               'account_id' => 'account_123456',
               'location_key' => 'lager-1',
               'category_id' => '12345',
               'payment_policy_id' => 'payment_123',
               'fulfillment_policy_id' => 'shipping_123',
               'return_policy_id' => 'return_123',
               'notification_destination' => 'https://domain.de/webhook',
               'notification_topic' => 'order.created',
               'webhook_secret' => 'zufaelliges-geheimes-secret',
               'webhook_url' => 'wird von dbxShop erzeugt',
               'api_scope' => "products:write\norders:read\nwebhooks:read",
            ),
         );
         $placeholders = $placeholderMap[$platform] ?? $placeholderMap['custom'];
         $ph = function (string $field) use ($placeholders): string {
            return $this->h($placeholders[$field] ?? '');
         };
         $secretPlaceholder = function (string $field) use ($placeholders): string {
            return $this->h((string)($placeholders[$field] ?? ''));
         };
         $status = (string)($channel['test_status'] ?? '');
         $statusBadge = $status === 'ok'
            ? '<span class="badge text-bg-success">Test ok</span>'
            : ($status === 'error' ? '<span class="badge text-bg-warning">Test offen</span>' : '<span class="badge text-bg-secondary">Nicht getestet</span>');
         $activeBadge = (int)($channel['active'] ?? 1) === 1
            ? '<span class="badge text-bg-success">Aktiv</span>'
            : '<span class="badge text-bg-secondary">Inaktiv</span>';
         $exportBadge = (int)($channel['export_enabled'] ?? 0) === 1 ? '<span class="badge text-bg-info">Export</span>' : '';
         $orderBadge = (int)($channel['order_import_enabled'] ?? 0) === 1 ? '<span class="badge text-bg-primary">Order-Import</span>' : '';
         $webhookPath = ($key !== '' && $platform !== 'shop') ? '?dbx_modul=dbxShop&dbx_run1=channel_webhook&channel=' . rawurlencode($key) : '';
         $open = $isNew || (int)($_GET['edit'] ?? 0) === $id;
         $editUrl = '?dbx_modul=dbxShop_admin&dbx_run1=channels&edit=' . $id;
         $helpId = $this->ensureShopChannelProviderHelpPage($platform);
         $helpButton = '';
         if ($helpId > 0) {
            $helpTitle = 'Hilfe: Channel ' . ($platformOptions[$platform] ?? 'Channel');
            $helpButton = $this->openWinButton(
               '?dbx_modul=dbxContent&dbx_run1=content&cid=' . $helpId . '&dbx_ajax=1',
               $helpTitle,
               '<i class="bi bi-question-circle"></i><span class="visually-hidden"> Hilfe</span>',
               'btn btn-outline-secondary btn-sm dbx-shop-channel-help',
               '72%',
               '82%'
            );
            $helpButton = str_replace('<a ', '<a onclick="event.stopPropagation();" ', $helpButton);
         }
 
         $form = dbx()->get_system_obj('dbxForm');
         $form->init('shop-channel-form-' . ($isNew ? 'new' : $id), 'shop-channel-form');
         $form->_dd = 'dbxShop|shopChannel';
         $form->_fd = 'dbxShop|shop-channel';
         $form->_data = $channel + array('id' => $id);
         $form->_rid = $isNew ? 0 : $id;
         $form->_action = '?dbx_modul=dbxShop_admin&dbx_run1=channels' . ($isNew ? '&new=1' : '&edit=' . $id);
         $form->set_activ_id($isNew ? 0 : $id);
         $form->add_rep('frame_skip_form_wrap', '0');
         $form->add_rep('form_class', 'dbx-shop-channel-dbXForm');
         $form->add_rep('form_attrs', 'data-target="dbxForm_{i}" data-dbx="lib=confirm|class=dbxConfirm|bind=button"');
         $form->add_rep('details_open', $open ? ' open' : '');
         $form->add_rep('channel_key_view', $this->h($key !== '' ? $key : 'neu'));
         $form->add_rep('channel_title_view', $this->h($channel['title'] ?? 'Neuer Channel'));
         $form->add_rep('platform_view', $this->h($platformOptions[$platform] ?? $platform));
         $form->add_rep('connection_view', $this->h($modeOptions[(string)($channel['connection_mode'] ?? 'manual')] ?? ($channel['connection_mode'] ?? 'manual')));
         $form->add_rep('active_badge', $activeBadge);
         $form->add_rep('export_badge', $exportBadge);
         $form->add_rep('order_badge', $orderBadge);
         $form->add_rep('status_badge', $statusBadge);
         $form->add_rep('last_test_date', !empty($channel['last_test_date']) ? $this->h($channel['last_test_date']) : '');
         $form->add_rep('channel_help_button', $helpButton);
         $form->add_rep('channel_edit_button', !$isNew ? '<a class="btn btn-outline-primary btn-sm dbx-shop-channel-edit" onclick="event.stopPropagation();" href="' . $this->h($editUrl) . '" title="Channel bearbeiten"><i class="bi bi-pencil-square"></i> Bearbeiten</a>' : '');
         $form->add_rep('hint_api', $this->h($hint[0]));
         $form->add_rep('hint_listing', $this->h($hint[1]));
         $form->add_rep('hint_feedback', $this->h($hint[2]));
         $form->add_rep('test_message', !empty($channel['test_message']) ? '<div class="col-12"><div class="alert alert-secondary py-2 mb-0">' . $this->h($channel['test_message']) . '</div></div>' : '');
         $form->add_rep('test_button', !$isNew ? '<button class="btn btn-outline-secondary btn-sm ms-1" name="shop_action" value="test_channel" title="Verbindung testen"><i class="bi bi-plug"></i> Test</button>' : '');
         $form->add_rep('delete_button', !$isNew ? '<button type="submit" class="btn btn-outline-danger btn-sm ms-1 dbxConfirm" name="shop_action" value="delete_channel" title="Channel loeschen" data-confirm-title="<i class=\'bi bi-trash\'></i> Channel loeschen" data-confirm="Diesen Channel wirklich loeschen?" data-confirm-hint="<small>Artikelzuordnungen fuer diesen Channel werden deaktiviert. Dieser Vorgang sollte nur ausgefuehrt werden, wenn der Channel nicht mehr verwendet werden soll.</small>" data-confirm-buttons="yesno"><i class="bi bi-trash"></i></button>' : '');
         $form->_msg_info = '';
 
         $form->add_fld('id', tpl: 'dbx|hidden', label: 'ID', rules: 'int', dd: 'dd::');
         $form->add_fld('channel_key', label: 'Key', placeholder: $placeholders['channel_key'] ?? '', data: $isNew ? '' : 'readonly=readonly');
         $form->add_fld('title', label: 'Channel');
         $form->add_fld('platform_type', tpl: 'select-single-label', label: 'Plattform', options: $platformOptions);
         $form->add_fld('connection_mode', tpl: 'select-single-label', label: 'Verbindung', options: $modeOptions);
         $form->add_fld('sorter', label: 'Sort');
         $form->add_fld('active', label: 'Aktiv');
         $form->add_fld('export_enabled', label: 'Export');
         $form->add_fld('order_import_enabled', label: 'Order-Import');
         $form->add_fld('description', label: 'Beschreibung', data: 'rows=2');
         $form->add_fld('api_base_url', placeholder: $placeholders['api_base_url'] ?? '');
         $form->add_fld('api_client_id', placeholder: $placeholders['api_client_id'] ?? '');
         $form->add_fld('api_username', placeholder: $placeholders['api_username'] ?? '');
         $form->add_fld('api_client_secret', placeholder: $secretPlaceholder('api_client_secret'));
         $form->add_fld('api_access_token', placeholder: $secretPlaceholder('api_access_token'));
         $form->add_fld('api_refresh_token', placeholder: $secretPlaceholder('api_refresh_token'));
         $form->add_fld('api_password', placeholder: $secretPlaceholder('api_password'));
         $form->add_fld('marketplace_id', placeholder: $placeholders['marketplace_id'] ?? '');
         $form->add_fld('seller_id', placeholder: $placeholders['seller_id'] ?? '');
         $form->add_fld('account_id', placeholder: $placeholders['account_id'] ?? '');
         $form->add_fld('location_key', placeholder: $placeholders['location_key'] ?? '');
         $form->add_fld('category_id', placeholder: $placeholders['category_id'] ?? '');
         $form->add_fld('payment_policy_id', placeholder: $placeholders['payment_policy_id'] ?? '');
         $form->add_fld('fulfillment_policy_id', placeholder: $placeholders['fulfillment_policy_id'] ?? '');
         $form->add_fld('return_policy_id', placeholder: $placeholders['return_policy_id'] ?? '');
         $form->add_fld('notification_destination', placeholder: $placeholders['notification_destination'] ?? '');
         $form->add_fld('notification_topic', placeholder: $placeholders['notification_topic'] ?? '');
         $form->add_fld('webhook_secret', placeholder: $secretPlaceholder('webhook_secret'));
         $form->add_fld('api_scope', placeholder: $placeholders['api_scope'] ?? '', data: 'rows=2');
         $form->add_obj('webhook_url', 'obj-value', '<label class="form-label">dbxShop Webhook-URL</label><input class="form-control form-control-sm" value="' . $this->h($webhookPath) . '" placeholder="' . $ph('webhook_url') . '" readonly>');
 
         return $form->run();
      };
 
      $channels = $this->repo()->channels();
      $content = $notice . '<div class="m-3 dbx-shop-channel-list">';
      if ((int)($_GET['new'] ?? 0) === 1) {
         $sorter = 10;
         foreach ($channels as $channel) {
            $sorter = max($sorter, (int)($channel['sorter'] ?? 0) + 10);
         }
         $content .= $rowHtml(array(
            'title' => '',
            'platform_type' => 'custom',
            'connection_mode' => 'api',
            'export_enabled' => 1,
            'order_import_enabled' => 1,
            'active' => 1,
            'sorter' => $sorter,
         ), true);
      }
      foreach ($channels as $channel) {
         $content .= $rowHtml($channel);
      }
      $content .= '</div>';
 
      $helpId = $this->ensureShopChannelsHelpPage();
      $helpButton = $helpId > 0
         ? $this->openWinButton('?dbx_modul=dbxContent&dbx_run1=content&cid=' . $helpId . '&dbx_ajax=1', 'Hilfe: Channels', '<i class="bi bi-question-circle"></i><span class="visually-hidden"> Hilfe</span>', 'btn btn-outline-secondary btn-sm me-1', '72%', '82%')
         : '';
      $barActions = '<a class="btn btn-outline-primary btn-sm me-1" href="?dbx_modul=dbxShop_admin&dbx_run1=channels&new=1" title="Neuen Channel anlegen"><i class="bi bi-plus-square"></i><span class="visually-hidden"> Neuer Channel</span></a>' . $helpButton;
      return $this->frame($content, 'Channels', $barActions);
   }
 
   public function run(): string {
      $run = dbx()->get_modul_var('dbx_run1', 'dashboard', 'parameter');
 
      switch ($run) {
         case '':
         case 'dashboard':
         case 'start':
            return $this->dashboard();
 
         case 'install':
            return $this->install();
 
         case 'products':
            return $this->products();
 
         case 'product_edit':
            return $this->productEdit();
 
         case 'product_tree_move':
            return $this->productTreeMove();
 
         case 'product_channel_mapping':
            return $this->productChannelMapping();
 
         case 'products_help':
            return $this->productsHelp();
 
         case 'groups':
            return $this->groups();
 
         case 'attributes':
            return $this->attributes();
 
         case 'product_attributes':
            return $this->productAttributes();
 
         case 'shipping_groups':
            return $this->shippingGroups();
 
         case 'channel_groups':
            return $this->channelGroups();
 
         case 'channels':
            return $this->channels();
 
         case 'media':
            return $this->media();
 
         case 'assign_media':
            return $this->assignMedia();
 
         case 'orders':
            return $this->orders();
 
         case 'order_detail':
            return $this->orderDetail();
 
         case 'order_invoice':
            return $this->orderInvoice();
 
         case 'order_invoice_pdf':
            return $this->orderInvoicePdf();
 
         case 'legal':
            return $this->shopLegalCmsPage(
               'legal',
               'Rechtstexte',
               'Diese Seite kommt aus dem CMS unter /shop/rechtstexte. Inhalte wie Anbieterkennzeichnung, AGB, Zahlung, Versand und Datenschutz-Hinweise werden dort gepflegt.',
               'legal'
            );
 
         case 'returns':
            return $this->returns();
 
         case 'settings':
            return $this->settings();
 
         case 'payment_test':
            return $this->paymentTest();
 
         default:
            return $this->placeholder('Unbekannter Shop-Aufruf', 'dbx_run1=' . $run . ' ist im Shop-Admin-Skeleton noch nicht definiert.');
      }
   }
}
?>