Starten mit der Probo Connect Plug-in fur Wordpress WooCommerce

Ein fliegender Start

Möchten Sie schnell mit dem Plugin starten? Nachfolgend finden Sie die Voraussetzungen und Schritte, damit Sie direkt loslegen können.

• Grundkenntnisse von WordPress und/oder WooCommerce. Haben Sie diese nicht? Nehmen Sie dann Kontakt mit einem WordPress-Spezialisten in Ihrer Nähe auf.

• Installieren Sie WordPress und WooCommerce, falls Sie dies noch nicht getan haben.

• Stellen Sie sicher, dass Sie Ihren Probo-API-Token zur Hand haben.

• Laden Sie Probo Connect über das Plugin-Verzeichnis in WordPress herunter.

• Aktivieren Sie Probo Connect.

• Folgen Sie den Schritten im Probo-Dashboard innerhalb von WooCommerce.

Gut zu wissen: Der Probo-Uploader funktioniert nur in Kombination mit dem klassischen Warenkorb. Die Probo-Versanddaten funktionieren nur in Kombination mit dem klassischen Checkout.

Häufig gestellte Fragen.

Nachfolgend haben wir versucht, so viele häufig vorkommende Fragen wie möglich zu beantworten.

Allgemein

Haben Sie eine Demo-Umgebung?

Wir haben uns bewusst dagegen entschieden, eine Demo-Umgebung zu erstellen. Sie können das Plugin in Ihrer eigenen (Test-)Umgebung installieren oder eventuell im WordPress Playground testen.

Helfen Sie bei Installation und Implementierung?

Probo hilft nicht bei der Installation und Implementierung des Plugins. Das klingt vielleicht seltsam, aber wir bieten nur technischen Support für unser eigenes Plugin. In dieser FAQ finden Sie hoffentlich die nötigen Hilfestellungen. Sollten Sie nicht weiterkommen, denken wir gerne mit Ihnen mit oder verweisen Sie weiter. Nehmen Sie Kontakt auf über api@probo.nl.

Fallen Kosten für die Nutzung der API und/oder des Plugins an?

Nein. Die Probo-API und das WooCommerce-Plugin sind für unsere Kunden kostenlos.

Wie erhalte ich ein Probo-Konto?

Weitere Informationen dazu finden Sie hier → https://apidocs.proboprints.com/requesting-a-probo-account

Wie erhalte ich einen Probo-API-Token?

Wenn Ihr Konto genehmigt wurde und Sie die Möglichkeit haben, auf Rechnung zu bezahlen, dann können Sie einen API-Token anfordern über Mein Konto → Daten und Einstellungen → API-Anbindung. Tragen Sie den Schlüssel anschließend ein bei WooCommerce → Einstellungen → Probo Connect.

Funktioniert dies auch für Shopify?

Nein, dieses Plugin funktioniert nur für WordPress in Kombination mit WooCommerce.

Installation & Voraussetzungen

Das Plugin lässt sich nicht aktivieren oder zeigt einen Fehler beim Aktivieren

Überprüfen Sie die Mindestvoraussetzungen: WordPress 6.7 oder höher, PHP 8.0 oder höher und eine aktive WooCommerce-Installation. Auf PHP 7.4 oder einer älteren WooCommerce-Version funktioniert das Plugin nicht zuverlässig. Wissen Sie nicht, welche Versionen Sie verwenden? Schauen Sie dann unter WooCommerce → Status nach oder fragen Sie Ihren Hosting-Anbieter.

Ich sehe die Probo-Einstellungen nirgends

Die Einstellungen finden Sie unter Probo Connect → Einstellungen oder WooCommerce → Einstellungen → Probo Connect. Sehen Sie diesen Tab nicht? Dann ist WooCommerce nicht aktiv oder nicht vollständig geladen. Aktivieren Sie zuerst WooCommerce und schauen Sie danach erneut nach.

