Wir bereiten die neuesten Anleitungen, Releases und Feature-Updates vor.
Anleitungen werden geladen
Wir bereiten die passenden Inhalte der Wissensdatenbank für diese Plattform vor.
WordPress-Datenbankstruktur | Chamevo Support Center
WordPress-Datenbankstruktur
Referenz für alle MySQL-Tabellen, Spalten und WooCommerce-Meta-Keys, die vom Chamevo-Plugin verwendet werden.
Aktualisiert am 29. April 20265 Min. Lesezeit
Chamevo speichert Produktdaten, Bestellungen, Print-Jobs und Konfigurationen in benutzerdefinierten MySQL-Tabellen mit dem Präfix {wp_prefix}fpd_. WooCommerce-Personalisierungsdaten werden in den eigenen Bestellungselement-Meta-Tabellen von WooCommerce gespeichert.
Benutzerdefinierte Tabellen
Alle Tabellennamen verwenden das WordPress-Tabellenpräfix (Standard: wp_) gefolgt von fpd_.
fpd_products
Speichert Chamevo-Produktdefinitionen.
Spalte
Typ
Beschreibung
ID
BIGINT(20)
Primärschlüssel
title
TEXT
Produktname
options
TEXT
JSON-kodierte Produktoptionen (Überschreibungen für globale Einstellungen)
thumbnail
TEXT
Base64 oder URL des Produkt-Thumbnails
user_id
BIGINT(20)
WordPress-Benutzer, der das Produkt erstellt hat (null für Admin)
JSON-kodierte Design-Daten, die für den Export gesendet wurden
status
TEXT
Job-Status (z. B. pending, completed)
order_item_key
VARCHAR(255)
Der WooCommerce-Bestellungselement-Meta-Key
created_at
TIMESTAMP
Job-Erstellungsdatum
WooCommerce-Bestellungselement-Meta
Wenn ein Kunde eine WooCommerce-Bestellung mit einem personalisierten Produkt aufgibt, speichert Chamevo Personalisierungsdaten in der Tabelle woocommerce_order_itemmeta.
Meta-Key
Typ
Beschreibung
_chamevo_data
JSON
Die vollständigen Personalisierungsdaten (Produkt-JSON, Ansichten, Elemente). Wird ab Version 2.7.0 geschrieben.
_fpd_data
JSON
Ältere Generation derselben Daten. Wird dauerhaft gelesen, ab 2.7.0 aber nicht mehr geschrieben.
fpd_data
JSON
Generation vor 3.4.9 ohne Präfix, derselbe Inhalt. Wird dauerhaft gelesen.
_fpd_printful_options
JSON
Vom Kunden ausgewählte Printful-spezifische Optionen
_chamevo_product_thumbnail
Text
Base64-kodiertes Thumbnail des personalisierten Produkts
_fpd_printful_order_dashboard_url
Text
URL zum Printful-Bestellungs-Dashboard (wird nach Printful-Bestellungserstellung gesetzt)
Die drei Generationen des Daten-Keys
Chamevo 2.7.0 hat den Key für Personalisierungsdaten von _fpd_data in _chamevo_data umbenannt. Alle drei Generationen bestehen nebeneinander:
Neue Bestellungen schreiben ausschließlich _chamevo_data.
Bestehende Datensätze werden weder migriert noch gelöscht. Eine Bestellung von vor 2.7.0 behält ihre _fpd_data- oder fpd_data-Zeile dauerhaft.
Jeder Lesevorgang löst zuerst den neuen Key auf. Wird eine Bestellung von vor 2.7.0 nach dem Update bearbeitet, schreibt die Bearbeitung _chamevo_data, und dieser Wert überdeckt die veraltete Zeile derselben Bestellposition.
Die Lesereihenfolge lautet _chamevo_data → fpd_data → _fpd_data. Der Key ohne Präfix steht dabei über _fpd_data, um die Rangfolge von vor 3.4.9 beizubehalten.
Lesen Sie den Meta-Key nie direkt aus. Verwenden Sie die Hilfsfunktion, die die Kette durchläuft und den ersten nicht leeren Wert zurückgibt:
// Löst _chamevo_data auf, dann fpd_data, dann _fpd_data
$data = chamevo_wc_get_order_item_meta( $item_id );
Wenn Sie die Datenbank direkt abfragen, berücksichtigen Sie alle drei Keys:
SELECT order_item_id, meta_value
FROM wp_woocommerce_order_itemmeta
WHERE meta_key IN ( '_chamevo_data', 'fpd_data', '_fpd_data' );
Ein Muster wie LIKE '%fpd_data%' trifft nicht auf _chamevo_data zu. Jede vor 2.7.0 geschriebene Abfrage, die sich darauf stützt, übergeht stillschweigend jede neue Bestellung.
Weitere umbenannte Keys
Dieselbe Umbenennung gilt für zwei weitere Speicherorte, mit demselben Verhalten beim Lesen:
Speicherort
Aktueller Key
Alter Key
WooCommerce-Warenkorbelement-Array
chamevo_data
fpd_data
Unter-Key in den Benutzer-Meta gespeicherter Designs
chamevo_data
fpd_data
Das Präfix des Meta-Keys für gespeicherte Designs (fpd_saved_product*) bleibt unverändert.
WooCommerce-Bestellungs-Meta
Die Printful-Integration speichert zusätzliche Daten in der WooCommerce-Bestellung selbst (nicht im Bestellungselement):
Meta-Key
Typ
Beschreibung
_fpd_printful_order_data
Array
Printful-Bestellungsantwortdaten
_fpd_printful_order_request
Array
Printful-API-Anfrage-Payload (nützlich zum Debuggen)
WordPress-Optionen
Chamevo speichert Einstellungen in der wp_options-Tabelle:
Options-Key
Beschreibung
chamevo_api_token
REST-API-Authentifizierungstoken
chamevo_*
Einzelne Plugin-Einstellungen (eine Zeile pro Einstellung)
Benutzer-Meta
Wenn die Funktion „Account Product Storage" aktiviert ist, werden vom Kunden gespeicherte Designs in der Tabelle wp_usermeta gespeichert:
Meta-Key-Muster
Beschreibung
fpd_saved_product*
Gespeicherte Personalisierungsdesigns pro Benutzer
PHP-Hilfsfunktionen
Verwenden Sie diese Funktionen anstelle direkter Datenbankabfragen:
Funktion
Zweck
chamevo_wc_get_order_item_meta($item_id)
Personalisierungsdaten aus einem WooCommerce-Bestellungselement abrufen (löst alle drei Generationen des Daten-Keys auf)
chamevo_has_content($post_id)
Prüfen, ob einem Beitrag Chamevo-Produkte zugewiesen sind; gibt Content-IDs oder false zurück
is_chamevo_product($post_id)
Prüfen, ob ein Beitrag ein Chamevo-aktiviertes Produkt ist (löst den Filter chamevo_designer_enabled aus)
