# VLB WooCommerce Schnittstelle

## Buchdaten statt doppelter Pflege

### Ihr Sortiment.  
Eine Datenquelle.  
Weniger Handarbeit.

#### Ein Buch ist mehr als Titel und Preis.

Autoren, Auflage, Erscheinungsdatum, Cover und Lieferbarkeit gehören ebenfalls auf die Produktseite. Wer diese Angaben einzeln in WooCommerce pflegt, muss Änderungen auch einzeln nachführen.

Der VLB Connector übernimmt die im eingerichteten VLB-Zugang verfügbaren Daten in den Shop. Bestehende Printtitel werden anhand ihrer [ISBN] (https://de.wikipedia.org/wiki/Internationale _Standardbuchnummer) wiedergefunden und aktualisiert. So wird aus der Datenquelle ein wiederholbarer Importablauf.

## Was der VLB Connector leistet

### Die VLB WooCommerce Schnittstelle  
im Detail.

Vom bibliografischen Datensatz bis zur Darstellung auf der Produktseite.

#### Produktpflege

##### Buchtitel anlegen.  
Daten aktualisieren.

Neue Titel werden als WooCommerce-Produkte veröffentlicht. Vorhandene Printprodukte werden über die ISBN zugeordnet und mit den VLB-Daten aktualisiert.

- Titel, Beschreibung und deutscher Europreis
- ISBN beziehungsweise GTIN als Kennung
- Schlagwörter und Kategorien aus THEMA-Codes

#### Medien & Details

##### Mehr Informationen  
zum Buch.

Cover werden heruntergeladen und im Shop verwendet. Verfügbare PDF-Leseproben und Inhaltsverzeichnisse werden lokal gespeichert und mit dem Produkt verknüpft.

- Autoren und biografische Angaben
- Sprache, Seitenzahl und Edition, soweit geliefert
- Produktdetails über Shortcodes ausgeben

#### Verfügbarkeit

##### Lieferstatus  
verständlich zeigen.

VLB-Verfügbarkeitscodes werden in deutsche Texte und einen WooCommerce-Lagerstatus übersetzt. Im Admin-Bereich stehen dafür zusätzliche Produktspalten bereit.

- Beispielsweise „Verfügbar“ oder „Wird neu aufgelegt“
- Lagerstatus in der Produktliste sortieren
- Statusübernahme bei der Importverarbeitung

#### Wiederkehrende Aufgaben

##### Importieren.  
Nach Zeitplan.

[WordPress] (https://de.wikipedia.org/wiki/WordPress) plant den Abruf täglich. Die Warteschlange wird alle fünf Minuten in Paketen mit bis zu 50 Einträgen je Aufruf verarbeitet.

- Zwei Datenbanktabellen für Aufgaben und Ergebnisse
- Neue und vorhandene Titel im selben Ablauf
- Ausführung abhängig von WP-Cron, Server und API

#### Kontrolle im Backend

##### Manuell starten.  
Fortschritt verfolgen.

Unter „VLB Import“ lässt sich ein Lauf auch direkt starten. Die Ansicht zeigt verarbeitete Produkte, den Fortschritt und eine geschätzte Restzeit.

- Ergebnisliste mit Produkttyp, Titel und ISBN
- Zugriff mit der Berechtigung manage _options
- Admin-Seite während des manuellen Laufs offen halten

#### Ausgabe & Erscheinung

##### E-Books erkennen.  
Neuerscheinungen zuordnen.

[E-Books] (https://de.wikipedia.org/wiki/E-Book) erhalten eine eigene Kategorie und Formatangaben. Bei künftigen Erscheinungsterminen hinterlegt das Plugin Vorbestell-Metadaten.

- E-Books als virtuelle Downloadprodukte markieren
- Formate ePub, mobi oder PDF zuordnen
- Downloaddateien und Vorbestellprozess separat einrichten

## So funktioniert die Anbindung

### Vom VLB-Datensatz  
zum Shop-Produkt.

Ein definierter Ablauf für die Einrichtung und den wiederkehrenden Datenimport.

01

### Anbindung einrichten

VLB-Zugänge, WooCommerce, Medienverzeichnisse und die projektspezifischen Zuordnungen vorbereiten.

02

### Titelliste abrufen

Aktive Titel aus dem eingerichteten [API-Zugang] (https://de.wikipedia.org/wiki/Programmierschnittstelle) laden und in die Importwarteschlange übernehmen.

03

### Produkte verarbeiten

Details und Medien abrufen. Produkte anlegen oder zuordnen, Daten und Lagerstatus aktualisieren.

04

### Ergebnisse prüfen

Importansicht und Produktdaten prüfen. Der abschließende Abgleich setzt nicht enthaltene Produkte auf „nicht auf Lager“.

## Daten, die im Shop ankommen

### Was wird  
übernommen?

Das Plugin verarbeitet Produkt- und Mediendaten. Bestellungen oder Kundendaten werden durch diesen Connector nicht an das VLB übertragen.

| Aus dem VLB | In WooCommerce |
| --- | --- |
| Titel & Beschreibung | Produktname und Produktbeschreibung |
| ISBN, GTIN & Preis | Identifikation und regulärer Produktpreis |
| Autor & Buchmerkmale | Produktattribute, etwa Sprache und Seitenzahl |
| THEMA & Schlagwörter | Kategorien für Printtitel und Produktschlagwörter |
| Cover & PDF-Inhalte | Produktbild und verknüpfte Zusatzinformationen |
| Verfügbarkeitscode | Lieferstatus-Text und zugeordneter Lagerstatus |

## Technik, die zum Projekt passen muss

### Die Grundlage  
für Ihren Buchshop.

Der Connector braucht eine abgestimmte Einrichtung. Die vorliegende Version ist auf einen projektspezifischen Shopbetrieb ausgelegt.

#### WordPress & WooCommerce

Eine bestehende [Shopinstallation] (https://www.sodah.de/ecommerce-seo/) und [PHP] (https://de.wikipedia.org/wiki/PHP) mit cURL für Mediendownloads.

#### VLB-API-Zugänge

Passende Berechtigungen für Metadaten, Cover und Medien. Zugangsdaten werden im Code eingerichtet.

#### Medien & Zeitplan

Schreibbare Verzeichnisse book-covers und book-content im Upload-Bereich sowie eine eingerichtete WP-Cron-Ausführung.

#### Shopkonfiguration

Kategoriezuordnung, Lieferstatus-Regeln und die im Code angesprochene Steuerklasse müssen zum Shop passen.

## Shopprojekt mit Sodah

### Buchhandel verstehen.  
Die Technik verbinden.

#### Eine passende Schnittstelle beginnt mit Ihrem Sortiment.

Der VLB Connector ist eine Grundlage für die Buchdaten-Anbindung in einem WooCommerce-Projekt mit Sodah. Entscheidend sind die verfügbaren Daten, die Regeln für bestehende Produkte und die Darstellung im Shop.

Besprechen Sie mit uns, wie sich der Connector in Ihr Vorhaben einfügt und welche [Anpassungen] (https://www.sodah.de/webentwicklung-agentur/) Ihre Installation benötigt.

[E-Commerce-Webentwicklung] (https://www.sodah.de/ecommerce-webdesign/) [Support & Wartung] (https://www.sodah.de/webdesign-agentur/support-wartung/)

## Häufige Fragen

### Gut zu wissen.

Konkrete Antworten zu Import, Einrichtung und den Grenzen des VLB Connectors.

### [Was ist der VLB Connector?] (#0f58831b148ac3220)

VLB Connector ist ein WordPress-Plugin von Sodah Webdesign. Es verbindet das Verzeichnis Lieferbarer Bücher (VLB) mit WooCommerce, legt Buchprodukte an und aktualisiert unter anderem Beschreibungen, Preise, Cover und Lieferstatus anhand der verfügbaren API-Daten.

### [Welche Voraussetzungen braucht die VLB-Anbindung?] (#0e3586cd71ddb37d9)

Erforderlich sind WordPress, WooCommerce, PHP mit cURL und passende VLB-API-Zugänge für Metadaten, Cover und Medien. Die Upload-Verzeichnisse book-covers und book-content müssen vorhanden und schreibbar sein. Für geplante Importe muss WP-Cron ausgeführt werden. Zugänge, Steuerklasse und Zuordnungen werden projektspezifisch eingerichtet; eine Einstellungsmaske dafür enthält diese Version nicht.

### [Wann werden die Buchdaten aktualisiert?] (#48a5d14b547ba9aba)

Der Code plant den Abruf der Titelliste täglich und die Verarbeitung der Warteschlange alle fünf Minuten mit bis zu 50 Einträgen je Aufruf. Die tatsächliche Ausführung hängt von WP-Cron, Server und API ab. Zusätzlich lässt sich der Import manuell starten. Eine Aktualisierung in Echtzeit ist nicht implementiert.

### [Welche Daten werden verarbeitet?] (#3d8c32490686644a7)

Verarbeitet werden Produkt- und Mediendaten: Titel, ISBN beziehungsweise GTIN, Beschreibungen, deutsche Europreise, Autorenangaben, bibliografische Merkmale, Schlagwörter, THEMA-Codes, Lieferstatus sowie verfügbare Cover und PDF-Zusatzinhalte. Sie werden als WooCommerce-Produkte, WordPress-Medien und Einträge in zwei Importtabellen gespeichert. Eine Übertragung von Bestell- oder Kundendaten an das VLB ist in diesem Code nicht implementiert.

### [Importiert das Plugin auch E-Books und Vorbestellungen?] (#2bb9b38e74e7d6dbb)

E-Books werden erkannt, einer eigenen Kategorie zugeordnet und als virtuelle, herunterladbare Produkte markiert. Die aktuelle Download-Routine hinterlegt bei fehlendem Download allerdings das Coverbild, keine E-Book-Datei. Zukünftige Erscheinungstermine erzeugen Vorbestell-Metadaten. Ein vollständiger Vorbestellprozess im Checkout ist in diesem Plugin nicht enthalten.

### [Was passiert mit bestehenden oder nicht mehr gelisteten Produkten?] (#039e5978d7240056f)

Printprodukte werden über die ISBN, E-Books über einen aus dem Titel abgeleiteten Schlüssel zugeordnet. Nach einer abgearbeiteten, nicht leeren Importliste setzt der Abgleich nicht enthaltene Shopprodukte auf nicht auf Lager. Daneben gibt es Bereinigungsroutinen: Erkannte Dubletten werden in den Papierkorb verschoben; veröffentlichte Produkte ohne ISBN- oder E-Book-Kennung werden dauerhaft gelöscht, sofern sie nicht unter die Non-Books-Ausnahme fallen. Der Abgleich ist deshalb vor dem Einsatz auf das Sortiment abzustimmen.

### [Kann ich den Import selbst starten und verfolgen?] (#a7a17205a6f9b9fbd)

Ja. Benutzer mit der WordPress-Berechtigung manage _options können unter VLB Import einen manuellen Lauf starten. Die Ansicht zeigt verarbeitete Titel mit Typ und ISBN, den Fortschritt und eine geschätzte Restzeit. Während des manuellen Imports muss die Seite geöffnet bleiben.

### [Wie lässt sich der VLB Connector mit Sodah einsetzen?] (#4198070c5cde95d98)

Der Connector ist eine Grundlage für die VLB-Anbindung in einem WooCommerce-Projekt mit Sodah. Dabei sind API-Zugänge, Sortiment, Datenzuordnung und Darstellung im Shop gemeinsam abzustimmen. Besprechen Sie Ihr Vorhaben mit Sodah; einen öffentlichen Download oder einen separaten Kaufweg stellt diese Seite nicht bereit.