tutorial-series-20260718/job.php

Go to the documentation of this file.

<?php
declare(strict_types=1);
 
$bundleDir = __DIR__;
 
function tutorial_content(string $name): string {
   $path = __DIR__ . '/content/' . $name . '.html';
   $html = file_get_contents($path);
   if ($html === false) {
      throw new RuntimeException('Tutorial-Inhalt fehlt: ' . $path);
   }
   return trim($html);
}
 
function tutorial_page(string $id, string $title, string $permalink, string $description, string $keywords, string $sorter, string $content): array {
   return array(
      'id' => $id,
      'action' => 'page.create',
      'params' => array(
         'lng' => 'de',
         'folder_id' => 15,
         'title' => $title,
         'seo_title' => $title,
         'permalink' => $permalink,
         'description' => $description,
         'keywords' => $keywords,
         'activ' => 1,
         'group_read' => '*',
         'template' => 'c-body1-footer',
         'hero_template' => 'none',
         'hero_image_id' => 'none',
         'gallery_template' => 'image-gallery',
         'gallery_visible_count' => '1',
         'gallery_image_size' => 'original',
         'gallery_lightbox_width' => '100vw',
         'gallery_overflow' => 'tutorial',
         'gallery_click_behavior' => 'lightbox',
         'sorter' => $sorter,
         'content' => $content,
      ),
   );
}
 
function tutorial_image(string $id, string $source, string $fileName, string $title, string $alt, string $caption, ?array $crop = null): array {
   $params = array(
      'source_file' => $source,
      'file_name' => $fileName,
      'media_folder' => 'img/gallery',
      'width' => 1600,
      'height' => 900,
      'fit' => 'contain',
      'quality' => 86,
      'title' => $title,
      'alt' => $alt,
      'caption' => $caption,
      'tags' => 'dbxapp,tutorial,screenshot',
   );
   if ($crop !== null) {
      $params['crop_x'] = $crop[0];
      $params['crop_y'] = $crop[1];
      $params['crop_width'] = $crop[2];
      $params['crop_height'] = $crop[3];
      $params['fit'] = 'cover';
   }
   return array('id' => $id, 'action' => 'media.create_image_variant', 'params' => $params);
}
 
function tutorial_assign(string $id, string $mediaRef, string $pageRef, string $caption): array {
   return array(
      'id' => $id,
      'action' => 'media.assign',
      'params' => array(
         'media_id' => '$ref:' . $mediaRef . '.media_id',
         'content_id' => '$ref:' . $pageRef . '.page_id',
         'slot' => 'gallery',
         'lng' => 'de',
         'caption' => $caption,
      ),
   );
}
 
function tutorial_assign_existing(string $id, int $mediaId, int $pageId, string $caption): array {
   return array(
      'id' => $id,
      'action' => 'media.assign',
      'params' => array(
         'media_id' => $mediaId,
         'content_id' => $pageId,
         'slot' => 'gallery',
         'lng' => 'de',
         'caption' => $caption,
      ),
   );
}
 
$steps = array();
 
// Bestehendes dbxKi-Tutorial zum vollstaendigen dbxContent/dbxKi-Ablauf ausbauen.
$steps[] = array(
   'id' => 'update_dbxcontent_dbxki',
   'action' => 'page.update',
   'params' => array(
      'lng' => 'de',
      'id' => 89,
      'patch' => array(
         'title' => 'Tutorial: dbxContent mit dbxKi',
         'seo_title' => 'Tutorial: dbxContent mit dbxKi',
         'description' => 'Neue CMS-Seiten, gezielte Änderungen, Medien, Prüfung und Übersetzungen mit dbxKi – Schritt für Schritt.',
         'keywords' => 'dbxContent, dbxKi, CMS, Content erstellen, Content ändern, Übersetzung, Tutorial',
         'content' => tutorial_content('dbxcontent-dbxki'),
         'template' => 'c-body1-footer',
         'hero_template' => 'none',
         'hero_image_id' => 'none',
         'gallery_template' => 'image-gallery',
         'gallery_visible_count' => '1',
         'gallery_image_size' => 'original',
         'gallery_lightbox_width' => '100vw',
         'gallery_overflow' => 'tutorial',
         'gallery_click_behavior' => 'lightbox',
      ),
   ),
);
 
