🔑 Aktivierung
Verwaltet die Aktivierung der für die Verbindung mit dem Pricelist Server erforderlichen Lizenz.
Die Eingabe der Lizenzdaten aktiviert alle Funktionen des Plugins.

Hauptfelder:
• License ID → eindeutiger Identifikationscode der Lizenz.
• License Expiration → Ablaufdatum der Lizenz.

Nach Eingabe der Daten auf Speichern drücken, um die Aktivierung abzuschließen. Das Fenster Sync zur Synchronisation wird aktiviert.

🔄 Sync
Ermöglicht die Synchronisierung der Kataloginhalte vom Pricelist Server zur WordPress-Seite.
Während der Synchronisierung werden Artikel, Preislisten, Beschreibungen und Bilder aktualisiert.

Verfügbare Funktionen:
• Manuelle Synchronisierung starten.
• Anzeige des Fortschrittsstatus.

💡 Tipp: Synchronisierung regelmäßig oder nach jeder Katalogaktualisierung durchführen.

🧰 Entwickeln
Ermöglicht das Festlegen der Standardsprache und das Durchführen von Tests, ohne die Produktionsumgebung zu beeinflussen.

Hauptfelder:
• Default Language → Referenzsprache für die Entwicklung basierend auf den verfügbaren Katalogsprachen.

⚙️ Setup
Verwaltet die allgemeinen Einstellungen des Plugins und des veröffentlichten Katalogs.

Verfügbare Optionen:
• Verkaufsbedingungen Seite → Link zur Informationsseite der Website.
• Maßeinheit → Basiseinheit für die Produkte (z. B. cm, mm, Stück).
• Währungssymbol → ON/OFF-Option, die bestimmt, ob das im Pricelist Server festgelegte Währungssymbol neben den Preisen angezeigt wird.
• ON → Das Währungssymbol wird neben den Preisen auf der Website angezeigt.
• OFF → Die Preise werden ohne Währungssymbol angezeigt.
• Fail-Safe-Sprache → Ersatzsprache, falls eine Übersetzung nicht verfügbar ist.
• Regeneration eindeutiger IDs → Funktion zur Neuerstellung der Block-IDs.

💡 Tipp: Die Option Währungssymbol nur aktiv halten, wenn die Online-Preislisten für eine einzige Referenzwährung bestimmt sind.

📱 App
Definiert die Integrationseinstellungen mit der dedizierten Pricelist-App oder dem mobilen Bereich der Website. Ermöglicht die Angabe der Zielseite und der grundlegenden Verbindungsparameter.

• Landing Page → Seite, die beim Öffnen des Chatbots angezeigt wird.

📝 Hinweis
Aktivieren Sie die Funktion für schnelle Kostenvoranschläge auf der Website. Benutzer können Artikel, Konfigurationen oder Oberflächen direkt aus der Preisliste auswählen und in Echtzeit eine geschätzte Gesamtsumme erhalten.

Hauptfunktionen:
• Aktivierung der dynamischen Preisberechnung.
• Verwaltung der Anpassungsoptionen (z. B. Farbe, Oberfläche, Menge).
• Anzeige der Kostenvoranschlagsübersicht.
Die generierten Kostenvoranschläge werden automatisch im Abschnitt Pricelist Note des Pricelist Servers gespeichert.

🧠 Betriebshinweise
• Überprüfen Sie die korrekte Aktivierung der Lizenz, bevor Sie die Synchronisation starten.
• Richten Sie die Entwicklungsumgebung getrennt von der Produktionsumgebung ein.
• Aktualisieren Sie regelmäßig die Daten über den Abschnitt Sync.
• Verwenden Sie Vault nur mit sicheren und geschützten Anmeldedaten.
• Überprüfen Sie regelmäßig die in WP-User konfigurierten Benutzer, um die Konsistenz zwischen WordPress und Pricelist Server zu gewährleisten.

Der Block Price-list Description ermöglicht es, innerhalb der Seiten der WordPress-Website die Beschreibungen der im mit dem Pricelist Server verbundenen Katalog enthaltenen Artikel anzuzeigen. Es ist einer der grundlegenden Blöcke, um die Struktur des Online-Katalogs aufzubauen, und ermöglicht es, automatisch Produktinformationen wie Beschreibungen, Überschriften und technische Daten über Artikelnummer oder Textsuche abzurufen.

