Ga naar inhoud

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

De pagina Zichtbaar voor van de stap-editor, met één groep geselecteerd

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

  1. Open Tours, klik bij de tour op Stappen bewerken en klik op Bewerken bij een stap
  2. Ga naar de pagina Zichtbaar voor van het stapdialoog (links) en vind het veld Zichtbaar voor groepen
  3. Selecteer één of meer Nextcloud-groepen
  4. 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:

  1. Maak de nieuwe stappen
  2. Beperk ze tot een Pilot-groep tijdens het verzamelen van feedback
  3. 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:

  1. Backend laadt de stap-configuratie uit wizard_steps_<lang>
  2. Backend leest de groepen van de huidige gebruiker via IGroupManager::getUserGroupIds()
  3. Voor elke stap checkt hij of visibleToGroups leeg is (zichtbaar voor iedereen) of overlapt met de groepen van de gebruiker
  4. 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 — visibleToGroups wordt 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

  1. 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.
  2. Documenteer je groep-gebruik — houd notities bij van welke groepen welke stappen gateen zodat toekomstige beheerders de structuur begrijpen.
  3. 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.
  4. 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