foreach (array(507, 508, 509, 510, 511) as $usageId) {
   $steps[] = array(
      'id' => 'unassign_dbxki_' . $usageId,
      'action' => 'media.unassign',
      'params' => array('usage_id' => $usageId),
   );
}
 
$dbxKiSlides = array(
   array(306, 'dbxKi öffnen: Von dieser Übersicht starten Sie neue Content-, Änderungs- und Übersetzungsaufträge.'),
   array(307, 'Neuen Content beschreiben: Zielseite, Thema, Zielgruppe, Aufbau und Grenzen vollständig angeben.'),
   array(281, 'Ergebnis finden: Im Content Tree Zielordner, neue Seite und Sprachstatus kontrollieren.'),
   array(285, 'Seitendaten prüfen: Titel, Permalink, Beschreibung, Template und Aktivstatus vergleichen.'),
   array(288, 'Inhalt lesen: Überschriften, Fakten, Links, Module und Handlungsaufforderung im Editor prüfen.'),
   array(291, 'Medien kontrollieren: Hero, Gallery und Inline-Medien im rechten CMS-Bereich richtig zuordnen.'),
   array(308, 'Gezielt ändern: Bestehende Seite wählen und exakt benennen, welche Bereiche gleich bleiben.'),
   array(309, 'Einzelseite übersetzen: Ausgangsseite, Zielsprache und Fachbegriffe festlegen.'),
   array(310, 'Sprachstruktur synchronisieren: Komplette Zielsprachen nur nach sorgfältiger Bereichs- und Inhaltsprüfung erzeugen.'),
);
foreach ($dbxKiSlides as $index => $slide) {
   $steps[] = tutorial_assign_existing('assign_dbxki_' . ($index + 1), $slide[0], 89, $slide[1]);
}
 
// Shop Admin.
$steps[] = tutorial_page(
   'shop_admin_page',
   'Tutorial: Shop administrieren',
   'tutorial-shop-admin',
   'Shop-Einstellungen, Artikel, Medien, Zahlungsarten, Channels und Bestellungen Schritt für Schritt verwalten.',
   'dbxShop Admin, Shop Einstellungen, Artikelpflege, Bestellungen, Zahlung, Channels, Tutorial',
   '0110',
   tutorial_content('shop-admin')
);
$steps[] = tutorial_image(
   'shop_admin_settings',
   'output/playwright/shop-settings-820-after.png',
   'tutorial-shop-admin-01-einstellungen.webp',
   'Shop-Grundeinstellungen',
   'Shop-Admin mit Aktivstatus, Standard-Channel, Währung, Preisanzeige und Mehrwertsteuerklassen',
   'Schritt 1: Shop aktivieren, Standard-Channel, Währung, Preis- und Steueranzeige zuerst festlegen.',
   array(0, 0, 820, 461)
);
$steps[] = tutorial_assign('assign_shop_admin_settings', 'shop_admin_settings', 'shop_admin_page', 'Schritt 1: Grundeinstellungen und Steuerklassen prüfen, bevor Artikel veröffentlicht werden.');
$steps[] = tutorial_image(
   'shop_admin_payment',
   'output/playwright/shop-settings-payment-820.png',
   'tutorial-shop-admin-02-zahlungsarten.webp',
   'Zahlungsarten konfigurieren',
   'Shop-Admin mit Vorkasse, Rechnung und PayPal-Sandbox-Einstellungen',
   'Schritt 2: Nur vollständig konfigurierte Zahlungsarten aktivieren; Online-Anbieter zuerst im Sandbox-Modus testen.',
   array(0, 0, 820, 461)
);
$steps[] = tutorial_assign('assign_shop_admin_payment', 'shop_admin_payment', 'shop_admin_page', 'Schritt 2: Vorkasse, Rechnung und Providerdaten sicher konfigurieren und testen.');
$steps[] = tutorial_image(
   'shop_admin_orders',
   'output/playwright/shop-orders-status-workflow.png',
   'tutorial-shop-admin-03-bestellungen.webp',
   'Bestellungen verwalten',
   'Shop-Admin-Bestellreport mit Filter, Status, Zahlung, Summe und Bearbeitungsaktion',
   'Schritt 3: Bestellungen suchen, Zahlungs- und Versandstatus unterscheiden und den Datensatz über die Aktion öffnen.'
);
$steps[] = tutorial_assign('assign_shop_admin_orders', 'shop_admin_orders', 'shop_admin_page', 'Schritt 3: Im Bestellreport nach Nummer oder Status filtern und die Detailbearbeitung öffnen.');
$steps[] = tutorial_image(
   'shop_admin_channel',
   'output/playwright/workflow-ebay-step2.png',
   'tutorial-shop-admin-04-channel-pruefung.webp',
   'Channel-Bereitschaft prüfen',
   'Workflow-Schritt zur automatischen Prüfung eines Shop-Artikels für einen eBay-Channel',
   'Schritt 4: Vor dem Export fehlende Channel-, Kategorie-, Policy- und Zugangsdaten anhand der automatischen Meldung ergänzen.'
);
$steps[] = tutorial_assign('assign_shop_admin_channel', 'shop_admin_channel', 'shop_admin_page', 'Schritt 4: Channel-Mapping und Bereitschaft prüfen; externe Veröffentlichung bleibt eine bewusste Aktion.');
 
