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.

CMS dashboard

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.

CMS dashboard

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.

CMS dashboard

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.

CMS dashboard

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.

CMS dashboard

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)

CMS dashboard

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].

CMS dashboard

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.

CMS dashboard

11.1.8. Items (tijdelijk) uit het menu halen

Wanneer u een (sub)pagina al dan niet tijdelijk uit het menu wilt halen, klikt u onder de kolom ‘Menu’ op het groene vinkje. Wanneer u het vinkje hier weghaalt haalt u de pagina uit het menu. Er komt dan een grijs vierkantje met een streep in de kolom te staan. Wilt u de pagina weer toevoegen aan het menu? Dan klikt u dit vierkantje weer aan en komt er weer een groen vinkje te staan.

CMS dashboard

Let op! U verwijdert door het vinkje weg te klikken niet de volledige pagina en u maakt ook de publicatie niet ongedaan. De betreffende pagina is alleen niet meer via het menu te raadplegen. Dit betekent dat mensen door middel van een directe link nog altijd de pagina kunnen bereiken.

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.

CMS dashboard

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.

CMS dashboard
Overschrijf URL
Vul hier een nieuwe URL in als u voor de pagina een andere URL wilt gebruiken
Doorsturen
Vul hier een URL in waarnaar de pagina moet worden doorgestuurd. Of kies een pagina uit het drop-down menu.
Sjabloon
Hier kiest u eventueel een sjabloon om voor de indeling en opmaak van de pagina te gebruiken.
ID
Vul hier de pagina-ID in. Dit is een unieke identificatie die gebruikt wordt door de page_url templatetag voor koppelingen naar deze pagina.
Schijn-oorsprong
Schijn-oorsprong maakt het mogelijk de navigatie-hiërarchie in te korten, zodat de URL overzichtelijker wordt. De schijn-oorsprong maakt het mogelijk dit aan te passen zonder dat de verandering ten koste gaat van de hiërarchische structuur. Door dit vakje aan te klikken lijkt het in de navigatie alsof de pagina een hoofdpagina is in plaats van een subpagina.
Gekoppeld menu
Hier kiest u aan welk menu de pagina moet worden gekoppeld.
Applicatie
Hiermee kunt u een applicatie aan de betreffende pagina koppelen.
X-frame opties
Hier kunt u aangeven of de pagina kan worden ingevoegd in andere pagina’s of websites. De beschikbare opties worden weergegeven in het drop-down menu:
  • 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.

CMS dashboard

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

  1. Ga naar de voorkant van de website terwijl u bent ingelogd als redacteur of beheerder.

  2. Navigeer naar de pagina die u wilt bewerken.

  3. 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.

  4. Breng de gewenste wijzigingen aan.

  5. 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.

CMS dashboard

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.

CMS dashboard

11.2.1. Sitebrede mogelijkheden via CMS menu

U kunt frontend diverse sitebrede dingen (geldend voor de gehele website) aanpassen. Dit doet u door in het CMS menu op de knop [OpenInwoner] te klikken. Er verschijnt een uitvouwmenu met verschillende opties die u kunt uitvoeren.

CMS dashboard

Wanneer u op een van de menu-items klikt, verschijnt er een pop-up pagina met het betreffende scherm uit de backend. Als u klaar bent met de wijzigingen kunt u dit scherm weer wegklikken en zit u weer volledig aan de voorkant van de website. In het screenshot kunt u zien dat het venster van de betreffende pagina in de backend óver de pagina aan de voorkant wordt weergegeven. Wanneer u uw gewenste wijzigingen heeft opgeslagen klikt u op het kruisje dat in het screenshot rood omkaderd is.

CMS dashboard
Pagina’s
Wanneer u in het menu op [Pagina’s] klikt, komt u terecht op ‘Pagina’s’ onder het menu-item CMS (Backend). Hier heeft u alle mogelijkheden die in hoofdstuk 11.2 beschreven staan.
Gebruikers
Wanneer u in het menu op [Gebruikers] klikt, komt u terecht op ‘Gebruikers’ onder het menu-item Gebruikersprofielen. Hier heeft u alle mogelijkheden die in hoofdstuk 4.6 beschreven staan.
Beheer
Wanneer u in het menu op [Beheer] klikt, komt u terecht op het dashboard van de backend. Hier heeft u alle mogelijkheden die in hoofdstuk 3 beschreven staan.
Gebruikersinstellingen
Wanneer u in het menu op [Gebruikersinstellingen] klikt, kunt u de instellingen van de ingelogde gebruiker wijzigen.
Klembord
Wanneer u plugins gekopieerd heeft komen deze op het klembord te staan. Zo kunt u deze eenvoudig op een andere pagina plakken. U kunt meerdere plugins in één keer kopiëren.
Klembord leegmaken
Selecteer dit om alle gekopieerde items uit het geheugen te verwijderen.

