Handleiding

Vormgeving bij installatie

Het GPP-Burgerportaal, maakt gebruik van het NL Design System (NLDS). Daarnaast zijn er diverse onderdelen van de interface die organisatie-specifiek ingericht kunnen worden.

In de lijst met omgevingsvariabelen staat uitgelegd welke gegevens het Burgerportaal nodig heeft van de organisatie, om aan te sluiten bij de huistijl van de website. Het gaat dan om die variabelen die beginnen met RESOURCES:

Let op: het is belangrijk om na te denken over deze onderdelen vóórdat een organisatie het GPP-Burgerportaal gaat installeren. Zie ook het stappenplan op de community website.

Vormgeving en beheer-functionaliteit

Het GPP-burgerportaal beschikt over een beheerscherm waarmee de welkomsttekst en video op de homepage, afbeeldingen en URL’s die op de website getoond worden, beheerd kunnen worden.

Hoe krijgt een gebruiker toegang tot het beheerscherm?

Het beheerscherm kan gevonden worden door in de browser in de navigatiebalk de URL van het burgerportaal in te voeren, aangevuld met “/beheer”. Bijvoorbeeld: https://burgerportaal.gemeente.nl/beheer. De gebruiker wordt vervolgens gevraagd om in te loggen.

Om een gebruiker beheerders-rechten te geven, moet deze een specifieke rol krijgen in de OpenID Connect Identity Provider (bijv. Azure AD). De naam van deze rol moet zijn afgestemd met de beheerders van de Identity Provider, en bij installatie van de App zijn ingeregeld. Neem hiervoor contact op met de beheerders van de Identity Provider.

Na inloggen ziet de beheerder rechtsboven de volgende menu-items, die we hieronder verder toelichten:

  • Homepage

  • Afbeeldingen

  • Externe links

  • Uitloggen

Homepage

Op het beheerscherm kunnen onder het menu-item “Homepage” twee items gewijzigd worden:

  • Welkomsttekst

    Dit is de welkomsttekst die op de homepage van het Burgerportaal aan de burger wordt getoond. Het is mogelijk om de tekst op te maken met titels (heading 1 en heading 2), hyperlinks, genummerde en ongenummerde lijsten.

  • Promotie- of instructievideo

    Op de homepage kan ook een embedded Youtube- of Vimeo-video getoond worden aan de burger. Dit is optioneel. Zo’n video kan helpen om aan de burger duidelijk te maken wat de Wet open overheid is en/of wat hij/zij/hen kan vinden op het Burgerportaal. Bij het veld staat een toelichting achter een (?)-knop over hoe de video-URL samengesteld moet zijn om correct te werken.

Onderaan het scherm staan knoppen om de wijzigingen op te slaan of de wijzigingen te annuleren.

Warning

Let op: Cross-Origin-Embedder-Policy wordt uitgeschakeld wanneer een video is ingesteld. De embedder is verantwoordelijk voor juiste toegankelijkheid van video content, inclusief ondertiteling en toetsenbordnavigatie.

Afbeeldingen

Op het beheerscherm kunnen onder het menu-item “Afbeeldingen” drie items gewijzigd worden:

  • Logo organisatie

    Hier kan het logo van de organisatie geüpload worden. Deze wordt op het Burgerportaal op iedere webpagina linksboven getoond. De afbeelding wordt geschaald zodat deze volledig getoond wordt. Hoeveel ruimte er is voor het logo wordt door de NLDS-tokens bepaald.

  • Favicon

    Hier kan het favicon van het Burgerportaal geüpload worden. Dit is het icoon dat in browsers in de navigatiebalk of het browser-tabblad wordt getoond.

  • Sfeerfoto

    Hier kan de sfeerfoto geüpload worden. Deze foto wordt op het Burgerportaal op iedere webpagina getoond als horizontale balk onder het organisatie-logo en het menu. De foto wordt geschaald en bijgesneden (een gelijk deel boven en onder) zodat de horizontale balk geheel gevuld wordt.

Onder ieder item staat een knop “Vervangen” waarmee een lokaal opgeslagen afbeelding geselecteerd en geüpload kan worden. Bij ieder item staat een toelichting achter een (?)-knop met informatie over o.a. geaccepteerde bestandsformaten en bestandsgrootte.

Tip