// Shop Frontend.
$steps[] = tutorial_page(
   'shop_frontend_page',
   'Tutorial: Shop im Frontend benutzen',
   'tutorial-shop-frontend',
   'Katalog, Produktdetail, Warenkorb, Kasse, Rechtstexte und Bestellstatus im Shop Schritt für Schritt benutzen.',
   'dbxShop Frontend, Katalog, Produkt, Warenkorb, Checkout, Bestellung, Tutorial',
   '0120',
   tutorial_content('shop-frontend')
);
$steps[] = tutorial_image(
   'shop_frontend_catalog',
   '.playwright-cli/page-2026-07-18T20-16-16-888Z.png',
   'tutorial-shop-frontend-01-katalog.webp',
   'Shop-Katalog',
   'dbXapp Shop-Katalog mit Artikelgruppen, Suche, Filtern und Produktkarten',
   'Schritt 1: Artikelgruppe wählen, Suche und Detailfilter verwenden und Trefferzahl kontrollieren.',
   array(0, 0, 1440, 810)
);
$steps[] = tutorial_assign('assign_shop_frontend_catalog', 'shop_frontend_catalog', 'shop_frontend_page', 'Schritt 1: Im Katalog Gruppen, Suche, Filter und Seitennavigation verwenden.');
$steps[] = tutorial_image(
   'shop_frontend_product',
   '.playwright-cli/page-2026-07-18T20-16-31-880Z.png',
   'tutorial-shop-frontend-02-produktdetail.webp',
   'Produktdetail',
   'Produktdetail eines dbXapp Pakets mit Bild, SKU, Beschreibung, Preis, Lieferung, Menge und Warenkorb-Schaltfläche',
   'Schritt 2: Produkt, SKU, Preis, Steuer, Versand, Lieferzeit und gewünschte Menge vor dem Hinzufügen prüfen.',
   array(0, 0, 1440, 810)
);
$steps[] = tutorial_assign('assign_shop_frontend_product', 'shop_frontend_product', 'shop_frontend_page', 'Schritt 2: Produktangaben und Menge prüfen und den Artikel in den Warenkorb legen.');
$steps[] = tutorial_image(
   'shop_frontend_cart',
   '.playwright-cli/page-2026-07-18T20-16-59-712Z.png',
   'tutorial-shop-frontend-03-warenkorb.webp',
   'Warenkorb',
   'Warenkorb mit Artikel, Menge, Preis, Versand, Gesamtsumme und Schaltfläche zur Kasse',
   'Schritt 3: Menge und Gesamtsumme kontrollieren, Änderungen aktualisieren und erst dann zur Kasse wechseln.',
   array(0, 0, 1440, 810)
);
$steps[] = tutorial_assign('assign_shop_frontend_cart', 'shop_frontend_cart', 'shop_frontend_page', 'Schritt 3: Warenkorbposition, Menge, Versand und Summe prüfen und zur Kasse wechseln.');
$steps[] = tutorial_image(
   'shop_frontend_checkout',
   '.playwright-cli/page-2026-07-18T20-17-13-302Z.png',
   'tutorial-shop-frontend-04-kasse.webp',
   'Kasse und Kundendaten',
   'Checkout mit Bestellübersicht und Eingabefeldern für Name, E-Mail, Telefon, Lieferadresse und Hinweis',
   'Schritt 4: Bestellübersicht erneut prüfen, Kundendaten vollständig eintragen und anschließend Zahlung und Rechtliches bestätigen.',
   array(0, 0, 1440, 810)
);
$steps[] = tutorial_assign('assign_shop_frontend_checkout', 'shop_frontend_checkout', 'shop_frontend_page', 'Schritt 4: Kundendaten, Zahlung und rechtliche Zustimmung sorgfältig abschließen; Bestellbutton nur einmal verwenden.');
 
