Sandik Produktanfrage

Vor der Installation

• Shopware: >= 6.5.8.10 und < 6.8.0
• PHP: >= 8.1
• Vor Änderungen ein aktuelles Datei- und Datenbankbackup erstellen.
• Bei produktiven Shops empfiehlt sich ein Test in einer Staging-Umgebung.

Welche Datei wird installiert?

Bei einem Kauf über shop.sandik-it.de erhältst du eine fertig installierbare Plugin-ZIP. Diese wird unverändert in Shopware hochgeladen und enthält bereits Lizenzaktivierung, Domainbindung und die Update-Funktion.

Eine über den offiziellen Shopware Store bezogene Version wird über Shopware installiert und aktualisiert. Die Store-Version enthält keine Sandik-Lizenzsperre.

Installation über die Shopware-Administration

1. Vor Änderungen ein aktuelles Shop- und Datenbankbackup erstellen; produktive Shops möglichst zuerst in einer Staging-Umgebung testen.
2. Die nach dem Kauf bereitgestellte Plugin-ZIP herunterladen und unverändert verwenden.
3. In Shopware zu Erweiterungen → Meine Erweiterungen wechseln und „Erweiterung hochladen“ wählen.
4. Die ZIP hochladen, anschließend „Installieren“ und danach „Aktivieren“ ausführen.
5. Die Shopware-Administration vollständig neu laden. Bei Storefront-Plugins anschließend die Storefront kontrollieren.
6. Bei einem Kauf direkt über Sandik-IT erfolgt die Lizenzaktivierung automatisch. Voraussetzung ist, dass die beim Kauf hinterlegte Shop-Domain zur Installation passt.

Alternative: Installation per SSH / CLI

Das Plugin-Verzeichnis muss unter custom/plugins/SandikProductInquiry liegen. Anschließend im Shopware-Hauptverzeichnis:

bin/console plugin:refresh
bin/console plugin:install --activate SandikProductInquiry
bin/console scheduled-task:register
bin/console assets:install
bin/console cache:clear
bin/console theme:compile

Lizenzaktivierung

Ein sichtbarer Lizenzschlüssel muss nicht eingegeben werden. Die über Sandik-IT bezogene Version prüft nach der Aktivierung automatisch die Shop-Domain beim Sandik-Update-System. Die beim Kauf angegebene Shop-URL muss zur Installation passen.

Production ist voll nutzbar. Staging und Development werden als getrennte Umgebungen erkannt und verwenden die jeweils für das Plugin hinterlegten Testlimits. Nach einer erfolgreichen Prüfung steht bei vorübergehender Nichterreichbarkeit des Lizenzservers ein Offline-Puffer zur Verfügung.

Grundkonfiguration

1. Unter Kataloge → Produkte den gewünschten Artikel öffnen.
2. Im Bereich Zusatzfelder das Feldset „Sandik Product Inquiry“ öffnen und den gewünschten Anfrage-Modus auswählen.
3. Empfänger, Kundenbestätigung, Datei-Upload, Rate-Limit und Aufbewahrung in der Plugin-Konfiguration prüfen.
4. Mit einem Testprodukt eine Anfrage absenden und E-Mail-Zustellung sowie Backend-Anzeige kontrollieren.

Scheduled Tasks, Messenger & Cron

Der Scheduled Task bereinigt abgelaufene Anfragen bzw. Anhänge entsprechend der Aufbewahrungseinstellungen. Shopwares Scheduled-Task-Runner und Messenger sollten regulär laufen.

Updates installieren

Bei der über Sandik-IT bezogenen Version werden kompatible Updates über den integrierten Sandik-Updater erkannt. Der Standardmodus ist manuell. Alternativ kann der Sandik App Hub die verfügbaren Updates zentral anzeigen und auslösen.

Vor einem integrierten Update wird ein Dateibackup angelegt. Ein Datei-Rollback ersetzt kein Datenbankbackup, da Datenbankmigrationen bei einem Downgrade nicht automatisch zurückgeführt werden.

Ein manuelles Update kann außerdem durch Hochladen einer neueren Plugin-ZIP über die Shopware-Erweiterungsverwaltung erfolgen. Das Plugin dabei nicht deinstallieren, damit vorhandene Daten und Einstellungen erhalten bleiben.

bin/console plugin:refresh
bin/console plugin:update SandikProductInquiry
bin/console assets:install
bin/console cache:clear

Bei Storefront-Änderungen anschließend das aktive Theme neu kompilieren.

Typische Probleme

• Kein Anfrageformular sichtbar: Produktmodus und Lizenzstatus prüfen; anschließend Cache und Theme neu kompilieren.
• E-Mail kommt nicht an: Shopware-Mailer und Mail-Logs prüfen.
• Datei-Upload schlägt fehl: erlaubte Dateitypen und Upload-Größe in Shopware/Server prüfen.

Wenn die Installation mit einem HTTP-500-Fehler abbricht, zuerst den Shopware-Logeintrag sowie var/log/ prüfen. Bei Dateirechtefehlern keine pauschalen 777-Rechte setzen, sondern Eigentümer und Schreibrechte der Shopware-Verzeichnisse korrigieren.

Installation & Konfiguration durch Sandik-IT

Wenn du die Einrichtung nicht selbst durchführen möchtest, kann Sandik-IT Installation, Aktivierung, Grundkonfiguration und einen kontrollierten Funktionstest übernehmen.

Installationsservice ansehen ↗