11.2.2. Paginamogelijkheden via CMS menu

U heeft frontend diverse mogelijkheden om pagina’s te bewerken, aan te maken, verwijderen en instellingen van pagina’s te wijzigen. Deze mogelijkheden ziet u in het submenu onder [Pagina].

CMS dashboard
Maak pagina
Via dit menu-item maakt u een nieuwe pagina of subpagina. Selecteer de juiste optie in het menu. U kunt hier tevens de huidige pagina dupliceren.
Paginaopties
Wanneer u in het menu op [Paginaopties] klikt, komt er een pop-up scherm in beeld met daarop common extensions. Hier kunt u aangeven of men voor de betreffende pagina – al dan niet met DigiD – ingelogd moet zijn. U kunt ook een indicator (teller) kiezen en een icoon voor de betreffende pagina selecteren.
CMS dashboard
Pagina-instellingen
Wanneer u in het menu op [Pagina-instellingen] klikt, gaat u direct naar de basisinstellingen van de betreffende pagina. Deze zijn ook te vinden in de backend onder het sub-item Pagina’s onder menu-item CMS. Zie hoofdstuk 11.1.9.
Geavanceerde instellingen
Wanneer u in het menu op [Geavanceerde instellingen] klikt, gaat u direct naar de geavanceerde instellingen van de betreffende pagina. Deze zijn ook te vinden in de backend onder het sub-item Pagina’s onder menu-item CMS. Zie hoofdstuk 11.1.9.
Sjablonen
Hier kunt u de pagina direct in een reeds aangemaakt sjabloon gieten of u kunt de structuur van de bovenliggende pagina laten overnemen.
Opslaan als paginatype
Hier kunt u de pagina een nieuw paginatype toewijzen. Wanneer u hierop klikt krijgt u direct de mogelijkheid een nieuwe page type te definiëren. Dit kunt u ook doen in de backend via ‘Page types’ onder het menu-item CMS. Via deze weg dient u echter nog wel te klikken op [Nieuwe Page type].
Publicatiedatums
Hier kunt u indien gewenst de begin- en einddatum van een pagina invullen.
Verberg in navigatie / Toon in navigatie
Selecteer [verberg in navigatie] om de pagina uit de navigatiebalk te verwijderen. Wanneer de pagina al is verborgen staat hier de knop [Toon in navigatie] om de pagina juist weer in de navigatiebalk weer te geven. Zie hoofdstuk 11.1.8.
Publicatie pagina ongedaan maken
Hiermee maakt u de publicatie van een pagina ongedaan. Zie hoofdstuk 11.1.4.
Terugdraaien naar live
Hiermee keert u terug naar de versie van de pagina die live staat. Eventuele wijzigingen worden niet doorgevoerd. Sla de wijzigingen eerst op als u deze daadwerkelijk wilt doorvoeren.
Pagina verwijderen
Selecteer dit om de huidige pagina te verwijderen. Zie hoofdstuk 11.1.10
Configuratie mijn profiel
Wanneer u op de pagina ‘Mijn Profiel’ bent kunt u deze pagina configureren. U kunt hier individuele opties in- of uitschakelen.

11.2.3. Hulpmogelijkheden via CMS menu

Onder ‘Help’ vindt u diverse mogelijkheden om antwoord op uw vragen te krijgen rond het Django CMS. U kunt de ontwikkelhandleiding, documentatie en de gebruikershandleiding raadplegen. U kunt op het forum terecht voor vragen en antwoorden over het Django CMS. U kunt via Slack hulp krijgen bij het Django CMS en bij ‘Wat is nieuw’ ziet u de laatste updates aan het Django CMS.

CMS dashboard

11.2.4. Taalmogelijkheden via CMS menu

Onder ‘Taal’ kunt u aangeven in welke taal u de pagina wilt hebben. Dit is voor Open Inwoner echter enkel Nederlands. Ook kunt u hier de vertaling van het Django CMS verwijderen.

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].

CMS dashboard

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].

CMS dashboard

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).

CMS dashboard

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).

CMS dashboard

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.

CMS dashboard

Nadat u de gewenste aanpassingen heeft gedaan slaat u deze op door op de knop [Publiceer veranderingen in de pagina] te klikken.

