Groep-gebaseerde stap-zichtbaarheid¶
Geïntroduceerd in v1.2.0.
Groep-gebaseerde stap-zichtbaarheid laat je individuele wizard-stappen beperken tot specifieke Nextcloud-groepen, wat rol-gebaseerde onboarding mogelijk maakt — verschillende tours voor verschillende rollen, zonder aparte configuraties bij te houden.
Hoe het werkt¶

Elke stap heeft een Zichtbaar voor groepen-veld (multi-select-dropdown van alle Nextcloud-groepen):
- Lege selectie (default) — stap is zichtbaar voor alle gebruikers
- Eén of meer groepen geselecteerd — stap is alleen zichtbaar voor gebruikers die lid zijn van minstens één van die groepen
Filtering gebeurt server-side in ApiController::getWizardSteps(), zodat gebruikers verborgen stappen ook niet via browser-developer-tools kunnen zien.
Groep-zichtbaarheid configureren¶
- Open Tours, klik bij de tour op Stappen bewerken en klik op Bewerken bij een stap
- Ga naar de pagina Zichtbaar voor van het stapdialoog (links) en vind het veld Zichtbaar voor groepen
- Selecteer één of meer Nextcloud-groepen
- Klik op Opslaan; de stap wordt direct opgeslagen
Om het resultaat te controleren klik je op Tour bekijken en kies je een groep onder Bekijken als: het voorbeeld toont de stappen die leden van die groep krijgen. Zie Bekijken.
Use-cases¶
Rol-gebaseerde onboarding¶
| Stap | Zichtbaar voor groepen | Doelgroep |
|---|---|---|
| Welkom | (leeg) | Alle gebruikers |
| Bestanden-overzicht | (leeg) | Alle gebruikers |
| Admin-paneel | Administrators |
Alleen admins |
| Geavanceerd zoeken | Power Users, Administrators |
Power users en admins |
| HR-self-service | HR |
HR-team |
| Dev-tools | Developers |
Developer-team |
Afdeling-specifieke tours¶
Maak één tour met sectie-specifieke stappen:
- Algemene stappen zichtbaar voor iedereen
- HR-specifieke stappen beperkt tot de
HR-groep - IT-specifieke stappen beperkt tot de
IT-groep - Marketing-specifieke stappen beperkt tot de
Marketing-groep
Pilot-groep-uitrol¶
Bij het testen van nieuwe wizard-content:
- Maak de nieuwe stappen
- Beperk ze tot een
Pilot-groep tijdens het verzamelen van feedback - Eenmaal gevalideerd, verwijder de groep-beperking om naar iedereen uit te rollen
Trainings-niveaus¶
- Basis-stappen (lege groepen) — iedereen ziet ze
- Geavanceerde stappen (beperkt tot
Power Users) — alleen ervaren gebruikers
Hoe filtering intern werkt¶
Wanneer de frontend GET /apps/introvox/api/steps opvraagt:
- Backend laadt de stap-configuratie uit
wizard_steps_<lang> - Backend leest de groepen van de huidige gebruiker via
IGroupManager::getUserGroupIds() - Voor elke stap checkt hij of
visibleToGroupsleeg is (zichtbaar voor iedereen) of overlapt met de groepen van de gebruiker - Geeft alleen de matchende stappen terug
Dit betekent:
- Gebruikers ontvangen nooit verborgen stap-content over de draad — bescherming zit op de API-laag
- Als een gebruiker later aan een groep wordt toegevoegd, zien ze de relevante stappen bij hun volgende wizard-weergave (geen caching van stap-lijsten per gebruiker)
Opmerkingen en edge-cases¶
- Export/Import behoudt groep-instellingen —
visibleToGroupswordt opgenomen in de JSON-payload - Groep-wijzigingen zijn direct van kracht — geen cache om te legen, geen admin-actie nodig
- Lege
visibleToGroups: []in geïmporteerde JSON betekent zichtbaar voor iedereen (zelfde als het veld afwezig zijn) - Groep-IDs vs. display-namen — IntroVox gebruikt groep-IDs, geen display-namen. De meeste installaties hebben deze gelijk, maar verifieer in Instellingen → Gebruikers.
Best practices¶
- Begin permissief, beperk later — laat nieuwe stappen aanvankelijk zichtbaar voor iedereen, en voeg groep-beperkingen toe zodra je weet wie wat nodig heeft. Makkelijker dan andersom.
- Documenteer je groep-gebruik — houd notities bij van welke groepen welke stappen gateen zodat toekomstige beheerders de structuur begrijpen.
- Controleer met Bekijken als — Tour bekijken → Bekijken als toont de stappen die leden van één groep krijgen, zonder dat je als iemand anders hoeft in te loggen. Zie Bekijken.
- Combineer met taal-scheiding — groep-gebaseerde filtering geldt binnen een taal. Om zowel taal als groep te targeten, configureer de stappen van die taal met de relevante groep-beperkingen.
Alternatieven voor stap-niveau-groep-beperking¶
| Doel | Aanpak |
|---|---|
| Verberg de hele app voor bepaalde gebruikers | Instellingen → Apps → IntroVox → Beperken tot groepen (Nextcloud-niveau) |
| Alle tours uitzetten | Zet Tours for everyone uit |
| Verschillende stappen per gebruikers-rol tonen | Groep-gebaseerde zichtbaarheid (deze pagina) |
| Een hele tour voor een app alleen aan bepaalde groepen geven | Zichtbaar voor bij die tour (Tours) |
| Voor één taal eigen tekst schrijven | Taalspecifieke versie toevoegen in de stappen-editor van een tour (Tours → Stappen bewerken) |
Zie ook¶
- Tourstappen beheren — stap-CRUD
- Stap-zichtbaarheid — groep-filters + gebruikers-voorkeuren
- API-referentie —
getWizardSteps-endpoint met filtering