Zum Hauptinhalt springen
Auf dieser Seite▾

Das Plug-in verbindet den Konfigurator mit einem WooCommerce-Shop. Es befindet sich im Early Access: Es ist nicht im WordPress-Plugin-Verzeichnis, hat keinen gelisteten Preis und wurde in unserem Testaufbau noch nicht end-to-end gegen ein laufendes WordPress und WooCommerce ausgeführt; probieren Sie es daher zuerst in einem Staging-Shop aus.

Was es tut

  • Fügt den von Ihnen gewählten Produktseiten einen Button Order cut to size hinzu (die Beschriftung können Sie ändern).
  • Öffnet den Konfigurator als Pop-up, als Seitenleiste oder auf der Seite, mit bereits gewählter Platte des Produkts.
  • Legt das Ergebnis als eine Position in den WooCommerce-Warenkorb, bepreist aus dem geprüften Angebot.
  • Behält die CutOptim-Bestell-ID und den Angebots-Hash an der Bestellposition und zeigt in der Bestellung eine kurze, lesbare Zusammenfassung „Cut to size“.
  • Empfängt die signierten Webhooks von CutOptim und fügt der WooCommerce-Bestellung eine Notiz hinzu.

Installation und Einrichtung

Voraussetzungen: WordPress 6.0 oder höher, PHP 7.4 oder höher und WooCommerce.

  1. Installieren und aktivieren Sie WooCommerce, dann das Plug-in.
  2. Öffnen Sie WooCommerce > CutOptim Configurator und tragen Sie Tenant-ID, öffentlichen Schlüssel und geheimen Schlüssel ein. Der geheime Schlüssel kann stattdessen in wp-config.php als CUTOPTIM_API_SECRET definiert werden. Die Schlüssel stammen aus der Konsole; der öffentliche Schlüssel funktioniert nur auf den Webadressen, die Sie dort für ihn aufgelistet haben.
  3. Wählen Sie, wie der Konfigurator sich öffnet, die Beschriftung des Buttons und die Produktkategorien, die den Button erhalten (keine Auswahl bedeutet jedes zugeordnete Produkt).
  4. Ordnen Sie Produkte Platten zu (unten).
  5. Für Bestellnotizen tragen Sie das Webhook-Secret im Plug-in ein und fügen die Webhook-Adresse, die die Einstellungsseite zeigt, Ihrer Konfiguration hinzu (siehe Bestellungen). Mehrere Secrets, eines pro Zeile, sind erlaubt, damit ein Secret rotiert werden kann.

Ein Produkt einer Platte zuordnen

Der Button erscheint nur bei einem Produkt, das für eine Platte in Ihrem CutOptim-Katalog steht. Das Plug-in löst die Platte in dieser Reihenfolge auf:

  1. die produkteigenen Felder CutOptim board und CutOptim thickness (mm) in den Produktdaten;
  2. eine Regel SKU to board in den Einstellungen, eine pro Zeile, zum Beispiel MDF-18 = MDF raw | 18 oder PLY-* = Birch plywood; eine exakte SKU hat Vorrang vor einem Präfix, und eine Zeile, die mit # beginnt, ist ein Kommentar;
  3. die Produktattribute cutoptim_material und cutoptim_thickness.

Ein Plattenname mit Markup oder eine Dicke außerhalb von 0 bis 200 mm wird verworfen, nicht repariert. Ist eine Platte zugeordnet, öffnet der Konfigurator bei der Zuschnittliste.

Wie der Preis in den Warenkorb kommt

Der Konfigurator im Browser meldet die Bestellung, aber einer Zahl aus dem Browser wird nie vertraut. Der einzige Weg des Plug-ins in den Warenkorb ist eine REST-Route auf Ihrem eigenen Server. Diese Route:

  1. sendet das signierte Angebot mit Ihrem geheimen Schlüssel zur Prüfung an CutOptim und lehnt ab, wenn es nicht gültig ist;
  2. kontrolliert, dass das Angebot zu den Positionen passt, die der Kunde gesehen hat;
  3. prüft die Währung gegen die Shop-Währung und lehnt eine Abweichung ab;
  4. fügt eine Warenkorbposition hinzu, bepreist aus den geprüften Summen, brutto oder netto, je nach Steuereinstellung Ihres Shops.