🔹 ID
Der Abschnitt ID enthält alle Hauptkonfigurationsparameter des Blocks.
• ID: Dies ist der automatisch zugewiesene eindeutige Code des Blocks. Er dient zur Identifizierung innerhalb der Seite und kann nicht manuell geändert werden.
• Tag: Bestimmt den Typ des HTML-Elements, das den Text enthalten wird (zum Beispiel paragraph, header 1, header 2, span, usw.). Ermöglicht die Definition der Hierarchie und des semantischen Stils des Inhalts.
• Font Style: Ermöglicht die Auswahl des Textstils aus den verfügbaren Optionen (Normal oder Fett).
• Price-list Code: Dies ist das Feld, das den Block mit einem Artikel der Preisliste verbindet. Der Code kann nicht manuell eingegeben werden, sondern muss über die Suche (Lupensymbol 🔍) ausgewählt werden. Es ist möglich, sowohl über Text (zum Beispiel Teil der Beschreibung) als auch über neutralen Code zu suchen.
• Mode: Dieses Feld wird nach der Auswahl des Codes automatisch ausgefüllt und gibt den Typ der abgerufenen Daten an. Es kann folgende Werte annehmen:
• Artikelbeschreibung → wenn die Suche einen Artikel gefunden hat.
• Kopfzeilenbeschreibung → wenn die Suche eine Kopfzeile gefunden hat.
• Field Type: Ermöglicht die Auswahl des anzuzeigenden Feldtyps, wie „Standardbeschreibungsfeld“, „Technisches Feld“ oder andere, je nach den für das Produkt verfügbaren Informationen.

🔹 Link
Der Abschnitt Link ermöglicht es, den Block anklickbar zu machen, indem er mit einer internen oder externen Ressource verknüpft wird.
• Typ: Definiert die Art der Verknüpfung, die angewendet werden soll. Die verfügbaren Optionen sind:
• Seite → verknüpft den Block mit einer Seite der Website.
• Beitrag → verknüpft den Block mit einem WordPress-Artikel.
• Benutzerdefinierter Link → ermöglicht das Einfügen einer benutzerdefinierten URL.
• Verknüpft: Je nach ausgewähltem Typ kann die Seite, der Beitrag oder die Webadresse ausgewählt werden, die zugeordnet werden soll. Dies ist nützlich, um beispielsweise einen Artikelcode mit der entsprechenden Produktseite oder einer Katalogkategorie zu verknüpfen.

🔹 Phantom
Der Abschnitt Phantom ermöglicht das Aktivieren des privaten Modus des Blocks.
• Phantom-Modus: Wenn er aktiviert ist, wird der Inhalt des Blocks für nicht registrierte Benutzer verborgen und bleibt nur für angemeldete Benutzer sichtbar. Dies ist besonders nützlich, um Inhalte zu verwalten, die ausschließlich für Händler, Partner oder internes Personal bestimmt sind (z. B. vertrauliche Preise oder technische Informationen).

🔹 Preisliste KI
Der Abschnitt Preisliste KI integriert den Block mit dem künstlichen Intelligenzsystem der Preisliste und ermöglicht die Erstellung dynamischer Beschreibungen oder personalisierter Texte basierend auf den Artikeldaten.
• Inhalt: Hauptfeld, in dem der Prompt eingegeben wird, also der Text, der die automatische Inhaltserstellung leitet. Es ist möglich, dynamische Tags zu verwenden, um die Daten des ausgewählten Produkts abzurufen.
Beispiel für einen Prompt:
• Der Code <COD> ist ein <st;A;des> des Modells <topic> mit Breite <diml>
• Gespeicherten Prompt laden / Prompt speichern: Ermöglichen das Laden eines zuvor gespeicherten Prompts oder das Speichern eines neuen, um ihn in anderen Blöcken wiederzuverwenden.
• Vorschau: Zeigt eine Vorschau des Endergebnisses, indem die Tags durch die tatsächlichen Werte des verbundenen Produkts ersetzt werden.
• Tag: Liste der verfügbaren Felder für den ausgewählten Artikelcode (z.B. COD, DIML, DIMP, DES, usw.), die innerhalb des Prompts verwendet werden können.
• Thema: Feld, das dem Referenzthema des Prompts gewidmet ist (zum Beispiel Modell, Kollektion oder Kategorie). Es ermöglicht die Erstellung kohärenterer und kontextualisierterer Texte im Hinblick auf das angezeigte Produkt.