Check na het uploaden van een afbeelding het resultaat op het Burgerportaal. is het resultaat niet geheel naar wens? Gebruik dan software om de foto of afbeelding te bewerken, upload de afbeelding opnieuw en check het resultaat. Soms vergt het enig geëxperimenteer om tot een tevredenstellend resultaat te komen.

Uitloggen

Door op dit menu-item te klikken wordt de beheerder uitgelogd.

Zoeken, vinden en raadplegen voor burgers

De kernfunctie van het GPP-burgerportaal is uiteraard het bieden van een publiek toegankelijke website waarop burgers openbaar gemaakte informatie kunnen zoeken, vinden en raadplegen. De burger hoeft niet in te loggen; de website ontsluit immers openbare informatie die de overheid drempelvrij aan haar burgers aan wil bieden. De burger kan de website bezoeken door eenvoudigweg naar de juiste URL te gaan, bijvoorbeeld https://open.gemeente.nl/.

De publieke website bestaat grofweg uit de volgende onderdelen:

  • Homepage

    Op de homepage springt de zoekbalk, welke over de sfeerfoto (zie hierboven) heen is geplaatst, het meest in het oog. De burger kan hier een of meer zoektermen invullen en op “enter” drukken of de knop “Zoeken” om naar de zoekresultaten te gaan (Zie hieronder). Onder de zoekbalk staan de welkomsttekst en eventueel een promotie- of instructievideo (zie hierboven). Daaronder verschijnt een automatisch draaiende carrousel met daarin de gepromote onderwerpen (Zie hieronder). Vervolgens worden enkele basale statistieken getoond (aantal gepubliceerde publicaties, documenten en onderwerpen) en de voetbalk met enkele links (zie hierboven).

  • Zoekresultaten

    Door op de homepage de zoekbalk te gebruiken of door in het menu bovenaan naar het item “Zoeken” te gaan, komt de burger terecht bij de zoekresultaten. Hier ziet de burger een lijst aan zoekresultaten die relevant zijn, gelet op de ingevoerde zoektermen. Bovenaan de lijst ziet de burger de mogelijkheid om de zoektermen aan te passen en de sortering aan te passen (op relevantie dan wel chronologisch). Aan de linkerzijde staat de mogelijkheid om de zoekresultaten te filteren op datum (van… tot…), type informatie, organisatie en/of informatiecategorie. Onderaan de lijst staat de mogelijkheid om door de lijst te bladeren. Om de webpagina overzichtelijk en performatief te houden worden namelijk max. 10 zoekresultaten per pagina getoond.

  • Detailschermen

    Wanneer een burger op een zoekresultaat klikt, dan wordt het detailscherm geopend. Op zo’n detailscherm worden de gegevens van die publicatie, dat document of dat onderwerp getoond. Op het detailscherm van een document staat ook een knop waarmee het bestand (bijv. PDF) gedownload kan worden. Op het detailscherm van een publicatie staat onderaan een lijst van gekoppelde documenten. Op het detailscherm van een onderwerp staat onderaan een lijst van gekoppelde publicaties. Uiteraard zijn verwijzingen naar documenten, publicaties en onderwerpen aanklikbaar, zodat het desbetreffende detailscherm wordt geopend.

  • Onderwerpen

    Door in het menu bovenaan naar het item “Onderwerpen” te gaan, komt de burger terecht op een overzicht aan onderwerpen. Bovenaan staan de “gepromote” onderwerpen, die ook te zien zijn in de carrousel op de homepage. Daaronder staat een lijst met alle gepubliceerde onderwerpen. Van ieder onderwerp wordt een afbeelding getoond en een korte toelichting. Door op een onderwerp te klikken opent de burger het detailscherm van het onderwerp (Zie hierboven).

Voor een uitgebreidere toelichting op (de samenhang van) onderwerpen, publicaties en documenten, als ook over de gegevens / metadata hiervan, zie de documentatie van de GPP-publicatiebank.

Aansluiting op de landelijke voorziening

Voor een correct werkende aansluiting op de Generieke Woo-Voorziening (GWV) moeten de openbare documenten vermeld worden in een sitemap. Het GPP-Burgerportaal genereert deze sitemaps, zodat de Woo-harvester ze kan overnemen. De sitemap wordt iedere 24 uur geactualiseerd. De sitemap is te vinden via https://domeinnaam-van-het-burgerportaal/robots.txt, en voldoet aan het schema diwoo-metadata.xsd versie 0.9.8.