Funktioniert das Plugin mit HPOS (High-Performance Order Storage)?

Ja, Probo Connect unterstützt HPOS. Zeigt WooCommerce dennoch eine „incompatible“-Warnung an? Dann liegt das an einem anderen bestellbezogenen Plugin, das nicht HPOS-kompatibel ist — nicht an Probo Connect.

Produkte

Wann wählen Sie welches Produkt?

API Products sind standardmäßige WooCommerce-Produkte (einfach oder variabel), die mit einem Probo-Produktcode verknüpft sind. Sie bestimmen die Druckdatei, Sie bestimmen den Preis, und Ihr Kunde sieht einfach eine normale Produktseite. API Products verwalten Sie über Ihre Probo-Plattform.

Configurable Products lassen Ihre Kunden selbst Produktoptionen wählen (Format, Material, Veredelung, Menge), ihr eigenes Design hochladen und den Preis in Echtzeit sehen — alles über den Probo-Konfigurator auf der Produktseite.

Ich möchte den Konfigurator an einer anderen Stelle platzieren

Der Konfigurator wird standardmäßig automatisch auf der Produktseite geladen. Möchten Sie ihn woanders? Überprüfen Sie dann die Einstellungen unter Probo → Einstellungen → Erweiterte Einstellungen. Dort können Sie das automatische Laden deaktivieren und selbst den Shortcode [connect_configurator] an der gewünschten Stelle platzieren.

Der Konfigurator ist auf Spanisch, die Optionen jedoch nicht

Wir haben die Standardelemente des Konfigurators übersetzt. Die Sprache stellen Sie über die Einstellung probo_configurator_language ein. Die Optionen des Konfigurators (Labels und Werte aus der Probo-API) werden nicht automatisch mitübersetzt. Diese können Sie selbst über den Editor bei einem Probo-Configurable-Produkt anpassen.

Preise stimmen nicht

Überprüfen Sie Ihre Margen-Einstellungen (probo_default_margin_multiplier und eventuelle Rush-Margen) sowie den Preismodus/die MwSt.-Einstellungen des Konfigurators (probo_configurator_price_mode und probo_configurator_price_tax). Gut zu wissen: Preise können bewusst nicht vom Frontend aus angepasst werden — das ist eine Sicherheitsmaßnahme.

Produkte synchronisieren nicht oder zeigen veraltete Daten

Die Synchronisierung läuft im Hintergrund über WP-Cron und aktualisiert nur Produkte, die tatsächlich geändert wurden. Gehen Sie diese Punkte durch:

• Läuft WP-Cron auf Ihrer Website? Auf Websites mit wenig Traffic oder mit einem externen Cron kann es sein, dass die Synchronisierung nicht von selbst startet.

• Hat das Produkt einen gültigen Probo-API-Code?

Aktivieren Sie Advanced → Logging → Products sync* (probo_logging_products_sync), um zu sehen, was passiert.

WooCommerce

Wie stelle ich den klassischen Warenkorb und den klassischen Checkout ein?

Seit einigen Jahren verwendet WooCommerce standardmäßig Blöcke (Blocks) für den Warenkorb und den Checkout. Der Probo-Uploader und die Probo-Versanddaten funktionieren nur mit den klassischen Varianten. So stellen Sie diese zurück:

Gehen Sie zu Seiten* in Ihrem WordPress-Dashboard.

Öffnen Sie die Seite Warenkorb* (Cart) und bearbeiten Sie diese.

• Entfernen Sie den bestehenden Warenkorb-Block.

Fügen Sie den Block Klassischer Warenkorb* oder einen Shortcode-Block hinzu und platzieren Sie darin: [woocommerce_cart]

Speichern Sie die Seite.

Machen Sie danach dasselbe für den Checkout:

Öffnen Sie die Seite Kasse* (Checkout) und bearbeiten Sie diese.

• Entfernen Sie den bestehenden Checkout-Block.