// Workflow erstellen.
$steps[] = tutorial_page(
   'workflow_create_page',
   'Tutorial: Workflow erstellen',
   'tutorial-workflow-erstellen',
   'Workflow-Definitionen mit Ziel, Bausteinen, Entscheidungen, Automatik und Modul-Bindings Schritt für Schritt erstellen.',
   'dbxWorkflow_admin, Workflow erstellen, Prozess-Designer, Entscheidung, Modul-Binding, Tutorial',
   '0130',
   tutorial_content('workflow-erstellen')
);
$steps[] = tutorial_image(
   'workflow_create_list',
   '.playwright-cli/page-2026-07-18T09-40-19-168Z.png',
   'tutorial-workflow-erstellen-01-definitionen.webp',
   'Workflow-Definitionen',
   'Liste aktiver Workflow-Definitionen mit Key, Titel, Ziel und Aktionen zum Bearbeiten oder Starten',
   'Schritt 1: Vorhandene Definitionen prüfen oder über „Neuer Workflow“ eine neue Definition beginnen.',
   array(0, 180, 1440, 810)
);
$steps[] = tutorial_assign('assign_workflow_create_list', 'workflow_create_list', 'workflow_create_page', 'Schritt 1: In der Definitionsliste Keys, Ziele und Aktivstatus prüfen und einen neuen Workflow anlegen.');
$steps[] = tutorial_image(
   'workflow_create_header',
   'output/playwright/workflow-edit-rid3.png',
   'tutorial-workflow-erstellen-02-kopfdaten.webp',
   'Workflow-Kopfdaten',
   'Workflow-Editor mit Feldern für Key, Titel, Ergebnis, Beschreibung und Aktivstatus',
   'Schritt 2: Stabilen Workflow-Key, verständlichen Namen, fachliches Ziel, Beschreibung und Aktivstatus festlegen.'
);
$steps[] = tutorial_assign('assign_workflow_create_header', 'workflow_create_header', 'workflow_create_page', 'Schritt 2: Key, Name, Ziel und Beschreibung fachlich eindeutig formulieren.');
$steps[] = tutorial_image(
   'workflow_create_designer',
   '.playwright-cli/page-2026-07-18T09-40-50-384Z.png',
   'tutorial-workflow-erstellen-03-designer.webp',
   'Visueller Prozess-Designer',
   'Workflow-Designer mit Palette für Eingabe, Aktion, Prüfung und Entscheidung sowie konfiguriertem Schritt',
   'Schritt 3: Bausteine in Reihenfolge anordnen und pro Schritt Bezeichnung, Schlüssel, Ergebnis, Bearbeitung und Abhängigkeit pflegen.',
   array(0, 200, 1440, 810)
);
$steps[] = tutorial_assign('assign_workflow_create_designer', 'workflow_create_designer', 'workflow_create_page', 'Schritt 3: Eingaben, Aktionen, Prüfungen und Entscheidungen im visuellen Designer zusammensetzen.');
$steps[] = tutorial_image(
   'workflow_create_binding',
   'output/playwright/workflow-bind-new.png',
   'tutorial-workflow-erstellen-04-binding.webp',
   'Modul-Binding erstellen',
   'Binding-Editor mit Generator für Modul, Datadic und Bind-Schlüssel',
   'Schritt 4: Fachmodul und DD verbinden, Auswahl und Vorbelegung prüfen und Finish-Logik auf den richtigen Datensatz begrenzen.'
);
$steps[] = tutorial_assign('assign_workflow_create_binding', 'workflow_create_binding', 'workflow_create_page', 'Schritt 4: Über Modul-Bindings Auswahlquellen, Fachformulare und Abschlusslogik sicher verbinden.');
 
