Integration einer Joomla! Webseite mit SuperSaaS

Diese Seite erklärt, wie Du den Online-Terminbuchungskalender von SuperSaaS in eine Joomla!-basierte Webseite integrieren kannst, sodass sich Deine Benutzer nur einmal anmelden müssen, um sowohl auf Deine Website als auch auf den darin eingebetteten Online-Terminbuchungskalender von SuperSaaS zuzugreifen. Um das nutzen zu können, musst Du Dich zunächst für ein (kostenloses) SuperSaaS anmelden.

• Benutze Joomla! Login Namen für SuperSaaS
• Installiere und richte das Plugin in Joomla! ein
• Ändere die Einstellungen in SuperSaaS, um Joomla! zu verknüpfen
• Füge Buchungs-Button in Deine Seite ein
• Tipps zur Fehlerbehebung

Verwendung der Login-Daten von Joomla für Deinen SuperSaaS Terminplaner

Das SuperSaaS-Plugin für Joomla! zeigt einen Jetzt Buchen Button, der Benutzer automatisch im Online-Terminbuchungskalender bei SuperSaaS mit dem Joomla!-Benutzernamen einloggt. Falls Deine Webseite nicht das Benutzer-Anmeldungssystem von Joomla benutzt, solltest Du besser die allgemeine Anleitung nutzen, wie Du einen online Terminkalender in Deine Webseite integrieren kannst.

Der vom Plugin erzeugte „Jetzt Buchen“ Button übergibt die Informationen der Joomla!-Benutzerdatenbank an SuperSaaS, erstellt den Benutzer in der SuperSaaS-Datenbank oder aktualisiert dessen Daten entsprechend. Das erspart den Benutzern und Kunden eine separate Anmeldung für das Online-Terminbuchungssystem und verhindert das doppelte Einloggen.

Plugin Installation und Einrichtung in Joomla!

Folge den Schritten, um das Modul in Joomla! einzurichten:

1. Installiere das Plugin. Gehe im Joomla!-Administratorbereich zu System>Installieren: Erweiterungen. Du kannst das Plugin installieren, ohne es separat herunterzuladen:
   • Bei Joomla! 6+, wähle die Option Aus Webkatalog installieren und suche nach „SuperSaaS“
   • Um die Kompatibilität mit älteren Joomla!-Versionen zu gewährleisten, lade eine Version von der Seite GitHub Versionen.
   Wenn Du das Modul anpassen möchtest, kannst Du es auch von unserem GitHub Repository herunterladen.
2. Richte das Plugin ein. Suche unter System>Verwalten: Plugins nach SuperSaaS und aktiviere es durch das Ändern des Status auf „Aktiviert“. Fahre nun mit der Konfiguration des Plugins fort, indem Du darauf klickst. Stelle sicher, dass „Öffentlich“ ausgewählt ist in den Einstellungen rechts bei „Zugriff“. Fülle als Nächstes den Bereich SuperSaaS Plugin Einstellungen (Settings) aus:
   • SuperSaaS account name* – Das ist der Name Deines Kontos (nicht Deine E-Mail-Adresse!)
   • SuperSaaS API key * – Du kannst den API-Schlüssel (API key) für Dein SuperSaaS Konto am Ende der Kontoinfos Seite finden.
   • Custom Domain Name – Wenn Du einen individuellen Domain-Namen (CNAME)für Deinen Kalender eingesetzt hast, der auf Deinen Online-Terminbuchungskalender verweist, musst Du ihn hier eingeben, um Deine Benutzer und Kunden richtig dort hin weiterzuleiten
   • Schedule name or URL – Entweder verwendest Du den Namen des Kalenders, den Du dafür benutzt oder Du setzt hier die volle URL des Kalenders ein, wenn Du dieser URL einige zusätzliche Parameter hinzufügen möchtest, um den Benutzer zu einer bestimmten Ansicht Deines Kalenders zu senden … mehr dazu unter Vorauswahl eines Datums oder einer Ansicht im Link in der Anleitung Link zu SuperSaaS von der eigenen Webseite
   (* – Pflichtfeld)

Ändere die Einstellungen im SuperSaaS Konto, um Joomla zu verknüpfen

Die Datenbank Deiner Joomla basierten Webseite leitet die Operationen als primäre Quelle. Das bedeutet, dass Änderungen in den Benutzerdaten Deiner Joomla!-Webseite an SuperSaaS weitergeleitet werden, jedoch nicht umgekehrt. Deswegen empfehlen wir, dass Deine Benutzer und Kunden ihre Benutzerdaten in SuperSaaS nicht ändern dürfen, weil das leicht zu Irritationen führen kann. Wenn ein Benutzer oder Kunde beispielsweise sein Passwort auf SuperSaaS ändert, ist ihm dabei wahrscheinlich nicht bewusst, dass sein Passwort für Joomla! aber noch immer Dasselbe geblieben ist.