Fügen Sie den Block Klassische Kasse oder einen Shortcode-Block* hinzu und platzieren Sie darin: [woocommerce_checkout]

Speichern Sie die Seite.

Tipp: Testen Sie nach dem Umstellen immer eine vollständige Bestellung in Ihrer (Test-)Umgebung, damit Sie sicher sind, dass alles korrekt durchläuft.

Troubleshooting

Die Verbindung mit Probo funktioniert nicht

Häufigste Ursachen:

• API-Schlüssel falsch kopiert (Leerzeichen oder abgeschnitten).

• Server blockiert ausgehenden HTTPS-Verkehr zu api.proboprints.com (Firewall/Proxy). Fragen Sie dies bei Ihrem Hosting-Anbieter nach.

• Falsche Umgebung: Sandbox vs. Produktion.

Aktivieren Sie Advanced → Logging → Ausgehende API-Calls (probo_log_outgoing_api_calls), um zu sehen, was die API genau zurückgibt. Der Authorization-Header wird niemals geloggt, sodass Ihr API-Schlüssel sicher bleibt.

Meine Bestellung wird storniert — was ist passiert?

Überprüfen Sie zunächst, ob der Sandbox-Modus nicht versehentlich aktiviert ist (probo_sandbox_mode); Sandbox-Bestellungen werden nicht wirklich ausgeführt. Richten Sie eine Fehler-E-Mail ein (probo_error_email), um Fehlerbenachrichtigungen zu erhalten, und schauen Sie in das Bestell-Log (probo-order-{id}) über WooCommerce → Status → Logs.

Meine Bestellung kommt nicht bei Probo an

Richten Sie eine Fehler-E-Mail ein (probo_error_email), um Fehlerbenachrichtigungen zu erhalten, und schauen Sie in das Bestell-Log (probo-order-{id}). Sollten Sie mit der erhaltenen Fehlermeldung nicht weiterkommen, überprüfen Sie den Payload über die Bestellaktion „Log Probo Payload“.

Der Konfigurator wird nicht angezeigt

Der Konfigurator wird standardmäßig über die Woo-Aktion woocommerce_single_product_summary geladen. Es kann sein, dass Ihr Theme diese Aktion angepasst oder entfernt hat. Sie können die Aktion über Probo → Einstellungen → Erweiterte Einstellungen anpassen.

Überprüfen Sie außerdem:

• Sind Ihre API-Zugangsdaten ausgefüllt und gültig?

• Hat das Produkt eine gültige Probo-Produkt-ID / einen API-Code verknüpft?

Elementor: Verwenden Sie das Elementor-Widget für den Konfigurator oder verwenden Sie den Shortcode [connect_configurator] auf der Produktseite. Vergessen Sie nicht, das automatische Laden des Konfigurators zu deaktivieren.

Divi: Verwenden Sie den Shortcode an der gewünschten Stelle. Vergessen Sie auch hier nicht, das automatische Laden zu deaktivieren.

Bei benutzerdefinierten Themes oder Page Buildern ist der Shortcode oft zuverlässiger als das automatische Laden.

Der Konfigurator lädt zwar, bleibt aber bei einem Spinner hängen

Der Konfigurator kommuniziert über Ihre eigene Website mit Probo, damit Ihr API-Schlüssel für Besucher nicht sichtbar ist. Diese Verbindung nutzt eine Sicherheitsprüfung (Same-Site-Check). Verwenden Sie Caching, ein CDN oder einen Reverse-Proxy? Dann können diese Prüfanfragen blockiert werden. Sie können vorübergehend mit der Einstellung probo_bypass_same_site_check testen — aber Achtung: Verstehen Sie die Sicherheitsimplikation, bevor Sie dies in der Produktion belassen.

Produkte werden doppelt in den Warenkorb gelegt

Dies war ein bekanntes Problem bei schnellem Klicken und wurde behoben. Sehen Sie dies noch immer? Aktualisieren Sie auf die neueste Version des Plugins.