Der Block Price-list Table ermöglicht die Anzeige der Preisdaten im Tabellenformat. Jede Tabelle kann vollständig angepasst werden: Anzahl der Zeilen und Spalten, Zellinhalte, Daten aus der Preisliste, Bilder, Links, Freitexte, Beschreibungen und vieles mehr. Es ist der ideale Block zur Erstellung strukturierter Preislisten, technischer Tabellen, Produktgitter oder konfigurierbarer Karten.

🔹 Tabellenstruktur
Die Tabelle wird basierend auf den in der Sektion Table Settings eingegebenen Parametern generiert:
• Rows number: Anzahl der zu generierenden Zeilen
• Columns number: Anzahl der zu generierenden Spalten
• Cell style: ermöglicht das Anwenden eines grafischen Stils auf die Zellen (Ränder, Hintergründe, Ausrichtungen)
Beim Speichern generiert das Plugin automatisch eine Liste von Zellen mit fortlaufendem Namen:
Format der Zellen:
cella-
Beispiele:
• Reihe 0 → cella-00, cella-01, cella-02
• Reihe 1 → cella-10, cella-11, cella-12
• …
• Reihe 5 → cella-50, cella-51, cella-52
Jede Zelle kann unabhängig konfiguriert werden.

🔹 Zellauswahl
Nach der Erstellung der Tabelle:
1. Das Dropdown-Menü Zelle wird geöffnet.
2. Die zu konfigurierende Zelle wird ausgewählt (z. B. zelle-01).
3. Je nach gewähltem Inhaltstyp zeigt die Seitenleiste unterschiedliche Einstellungen an.

🔹 Verfügbare Inhaltstypen
Für jede Zelle kann der Inhaltstyp über das Feld Cell Type ausgewählt werden:
• Artikelbeschreibung
• Artikeldaten
• Überschriftenbeschreibung
• Preis
• Freier Text
• Bild
Wenn ein Typ ausgewählt wird, zeigt die Seitenleiste die entsprechenden Einstellungen für die Kategorie an.

🔸 KONFIGURATION DER ZELLEN
Nachfolgend sind alle möglichen Konfigurationen basierend auf dem gewählten Inhalt beschrieben.

🟦 1. Artikelbeschreibung
Zeigt eine Beschreibung des verknüpften Artikels an.

Verfügbare Felder:
• Artikelcode: wird durch Klicken auf die Lupe und Suchen ausgewählt:
• neutraler Code
• beschreibender Text des Artikels
• Modus: wird automatisch ausgefüllt
• Feldtyp: wählt aus, welches beschreibende Feld angezeigt werden soll (z.B. Standardbeschreibung, technische Beschreibung, Sprache, usw.).
• ROW SPAN / COL SPAN: Ermöglichen das Zusammenführen der Zelle mit den angrenzenden:
• 0 = keine Zusammenführung
• 1+ = Zusammenführung der Zellen vertikal oder horizontal

🟩 2. Artikeldaten
Zeigt Stamminformationen des Produkts an.

Beispiele für auswählbare Felder:
• Artikelcode
• Abmessungen
• Höhe, Breite, Tiefe
• zusätzliche Informationen
Funktioniert wie Artikelbeschreibung, mit Suche über Lupe.

🟧 3. Kopfzeilenbeschreibung
Zeigt Beschreibungen an, die zu den Kopfzeilen der Preisliste gehören.

Felder
• Kopfzeilencode: Suche über Lupe, indem eine Kopfzeile der Preisliste ausgewählt wird.
• Feldtyp: Beschreibendes Feld der Kopfzeile
• Link:
• Typ: Auswahl des Inhaltstyps (Seite, Beitrag, Benutzerdefinierter Link)
• Verknüpft: Auswahl der Seite/des Beitrags/der URL
Nützlich, um Kategorien oder Abschnitte anklickbar zu machen.

