Single sign-on voor Joomla! websites

Deze pagina legt uit hoe u een SuperSaaS-agenda integreert in een Joomla! website zodat gebruikers maar een keer hoeven in te loggen om zowel uw website als de SuperSaaS-agenda te gebruiken. Om dit te kunnen doen dient u eerst een (gratis) SuperSaaS-account aan te maken.

• Joomla! gebruikersnamen gebruiken voor SuperSaaS
• De plugin in Joomla! installeren en instellen
• Instellingen in SuperSaaS aanpassen om met Joomla! te koppelen
• Een boekingsknop aan uw pagina’s toevoegen
• Veel voorkomende problemen

Joomla! loginnamen gebruiken voor uw SuperSaaS-agenda

De SuperSaaS Joomla!-plugin toont een knop met de tekst Reserveer nu waarmee de gebruiker automatisch inlogt bij een SuperSaaS-agenda met zijn Joomla!-gebruikersnaam.

De knop die door de plugin wordt gegenereerd, stuurt de gebruikersgegevens uit uw Joomla!-database door naar SuperSaaS, zodat de gebruiker daar wordt aangemaakt of indien nodig wordt bijgewerkt. Dat voorkomt dat gebruikers twee aparte logins nodig hebben en twee keer moeten inloggen.

Installatie en configuratie van de plugin in Joomla!

Voer de volgende stappen uit om de plugin in te stellen:

1. Installeer de plugin. Op de Joomla!-beheerpagina gaat u naar Systeem>Extensies installeren. U kunt de plugin installeren zonder hem apart te downloaden:
   • Voor Joomla! 6+ kiest u de optie Installeren vanaf Web en zoekt u naar “SuperSaaS”
   • Voor oudere Joomla!-versies downloadt u een release vanaf de GitHub releases-pagina.
   Als u de module wilt aanpassen, kunt u hem ook downloaden uit onze GitHub-repository.
2. Stel de plugin in. Zoek in Systeem>Plugins beheren naar SuperSaaS en zet de status op “Ingeschakeld”. Zorg ervoor dat “Openbaar” is geselecteerd bij “Toegang”. Vul vervolgens het gedeelte SuperSaaS Plugin-instellingen in:
   • SuperSaaS accountnaam* – Dit is de naam van uw account (niet uw e-mailadres)
   • SuperSaaS API key * – De API key van uw SuperSaaS-account kunt u vinden onderaan de pagina Accountbeheer.
   • Eigen domeinnaam – Als u een eigen domeinnaam heeft gemaakt die naar uw agenda wijst, kunt u die hier invullen zodat de knop daar ook naartoe verwijst.
   • Agendanaam of URL – U kunt hier de naam van een agenda opgeven, of een volledige URL als u de gebruiker met extra parameters naar een specifieke weergave wilt sturen.
   (* – verplicht veld)

Uw SuperSaaS-accountinstellingen aanpassen zodat die met Joomla! werken

Uw Joomla!-gebruikersdatabase is leidend, wat betekent dat wijzigingen in de gebruikersgegevens op uw Joomla!-site worden doorgegeven aan SuperSaaS, maar niet andersom. Daarom raden we aan om gebruikers hun gegevens niet in SuperSaaS te laten aanpassen, omdat dat gemakkelijk tot verwarring kan leiden. Als een gebruiker bijvoorbeeld zijn wachtwoord zou mogen wijzigen in SuperSaaS, dan zou hij waarschijnlijk niet beseffen dat zijn Joomla!-wachtwoord nog steeds hetzelfde is.

Maak de volgende wijzigingen om inconsistenties te voorkomen:

1. Op de pagina Toegangsbeheer selecteert u Inloggen en registratie op uw eigen site beheren
2. Op de pagina Toegangsbeheer selecteert u Voorkom dat gebruikers hun eigen gegevens kunnen aanpassen
3. Op de pagina Layout instellingen vult u in het veld Uw URL de URL in van de pagina op uw site waar gebruikers kunnen inloggen

Verder moet u ervoor zorgen dat de databasevelden in Joomla! overeenkomen met die in uw SuperSaaS-gebruikersdatabase. Maak de volgende aanpassingen op de pagina Toegangsbeheer:

1. Zet de optie uit: Gebruik het e-mailadres als loginnaam
2. Zet de knop voor E-mailadres op Optioneel (of Verplicht)
3. Zet alle andere velden op Niet vragen (u kunt het veld Wachtwoord ook uitschakelen als u de optie Login wordt niet hier afgehandeld hebt gekozen)

SuperSaaS instellen

De afbeelding links toont de pagina Toegangsbeheer in uw SuperSaaS-account nadat u de bovenstaande instellingen hebt gemaakt.

De knop toevoegen aan uw pagina’s

Plaats de shortcode [supersaas] op alle pagina’s waar u de knop wilt laten verschijnen. De shortcode kan optionele parameters after, label en image gebruiken om de waarden uit het instellingenscherm te overschrijven.

Dit is handig als u bijvoorbeeld meerdere knoppen naar verschillende agenda’s wilt laten wijzen:

[supersaas after="agenda_1" label="Reserveer op agenda 1"]

[supersaas after="agenda_2" label="Reserveer op agenda 2" image="https://example.com/book_now.gif"]

De knop uitproberen

U kunt de knop nu op uw eigen site uitproberen. Als beheerder moet u nog steeds op de normale manier via de SuperSaaS-site inloggen, dus test dit door uzelf voor te doen als gewone gebruiker. Als u superusers in SuperSaaS wilt instellen, zorg er dan voor dat zij eerst minstens een keer via de knop hebben ingelogd voordat u hun rol wijzigt op de pagina Gebruikerbeheer.

Veel voorkomende problemen

• Let op dat de knop alleen zichtbaar is voor gebruikers die ingelogd zijn op uw Joomla!-site.
• Als u de melding “E-mail is geen geldig e-mailadres” ziet, lees dan de sectie hierboven over het aanpassen van uw SuperSaaS-accountinstellingen opnieuw door om te controleren of alles goed staat.
• Als u de melding “Login name is a reserved word” ziet, probeer dan opnieuw in te loggen met een andere gebruikersnaam.
• Als de knop de gebruiker wel doorstuurt, maar hem niet echt inlogt, en u een URL hebt gebruikt in het veld Agendanaam of URL, controleer dan of het domein van die URL is ingevuld in het veld Eigen domeinnaam.