Schlägt etwas fehl, wird nichts hinzugefügt, und der Kunde wird gebeten, es erneut zu versuchen. An der Kasse werden die CutOptim-Bestell-ID und der Angebots-Hash an die Bestellposition kopiert. Eine Webhook-Bestätigung zählt nur, wenn ihr Plan-Hash mit dem an der Position gespeicherten übereinstimmt.

Die Prüfungen und die dahinterliegenden API-Aufrufe stehen in der Konfigurator-API-Referenz.

Grenzen

  • Early Access. Nicht im WordPress-Verzeichnis; zuerst im Staging testen.
  • Währung. Die Shop-Währung und die Währung der CutOptim-Konfiguration müssen dieselbe sein.
  • Sprache. Die eigenen Texte des Plug-ins (Einstellungen und Meldungen) sind auf Englisch; das Konfigurator-Widget selbst gibt es in zehn Sprachen.
  • Zahlung. Zahlung, Lagerbestand, Steuer und Versand sind Sache von WooCommerce.
  • Bestellnotizen. Das Plug-in akzeptiert Bestellstatus-Ereignisse; ein Statusereignis wird vom Dienst nur gesendet, wenn Sie den Status einer Bestellung in der Konsole ändern.

FAQ

Was macht das WooCommerce-Plug-in?
Es fügt den von Ihnen gewählten Produkten einen Button Order cut to size hinzu. Der Kunde gibt Teile ein, sieht den Schnittplan und einen Preis nach Ihren Regeln, und das Ergebnis landet als eine Position im WooCommerce-Warenkorb. Warenkorb, Kasse, Lagerbestand, Steuer, Versand und Zahlung bleiben in WooCommerce; CutOptim nimmt keine Zahlungen entgegen.
Kann ein Kunde den Preis in der Browser-Konsole ändern?
Nein. Das Plug-in hat genau einen Weg in den Warenkorb, eine Route auf Ihrem eigenen Server. Diese Route bittet CutOptim, das signierte Angebot mit Ihrem geheimen Schlüssel zu prüfen, kontrolliert, dass das Angebot zu den Positionen passt, die der Kunde gesehen hat, und fügt erst dann eine Warenkorbposition hinzu, die aus den geprüften Summen bepreist ist. Ein aus dem Browser gesendeter Preis wird nie verwendet.
Ist es im WordPress-Plugin-Verzeichnis verfügbar?
Noch nicht. Es befindet sich im Early Access und wird noch nicht öffentlich verteilt; zum Ausprobieren fragen Sie uns über die Kontaktseite an. Der End-to-End-Test des Plug-ins mit WordPress und WooCommerce ist noch nicht gelaufen, betrachten Sie es daher als eine Version, die Sie zuerst in einem Staging-Shop testen.
Wie sage ich dem Plug-in, welches Produkt welche Platte ist?
Auf drei Wegen, in dieser Reihenfolge geprüft: die produkteigenen Felder CutOptim board und CutOptim thickness in den Produktdaten, eine SKU-Regel in den Plug-in-Einstellungen wie MDF-18 = MDF raw | 18 oder eine Präfixregel wie PLY-* = Birch plywood sowie die Produktattribute cutoptim_material und cutoptim_thickness. Ein Produkt ohne aufgelöste Platte erhält keinen Button.
Warum wurde mein Artikel nicht in den Warenkorb gelegt?
Der Preis konnte nicht bestätigt werden. Häufige Ursachen: Die Shop-Währung weicht von der Währung in Ihrer CutOptim-Konfiguration ab (es gibt keine Umrechnung), der geheime Schlüssel oder die Tenant-ID ist falsch, oder das Angebot ist abgelaufen. Der Kunde sieht eine Meldung und kann es erneut versuchen.
Unterstützt es andere Shop-Plattformen, etwa Shopify?
Nein. WooCommerce ist das einzige Plattform-Plug-in. Für jeden anderen Shop nutzt Ihr Entwickler die dokumentierten Schritte zu Prüfung und Webhook mit dem Referenzcode, beschrieben auf der Seite zu individuellen Plattformen.

Aktualisiert: 19. Oktober 2026