Der Uploader wird nicht angezeigt

Unser Uploader funktioniert nur in Kombination mit dem klassischen Warenkorb. Stellen Sie sicher, dass Sie diesen verfügbar gemacht haben (siehe „Wie stelle ich den klassischen Warenkorb und den klassischen Checkout ein?“). Verwenden Sie nur einfache Produkte und nicht den Probo-Uploader, dann müssen Sie den klassischen Warenkorb nicht verwenden.

Gut zu wissen: Produkte, die keine Datei benötigen (zum Beispiel Template-Produkte), zeigen die Uploader-Schaltfläche bewusst nicht an.

Der Uploader-Status bleibt hängen

Beim „Dateien nach Bestellung“-Ablauf prüft das Plugin regelmäßig den Status bei Probo. Überprüfen Sie die Uploader-Sessions-Seite und das Poll-Intervall (probo_uploader_polling_interval). Funktioniert es noch immer nicht, prüfen Sie, ob admin-ajax.php auf Ihrer Website erreichbar ist — einige Security-Plugins blockieren dies.

Diagnose & Support

Wie kann ich die Payload einer Bestellung selbst einsehen (debuggen)?

Möchtest du genau sehen, welche Daten an Probo gesendet werden (Adresse, Produkte, Konfiguration, Lieferdatum)? Das geht ohne Code, über eine integrierte Debug-Aktion:

Öffne die Bestellung über WooCommerce → Bestellungen.*

Wähle im Block Bestellaktionen* (rechts, bei der Schaltfläche "Aktualisieren") die Aktion "Log Probo payload (debug)" und führe sie aus.

• Die vollständige Payload, die an Probo gesendet würde, wird in das Bestellprotokoll geschrieben.

Sieh dir das Protokoll über WooCommerce → Status → Protokolle* an, oder über den Link "View order log" im Probo Order Panel. Jede Bestellung hat eine eigene Protokollquelle: probo-order-{id}.

Möchtest du die Payload jeder Bestellung sehen, die tatsächlich synchronisiert wird? Aktiviere dann Advanced → Logging → Ausgehende API-Calls (probo_log_outgoing_api_calls). Jeder API-Call wird dann protokolliert; der Authorization-Header wird niemals protokolliert.

Wichtig zu wissen:

• Schalte das Logging nach dem Debuggen wieder aus – es ist standardmäßig aus Performance-Gründen deaktiviert.

• Die Payload enthält Kundendaten (Name/Adresse). Teile Protokolle daher nicht einfach so.

Möchtest du an der Payload etwas ändern, statt sie nur einzusehen? Das ist individuelle Anpassung über Hooks (probo_order_payload_filter_*) und erfordert einen Entwickler.

Wie debugge ich Probleme am besten?

Sämtliches Logging ist standardmäßig deaktiviert (aus Performance-Gründen) und wird pro Kategorie unter Advanced → Logging aktiviert:

• Bestellverarbeitung (probo_logging_orders)

• Produkt-Sync (probo_logging_products_sync)

• Allgemein (probo_logging_general)

• Eingehende Callbacks (probo_log_incoming_callbacks)

• Ausgehende API-Calls (probo_log_outgoing_api_calls)

Jede Kategorie hat einen "view log"-Link. Die Protokolle findest du unter WooCommerce → Status → Protokolle. Bestellprotokolle sind pro Bestellung gruppiert (probo-order-{id}). Aktiviere nur das, was du benötigst.

Ich habe viele hängengebliebene Scheduled Actions

Verwende das Wartungstool (probo_clear_scheduled_actions), um Probo Scheduled Actions abzubrechen und aufzuräumen. Mit demselben Tool kannst du auch Protokolldateien pro Kategorie löschen.

1. Extending the logic; hooks and filters
2. Creating a custom uploader
3. Changing the styling