Mache folgenden Änderungen an Deinem SuperSaaS-Konto, um Inkonsistenzen zu vermeiden:

1. Wähle auf dem Dashboard Zugangskontrolle und klicke Login und Registrierung werden auf Ihrer Webseite verwaltet
2. Wähle auf dem Dashboard Zugangskontrolle und setze ein Häkchen bei Verhindern, dass Benutzer ihre eigenen Informationen aktualisieren
3. Wähle auf dem Dashboard Layouteinstellungen und fülle das Eingabefeld Ihre URL mit der URL aus von der Webseite auf der Deine Nutzer und Kunden sich normalerweise anmelden

Zweitens solltest Du sicherstellen, dass die Datenbankfelder in Joomla! mit der Datenbank Deiner SuperSaaS Benutzer übereinstimmt. Nimm dafür folgende Änderungen unter Zugangskontrolle vor:

1. Deaktiviere die Auswahl E-Mail-Adresse als Login-Namen verwenden
2. Ändere das Auswahlfeld Login-Name/E-Mail auf Optional (oder auf Nicht fragen)
3. Ändere alle anderen Auswahlfelder zu Nicht fragen (Du kannst ebenfalls Passwort deaktivieren, wenn Du zuvor Login und Registrierung werden auf Ihrer Webseite verwaltet) ausgewählt hast

SuperSaaS Einstellungen

Dieses Bild entspricht der Seite „Zugangskontrolle“ in Deinem SuperSaaS Konto nach den oben beschriebenen Einstellungen.

Füge den Buchungs-Button auf Deiner Webseite ein

Füge den Kurzbefehl [supersaas] als das Kürzel für den vollen HTML-Befehl überall dort auf Deiner Webseite ein, wo Du die Schaltfläche als Button zur Weiterleitung auf Deinen online Terminkalender zeigen willst. Der Kurzbefehl kann auch zusätzliche Befehle enthalten: Die Parameter after, für nach, labelfür die Auswahl eines Kalenders und image um ein Bild hinzuzufügen, überschreiben damit die Werte der Einstellungen für die Bildschirmansicht.

Das ist dann praktisch, wenn Du mehrere Buchungs-Buttons zu unterschiedlichen online Buchungskalendern hinzufügen möchtest. Wie beispielsweise:

[supersaas after="schedule1" label="Buchung auf Kalender 1"]

[supersaas after="schedule2" label="Buchung auf Kalender 2" image="https://example.com/jetzt_buchen.gif"]

Text- und Bildbeispiele mit Kurzbefehl in einem Joomla Beitrag

Probiere es aus

Jetzt kannst Du die Buttons auf Deiner Webseite ausprobieren. Als Administrator musst Du Dich weiterhin über die SuperSaaS Hauptseite unter Anmeldung einloggen. Um die Funktion des Buttons richtig auszuprobieren, wie ein normaler Anwender Deiner Seite, solltest Du am besten abgemeldet sein. Wenn Du einen Superbenutzer in SuperSaaS anlegen willst, dann sorge dafür, dass diese Person sich zuvor mindestens einmal eingeloggt hat, indem sie diesen neuen Button zum Einloggen genutzt hat, bevor Du deren Rolle unter Benutzer-Management änderst.

Tipps zur Fehlerbehebung

• Beachte, dass der Button nur für Benutzer, die bereits in Deiner Joomla! Webseite eingeloggt sind, erscheint.
• Bei der Fehlermeldung Email is not a valid email address (E-Mail ist keine gültige E-Mail-Adresse), lies bitte den Abschnitt „Ändern der SuperSaaS Kontoeinstellungen, um Joomla! zu verwenden“ erneut, um sicherzugehen, dass die richtigen Vorgaben in Deinem SuperSaaS Konto eingestellt sind
• Bei der Fehlermeldung Login name is a reserved word (Benutzername ist ein reserviertes Wort) ist Dein Benutzername ein reserviertes Wort in SuperSaaS. Teste den Login bitte mit einem anderen Benutzernamen beim Einloggen.
• Wenn der neue Button den Benutzer und Kunden zwar weiterleitet, ihn dabei jedoch nicht einloggt und Du in den Plugin-Einstellungen eine URL im Feld Schedule name or URL (Kalender Name oder URL) verwendet hast, dann sollte die Domain dieser URL in Joomla! im Feld Custom Domain Name eingetragen sein.