Installation und Setup

insic AVS für WordPress — Einrichtung

Version 0.5.1 · WordPress ab 6.6 · WooCommerce ab 8.0 · PHP ab 8.1

Das Plugin ersetzt die Registrierung in WooCommerce durch das insic AVS Widget und zeigt den Prüfstatus im Kundenkonto an. Die Einrichtung dauert etwa zwanzig Minuten.

1. Domain freischalten lassen

Das Widget lädt seine Konfiguration von der insic-API. Diese Anfrage muss von insic für deine Domain erlaubt sein. Melde die Domain deshalb vor der Einrichtung dort an, mit vollem Protokoll:

https://ihre-domain.de

Läuft die Website unter mehreren Adressen — mit und ohne www, oder zusätzlich als Testumgebung —, müssen alle genannt werden.

Fehlt die Freischaltung, erscheint das Widget ohne Beschriftungen und ohne Partner-Gestaltung. Angemeldete Administratoren sehen dann einen Hinweis über dem Widget.

2. Theme prüfen

Nicht jedes Theme funktioniert. Bei den mitgelieferten WordPress-Themes (Twenty Seventeen, Twenty Twenty-One, Twenty Twenty-Four, Twenty Twenty-Five) bleibt das Widget unsichtbar: Es lädt und rendert, kann seine eigenen Stile aber nicht einfügen und fällt dadurch auf null Höhe zusammen.

Getestet und funktionsfähig sind Elementor sowie Themes mit eigenem Seitenaufbau. Prüfe die Darstellung deshalb früh — am besten direkt nach Schritt 5.

3. Plugin installieren

1. In WordPress Plugins → Installieren → Plugin hochladen öffnen.
2. insic-avs.zip auswählen und installieren.
3. Auf Plugin aktivieren klicken.

4. Einstellungen ausfüllen

Zu finden unter Einstellungen → insic AVS.

• API-Adresse: https://test.insic.de/api
• Ressourcen-Adresse: https://test.insic.de/frontend/user
• partnerId: die ID deiner Installation

Ohne partnerId erscheint kein Widget. Für den Produktivbetrieb zeigen beide Adressen auf die Live-Umgebung, nicht auf test.insic.de.

Die Ankreuzfelder unter „Registrierung“ können angehakt bleiben. Die Startansicht sollte auf „Das Widget entscheidet“ stehen — das Widget kennt seinen Anmeldestatus selbst.

5. Seiten vorbereiten

Eine Seite anlegen und diesen Shortcode einsetzen:

Das ist der zuverlässigste Weg. Der Shortcode zeigt je nach Zustand Anmeldung, Registrierung oder die laufende Prüfung.

Soll zusätzlich die Seite Mein Konto genutzt werden, muss sie den Shortcode

enthalten. Steht dort der Mein-Konto-Block, rendert WooCommerce nichts und das Widget erscheint ebenfalls nicht.

Die Statusanzeige lässt sich mit an beliebiger Stelle einsetzen.

6. Rückmeldung einrichten

Damit der Shop von abgeschlossenen Prüfungen erfährt, braucht insic eine Adresse. Sie steht auf der Einstellungsseite:

https://ihre-domain.de/wp-json/insic-avs/v1/callback

Diese Adresse zusammen mit dem Callback-Token an insic geben. Dort wird sie in den Service-Params sendUserRegister, sendUserUpdate und sendStatusRequest hinterlegt. Das Token ist ein Geheimnis und gehört nicht in Tickets oder öffentliche Dokumente.

7. Prüfen, ob alles läuft

1. Registrierungsseite in einem privaten Fenster öffnen — das Widget erscheint nach wenigen Sekunden.
2. Mit einer Testadresse registrieren — danach bist du angemeldet.
3. In der Benutzerübersicht prüfen, ob das Konto angelegt wurde.
4. Prüfung durchlaufen — die Statusanzeige wechselt ohne Neuladen.
5. Testkonto löschen, damit die Adresse wieder frei ist.

Wenn etwas nicht funktioniert

Kein Widget zu sehen: partnerId in den Einstellungen prüfen. Bleibt die Stelle leer, blockiert womöglich ein Cookie-Banner oder ein Sicherheits-Plugin das Skript von insic.

Widget lädt, bleibt aber unsichtbar: Meist das Theme, siehe Schritt 2. Zur Kontrolle in der Browserkonsole eingeben:

document.getElementById('___avs-wrapper').children.length

Kommt eine Zahl größer null zurück, hat das Widget gerendert und es fehlen nur die Stile.

Widget ohne Beschriftungen: Die Domain ist bei insic nicht freigeschaltet, siehe Schritt 1.

Status ändert sich nie: Die Rückmeldung kommt nicht an. Adresse und Token bei insic prüfen, und ob eine Firewall die Anfrage blockiert.

Nach der Registrierung kommt eine Mail statt einer Anmeldung: Kein Fehler — das Konto wurde über die Rückfallebene angelegt.

Anmeldeformular erscheint trotz Anmeldung: Das WordPress-Passwort weicht ab. WordPress ist die führende Instanz; mit dem WordPress-Passwort anmelden.

Was diese Version noch nicht kann

• Den Kauf sperren, bis die Prüfung abgeschlossen ist
• Bestehende Konten nachträglich einbeziehen

Bei Fragen zur Einrichtung: über den vereinbarten Support-Kanal.