11. CMS
Onder CMS vindt u alle dingen die u middels het CMS kunt aanpassen. Bij Page types kunt u het soort pagina definiëren en onder Pagina’s kunt u de menustructuur van uw Open Inwoner aanpassen. Het gaat hier om de pagina’s die worden weergegeven in het uitklapmenu op de homepage. Middels het CMS kunt u eenvoudig pagina’s aan- en uitzetten en verplaatsen. Tevens kunt u als beheerder door het CMS nu wijzigingen aan de voorkant van Open Inwoner doorvoeren zonder dat u hiervoor in de backend naar de configuratie hoeft te gaan.
11.1. Pagina’s
Bij Pagina’s ziet u de boomstructuur van het menu van Open Inwoner. In het screenshot rood omkaderd.
U kunt hier eenvoudig allerlei wijzigingen aanbrengen aan dit menu. Zo kunt u de volgorde van de menu items veranderen, de items aan applicaties koppelen, u kunt de status van het menu item wijzigen, items toevoegen of verwijderen, items (tijdelijk) uit het menu halen, kopiëren en pagina’s wijzigen.
11.1.2. Een pagina als startpagina instellen
Wanneer u een andere pagina dan de homepage als startpagina (aangegeven met het icoontje van het lichtgrijze huisje) wilt instellen, dan selecteert u in het hamburgermenu achter de betreffende pagina [Instellen als startpagina]. Wanneer u dit heeft gedaan komt het icoontje van het huisje achter de geselecteerde pagina te staan.
11.1.3. Gekoppelde applicatie wijzigen
Wanneer u dubbelklikt op het grijze icoontje met puzzelstukjes achter een menu item kunt u de gekoppelde applicatie wijzigen. Door te dubbelklikken komt u in het scherm met geavanceerde instellingen, waar bij “Applicatie” de gekoppelde applicatie kan worden aangepast. Zie het rode kader in het onderstaande screenshot. Klik na het wijzigen op [Opslaan] om de wijzigingen door te voeren.
11.1.4. Status wijzigen
Wanneer u onder de kolom ‘NL’ op het gekleurde bolletje klikt, kunt u de status van de gekozen pagina wijzigen. De kleur van het bolletje geeft de huidige versiestatus aan (zie ook hoofdstuk 11.1.11 over versiebeheer):
Groen — de pagina is gepubliceerd en zichtbaar voor bezoekers.
Blauw — er is een conceptversie met nog niet gepubliceerde wijzigingen.
Grijs — de pagina heeft geen gepubliceerde versie en is niet bereikbaar voor bezoekers.
Wanneer u op een bolletje klikt komt er een pop-up in beeld met de mogelijkheid om een voorbeeld van de pagina te bekijken of om de status te wijzigen. Wanneer u in de kolom klikt als de pagina gepubliceerd is (zoals in het screenshot het geval is) krijgt u hier de optie te zien om de publicatie van de pagina te ongedaan te maken. Klikt u hier op een pagina met een grijs bolletje, dan kunt u hier kiezen voor publiceren.
11.1.5. Items toevoegen
Wanneer u nieuwe pagina’s wilt toevoegen klikt u op de blauwe button met [Nieuwe pagina]. U maakt dan een nieuwe pagina op hoofdniveau aan. U komt in een nieuw scherm waarin u de gegevens van de nieuwe pagina moet invullen. Wanneer alle gegevens zijn ingevuld klikt u op [Opslaan]. U keert hierna terug naar het paginaoverzicht. Wilt u een nieuwe subpagina aanmaken? Dan klikt u op [+] achter de betreffende hoofdpagina. U komt vervolgens op een nieuw scherm waarin u de gegevens van de nieuwe subpagina moet invullen. Dit zijn dezelfde gegevens als bij een nieuwe hoofdpagina. Wanneer alle gegevens zijn ingevuld klikt u op [Opslaan].
Let op! De zojuist aangemaakte pagina is nog niet gepubliceerd (grijs bolletje). U dient de pagina eerst te publiceren (zie hoofdstuk 11.1.4)
Wanneer u na het aanmaken van de pagina de plek in de boomstructuur wilt veranderen, kunt u de pagina volgens de in hoofdstuk 11.1.1 beschreven methode een gewenste plek geven.
11.1.6. Preview van een pagina bekijken
Om een voorbeeld van een pagina te bekijken en te zien hoe het er in de frontend uitziet, klikt u op het oogje achter de betreffende pagina. In hetzelfde venster opent de website op de aangeklikte pagina. Wilt u dit in een ander tabblad of ander venster, gebruik dan uw rechter muisknop en klik op [open link in nieuw venster] of [open link in nieuw tabblad].
In het nieuw geopende scherm ziet u tevens bovenin beeld een balk met frontend navigatie voor het CMS. Op deze manier kunt u via de voorkant van de website/pagina dingen aanpassen zonder dat u eerst weer terug hoeft te gaan naar de beheeromgeving. Zie meer hierover in hoofdstuk 11.2.
11.1.7. Items kopiëren
Wanneer u een pagina wilt dupliceren klikt u op het hamburgermenu achter de betreffende pagina op [kopiëren] te klikken. Wanneer niets gekopieerd is, is de knop [plakken] grijs. Wanneer u echter een pagina gekopieerd heeft krijgt u wel de mogelijkheid te plakken. De gekopieerde pagina wordt geplakt op de geselecteerde locatie, maar kan vervolgens eenvoudig op de bij hoofdstuk 11.1.1 beschreven methode worden versleept.
11.1.9. Pagina’s wijzigen
U kunt pagina’s (menu items) wijzigen door in het overzicht op het potloodje te klikken achter de betreffende pagina, zoals middels het rode kader is weergegeven.
Wanneer u op het potlood-icoontje klikt komt u op een nieuw scherm waarin u allerlei dingen rond de pagina kunt wijzigen. Standaard ziet u enkel de basisinstellingen om te wijzigen. Dit zijn dezelfde gegevens als bij het aanmaken van een nieuw pagina.
Geavanceerde instellingen
U kunt echter ook op de button [Geavanceerde instellingen] klikken, waarna u de geavanceerde instellingen kunt wijzigen. U komt dan op een ander scherm terecht waar u aanvullende gegevens kunt wijzigen. Na het wijzigen klikt u op [Opslaan]. U kunt dit scherm ook direct bereiken door in het hamburgermenu achter de betreffende pagina op [Geavanceerde instellingen] te klikken.
Van bovenliggende pagina erven: Instellingen overnemen van de bovenliggende pagina
Ontzeggen: De pagina kan NIET worden ingevoegd in andere pagina’s of websites
Alleen deze website: De pagina kan enkel worden ingevoegd in deze website
Toestaan: De pagina kan worden ingevoegd in andere pagina’s of websites
11.1.10. Pagina’s verwijderen
Om een pagina helemaal te verwijderen klikt u op het hamburgermenu (de drie streepjes) achter de betreffende pagina. Er verschijnt nu een pop-up met diverse opties, waaronder [Verwijderen]. Wanneer u hierop klikt verwijdert u de gehele pagina. U haalt hiermee dus alles weg en verwijdert niet enkel de pagina uit het menu.
11.1.11. Versiebeheer
CMS 4 introduceert een volledig versiebeheer voor pagina-inhoud (versioning). Dit vervangt het vroegere eenvoudige onderscheid tussen een gepubliceerde en een conceptpagina: elke pagina heeft nu één of meer expliciet beheerde versies.
Versiestatussen
Elke versie van een pagina bevindt zich altijd in één van de volgende statussen:
Concept — De versie is aangemaakt maar nog niet gepubliceerd. Alleen ingelogde redacteuren en beheerders kunnen deze versie bekijken via de preview.
Gepubliceerd — De versie is zichtbaar voor alle bezoekers van de website. Er kan op elk moment slechts één versie tegelijk gepubliceerd zijn.
Niet-gepubliceerd — De versie was eerder gepubliceerd, maar de publicatie is teruggedraaid. De pagina is niet meer zichtbaar voor bezoekers.
Gearchiveerd — De versie is gearchiveerd. Dit gebeurt automatisch wanneer een nieuwe versie wordt gepubliceerd; de vorige gepubliceerde versie wordt dan gearchiveerd.
Werkwijze: bewerken en publiceren
Ga naar de voorkant van de website terwijl u bent ingelogd als redacteur of beheerder.
Navigeer naar de pagina die u wilt bewerken.
Klik op [Bewerken] in de CMS-werkbalk bovenaan. Bestaat er al een conceptversie, dan opent die versie. Anders wordt er automatisch een nieuwe conceptversie aangemaakt op basis van de huidige gepubliceerde versie.
Breng de gewenste wijzigingen aan.
Klik op [Publiceer veranderingen in de pagina] om de conceptversie te publiceren. De vorige gepubliceerde versie wordt automatisch gearchiveerd.
Note
In tegenstelling tot het vroegere CMS 3 worden wijzigingen niet automatisch zichtbaar voor bezoekers zodra u ze opslaat. U dient altijd expliciet op [Publiceer veranderingen in de pagina] te klikken om een versie live te zetten.
Versiegeschiedenis bekijken
Via de backend (CMS > Pagina’s) kunt u per pagina de versiegeschiedenis bekijken en eerder gearchiveerde versies terugzetten. Klik op het hamburgermenu achter de betreffende pagina en kies [Versies beheren].
11.2. Via de frontend wijzigingen doorvoeren
Het CMS maakt het mogelijk aan de voorkant van Open Inwoner direct bepaalde wijzigingen door te voeren. Op deze manier hoeft u voor sommige wijzigingen niet meer eerst naar de configuratie in de backend te gaan. Om frontend wijzigingen te maken gaat u eerst in de backend naar het onderdeel ‘pagina’s’ onder het menu-item CMS en klikt u op het oogje achter de pagina die u wilt wijzigen, zie hoofdstuk 11.1.6.
In het nieuw geopende scherm ziet u nu bovenin beeld een balk met frontend navigatie voor het CMS. Op deze manier kunt u via de voorkant van de website/pagina dingen aanpassen zonder dat u eerst weer terug hoeft te gaan naar de beheeromgeving.
11.2.5. Frontend een nieuwe pagina maken
U kunt eenvoudig en snel een nieuwe pagina aanmaken wanneer u op de knop [Maken] klikt. Afhankelijk van op welke pagina u zich bevindt krijgt u de mogelijkheid een nieuwe pagina of subpagina te maken. Maak een keuze en klik op [Volgende].
Er opent nu een nieuw scherm waarin u de titel en slug van de pagina kunt invoeren en eventueel content kunt maken in een editor. Klik wanneer u klaar bent op [Maken].
11.2.6. Frontend een pagina wijzigen
U kunt eenvoudig een pagina bewerken wanneer u op de knop [Bewerken] klikt. Let op! Deze knop is alleen zichtbaar als u op de live versie (gepubliceerde pagina) bent. Bevindt u zich op een pagina waar al zaken gewijzigd zijn, dan ziet u hier de knop [Bekijk gepubliceerde pagina].
Conceptversie bekijken (preview)
Voordat u een conceptversie publiceert kunt u een voorbeeld bekijken zoals de pagina er voor bezoekers uit zal zien. Klik hiervoor in de CMS-werkbalk op [Bekijk] of [Preview]. De preview is alleen zichtbaar voor ingelogde redacteuren en beheerders; bezoekers zien de pagina pas nadat u deze heeft gepubliceerd (zie hoofdstuk 11.1.11).
Wanneer u op de knop [Bewerken] heeft geklikt krijgt u de mogelijkheid dingen aan te passen. Wanneer u met de muis over de elementen op de pagina hoovert kunt u zien wat u kunt aanpassen. Er verschijnt een pop-up die zegt dat u kunt dubbelklikken om te bewerken. Onder deze tekst staat wát u kunt aanpassen (welk element).
Als u dubbelklikt krijgt u een nieuw venster met de aan te passen dingen. Indien er geen te bewerken plugin is krijgt u hier een melding van in het nieuwe venster.
Nadat u de gewenste aanpassingen heeft gedaan slaat u deze op door op de knop [Publiceer veranderingen in de pagina] te klikken.
11.2.7. Frontend een onderwerp wijzigen
U kunt eenvoudig een onderwerp wijzigen door op de onderwerp-pagina op het potloodicoontje te klikken. Als u hierover hoovert ziet u staat ‘Bekijk in beheeromgeving’. Wanneer u op het potloodicoontje klikt, opent in een nieuw venster de backend van het betreffende onderwerp. Hier kunt u alles wijzigen rond dit onderwerp. Zie meer hierover in hoofdstuk 6.9.
11.2.9. ‘Ga Naar’ links op homepagina via CMS
Wanneer u de homepagina bewerkt, kunt u via het plugin menu een nieuw blok toevoegen met 1 of meerdere externe links. Elke ‘Ga naar’ link dient een eigen icoontje te krijgen. De iconenset die in Open Inwoner wordt gebruikt is Material Icons. Deze bevat meer dan 2000 iconen waaruit u kunt kiezen.
Voeg eerst de plugin toe aan de pagina door middel van het plus symbool. Sleep deze plugin naar de gewenste volgorde binnen de plugin hiërarchie.
Voeg daarna één of meerdere links via het plus-symbool dat is verschenen bij de externe links plugin via ‘Voeg plugin toe’. Kies daar ‘Generiek’ >> ‘Link’
Selecteer voor elke link een passend icoon. De linktekst kan worden ingevoerd via de rich tekst editr. De gehele tekst en het icoon worden onderdeel van de link en zijn aanklikbaar.
Een icoon kan worden ingesteld door de juiste icoonnaam in te vullen in het veld ‘Icoon’. De exacte namen van alle beschikbare iconen vindt u op: https://fonts.google.com/icons
Kies in de linkerbalk de subset ‘Material Icons’ (niet ‘Material Symbols’) en selecteer vervolgens de variant ‘Outlined’. In het middendeel kunt u gericht zoeken op soorten iconen, bijvoorbeeld ‘park’ of ‘help’.
De exacte code-naam van het icoon verschijnt in de rechter pop-up. Vul deze naam in het veld ‘Icoon’ in, inclusief eventuele underscores (bijvoorbeeld help_outline of account_balance).
Plugin toevoegen:
De titel van het pagina blok is standaard ‘ingesteld als ‘Ga naar’ maar hier kan uiteraard ook een andere tekst worden ingevoerd. deze titel wordt zichtbaar als H2 kopje boven de links.
Link toevoegen:
‘Material Icons’ set selecteren, tevens ‘Outlined’ set kiezen en icoon zoeken:
Icoon kiezen en exacte naam zoeken bij ‘Web’ >> ‘Icon Font’:
Icoonveld correct invullen en eventueel link laten openen in nieuw venster via geavanceerde instellingen:
Publiceer de pagina om de wijzigingen definitief te maken.
Hieronder een voorbeeld van hoe het blok er aan de voorkant uit kan zien met 4 toegevoegde links. De iconen die hier zijn gebruikt, zijn achtereenvolgens: ‘people’, ‘message’, ‘list_alt’ en ‘insert_drive_file’.
11.2.11. Contactformulier aanpassen via CMS
Het contactformulier van Open Inwoner kan worden aangepast via het Django CMS. Hiervoor dient u eerst de configuratie voor openklant te voltooien. Zie hoofdstuk 9.4. Daar kunt u kiezen voor een API of e-mail of beiden. Wanneer aan het Klanten Systeem een “contact formulier onderwerp” wordt toegevoegd, wordt deze zichtbaar in de keuzelijst van het gepubliceerde contactformulier.
Django CMS kan worden bereikt via het CMS menu. U krijgt dan in de front-end van het Open Inwoner Platform de opties om nieuwe pagina’s aan te maken of te wijzigen. Indien u dit nog niet gedaan heeft, dan kunt u hier een pagina aanmaken voor het contactformulier en deze eerst opslaan.
Na bewaren kunt u voor deze contactpagina naar “Geavanceerde instellingen” gaan en daar eerst het juiste sjabloon kiezen (“CMS Contactformulier Sjabloon”) en de juiste Applicatie koppelen: “Openklant applicatie.” Publiceer de pagina. Deze wordt direct zichtbaar als link in de footer en in de sitemap.
Wanneer u op de pagina van het contactformulier zelf bent, dan vindt u in de CMS plugin werkbalk ook de contactformulier plugin.
Wanneer u op het potloodicoontje klikt, verschijnt er een pop-up waarmee u de begeleidende teksten van het contactformulier kunt aanpassen middels een rich text editor. Zodra u uw gewenste teksten heeft opgesteld klikt u op opslaan en “Publiceer veranderignen in de pagina.” De tekst wordt direct boven het contactformulier weergegeven.
Het contactformulier dat publiekelijk zichtbaar is voor alle gebruikers kunt u hier een andere beschrijvende tekst mee geven dan het contact formulier dat alleen zichtbaar is voor ingelogde gebruikers.
11.2.12. Takenlijst plugin configureren via CMS
De Takenlijst plugin toont een gepersonaliseerde lijst met openstaande taken voor ingelogde gebruikers. Deze taken kunnen afkomstig zijn uit twee verschillende bronnen:
ZGW API taken - Openstaande taken uit zaakgericht werken systemen
Objects API taken - Externe taken opgeslagen in de Objects API volgens gestandaardiseerde JSON schemas
Vereisten
Voordat u de Takenlijst plugin kunt configureren, moeten de volgende koppelingen zijn ingesteld:
Objects API configuratie - Zie hoofdstuk 9.8 voor het configureren van de Objects API service. Deze koppeling is nodig om externe taken op te halen.
Object Types configuratie - In de Objects API moeten twee object types zijn geconfigureerd met de juiste JSON schemas. Deze object types worden automatisch opgehaald en zijn beschikbaar als keuze in de plugin configuratie via hun titel:
Object Type (Generieke Dienstverlening) - Voor URL-taken volgens het volgende JSON schema:
{ "type": "object", "title": "ObjectType Taak", "description": "Externe klant taak schema V1.1.1", "required": ["titel", "status", "soort", "identificatie", "verwerker_taak_id", "eigenaar"], "properties": { "titel": {"type": "string", "description": "Weergave naam van de taak"}, "status": { "enum": ["open", "afgerond", "verwerkt", "gesloten"], "type": "string" }, "soort": { "enum": ["url", "portaalformulier", "ogonebetaling"], "type": "string" }, "identificatie": { "type": "object", "description": "KVK of BSN waaraan de taak gericht is" }, "url": { "type": "object", "properties": { "uri": {"type": "string", "format": "uri"} } }, "verwerker_taak_id": {"type": "string", "format": "uuid"}, "eigenaar": {"type": "string"} } }
Het volledige schema is beschreven in de Gitbook documentatie voor generieke dienstverlening.
Object Type (Extern Formulier Taak - Legacy) - Voor taken met externe formulieren volgens het volgende JSON schema:
{ "$id": "oip-klanttaak.schema.json", "type": "object", "title": "OIP Klanttaak", "required": ["titel", "status", "soort", "betrokkene", "portaalformulier", "verwerker_taak_id", "eigenaar"], "properties": { "soort": {"const": "externformulier"}, "titel": {"type": "string"}, "status": { "enum": ["open", "uitgevoerd", "afgebroken", "verwerkt", "ingetrokken"], "type": "string" }, "betrokkene": { "type": "object", "required": ["source", "levelOfAssurance", "authorizee"], "properties": { "source": {"const": "digid"}, "authorizee": { "type": "object", "properties": { "legalSubject": { "type": "object", "properties": { "identifier": {"type": "string", "pattern": "^[0-9]{9}$"}, "identifierType": {"const": "bsn"} } } } } } }, "portaalformulier": { "type": "object", "required": ["formulier"], "properties": { "formulier": { "type": "object", "properties": { "soort": {"const": "url"}, "value": {"type": "string", "format": "uri"} } } } }, "verwerker_taak_id": {"type": "string", "format": "uuid"}, "eigenaar": {"type": "string"} } }
ZGW API configuratie (optioneel) - Indien u ook openstaande taken uit zaaksystemen wilt tonen, configureer dan de ZGW API koppelingen. Zie hoofdstuk 9.7.
Plugin toevoegen aan een pagina
De Takenlijst plugin wordt meestal toegevoegd aan de homepage of aan een persoonlijke ‘Mijn Omgeving’ pagina:
Navigeer naar de gewenste pagina via CMS > Pagina’s
Klik op [Bewerken] om de pagina te bewerken
Open het plugin menu (de knop met rechts uitgelijnde regels en bullets)
Klik op [+] om een nieuwe plugin toe te voegen
Selecteer “Takenlijst Plugin” uit de lijst met beschikbare plugins
Configureer de plugin met de volgende velden:
Plugin configuratie
In het configuratiescherm van de Takenlijst plugin kunt u de volgende instellingen aanpassen:
Belangrijk: De twee object type velden zijn verwisseld ten opzichte van eerdere versies. Het veld “Object Type (Generieke Dienstverlening)” is nu bedoeld voor URL-taken, terwijl “Object Type (Extern Formulier Taak - Legacy)” bedoeld is voor de legacy externe formulier taken.
Klik op [Opslaan] om de configuratie op te slaan
Sleep de plugin naar de gewenste positie in de pagina structuur
Klik op [Publiceer veranderingen in de pagina] om de wijzigingen live te zetten
Resultaat
Na het publiceren van de pagina zien ingelogde gebruikers met een BSN een gepersonaliseerde lijst met hun openstaande taken. Elke taak toont:
Type taak (soort)
Titel van de taak
Status
Verloopdatum
Eigenaar (waar van toepassing)
Link naar de taak voor verdere afhandeling
Niet-ingelogde gebruikers of gebruikers zonder BSN zien een lege lijst of een bericht dat zij moeten inloggen om hun taken te kunnen bekijken.
Troubleshooting
Als de takenlijst leeg blijft terwijl er wel taken zouden moeten zijn:
Controleer of de Objects en Objecttypes API service correct is geconfigureerd
Controleer of de object types correct zijn ingevuld in de plugin configuratie
Controleer of er daadwerkelijk taken in de Objects API staan met het juiste BSN
11.2.13. Statische aliassen bewerken
Statische aliassen zijn inhoudsblokken die op meerdere pagina’s tegelijk worden hergebruikt. Een alias wordt op al die pagina’s op dezelfde manier weergegeven. Wanneer u de inhoud van een alias aanpast, is die wijziging direct zichtbaar op alle pagina’s waar de alias is geplaatst.
Voorbeelden van aliassen zijn de homepagina-blokken die op meerdere plekken in de site verschijnen.
Note
In CMS 3 werden deze blokken statische placeholders (static placeholders) genoemd. In CMS 4 heten ze statische aliassen (static aliases). De functionaliteit is vergelijkbaar, maar de bewerkstroom is gewijzigd zoals hieronder beschreven.
Note
Vanaf CMS 4 kunnen statische aliassen niet meer worden bewerkt door op het element op de homepagina te klikken of via het plugin menu van de pagina. Aliassen zijn een apart versiebeheerd inhoudstype en vereisen een eigen bewerkstroom.
Werkwijze: een statische alias bewerken
Ga naar de voorkant van de website terwijl u bent ingelogd als redacteur of beheerder.
Klik in de CMS-werkbalk bovenaan op [Aliassen] (of Aliases in de Engelse interface).
Er verschijnt een overzicht van alle beschikbare statische aliassen.
Zoek de alias die u wilt bewerken en klik op het potloodicoontje of [Bewerken].
Breng de gewenste wijzigingen aan aan de plugins binnen de alias.
Klik op [Publiceer alias] om de gewijzigde versie van de alias te publiceren.
Note
Net als bij gewone pagina’s (zie hoofdstuk 11.1.11) zijn wijzigingen aan een alias pas zichtbaar voor bezoekers nadat u de alias expliciet heeft gepubliceerd. Opslaan alleen is niet voldoende.