// Workflow benutzen.
$steps[] = tutorial_page(
   'workflow_use_page',
   'Tutorial: Workflow benutzen',
   'tutorial-workflow-nutzen',
   'Workflow starten, Aufgaben bearbeiten, automatische Prüfungen verstehen, Fachmodule nutzen und kontrolliert abschließen.',
   'dbxWorkflow, Workflow nutzen, Schritte, Automatik, Review, Abschluss, Tutorial',
   '0140',
   tutorial_content('workflow-nutzen')
);
$steps[] = tutorial_image(
   'workflow_use_start',
   'output/playwright/workflow-ebay-step1.png',
   'tutorial-workflow-nutzen-01-start.webp',
   'Workflow starten',
   'Gestarteter Workflow mit Ziel, Fortschritt, erster Aufgabe, Artikelauswahl und Übernehmen-Schaltfläche',
   'Schritt 1: Ziel prüfen, den richtigen Fachdatensatz auswählen und den ersten Wert mit „Übernehmen“ speichern.'
);
$steps[] = tutorial_assign('assign_workflow_use_start', 'workflow_use_start', 'workflow_use_page', 'Schritt 1: Neue Instanz starten, Ziel prüfen und den ersten Schritt bewusst übernehmen.');
$steps[] = tutorial_image(
   'workflow_use_check',
   'output/playwright/workflow-ebay-step2.png',
   'tutorial-workflow-nutzen-02-automatik.webp',
   'Automatische Prüfung',
   'Workflow nach automatischer Bereitschaftsprüfung mit erledigten und gesperrten Schritten',
   'Schritt 2: Automatische Meldung vollständig lesen; fehlende Angaben im Fachmodul ergänzen, bevor der Ablauf fortgesetzt wird.'
);
$steps[] = tutorial_assign('assign_workflow_use_check', 'workflow_use_check', 'workflow_use_page', 'Schritt 2: Automatische Prüfung auswerten und fehlende Fachdaten gezielt ergänzen.');
$steps[] = tutorial_image(
   'workflow_use_module',
   '.playwright-cli/page-2026-07-18T09-47-11-599Z.png',
   'tutorial-workflow-nutzen-03-modulschritt.webp',
   'Fachmodul bearbeiten',
   'Aktueller Workflow-Schritt mit Links zur Artikelbearbeitung und zum eBay-Mapping sowie Bestätigung',
   'Schritt 3: Fachformular öffnen, dort speichern, zum Workflow zurückkehren, Bestätigung setzen und übernehmen.',
   array(0, 180, 1440, 810)
);
$steps[] = tutorial_assign('assign_workflow_use_module', 'workflow_use_module', 'workflow_use_page', 'Schritt 3: Fachmodul wirklich speichern und danach den Modulschritt im Workflow bestätigen.');
$steps[] = tutorial_image(
   'workflow_use_review',
   'output/playwright/workflow-ebay-review.png',
   'tutorial-workflow-nutzen-04-review.webp',
   'Review und Abschluss',
   'Workflow-Abschlussprüfung mit 100 Prozent Fortschritt, Ergebnisübersicht und bewusster Abschlussaktion',
   'Schritt 4: Zusammenfassung, externe Daten und Ziel kontrollieren und erst danach den fachlichen Abschluss bestätigen.'
);
$steps[] = tutorial_assign('assign_workflow_use_review', 'workflow_use_review', 'workflow_use_page', 'Schritt 4: Review vollständig prüfen; 100 Prozent sind erst nach erfolgreichem Finish der fachliche Abschluss.');
 
// Tutorial-Uebersicht zuletzt aktualisieren, wenn alle Zielseiten angelegt sind.
$steps[] = array(
   'id' => 'update_tutorial_overview',
   'action' => 'page.update',
   'params' => array(
      'lng' => 'de',
      'id' => 79,
      'patch' => array(
         'description' => 'Übersicht aller dbXapp Tutorials für Grundlagen, dbxContent mit dbxKi, Shop und Workflow.',
         'keywords' => 'dbXapp Tutorials, dbxContent, dbxKi, Shop, Workflow, Anleitung',
         'content' => tutorial_content('overview'),
      ),
   ),
);
 
echo json_encode(
   array('recipe' => 'tutorial-series-20260718.v1', 'steps' => $steps),
   JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES | JSON_THROW_ON_ERROR
);