CMS dashboard

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.

CMS dashboard

11.2.8. Plugin menu

Wanneer u de homepage bewerkt krijgt u de mogelijkheid het plugin menu aan te klikken. Dit is de knop met rechts uitgelijnde regels en bullets. Zie het rode kader in het screenshot.

CMS dashboard

Wanneer dit wordt uitgevouwen ziet u alle actieve plugins. Deze plugins kunt u bewerken door op het potloodicoontje van de betreffende plugin te klikken. U kunt nieuwe plugins toevoegen door op [+] te klikken en u kunt de plugins eenvoudig een andere plek op de pagina geven door ze te verslepen naar de gewenste plek.

CMS dashboard

Wanneer u op het hamburgermenu klikt krijgt u de mogelijkheid de plugins te knippen, kopiëren, plakken, verwijderen, markeren en een alias te creëren. Knippen, kopiëren, plakken en verwijderen spreken voor zich.

CMS dashboard

Markeren Wanneer u op markeren klikt wordt de betreffende plugin op de pagina weergegeven met een blauw kader. Zo weet u precies welk element op de pagina met de betreffende plugin wordt bedoeld.

Creëer alias Door een alias te creëren kunt u content hergebruiken op verschillende pagina’s en deze op één plek beheren. Wanneer hergebruikte content op één plek wordt gewijzigd, wordt dit door de alias ook op de andere plekken gewijzigd.

Note

Een eenmaal aangemaakte alias kunt u niet bewerken via het plugin menu van de pagina waarop hij is geplaatst. Gebruik hiervoor de [Aliassen]-optie in de CMS-werkbalk. Zie hoofdstuk 11.2.13.

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.

CMS contactformulier aanmaken

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.

CMS contactformulier geavanceerde instellingen

Wanneer u op de pagina van het contactformulier zelf bent, dan vindt u in de CMS plugin werkbalk ook de contactformulier plugin.

CMS contactformulier

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.

CMS contactformulier introductie teksten

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:

  1. ZGW API taken - Openstaande taken uit zaakgericht werken systemen

  2. 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:

  1. 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.

  2. 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"}
        }
      }
      
  3. 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:

  1. Navigeer naar de gewenste pagina via CMS > Pagina’s

  2. Klik op [Bewerken] om de pagina te bewerken

  3. Open het plugin menu (de knop met rechts uitgelijnde regels en bullets)

  4. Klik op [+] om een nieuwe plugin toe te voegen

  5. Selecteer “Takenlijst Plugin” uit de lijst met beschikbare plugins

  6. Configureer de plugin met de volgende velden:

Plugin configuratie

In het configuratiescherm van de Takenlijst plugin kunt u de volgende instellingen aanpassen:

Titel
De titel die boven de takenlijst wordt weergegeven (standaard: “Mijn Taken”)
Object Type (Generieke Dienstverlening)
Selecteer hier het object type voor URL-taken uit de dropdown lijst. Wanneer de Objects API correct is geconfigureerd, verschijnen de beschikbare object types automatisch in de lijst op basis van hun titel. Dit object type wordt gebruikt voor externe taken met een directe URL - deze taken leiden de gebruiker direct naar een externe website of formulier.
Object Type (Extern Formulier Taak - Legacy)
Selecteer hier het object type voor taken met externe formulieren uit de dropdown lijst. Wanneer de Objects API correct is geconfigureerd, verschijnen de beschikbare object types automatisch in de lijst op basis van hun titel. Dit object type wordt gebruikt voor de legacy implementatie van externe formuliertaken waarbij het formulier binnen het platform wordt getoond.

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.

  1. Klik op [Opslaan] om de configuratie op te slaan

  2. Sleep de plugin naar de gewenste positie in de pagina structuur

  3. 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:

  1. Controleer of de Objects en Objecttypes API service correct is geconfigureerd

  2. Controleer of de object types correct zijn ingevuld in de plugin configuratie

  3. 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

  1. Ga naar de voorkant van de website terwijl u bent ingelogd als redacteur of beheerder.

  2. Klik in de CMS-werkbalk bovenaan op [Aliassen] (of Aliases in de Engelse interface).

CMS static alias bewerken
  1. Er verschijnt een overzicht van alle beschikbare statische aliassen.

  2. Zoek de alias die u wilt bewerken en klik op het potloodicoontje of [Bewerken].

  3. Breng de gewenste wijzigingen aan aan de plugins binnen de alias.

  4. 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.