🟥 4. Preis
Zeigt einen Preis aus der Preisliste an.

Verfügbare Felder
• Artikelcode: nur über die Suche auswählbar
• Preisspalte: zu verwendende Spalte der Preisliste

🟨 5. Freitext
Geben Sie manuell Text in eine Zelle ein, dieser wird nicht übersetzt.

🟪 6. Bild
Fügt ein Bild in die Zelle ein.

Bildauswahl:
• Das Bild wird aus der WordPress-Medienbibliothek ausgewählt.

Bildgrößen:
• Bild automatische Größe = EIN –> Verwendet die Originalgröße des Bildes.
• Bild automatische Größe = AUS –> Ermöglicht die manuelle Definition von:
• Breite
• Höhe
• Maßeinheit (px, %, vh, vw, usw.)

Präfix / Suffix:
Ermöglichen die Auswahl eines Bildes basierend auf dem Dateinamen mit angegebenem Suffix oder Präfix.
Präfix/Suffix ermöglichen das Finden von Varianten wie:
• AB01.jpg
• zeichnung_AB01.png
• AB01_schema.jpeg

Beispiel:
Artikelcode = AB01
Präfix = zeichnung_
Suffix = (leer)
Das Plugin sucht automatisch in der Medienbibliothek nach einer Datei, die enthält:
zeichnung_AB01.*

Rekursive Überschreibung:
Dient für den rekursiven Block (im nächsten Modul erklärt).
Wenn Rekursive Überschreibung aktiv ist, bleibt das ausgewählte Bild erhalten, ohne automatisch basierend auf dem ausgewählten Artikelcode ersetzt zu werden.

🔹 SPEICHERN
Die Schaltfläche Save cell befindet sich im Konfigurationsbildschirm jeder einzelnen Zelle.
Sie dient zum Speichern von:
• den Einstellungen der aktuell ausgewählten Zelle
• der allgemeinen Konfiguration der Tabelle
• dem aktuellen Status der WordPress-Seite

👉 Es ist wichtig, auf „Save cell“ zu klicken, bevor Sie die ausgewählte Zelle verlassen, da sonst die vorgenommenen Änderungen nicht übernommen werden.

🔹 VORSCHAU
Klicken Sie auf Show Table, um die Vorschau der Tabelle mit den generierten Daten zu sehen.

Der Block Price-list Recursive ermöglicht es, automatisch eine Reihe von wiederholten Tabellen zu generieren, ausgehend von einer mit dem Block Price-list table erstellten Vorlage und deren Anwendung auf mehrere ausgewählte Artikelnummern. Das Ergebnis ist eine Abfolge von Tabellen, die in der Struktur identisch sind, aber unterschiedliche Inhalte basierend auf dem zugeordneten Code haben.

Wichtiger Hinweis: Der Block Recursive funktioniert nur bei Artikelnummern, nicht bei Überschriften.

1. Verwaltung der Zuordnungen
Öffnen des Panels
Klicken Sie auf Manage Associations, um das Fenster zur Verwaltung der Codes zu öffnen.
Eine Zuordnung hinzufügen
1. Klicken Sie auf Add Association
2. Suchen Sie einen Artikelcode über Text oder Code
3. Klicken Sie auf Associa neben dem gewünschten Code
4. Wiederholen Sie dies für alle erforderlichen Codes
5. Bestätigen Sie mit Save & Close
Reihenfolge der Zuordnungen
• Jeder Code wird mit einer automatischen Position eingefügt (0,1,2,…)
• Sie können diese mit Move Up / Move Down ändern
• Die festgelegte Reihenfolge bestimmt die Reihenfolge, in der die Tabellen im Frontend generiert werden

2. Auswahl des Templates
Nachdem Sie die Zuordnungen gespeichert haben, wählen Sie im Template-Menü aus, welche Tabelle (zuvor mit der Preisliste-Tabelle erstellt) für jeden Code verwendet werden soll. Das Template ist obligatorisch, weil:
• es die Struktur der Zellen definiert
• es angibt, welche Felder ersetzt werden müssen
• es dem Rekursiven ermöglicht zu wissen, welche Elemente generiert werden sollen (Texte, Bilder, Preise usw.).

