Installation and License

So installieren Sie WP2Amparex frisch und aktivieren die Lizenz.
Wenn Sie von einer alten Freemius-Version kommen, siehe zusätzlich
Update-Pfad: Freemius zu EDD.

1. Plugin hochladen

1. Im WordPress-Backend: Plugins → Install → Upload plugin.
2. The wp2amparex-booking-tool-vX.Y.Z.zip auswählen, die Sie über
   isla-stud.io erhalten
   haben, und auf Jetzt installieren Click.
3. Anschließend Plugin aktivieren.

Im Backend erscheint danach links der Menüpunkt WP2Amparex mit eigenem
Icon (Kalender).

2. Amparex-API konfigurieren

1. WP2Amparex → Einstellungen → Tab „Amparex API".
2. Eintragen:
   • API-URL Ihres Mandanten (z. B. https://kunde.amparex.net/webapi/)
   • Mandant
   • Benutzername and Passwort des technischen API-Zugangs
3. Speichern und auf „Verbindungstest" klicken (falls verfügbar).

Die Zugangsdaten werden in wp_options gespeichert. Sie sollten daher
einen dedizierten technischen API-Benutzer in Amparex einrichten, nicht
den persönlichen Admin-Zugang verwenden.

Wenn Sie zwischen mehreren Amparex-Mandanten wechseln oder einen technischen
API-Benutzer austauschen, beachten Sie zusätzlich
Mandantenwechsel und Setups.

3. Buchungs-Shortcode einbauen

Auf der Wunschseite (z. B. „Termin buchen"):

[wp2a_booking]

Speichern, die Seite öffnen, und der Wizard sollte mit dem Filialschritt
(oder direkt mit der Terminkategorie, wenn nur eine Filiale existiert)
starten.

4. Lizenz eintragen

1. WP2Amparex → License & Updates.
2. Ihren Schlüssel ins Feld license key eintragen.
3. On Activate the license Click.

Erfolg sieht so aus:

• Statusbalken grün, Bezeichnung „Aktiv".
• Update-Kanal: „EDD / isla-stud.io".
• Letzte Prüfung: aktuelles Datum.

Künftige Updates erscheinen dann automatisch im Standard-WordPress-Plugin-
Updater, exakt so wie bei jedem anderen Plugin auch.

Was passiert ohne Lizenz?

Das Plugin sperrt Funktionen nicht hinter der Lizenz; der Schlüssel steuert
ausschließlich, ob Sie zukünftige Versionen über den WordPress-Updater
bekommen.

5. E-Mail-Signatur mit Logo

Im Tab E-Mails können Sie die Textergänzung für die Kundenmail und die
Signatur mit dem WordPress-Editor bearbeiten. Für Logos gibt es bewusst keinen
„Bild einfügen"-Button im Editor, sondern ein separates Signatur-Logo.

So verwenden Sie es:

1. Under Logo für E-Mail-Signatur ein Bild auswählen.
2. Eine Breite zwischen 40 and 600 Pixeln setzen.
3. In der Signatur den Platzhalter {{logo}} an die gewünschte Stelle setzen.
4. Einstellungen speichern und eine Testbuchung durchführen.

Erlaubte Formate sind PNG, JPEG and GIF. SVG and WebP werden
nicht unterstützt, weil sie in einigen Mail-Clients, besonders Outlook, nicht
zuverlässig dargestellt werden. Wenn kein gültiges Logo gewählt ist, wird
{{logo}} in der Signatur leer ersetzt.

Der Platzhalter wird nur in Ihre E-Mail-Signatur ersetzt. In der allgemeinen
Textergänzung für Kundenmails bleibt {{logo}} normaler Text.

6. Erste Testbuchung

1. Im Incognito Window Ihre Buchungs-Seite öffnen.
2. Wizard komplett durchklicken bis zur Bestätigungsseite.
3. In Amparex prüfen, ob der Termin angekommen ist.
4. Bestätigungsmail im genutzten Postfach prüfen.

Tipp: Für Tests in Amparex eine eigene Terminkategorie „WP2A-Test"
einrichten, damit Testbuchungen nicht zwischen echten Kundenterminen
stehen.

Häufige Stolperfallen

• „WP2Amparex Cache leeren" – wenn Sie Filialen, Mitarbeiter, Kategorien
  oder Vorlagen in Amparex ändern und das Frontend zeigt noch alte Stände,
  siehe Clear Cache and Diagnostics.
• „Jetzt nach Plugin-Updates suchen" – wenn ein neues WP2Amparex-Release
  veröffentlicht wurde, Ihre Website es aber noch nicht im WordPress-Updater
  anzeigt. Der Button prüft nur den EDD-Updatekanal neu und löscht keine
  Amparex-Daten.
• Keine freien Slots sichtbar – häufig ein Konfigurationsthema in Amparex
  (Mitarbeitende nicht für Online-Buchung freigegeben, falsche
  Ressourcen-Beschreibungen, fehlende Filial-Zuordnungen).
• Bestätigungsmails kommen nicht an – prüfen, ob WordPress überhaupt
  Mails versendet (z. B. mit dem Plugin „WP Mail Logging"); WP2Amparex nutzt
  die WordPress-Mailfunktion.

Detailliertere Anweisungen finden Sie unter Common problems.