3. Bildpräfix/-suffix (Achtung!)
Im Block Recursive können Sie einstellen:
• Bildpräfix
• Bildsuffix
Diese Werte werden auf ALLE Bilder innerhalb der Vorlage angewendet.

⚠️ Achtung
Wenn in der Vorlage einige Zellen bereits ein spezifisches Präfix/Suffix haben, könnte das Hinzufügen eines Präfixes/Suffixes im Rekursiven:
• die Präfixe/Suffixe duplizieren,
• dazu führen, dass das Bild nicht gefunden wird.
Faustregel
• Wenn alle Bilder ein bestimmtes Präfix oder Suffix haben sollen → stellen Sie es im Recursive ein.
• Wenn nur einige Bilder es haben sollen → stellen Sie es direkt in der Tabelle (Vorlage) ein und lassen Sie Präfix und Suffix im Recursive leer.

4. Wie erfolgt die Generierung der Tabellen
Für jeden zugeordneten Code:
1. Das System klont die Vorlage
2. Ersetzt automatisch die Felder der Zellen (z.B. Code, Abmessungen, Bild, Beschreibung, usw.)
3. Wendet Präfixe/Suffixe auf die Bilder an (falls im Recursive eingestellt)
4. Zeigt auf der Seite eine Sequenz von Tabellen, eine für jeden Code

Beispiel:
Sie haben die Codes AB01, AB02, AB03 ausgewählt
→ Es werden drei identische Tabellen in der Struktur generiert, jedoch mit:
• unterschiedlichem Code
• unterschiedlichen Beschreibungen
• Bildern mit den Namen AB01 / AB02 / AB03
• automatisch angepassten Textinhalten

5. KI-Felder
Der Recursive enthält kein Feld „content“: Der KI-Text befindet sich im Template, wo er dynamisch geschrieben wird (z. B. mit KI-Tags wie <COD>, <DES> <diml> usw.).
Es kann nur das allgemeine Thema angewendet werden.
Der Recursive beschränkt sich darauf, die korrekten Werte für jeden Code zu übergeben.

6. Endausgabe (Render)
Bei der Veröffentlichung zeigt der Block:
• eine Tabelle für jeden Code
• in der festgelegten Reihenfolge
• mit korrekt ersetzten Daten und Bildern

Der Block Price-list Single Price ermöglicht es, einen einzelnen Preis aus der Preisliste für einen bestimmten Artikel und eine ausgewählte Preisspalte anzuzeigen. Er wird beispielsweise verwendet, wenn du den Preis eines Produkts auf einer Detailseite oder in einem Produktdatenblatt anzeigen möchtest.

⚙️ Blockeinstellungen

🔎 Preislisten-Code
Suchfeld, das es dir ermöglicht, den Artikelcode nur über die Suche auszuwählen.
👉 Du kannst ihn nicht manuell eingeben.
Du kannst suchen über:
• Beschreibungstext
• Neutraler Code
Sobald ein Ergebnis ausgewählt ist, wird der Block automatisch mit dem Artikel verknüpft.

🧱 Spalte
Wählen Sie aus, aus welcher Preisspalte der Wert entnommen werden soll.

📌 Wofür ist das?
Viele Unternehmen verwenden mehrere Spalten, um unterschiedliche Preise zu verwalten:
• verschiedene Materialien
• Varianten
• Preisklassen

Beispiel:
• Spalte 001 → Preis in Melamin
• Spalte 002 → Preis in Marmor
👉 Mit diesem Feld wählen Sie genau aus, welcher Preis angezeigt werden soll.

💱 Währung

Das Währungssymbol:
• wird vom Pricelist Server festgelegt (z.B. €, $, CHF…)
• kann in den Einstellungen des WordPress-Plugins aktiviert oder deaktiviert werden (Optionen EIN/AUS)

👉 Der Block verwaltet nicht direkt die Währung, sondern nur die Anzeige.