> This is part 1 of 2 of the full documentation (pages 1–100 of 141).
> The content is paginated: fetch every part to see all of it.
> Next part: https://docs.openstad.org/openstad/llms-full.txt/1
> Page index: https://docs.openstad.org/openstad/llms.txt

# Introductie

An Introduction to the OpenStad Ecosystem

The OpenStad software allows for different e-democracy websites to be created & managed. It supports: single & multiple voting on ideas, submitting ideas, participatory budgeting, arguments, voting and arguments, different authentication methods, managing multiple sites and more.

![Westbegroot screenshot](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-7f213f52312969a877096d63c9e7a5dd7b994280%2Fwestbegroot-screenshot.png?alt=media)

Initially the software was developed in Amsterdam. It's currently actively used in many different cities, such as Amsterdam, Den Haag, Haarlem & Alphen aan den Rijn.&#x20;

The ecosystem contains a CMS & sitebuilder that allows for pages to be build from scratch, an API and an admin panel that allows for multiple sites be created, copied and managed.

Check out the [Technical Documentation](/openstad/technical) for the different servers we are managing and how to install the servers.

For web editors: find out the CMS basics under [Werken in het CMS - Algemeen](/openstad/manual/intro) (in Dutch), and read about creating and filling pages under [Pagina's opbouwen](https://github.com/Amsterdam/openstad-docs/blob/master/manual/creating-pages/intro.md) (in Dutch).

Or check out the available CMS modules and it's features in the [Modules overview](https://github.com/Amsterdam/openstad-docs/blob/master/modules/README.md)


# Projectmanagement


# Algemene kaders

Neem van tevoren voldoende tijd om het participatieproces te ontwerpen.\
Een goed participatieproces ontwerpen is cruciaal voor een goede werking van de online tool.

Het proces en de communicatie worden zodanig ingericht dat de uitkomst van de stemming achteraf niet ter discussie kan staan (bijvoorbeeld afspraken over minimale opkomst).

## Doel

Wat wil je bereiken? Het is belangrijk om het doel scherp te hebben, voordat je bepaalt welke tools daarbij kunnen ondersteunen.

* Tool keuze is afhankelijk van doel
  * voordelen/nadelen van online/offline.

## Burgers betrekken

Wat wil je van burgers weten? Waarom wil de gemeente samenwerken? Waarom zouden burgers hier aan mee willen werken? Wat zit er voor hen in? Maak duidelijk wat de invloed is die ze kunnen uitoefenen.&#x20;

* De tijd/energie die bewoners besteden aan meedoen aan de tool, is geoorloofd
* Worden bewoners voldoende ‘beloond’ voor de energie die ze er in steken
* Bewoners worden in de goede rol geplaatst (die van gebruiker van hun eigen context, niet van technisch/beleids/planningsexpert).

Wie wil je erbij betrekken? Wie is de doelgroep en hoe kun je er voor zorgen dat je toegankelijk bent voor de hele doelgroep?

* Inclusiviteit
  * Zorg voor voldoende momenten waar mensen die het lastig vinden om met de websites om te gaan, hulp kunnen krijgen. Bijv. op een stadsloket of in een buurthuis.
  * Combineer online en offline om een optimale proces te begeleiden.

## Proces

Waar in het proces valt de participatie activiteit? Iedere fase van het participatieproces vraagt om een ander soort samenwerking met bewoners, heeft een ander doel en gebruikt andere tools.

Zorg ervoor dat het proces helder is en helder wordt gecommuniceerd naar participanten.

Bijvoorbeeld, als het gaat om stemmen:

* Laat bewoners alleen kiezen/stemmen op plannen die haalbaar zijn, en waarvan de uitvoering al goedgekeurd is
  * De opties waar bewoners op kunnen stemmen zijn haalbaar en realiseerbaar (wat betreft kaders, beleid, regelgeving)
  * Opties verschillen van elkaar (er valt duidelijk iets te kiezen)
* Stemmen geeft de indruk dat het resultaat definitief is: wat gekozen is (door de meerderheid) wordt ook uitgevoerd. Zorg dat die ruimte er daadwerkelijk is.&#x20;

Als het gaat om ideeën insturen of meningen verzamelen:

* Maak duidelijk waar de ideeën/resultaten voor worden gebruikt. Hoe worden ze afgewogen? Wie beslist wat wel of niet doorgaat/verder wordt uitgewerkt/wordt opgepakt?
* Geef aan of er kaders zijn waar ideeën/meningen aan moeten voldoen. (Bijvoorbeeld, mag maximaal 10.000 euro kosten, etc).&#x20;

## Spelregels

Wees vanaf het begin helder over de spelregels.

* Wie mag er mee doen/beslissen? Wat is belangrijker: dat er zoveel mogelijk mensen meedoen of dat een bepaalde, specifieke groep meedoet?
* Wat is geaccepteerd gedrag en wat niet? (bijvoorbeeld: je mag één stem uitdelen per persoon, grof taalgebruik in reacties wordt niet geaccepteerd)
* Wat is de periode waarin om betrokkenheid wordt gevraagd?

## Transparantie

Transparantie van het proces gaat over de volgende onderdelen:

* Bepaal van te voren wat ga je doen met de uitkomsten en hoe krijgen bewoners dit krijgen teruggekoppeld
* Maak het proces van tevoren ook het proces duidelijk, zodat bewoners weten waar ze aan mee gaan doen
* Het proces en de communicatie worden zodanig ingericht dat het voor bewoners duidelijk is welke invloed de stemming heeft (stemmen bewoners voor een directe plaatsing of moet de uitkomst nog langs een bepaalde commissie).
* Mate van invloed
* Van tevoren op een rijtje hebben:
  * Welke besluiten zijn er al genomen?
  * Welke informatie is al gedeeld?
  * Waar ben je in het planproces?
  * Welke (bestuurlijke) besluiten liggen in het verschiet en wanneer?

## Bestuurlijke goedkeuring

Leg in voorbereiding eventuele proces ontwerpkeuzes voor aan je bestuurder. Die is eindverantwoordelijke voor het proces. Twijfel je over bepaalde keuzes, bespreek dan de voor- en nadelen met je bestuurder, of leg scenario's aan hun voor.&#x20;

## Communicatie

Communicatie is een belangrijk onderdeel van digitale participatie. De website zelf moet natuurlijk duidelijk worden ingericht. Plaats belangrijke informatie over de achtergrond van het project en vervolgstappen op de site. Maak duidelijk hoe mensen meer informatie kunnen vinden of opvragen.

Vergeet niet de communicatie rondom het project: je moet mensen vertellen dat de website bestaat. Gebruik brieven, posters, flyers, ambassadeurs, social media, en andere middelen om aandacht te genereren voor het proces.

## Authenticatie en verificatie

Kies een passende manier van authenticatie. Vind een passende balans tussen laagdrempelig en fraudegevoeligheid. Weeg hiermee af: waarde/impact van het besluit (iedereen mag stemmen vs. er is een specifieke doelgroep die mag meedoen). En of je helemaal zeker moet weten dat er geen fraude is gebeurd (met grote sommen geld bijv.)&#x20;

|                  | Drempel      | Fraude gevoeligheid |
| ---------------- | ------------ | ------------------- |
| Anoniem/iedereen | 🟢 Laag      | 🟠 Hoog             |
| Postcode         |              | 🟠 Hoog             |
| Email adres      |              | 🟡 Gemiddeld        |
| Sms verificatie  | 🟡 Gemiddeld | 🟢 Laag             |
| Unieke stemcodes | 🟠 Hoog      | 🟢 Laag             |


# Participatieprocessen

> **'Projectmanagement' vs. 'Inrichten digitale tools'**
>
> Er komen een hoop verschillende dingen kijken bij het ontwerpen, voorbereiden, lanceren en uitvoeren van participatieprocessen. Vaak doe je dit niet alleen maar met een team. De documentatie die de verschillende participatieprocessen beschrijft is daarom opgesplitst in twee delen;
>
> * Procesontwerp en projectmanagement: wat komt er allemaal kijken bij een participatieproces, waar moet je rekening mee houden en keuzes in maken? (dit onderdeel)
> * Opzetten digitale tools: hoe kunnen de digitale tools van de OpenStad software ingezet en geconfigureerd worden om het ontworpen participatieproces te ondersteunen? ([Digitale tools > Participatieprocessen](/openstad/manual/processes))

We beschrijven hier een aantal belangrijke onderwerpen waar goed over na moet worden gedacht voordat er wordt begonnen aan het ontwerpen en inrichten van bijbehorende tools.

### Processen

Overzicht van drie verschillende participatieprocessen die we ondersteunen. In dit hoofdstuk worden de belangrijkste stappen/onderdelen/beweegredenen voor de processen uiteengezet wat betreft het projectmanagement.

* [Voorkeurspeiling](/openstad/project-management/processes/poll) - Laat bewoners kiezen uit een beperkt aantal voorstellen, bijvoorbeeld tussen verschillende ontwerpen voor de herinrichting van een straat.
* [Wedstrijd](/openstad/project-management/processes/contest) - Laat bewoners bijvoorbeeld een ontwerp, idee, foto of naam indienen. Uit de inzendingen worden één of meerdere winnaars gekozen door bijvoorbeeld medebewoners te laten stemmen, of door een juryprijs uit te reiken.
* [Participatief begroten](/openstad/project-management/processes/participatory-budgeting) - Een proces dat uit meerdere fases bestaat, waarbij bewoners plannen kunnen indienen, en later in het proces zelf stemmen welke plannen uitgevoerd worden.

### Bedenk je eigen proces!

Bovenstaande voorbeelden zijn gebaseerd op use-cases waarvoor de tools ontwikkeld zijn. De tools kunnen echter ook worden ingezet op andere manieren. Zolang er bij het ontwerpen van het process en het inrichten van de tools goed wordt nagedacht over het doel van het proces en de effecten van gemaakte keuzes.


# Voorkeurspeiling

Voorbeelden van het 'voorkeurspeiling'-proces zijn te vinden onder de ['Voorbeelden' op OpenStad.org](https://openstad.org/voorbeelden). Specifieke voorbeelden zijn:

* [Bewoners bepalen herontwerp Gillis van Ledenberchstraat - Gemeente Amsterdam](https://openstad.org/voorbeelden/herontwerp-gillis-van-ledenberchstraat)


# Wedstrijd

Voorbeelden van het 'wedstrijd'-proces zijn te vinden onder de ['Voorbeelden' op OpenStad.org](https://openstad.org/voorbeelden). Specifieke voorbeelden zijn:

* [Wie heeft het groenste dak, balkon of dakterras van de buurt? - Gemeente Amsterdam](https://openstad.org/voorbeelden/groen-op-je-dak-amsterdam-west)


# Participatief begroten

Participatief begroten kan worden ingezet wanneer er een budget beschikbaar is gesteld om plannen uit te voeren voor een bepaalde doelgroep. In de eerste fase kan men plannen indienen ter invulling van het budget. Na een controle op haalbaarheid door de organisator, kan de doelgroep stemmen op de plannen die ze het beste vinden. De winnende plannen worden uitgevoerd.

Voorbeelden van het 'participatief begroten'-proces zijn te vinden onder de ['Voorbeelden' op OpenStad.org](https://openstad.org/voorbeelden). Specifieke voorbeelden zijn:

* [Bezoudenhout Begroot - Gemeente Den Haag](https://openstad.org/voorbeelden/bezuidenhout-begroot)
* [Buurtbudget Slotermeer Noord-oost - Gemeente Amsterdam](https://openstad.org/voorbeelden/buurtbudget-slotermeer-noord-oost)
* [Mariahoeve Knapt Op - Gemeente Den Haag](https://openstad.org/voorbeelden/mariahoeve-knapt-op)

## Overzicht spelregels

Het is belangrijk om de spelregels van het proces voorafgaand aan het proces duidelijk te hebben. De spelregels moeten helder gecommuniceerd worden aan de doelgroep.

* Waar moet een plan aan voldoen (deels technisch op te lossen)
* Hoeveel draagvlak is er nodig (aantal likes in ronde 1)?
* Wat houdt de haalbaarheidstoets in?
* Wie mogen er plannen indienen?
* Wie mogen er stemmen?
* Hoe komt de uitslag tot stand
* Wat gebeurt er met de uitslag
* omgangsregels in geval van reactiemogelijkheid

## Authenticatie

In deze beschrijving van het process wordt gebruik gemaakt van 3 verschillende authenticatie methoden.

* Naam en e-mail adres worden gevraagd aan plan indieners om contact met hen op te kunnen nemen.
* IP-adres wordt gecontroleerd van website bezoekers die een plan 'liken'.
* Unieke stemcodes worden verstrekt aan de doelgroep die mag stemmen op haalbare plannen in de derde fase.

## Verschillende fases van het proces

Dit proces bestaat uit 3 verschillende fases.

1. [Indienfase](#indienfase)
2. [Tussenfase](#tussenfase)
3. [Stemfase](#stemfase)

### Indienfase

Tijdens de indienfase is het voor bewoners mogelijk om plannen voor hun buurt in te dienen. Op deze plannen kan vervolgens gestemd worden ('liken') zodat de gemeente weet hoeveel draagvlak er voor een plan is, voordat er tijd en geld gestoken wordt in een haalbaarheidsonderzoek. Ook kunnen andere bewoners reacties plaatsen bij een plan.

Om de bewoners die op de laatste dag hun plan hebben ingediend nog de mogelijkheid te geven om voldoende likes te verzamelen, kan de mogelijkheid om plannen in te dienen (een week) eerder gesloten worden dan de mogelijkheid om likes te geven.

> [Lees hier hoe je de digitale tools voor deze fase kunt opzetten](/openstad/manual/processes/participatory-budgeting#indienfase)

### Tussenfase

Omdat het belangrijk is in de stemfase alleen plannen voor te leggen die bij winst ook uitgevoerd kunnen worden, wordt er tussen het indienen en het stemmen een haalbaarheidstoets uitgevoerd door de gemeente. In deze haalbaarheidstoets worden de plannen getoets op criteria zoals: het plan leidt niet tot meerjarige of structurele kosten, het plan is technisch en juridisch uitvoerbaar, de begroting van het plan is realistisch en het plan is financieel haalbaar. Vaak raken plannen meerdere afdelingen binnen de gemeente en moeten er ambtenaren samen komen om te discussiëren over de haalbaarheid van het plan, plan voor deze fase genoeg tijd.

Mogelijk wordt er binnen de haalbare plannen nog een selectie gemaakt, om het totaal aantal plannen uiteindelijk op de stemsite wat te beperken. In deze fase blijft de indienwebsite zichtbaar voor het publiek.

Er vanuit gaande dat er een behoorlijk bedrag beschikbaar is dat door bewoners verdeeld wordt, is het waarschijnlijk wenselijk dat bewoners kunnen stemmen met een unieke persoonlijke stemcode. Deze stemcodes moeten aangemaakt worden, en gecombineerd worden met gegevens uit de Basisregistratie Personen (BRP).

#### Voorbereiden stemfase

> [Lees hier hoe je de digitale tools voor deze fase kunt opzetten](/openstad/manual/processes/participatory-budgeting#tussenfase)

### Stemfase

Voor deze fase wordt aan de achterkant een nieuwe website gebruikt. Dit heeft als voordeel dat de originele ingediende plannen van bewoners bewaard blijven en als archief kunnen dienen, terwijl op de stemsite alleen de plannen geplaatst worden die door zijn naar de stemfase. Deze plannen kunnen hier ook een aangepaste (kortere) beschrijving krijgen volgens een format dat bij alle plannen overeenkomt, zodat ze goed te vergelijken zijn. Een ander voordeel is dat deze website opgezet, gevuld en getest kan worden, terwijl voor bezoekers de indienwebsite nog zichtbaar is.

> [Lees hier hoe je de digitale tools voor deze fase kunt opzetten](/openstad/manual/processes/participatory-budgeting#stemfase)


# Digitale tools

>


# OpenStad CMS basis

In dit eerste onderdeel worden de belangrijkste basisprincipes van het CMS uitgelegd dat gebruikt wordt voor het opbouwen van de OpenStad websites. Deze zaken zijn goed om te weten voordat in het volgende onderdeel uitgelegd wordt hoe de pagina’s opgebouwd worden.


# Inloggen

Laten we beginnen bij het begin; om in het CMS te kunnen werken moet je ingelogd zijn. Dit gaat via dezelfde route als de andere gebruikers die bijvoorbeeld iets willen indienen of een reactie achter willen laten op de website. De OpenStad websites maken gebruik van een inlogsysteem waarbij je kan kiezen om per mail een inlog-link te ontvangen, of met username en wachtwoord inloggen.&#x20;

Aan de achterkant moeten we jouw e-mailadres *editor*-rechten geven. Dit gaat per website, als je op OpenStad-website A kunt bewerken, betekent dat niet automatisch dat dat ook op OpenStad-website B het geval is.

Heeft de website geen knop om in te loggen? Plak dan */admin/login* achter de basis-URL.

**Username & wachtwoord instellen bij het eerste keer inloggen op een OpenStad site:**

* Neem de ‘admin login’-route, door ‘/admin’ achter de basis-url van de projectwebsite te plakken.
* Daar kun je nu kiezen, of je wilt inloggen met wachtwoord of met een inlog-link in de mail.
* Er is standaard een extra beveiligingslaag ingesteld in de vorm van een ‘two factor authentication’ (2FA) token. Dit is verplicht voor overheidswebsites. Als je met jouw emailadres nog niet eerder hebt ingelogd met een wachtwoord, dan moeten er 2 dingen gebeuren:
  * **Wachtwoord instellen:**\
    Mocht er nog geen wachtwoord ingesteld zijn voor je account, dan kun je dit doen via de ‘Wachtwoord vergeten’ link die je op het inlogscherm kunt vinden.
  * **Two factor authentication (2FA) instellen**\
    Als dit nog niet is ingesteld, dan kom je na de eerste inlogstap vanzelf terecht op de pagina ‘Configureer je two-factor app’. Er zijn verschillende manieren om dit te doen, de meest gebruikte is via een app op je telefoon.&#x20;
    * Er zijn meerdere apps die gebruikt kunnen worden, mogelijk staat er al eentje op je telefoon. De bekendste zijn;
      * Google Authenticator
      * Microsoft Authenticator
      * Authy
    * Gebruik zo’n soort app om de QR code te scannen op de ‘Configureer je two-factor app’-pagina. Let op; we merken dat het inladen van de QR-code soms heel snel gaat maar soms ook iets langer duurt. Het kost even eenmalig wat tijd om de Authenticator app aan je OpenStad account te koppelen, maar dit hoeft maar eenmalig te gebeuren en daarna kun je veel sneller inloggen op de OpenStad sites.


# De bouwstenen

Pagina’s zijn opgebouwd uit een verzameling van verschillende [*widgets*](/openstad/manual/modules), welke flexibel op elke pagina op een andere manier ingezet kunnen worden. Wat er allemaal binnen een widget valt kan sterk verschillen; het kan zo klein zijn als een enkele titel, maar ook zo groot als een hele stem-widget of een heel formulier. Elke widget heeft een eigen set van instellingen die de vertoning en/of de werking ervan bewerkbaar maken.

![Een aantal voorbeelden van widgets, samen op 1 pagina. ](https://lh3.googleusercontent.com/Wz_0gVpKhUS822HCvyYzzarJwLQ_foF4aCAyyeuIIo50IlSIwP-n5dYd6vQvAYvpqIz6wa5BlNIESWlYGXOoFSk4RiRj5u3NSrDTJisIcdbDNndAZSvQzqr_oyxANFRC5nv_DLZY)

Lees meer over hoe je een website bouwt op [pagina vullen.](/openstad/manual/how-tos/edit-page)


# Live in-page editing

Het CMS werkt met het zogenaamde *live in-page editing*. Dat betekent dat als we de pagina’s aan het bewerken zijn, deze er nagenoeg hetzelfde uitzien als dat de bezoekers van de website de pagina’s zullen gaan zien. Als je wijzigingen maakt in de (widgets op de) pagina kun je dus direct zien wat voor een effect dit heeft op het eindresultaat. Broodteksten op een pagina typ je zelfs direct op een pagina. De verschillende widgets zijn door te *draggen & droppen* gemakkelijk van positie te wijzigen.

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/live-inpage-editing.mp4>" %}


# Bewerkmodus (Draft)

Op het moment dat je inlogt met een account dat bewerk-rechten heeft zie je linksboven en linksonder op de pagina interface-elementen van het CMS verschijnen. Linksonder is de knop om de bewerkmodus aan of uit te schakelen.

Als je voor het eerst inlogt dan zal de knop op de *Live* modus staan, dan is het niet mogelijk om de pagina te bewerken. Door er op te klikken kan je switchen naar de *Draft* modus, dan is het wel mogelijk om (de widgets op) de pagina te bewerken.

In de *Draft* modus zijn de verschillende widgets te bewerken door er met je muisaanwijzer overheen te gaan, zodat de bewerkopties zichtbaar worden.

Known-issue: In sommige gevallen kan het lastig zijn om (de juiste) bewerkopties zichtbaar te krijgen. Bij grotere widgets is het soms even zoeken in welke hoek de bewerkopties getriggerd worden. Bij kleine widgets, en widgets die vlak bij elkaar geplaatst zijn, krijg je soms de opties van een naastgelegen widget te zien. Dit kan soms even zoeken zijn!

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/live-draft.mp4>" %}


# Versiebeheer

ApostropheCMS maakt gebruik van *version control*, of *versiebeheer* in het Nederlands. Tijdens het werken worden er verschillende versies van de pagina opgeslagen. Dit zou je kunnen zien als verschillende momentopnames van een pagina.

Als je een pagina bewerkt hebt, dan verschijnt er linksonder naast de *Live/Draft*-switch een nieuwe knop getiteld *Commit* (naast *Submit*, maar deze gebruiken we niet). Als je op *Commit* drukt dan maak je zo een momentopname van de pagina. **De wijzigingen die je hebt gemaakt op de pagina en die tot dan toe alleen nog voor jou zichtbaar waren in de&#x20;*****Draft modus,*****&#x20;worden doorgevoerd en publiekelijk zichtbaar voor iedereen als je op&#x20;*****Commit*****&#x20;drukt** (tenzij de pagina niet gepubliceerd is, daarover hieronder meer). Dit kun je zelf ook zien door te switchen van de *Draft* naar de *Live* modus.

Eén van de grote voordelen van het gebruik van versiebeheer is dat je gemakkelijk terug kunt keren naar een eerdere versie/momentopname van de pagina. Dit kan bijvoorbeeld handig zijn als je per ongeluk verkeerde wijzigingen hebt gemaakt of widgets hebt verwijderd waarvan je later toch spijt hebt. Hoe dit precies werkt wordt verderop in de documentatie uitgelegd.

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/version-control.mp4>" %}


# Participatieprocessen

> **'Projectmanagement' vs. 'Inrichten digitale tools'**
>
> Er komen een hoop verschillende dingen kijken bij het ontwerpen, voorbereiden, lanceren en uitvoeren van participatieprocessen. Vaak doe je dit niet alleen maar met een team. De documentatie die de verschillende participatieprocessen beschrijft is daarom opgesplitst in twee delen;
>
> * Procesontwerp en projectmanagement: wat komt er allemaal kijken bij een participatieproces, waar moet je rekening mee houden en keuzes in maken? ([Projectmanagement > Participatieprocessen](/openstad/project-management/processes))
> * Opzetten digitale tools: hoe kunnen de digitale tools van de OpenStad software ingezet en geconfigureerd worden om het ontworpen participatieproces te ondersteunen? (dit onderdeel)

## Processen

Overzicht van de verschillende participatieprocessen die we ondersteunen. Hier worden de belangrijkste stappen/onderdelen/beweegredenen voor de processen uiteengezet, en er wordt vanuit hier verwezen naar de verschillende [how-to's](https://github.com/Amsterdam/openstad-docs/blob/master/manual/manual/how-tos/README.md) waar deze processen op leunen.

* [Voorkeurspeiling](/openstad/manual/processes/poll) - Laat bewoners kiezen uit een beperkt aantal voorstellen, bijvoorbeeld tussen verschillende ontwerpen voor de herinrichting van een straat.
* [Wedstrijd](/openstad/manual/processes/contest) - Laat bewoners bijvoorbeeld een ontwerp, idee, foto of naam indienen. Uit de inzendingen wordt vervolgens één of meerdere winnaars gekozen. Het kiezen van de winnaars kan bijvoorbeeld gebeuren door medebewoners te laten stemmen, en/of door een juryprijs uit te reiken.
* [Participatief begroten](/openstad/manual/processes/participatory-budgeting) - Een proces dat uit meerdere fases bestaat, waarbij bewoners plannen kunnen indienen, en later in het proces zelf stemmen welke plannen uitgevoerd worden.

Er wordt hard gewerkt om bovenstaande lijst uit te breiden met nieuwe vormen van online bewonersparticipatie. De volgende processen zijn momenteel in ontwikkeling:

* Keuzewijzer - bewoners helpen een weloverwogen keuze te maken door verschillende consequenties af te wegen
* Gebiedsontwikkeling - met behulp van een interactieve kaart


# Voorkeurspeiling

De voorkeurspeiling kan ingezet worden om de voorkeur van bewoners op te halen tussen verschillende voorstellen. Dit kan in principe vanalles zijn, maar in de praktijk wordt dit vaak ingezet om te kiezen tussen verschillende ontwerpen voor de herinrichting van de openbare ruimte.

## Voorbereiding

Bij de voorbereiding van dit proces zijn de volgende how-to's relevant:

* [Inzendingen uploaden](/openstad/manual/how-tos/upload-ideas) - lees hoe je als [moderator, editor of admin](/openstad/manual/miscellaneous/roles) plannen in de database kunt zetten. Het is niet relevant om het voor bewoners mogelijk te maken om voorstellen/plannen in te kunnen dienen.
* [Inzendingen weergeven](/openstad/manual/how-tos/show-ideas) - in dit geval kiezen we voor de 'uitklapper'-weergave van de plannen, zodat de inhoud van de plannen zichtbaar wordt binnen het overzicht. Dit is nodig om de stemmodule te kunnen gebruiken.
* [Stemmen](/openstad/manual/how-tos/voting) - stel de stemmodule naar wens in.
* [Unieke stemcodes](/openstad/manual/how-tos/voting-codes) - genereer unieke stemcodes, en lees tips om deze op de juiste manier te verwerken. Dit is niet relevant als je er voor kiest om bewoners zich te laten authentificeren met een e-mail adres.

Let op:

* Zorg dat de verschillende voorstellen die je voorlegt goed met elkaar te vergelijken zijn.
* Benadruk de verschillen tussen de voorgelegde voorstellen in beeld en/of tekst.
* Let erop dat de verschillen groot genoeg zijn om werkelijk een keuze te zijn.

## Stemfase

Tijdens de stemfase zijn de volgende how-to's relevant:

* [Stemmen](/openstad/manual/how-tos/voting) - bekijk de voortgang van de uitgebrachte stemmen.

## Afronding

Bij de afronding van de stemfase zijn de volgende how-to's relevant:

* [Stemmen](/openstad/manual/how-tos/voting)  - lees hoe je de stemfunctionaliteit kunt sluiten.

Vergeet niet de content van de pagina's aan te passen om bezoekers van de site duidelijk te maken dat de stemfase gesloten is.


# Wedstrijd

Dit proces wordt hier nu 'wedstrijd' genoemd, maar dit moet breed opgevat worden. Bewoners kunnen bijvoorbeeld een ontwerp, idee, foto of naam indienen. Uit de inzendingen worden één of meerdere winnaars gekozen. Het kiezen van de winnaars kan bijvoorbeeld gebeuren door medebewoners te laten stemmen, en/of door een juryprijs uit te reiken.

De ontwerpwedstrijd bestaat uit twee of drie fases.

1. Indienen
2. Haalbaarheidstoets / juryprijs
3. Eventueel stemfase

## Indienfase

Tijdens de indienfase worden bewoners van een bepaald gebied uitgenodigd om ideeën die ze hebben voor hun buurt te uploaden. Bewoners dienen plannen in door middel van het invullen van een formulier op de website. De plannen kunnen ‘geliked’ worden en andere bewoners kunnen reacties plaatsen bij een plan.

### Voorbereiding indienfase

Maak in het [adminpanel](/openstad/manual/miscellaneous/adminpanel) een nieuwe lege website aan en volg onderstaande how-to's om deze te vullen, of begin te werken vanuit een website waar de basisfunctionaliteit al werkt: \[TODO toevoegen hoe en wat].

Voor het begin van deze fase zijn de volgende how-to's relevant:

* [Plannen indienen](https://docs.openstad.amsterdam/manual/how-tos/upload-ideas.html) - maak een formulier aan waarin bewoners hun inzending voor de website kwijt kunnen.
* [Plannen weergeven](https://docs.openstad.amsterdam/manual/how-tos/show-ideas.html) - kies voor detailweergave wanneer je argumenten/reacties wil faciliteren.

### Gedurende de indienfase

Tijdens de indienfase zijn de volgende how-to's relevant:

* [Moderatie](https://docs.openstad.amsterdam/manual/how-tos/moderation.html)
* [Plannen indienen](https://docs.openstad.amsterdam/manual/how-tos/upload-ideas.html) - Voeg zelf plannen toe van indieners waarbij het indienen niet lukt.

### Afronding van de indienfase

Het sluiten van de indienperiode gaat als volgt:

1. Pas de pagina's van de website aan, zodat het voor bezoekers duidelijk is dat er niets meer ingediend kunnen worden.
2. Schakel in het admin-panel \[TODO link en misschien meer uitleg toevoegen] uit dat er nog plannen ingediend kunnen worden, zodat dit ook aan de achterkant geblokkeerd wordt.

## Haalbaarheidstoets

In deze fase blijft de indienwebsite zichtbaar voor het publiek. Tijdens deze fase worden de ingediende plannen op haalbaarheid onderzocht. Mogelijk wordt er binnen de haalbare plannen nog een selectie gemaakt, om het totaal aantal plannen uiteindelijk op de stemsite wat te beperken. Wees transparant over op welke manier dit gebeurt in de spelregels.

*Authenticatie methoden - Bekijk hier de methoden voor authenticatie om een passende methode te vinde*

Voor deze fase zijn de volgende how-to's relevant:

* [Plannen exporteren en importeren](https://docs.openstad.amsterdam/processes/manual/how-tos/importing-plans.md) - lees hier hoe de plannen te exporteren zijn. Dit overzicht is handig bij de haalbaarheidstoetsen, en is een goede basis voor de spreadsheet die in de volgende fase nodig is om de verwerkte plannen weer te importeren.
* Authenticatie methoden -

## Stemfase

Voor deze fase wordt aan de achterkant een nieuwe website gebruikt. \[ TODO aanvullen ]

### Voorbereiding stemfase

Maak voor deze fase dus een nieuwe website aan in het admin-panel, of begin te werken vanuit een website waar de basisfunctionaliteit al werkt: \[TODO toevoegen hoe en wat].

Voor deze fase zijn de volgende how-to's relevant:

* [Plannen exporteren en importeren](https://docs.openstad.amsterdam/processes/manual/how-tos/importing-plans.md) - importeer de verwerkte plannen uit de indienfase.
* [Stemmen](https://docs.openstad.amsterdam/processes/manual/how-tos/voting.md) - stel de stemmodule naar wens in.

### Gedurende de stemfase

Tijdens de stemfase zijn de volgende how-to's relevant:

* [Stemmen](https://docs.openstad.amsterdam/processes/manual/how-tos/voting.md) - bekijk de voortgang van de uitgebrachte stemmen.

### Afronding stemfase

Bij de afronding van de stemfase zijn de volgende how-to's relevant:

* [Stemmen](https://docs.openstad.amsterdam/processes/manual/how-tos/voting.md) - lees hoe je de stemfunctionaliteit kunt sluiten.

Vergeet niet de content van de pagina's aan te passen om bezoekers van de site duidelijk te maken dat de stemfase gesloten is.

### Uitslag

Voor de uitslag zijn de volgende how-to's relevant:

* Nieuwsbrief - lees hoe je e-mail adressen verzameld van mensen die op de hoogte gehouden willen worden.
* Plannen overview sorteren - Lees hier hoe je een selectie van de plannen kunt weergeven in resource overview.
* Files - lees hier hoe je een pdf kunt uploaden waar je via een link heen kunt navigeren.

Pas de pagina’s aan om de uitslag bekend te maken.


# Participatief begroten

> [Lees hier op de projectmanagement pagina de introductie van dit participatieproces](/openstad/project-management/processes/participatory-budgeting#participatief-begroten---projectmanagement)

## Indienfase

> [Lees hier waar je in deze fase rekening mee moet houden wat betreft procesontwerp en projectmanagement](/openstad/project-management/processes/participatory-budgeting#indienfase)

Tijdens de indienfase worden bewoners van een bepaald gebied uitgenodigd om ideeën die ze hebben voor hun buurt te uploaden. Bewoners dienen plannen in door middel van het invullen van een formulier op de website. De plannen kunnen ‘geliked’ worden en andere bewoners kunnen reacties plaatsen bij een plan.

### Voorbereiding indienfase

Je moet eerst een nieuwe site aanmaken. Je kunt beginnen met een lege site en deze met behulp van onderstaande how-to's vullen, of start direct met de template-website *Plannen insturen*, waar de basisfunctionaliteit al werkt. Bekijk de how-to [Nieuwe site aanmaken](/openstad/manual/how-tos/new-site) voor verdere uitleg.

Voor het begin van deze fase zijn verder de volgende how-to's relevant:

* [Plannen indienen](/openstad/manual/how-tos/upload-ideas) - vraag bewoners in het formulier ten minste om een titel, samenvatting, beschrijving en afbeelding. Het vragen naar een locatie is vaak ook gewenst.
* [Plannen weergeven](/openstad/manual/how-tos/show-ideas) - kies voor de combinatie van overzicht- en detailweergave zodat er op de detailweergave-pagina argumenten geplaatst kunnen worden (zie volgende punt).
* [Reacties en argumenten](/openstad/manual/how-tos/arguments) - het is projectafhankelijk of er algemene reacties, of een scheiding tussen voor- en tegen-argumenten gewenst is.
* [Likes verzamelen](/openstad/manual/how-tos/like-ideas) - stel een stemdrempel in, en bekijk de herkomst van de likes om mogelijke fraude op te sporen. Lees hier ook hoe de mogelijkheid om plannen te liken uitgeschakeld kan worden.

### Gedurende de indienfase

Tijdens de indienfase zijn de volgende how-to's relevant:

* [Moderatie](/openstad/manual/how-tos/moderation)

### Afronding van de indienfase

Het sluiten van de indienfase bestaat uit twee stappen. Om de bewoners die op de laatste dag hun plan hebben ingediend nog de mogelijkheid te geven om voldoende likes te verzamelen, kan de mogelijkheid om plannen in te dienen (een week) eerder gesloten worden dan de mogelijkheid om likes te geven.

Het sluiten van de indienperiode gaat als volgt:

1. Pas de pagina's van de website aan, zodat het voor bezoekers duidelijk is dat er geen plannen meer ingediend kunnen worden, maar dat bezoekers de ingediende plannen nog wel kunnen liken.
2. Schakel de mogelijkheid om plannen in te kunnen dienen uit in het [adminpanel](/openstad/manual/miscellaneous/adminpanel), zodat dit ook aan de achterkant geblokkeerd wordt.

Het sluiten van de mogelijkheid om te liken gaat als volgt:

1. Pas de pagina's van de website aan, zodat het voor bezoekers duidelijk is dat ook de ingediende plannen niet meer geliked kunnen worden.
2. Wijzig de status van de ingediende plannen om het liken uit te schakelen. Hoe dit werkt is beschreven in de volgende how-to: [Likes verzamelen](/openstad/manual/how-tos/like-ideas)

## Tussenfase

> [Lees hier waar je in deze fase rekening mee moet houden wat betreft procesontwerp en projectmanagement](/openstad/project-management/processes/participatory-budgeting#tussenfase)

Voor deze fase zijn de volgende how-to's relevant:

* [Plannen exporteren en importeren](/openstad/manual/how-tos/importing-plans) - lees hier hoe de plannen te exporteren zijn. Dit overzicht is handig bij de haalbaarheidstoetsen, en is een goede basis voor de spreadsheet die in de volgende fase nodig is om de verwerkte plannen weer te importeren.
* [Unieke stemcodes](/openstad/manual/how-tos/voting-codes) - genereer unieke stemcodes, en lees tips om deze op de juiste manier te verwerken.

## Stemfase

> [Lees hier waar je in deze fase rekening mee moet houden wat betreft procesontwerp en projectmanagement](/openstad/project-management/processes/participatory-budgeting#stemfase)

Voor deze fase wordt aan de achterkant een nieuwe website gebruikt. Dit heeft als voordeel dat de originele ingediende plannen van bewoners bewaard blijven en als archief kunnen dienen, terwijl op de stemsite alleen de plannen geplaatst worden die door zijn naar de stemfase. Deze plannen kunnen hier ook een aangepaste (kortere) beschrijving krijgen volgens een format dat bij alle plannen overeenkomt, zodat ze goed te vergelijken zijn. Een ander voordeel is dat deze website opgezet, gevuld en getest kan worden, terwijl voor bezoekers de indienwebsite nog zichtbaar is.

### Voorbereiding stemfase

Maak voor deze fase dus een nieuwe website aan in het admin-panel. Je kunt beginnen met een lege site en deze met behulp van onderstaande how-to's vullen, of start direct met de template-website *Participatief begroten*, waar de basisfunctionaliteit al werkt. Bekijk de how-to [Nieuwe site aanmaken](/openstad/manual/how-tos/new-site) voor verdere uitleg.

Voor deze fase zijn de volgende how-to's relevant:

* [Plannen exporteren en importeren](/openstad/manual/how-tos/importing-plans) - importeer de verwerkte plannen uit de indienfase.
* [Stemmen](/openstad/manual/how-tos/voting) - stel de stemmodule naar wens in.

### Gedurende de stemfase

Tijdens de stemfase zijn de volgende how-to's relevant:

* [Stemmen](/openstad/manual/how-tos/voting) - bekijk de voortgang van de uitgebrachte stemmen.

### Afronding stemfase

Bij de afronding van de stemfase zijn de volgende how-to's relevant:

* [Stemmen](/openstad/manual/how-tos/voting) - lees hoe je de stemfunctionaliteit kunt sluiten.

Vergeet niet de content van de pagina's aan te passen om bezoekers van de site duidelijk te maken dat de stemfase gesloten is.

### Uitslag

Voor de uitslag zijn de volgende how-to's relevant:

* Nieuwsbrief - lees hoe je e-mail adressen verzameld van mensen die op de hoogte gehouden willen worden.
* Plannen overview sorteren - Lees hier hoe je een selectie van de plannen kunt weergeven in resource overview.
* Files - lees hier hoe je een pdf kunt uploaden waar je via een link heen kunt navigeren.

Pas de pagina’s aan om de uitslag bekend te maken.


# How-to's

* [Nieuwe site aanmaken](/openstad/manual/how-tos/new-site)
* [Nieuwe pagina's toevoegen](/openstad/manual/how-tos/new-page)
* [Pagina's vullen](/openstad/manual/how-tos/edit-page)
* [Inzendingen uploaden](/openstad/manual/how-tos/upload-ideas)
* [Inzendingen weergeven](/openstad/manual/how-tos/show-ideas)
* [Filteren en categoriseren van inzendingen](/openstad/manual/how-tos/filter-ideas)
* [Likes verzamelen](/openstad/manual/how-tos/like-ideas)
* [Reacties en argumenten](/openstad/manual/how-tos/arguments)
* [Moderatie](/openstad/manual/how-tos/moderation)
* [Unieke stemcodes](/openstad/manual/how-tos/voting-codes)
* [Stemmen](/openstad/manual/how-tos/voting)
* [Inzendingen exporteren en importeren](/openstad/manual/how-tos/importing-plans)
* [Vormgeving & logo aanpassen](/openstad/manual/how-tos/styling)


# Nieuwe site aanmaken

Er zijn drie verschillende manieren om een nieuwe site aan te maken:

* [Een standaard template kiezen](#template-website) - dit kan ook een lege website zijn
* [Een bestaande website kopieëren](#kopie-van-bestaande-site)
* [Een bestaande website via een extern bestand exporteren en importeren](#exporteren-en-importeren)

## Template website

Door een nieuwe website te maken op basis van een template, kun je van start gaan met een site die al gevuld en ingesteld is voor een bepaald proces. Het is via deze route ook mogelijk om een lege website aan te maken.

Er zijn seven template websites beschikbaar:

* **Lege site** - begin *from scratch* met het inrichten van een nieuwe site.
* **'Plannen insturen'-site** - kan gebruikt worden voor de *indienfase* van het [Participatief begroten](/openstad/project-management/processes/participatory-budgeting)-proces.
* **'Participatief begroten'-site** - kan gebruikt worden voor de *stemfase* van het [Participatief begroten](/openstad/project-management/processes/participatory-budgeting)-proces.
* **'Stem'-site** - kan gebruikt worden voor het [Voorkeurspeiling](/openstad/project-management/processes/poll)-proces.
* **'Kaart-bewoners'-site:** kan gebruikt worden om punten van bewoners te inventariseren op een kaart.
* **'Kaart-gemeente'-site:** kan gebruikt worden om reacties van bewoners te verzamelen per punt op een kaart.
* **'Keuzewijzer'-site:** kan gebruikt worden om meningen te verzamelen over afwegingen.&#x20;

Om één van deze templates te gebruiken moet je in het [adminpanel](/openstad/manual/miscellaneous/adminpanel) rechtsboven op *Maak nieuwe site aan* klikken. Je krijgt dan een formulier waar je de volgende velden moet invullen:

* **Naam van de website** - de titel die in het adminpanel gebruikt wordt om naar de website te refereren, deze hoeft niet overeen te komen met de titel die op de website zelf gebruikt wordt.
* **Domeinnaam** - de domeinnaam waarop de website bereikbaar moet worden. Deze kan later nog aangepast worden.
* **Type site** - kies welke template je als basis voor de website wil gebruiken, zie hierboven het overzicht van de beschikbare templates.
* **Gebruikers en rechten** - kies of je gebruikers en de bijbehorende rechten wilt kopiëren van een andere site.&#x20;
* **Einddatum** -  stel een datum in wanneer het proces is afgelopen en de website gesloten kan worden. Voor meer informatie zie admin panel [Adminpanel](/openstad/manual/miscellaneous/adminpanel#settings).&#x20;
* **E-mail instellingen** - er kunnen verschillende e-mails verzonden worden vanuit de website. Je kunt hier de naam en het e-mail adres opgeven dat als afzender van deze mails getoond moet worden.

Klik vervolgens onderaan het formulier op *Site aanmaken*. Je komt daarna direct op het [dashboard](/openstad/manual/miscellaneous/adminpanel#dashboard) van de nieuwe website terecht.

## Kopie van bestaande site

Met deze functie kan er een kopie gemaakt worden van een site die al in het huidige [adminpanel](/openstad/manual/miscellaneous/adminpanel) bestaat.

Om een site te kopiëren druk je in het [adminpanel](/openstad/manual/miscellaneous/adminpanel) rechtsboven op *Kopieer site*. Je krijgt dan een formulier waar je de volgende velden moet invullen:

* **Naam van de website** - de titel die in het adminpanel gebruikt wordt om naar de website te refereren, deze hoeft niet overeen te komen met de titel die op de website zelf gebruikt wordt.
* **Domeinnaam** - de domeinnaam waarop de website bereikbaar moet worden. Deze kan later nog aangepast worden.
* **Kies site om te kopiëren** - kies welke website je wil kopiëren.
  * **Gebruikers en rechten** - en of je de gebruikers en rechten van deze site wilt meekopieeren.&#x20;
* **E-mail instellingen** - er kunnen verschillende e-mails verzonden worden vanuit de website. Je kunt hier de naam en het e-mail adres opgeven dat als afzender van deze mails getoond moet worden.

Klik vervolgens onderaan het formulier op *Site aanmaken*. Je komt daarna direct op het [dashboard](/openstad/manual/miscellaneous/adminpanel#dashboard) van de nieuwe website terecht.

## Exporteren en importeren

Via deze functie kunnen er websites uitgewisseld worden tussen verschillende omgevingen. Dit kunnen verschillende installaties van de OpenStad-software zijn bij bijvoorbeeld andere gemeenten, maar het kunnen ook verschillende test- en productie-omgevingen zijn op dezelfde server.

### Exporteren van een website

Zoeken binnen het [adminpanel](/openstad/manual/miscellaneous/adminpanel) de website op die je wenst te exporteren, en klik vervolgens op *beheer* (dus niet *beheer (beta)*) om het [dashboard](/openstad/manual/miscellaneous/adminpanel#dashboard) van de website te openen. In het menu aan de linkerkant zie je de optie *Export*.

Op het moment van schrijven kun je kiezen om de volgende elementen mee te exporteren:

* **CMS attachments** - Dit zijn bestanden die aan de website gekoppeld zijn, hier vallen ook afbeeldingen onder. **Let op**: Door deze optie aan te vinken kan het bestand dat geëxporteerd wordt erg groot worden.
* **Choices Guides** - Dit zijn de instellingen van de Keuzewijzer.

Klik vervolgens op *Export* om de website op te slaan in het \*.tgz bestandsformaat.

### Importeren van een website

Zodra je een \*.tgz-bestand van een OpenStad-website hebt, kun je deze in een andere omgeving importeren. Ga hiervoor naar het [adminpanel](/openstad/manual/miscellaneous/adminpanel) en kies rechtsboven voor *Importeer site*. Je krijgt dan een formulier waar je de volgende velden moet invullen:

* **Naam van de website** - de titel die in het adminpanel gebruikt wordt om naar de website te refereren, deze hoeft niet overeen te komen met de titel die op de website zelf gebruikt wordt.
* **Selecteer bestand** - Kies hier het \*.tgz-bestand van de OpenStad-website.
* **Domeinnaam** - de domeinnaam waarop de website bereikbaar moet worden. Deze kan later nog aangepast worden.

Klik vervolgens onderaan het formulier op *Import*. Je komt daarna direct op het [dashboard](/openstad/manual/miscellaneous/adminpanel#dashboard) van de nieuwe website terecht.


# Nieuwe pagina's toevoegen

Een nieuwe pagina aanmaken kan op verschillende manieren. De eerste manier is via *Page menu* links onder in het scherm. Je kunt een nieuwe lege pagina aanmaken door te klikken op *New Page*.

![Nieuwe pagina aanmaken via Page Menu](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-71785738b28932d9e3ec9de12a1132fc5ec32064%2FNieuwe_pagina_page_menu_new_page.jpg?alt=media)

Je krijgt dan een instellingenscherm te zien voor de nieuwe pagina. Automatisch opent deze op het *Basics* tabblad. Hier kun je de pagina een titel geven (*Title*), dit is de naam van de pagina die bijvoorbeeld in de menubalk te zien is en in verschillende instellingen pagina’s. Wanneer je het eens bent met de voorgestelde slug en standaardinstellingen (de website wordt gepubliceerd en de naam verschijnt in de menubalk), klik je op *Save Draft*. Je hebt een pagina aan gemaakt!

Je kunt later terug naar deze instellingen door wanneer je (In *Draft* modus) op de pagina bent op Page menu → Page Settings te klikken of via OpenStad → Pages *en dan achter de naam van de pagina* op *Settings* te klikken.

## Slug

In het *Basics* tabblad onder *Page Settings* kies je onder het kopje *Slug* de URL van de nieuwe pagina. Oftewel wat er achter de *basis URL* (projectnaam.nl) komt te staan om bij de nieuwe pagina te komen: projectnaam.nl/slug. Het is belangrijk dat er geen spaties staan in de slug, dus gebruik bij meerdere woorden tussen-streepjes. De *slug* begint altijd met een *forward slash*; /.

Als je een nieuwe pagina aanmaakt vanaf een pagina die niet \_Home \_is, krijg je last van *nesting*. Er komen twee *slashes* in je URL te staan (projectnaam.nl/pagina/nieuwepagina), dit kan een verwarrende URL opleveren, dus maak hier liever één van (projectnaam.nl/nieuwepagina).

## (Nog niet) publiceren

Je kunt in het *Basics tablad* van je instellingenscherm aangeven of de pagina gepubliceerd moet worden onder *Published*→ *Yes/No*.

Het is mogelijk om pagina’s op te zetten, en ook tussendoor te *comitten*, zonder dat deze zichtbaar zijn voor bezoekers van de website. Je kiest dan *Published* → *No.* Een niet gepubliceerde pagina herken je aan een rode knop getiteld *Unpublished* links onderin het venster wanneer je op de pagina bent. Door hierop te klikken en vervolgens te kiezen voor *Publish Page* kun je de pagina zichtbaar maken voor iedereen.

Het omgekeerde proces kost iets meer handelingen; ga hiervoor eerst linksonder naar *Page Menu*, ga naar *Page Settings* en kies op het *Basics* tabblad (die standaard als eerste opent) onder het kopje *Published* voor *No*. Klik dan rechtsboven op *Save Draft*. Vergeet niet de pagina te *comitten* om de wijzigingen daadwerkelijk door te voeren.

Een uitzondering is de *Home*-pagina, die kan niet *unpublished* worden.

Publiceren: (In *Draft* modus) *Unpublished* → *Publish Page* ( → *Commit*)

Publiceren ongedaan maken: (In *Draft* modus) *Page Menu* → *Page Settings* → *Published: No* → *Save Draft* ( → *Commit*)

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/(un)publish.mp4>" %}

## Hide in navigation

Ook kun je in het *basics* tabblad aangeven of de pagina verstopt moet worden in de menubalk; Hide in Navigation → *Yes/No*. Wanneer je een pagina wil aanmaken die alleen te bezoeken is via een knop/link op een andere pagina vul je hier *Yes* in. Dit geldt bijvoorbeeld voor formulier pagina’s maar ook voor de pagina’s over cookies en de privacy verklaring. Wanneer je hier *No* invult verschijnt de pagina naast *Home* en je andere pagina’s in de menubalk.

Klik op *Save Draft* rechts bovenin om je nieuwe pagina aan te maken. Je kunt later terug naar deze instellingen door wanneer je op de pagina bent op Page menu → Page Settings te klikken of via OpenStad → Pages *en dan achter de naam van de pagina* op Settings te klikken.

![Nieuwe pagina formulier](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-4256a085938f094e6a5bdcaa27eac458554d408c%2FNieuwe_pagina_New_page_form.jpg?alt=media)

## Copy page

Je kunt ook een nieuwe pagina aanmaken door een bestaande pagina binnen je website te kopiëren. Dit kan bijvoorbeeld handig zijn wanneer de pagina die je wil aanmaken dezelfde lay-out of widgets moet hebben. Je kopieert een pagina door op de pagina waarop je je op dat moment bevindt te gaan naar *Page Menu*, links onderin het scherm en daar te kiezen voor *Copy Page*. Je kopieert naast de inhoud van de pagina ook de instellingen.

![Copy page formulier](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-d31745dc64a4304371c24f1d342a099cd8f9bd3e%2FNieuwe_pagina_Copy_page_form.jpg?alt=media)


# Pagina's vullen

Pagina’s worden opgebouwd door ze te vullen met de verschillende beschikbare [*widgets*](/openstad/manual/modules). Maar eerst moet de layout van een pagina bepaald worden met *sections* en *columns*, zodat de widgets een bepaalde positie op de pagina krijgen.

## Sections en columns

Als je op een lege pagina begint moet je altijd eerst een *section* toevoegen. Een section beslaat altijd de volledige breedte van een pagina. Binnen een section kun je het aantal en de verdeling van de *kolommen* aangeven. Binnen deze kolommen plaats je vervolgens de verschillende *widgets*. Een pagina heeft minimaal één section, maar er kunnen ook meerdere onder elkaar geplaatst worden.

### Section toevoegen

Als de pagina nog helemaal leeg is, dan verschijnt er vanzelf een ‘+’-icoontje in het midden van de pagina. Als er al een of meerdere andere sections op de pagina aanwezig zijn, dan kun je er nieuwe aan toevoegen door je muisaanwijzer boven, tussen, of onder de sections te bewegen, daar waar je een nieuwe wil toevoegen. Er verschijnt dan ook een ‘+’-icoontje.

Klik op het ‘+’-icoontje en kies voor *Add a section*. Er verschijnt nu een pop-up scherm getiteld *Column Section*. Er zijn hier verschillende dingen in te stellen, maar de belangrijkste is het onderdeel *Columns*. Hieronder kies je het aantal en de procentuele verdeling van de breedte van de kolommen die in de section geplaatst worden. Daarnaast kun je hier ook eventueel een achtergrondkleur of een achtergrondafbeelding kiezen.

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/add-section.mp4>" %}

## Widgets

De *widgets* bevatten dus uiteindelijk de inhoud van een pagina, en zijn altijd in een *column* geplaatst. Voorbeelden van veelgebruikte widgets zijn *Title* (titel), *Rich Text* (broodtekst), *Image* (afbeelding), *Link or button* (verschillende vormen van linkjes en knoppen) en *List* (lijst/opsomming). Maar daarnaast zijn er nog veel meer, vaak meer specifieke widgets. Kijk voor de complete lijst met widgets onder [Widgets referentie](/openstad/manual/modules).

Als je een account met beperkte rechten hebt (editor) zullen niet alle widgets beschikbaar zijn om toe te voegen.

### Widget toevoegen

Als een kolom nog leeg is verschijnt er vanzelf een ‘+’-icoontje, als er wel al één of meerdere widgets in een kolom geplaatst zijn dan moet je de muisaanwijzer bewegen over de positie waar je een nieuwe widget wil toevoegen om het ‘+’-icoontje zichtbaar te maken.

Als je op het ‘+’-icoontje klikt, verschijnt er een menuutje met alle beschikbare widgets. Als je een widget kiest, zal er eerst een pop-up verschijnen waar je de instellingen van de gekozen widget kunt bepalen. Vervolgens klik je rechtsboven op *Save \[...]* om de widget met de gekozen instellingen toe te voegen. Een uitzondering hierop is de *Rich Text*-widget (broodtekst), deze wordt direct aan de pagina toegevoegd en bewerk je op de pagina zelf in plaats van in een pop-up (*in-context editing*).

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/add-widget.mp4>" %}

## Aanpassen en verwijderen

Widgets op de pagina zijn aan te passen via het mouseover-menu. Beweeg de muisaanwijzer over een widget om dit menu te laten verschijnen. De verschillende opties van het mouseover-menu zijn, van links naar rechts:

* Slepen (Drag)
* Omhoog schuiven (Move Up)
* Omlaag schuiven (Move Down)
* Dupliceren (Clone Widget)
* Instellingen aanpassen (Edit \[...])
* Verwijderen (Trash)

De eerste drie opties kunnen gebruikt worden om de positie van de widget te veranderen. Door op de tweede en derde knop te klikken verplaats je de widget respectievelijk naar boven en naar beneden, maar dit werkt alleen binnen een kolom, je kunt op deze manier niet een widget van de ene naar de andere kolom verplaatsen.

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/move-widget-buttons.mp4>" %}

Als je de eerste knop met de muis ingedrukt houdt, dan kun je de widget door te slepen op een andere locatie plaatsen. Terwijl je aan het slepen bent dan zie je op de pagina omlijnde gebieden verschijnen, welke aangeven dat je de widget op die plek los kunt laten. Op deze manier kun je widgets ook van de ene kolom naar de andere kolom verplaatsen.

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/move-widget-dragdrop.mp4>" %}

Door de widget te dupliceren wordt een kopie van de widget, met dezelfde instellingen, er direct onder geplaatst. Door op *Edit \[...]* te klikken opent de pop-up met instellingen. Met de laatste optie verwijder je de widget.

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/duplicate-edit.mp4>" %}

Als je een account met beperkte rechten hebt (editor) zullen niet alle widgets bewerkbaar zijn.

## Herstellen

Er zijn twee manieren om gemaakte wijzigingen terug te draaien. Je kunt terug naar de laatste gecomitte versie van een pagina (die dus onder *Live* zichtbaar is), en je kunt elke losse gemaakte wijziging op een pagina ongedaan maken. Dit gaat op twee verschillende manieren, die worden hieronder verder uitgelegd.

### Terug naar Live

Om terug te keren naar de laatste gecomitte versie van een pagina, open je eerst het hoofdmenu door linksboven op *OPENSTAD* te klikken (je moet hiervoor in *Draft* modus zijn). Kies vervolgens *Workflow* → *Manage*. In het *Manage Workflow* overzicht zie je een lijst met onder andere de verschillende pagina’s van de website. Zoek de pagina welke je naar de Live versie wil herstellen, en klik in de rechterkolom onder *Actions* op de knop *Revert*.

(In *Draft* modus) *Hoofdmenu* → *Workflow* → *Manage* → *Revert*

{% embed url="<https://cdn.jsdelivr.net/gh/Amsterdam/openstad-docs/video/revert-to-live.mp4>" %}

### Losse wijzigingen ongedaan maken

Dit kunnen dus ook wijzigingen zijn waarvan je niet tussendoor een momentopname (*commit*) gemaakt hebt. Op de pagina waar je de wijzigingen wilt terugdraaien, klik je linksonder op *Page Menu* (je moet hiervoor in *Draft* modus zijn). Kies vervolgens *Page Versions* om een lijst te zien met alle wijzigingen die er aan de pagina gemaakt zijn. Klik op *Revert to* om gemaakte wijzigingen terug te draaien.

(In *Draft* modus) *Page Menu* → *Page Versions* → *Revert to*


# Inzendingen uploaden

Er zijn twee gebruiksgroepen die inzendingen willen uploaden. De eerste is bewoners, wanneer ze een plan willen indienen voor een begroot traject of een ontwerp voor een wedstrijd. De tweede groep is het projectteam van de gemeente zelf. Bewoners kunnen dan stemmen/hun voorkeur uitspreken/reageren op de inzendingen van de gemeente. Ook wanneer er een keuze aan bewoners wordt voorgelegd waarop gestemd kan worden, noemen we deze keuzeopties ook inzendingen. In het systeem worden ze namelijk op dezelfde manier gemaakt; met een *resource form.*

Een [resource form](/openstad/manual/modules/resource-form) is de widgets waarmee je inzendingen uploaden mogelijk maakt. Het is een formulier waarmee je een inzending kunt uploaden. Bewoners of de gemeente kunnen gebruik van het formulier maken. Lees in het widget hoofdstuk van *resource form* hoe je het formulier aan kunt passen.

Na het maken van een resource form (de formulier wat bewoners/de gemeente gaat gebruiken), moet je de [inzendingen ook weergeven](/openstad/manual/how-tos/show-ideas) zodat ze zichtbaar zijn voor gebruikers op de website. Dit wordt uitgelegd in het volgende how-to.

## Bewoners gaan inzendingen uploaden:

* Een veel gebruikte formulier is het [plan-indien](/openstad/project-management/processes/participatory-budgeting#indienfase) formulier bij participatief begroten. Je kan hiervoor de [template ](/openstad/manual/how-tos/new-site#template-website)gebruiken.&#x20;
* Ook kun je een eigen formulier maken met de widget [resource form.](/openstad/manual/modules/resource-form)

### Admin panel instellingen

![Admin panel voor Ideas](https://lh4.googleusercontent.com/HcBH2BJoB2CsFtxOn4AsILWkwKJQEHNuzuzZRgJ50odZ92438sBPwNzsH1HPxb7gU_PMKdmlcJxLIDmGRF2m7eLpZ_AXFd9w8ZiOPaAYSS5b4ih7-x-mls1W5uTyaWP-upnX04ok)

| Instelling                                                                                  | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Possible to send in ideas?                                                                  | <p>Aan: gebruikers kunnen inzendingen uploaden via het formulier. <br>Uit: gebruikers krijgen een foutmelding als ze inzendingen proberen te uploaden, omdat het formulier geen nieuwe inzendingen accepteert. (Als dit uit staat wil je, om verwarring te voorkomen, ook het formulier pagina <a href="/openstad/manual/how-tos/new-page#nog-niet-publiceren">unpublishen </a>en verwijzingen naar het formulier verbergen of verwijderen).</p> |
| Minimum votes needed for idea?                                                              | Vul hierin het minimaal aantal likes dat een inzending moet hebben om door te gaan naar de volgende fase.                                                                                                                                                                                                                                                                                                                                        |
| Min/max length of title, summary en description                                             | Vul hierin het minimum/maximum aantal karakters dat een inzending moet hebben bij het invullen van het formulier.                                                                                                                                                                                                                                                                                                                                |
| Automatically update status from OPEN to CLOSED when an idea is a given number of days old. | **Aan**: Vul het aantal dagen in wat je wil gebruiken. Hiermee kun je gebruik maken van bepaalde termijnen waarmee een status veranderd. Bijvoorbeeld: als je 90 dagen hebt om het minimum aantal likes te halen. **Uit**: je zal handmatig de [statussen ](broken://pages/lNZsGGhddgFl6PTvYHOr)van inzendingen moeten aanpassen.                                                                                                                |

### Thank you email

Een uploader van een inzending ontvangt automatisch een *thankyou* email, dat de inzending is ingestuurd, op de email van zijn geregistreerde account (waarmee de inzending was geüpload).&#x20;

Het email kun je instellen in de [admin panel](/openstad/manual/miscellaneous/adminpanel). Ga naar Settings > Ideas en scroll naar beneden voor het kopje *Thank you email.*

![Thank you email weergave in het admin panel](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FMCcVhYsQs9lPgiRmLnVA%2Fimage.png?alt=media\&token=d8c94f26-28f6-47f0-bac9-bf8a24850889)

De email wordt geschreven in html. Hier staat een korte uitleg over als je klikt op *'More info on the E-mail Template'.*

Indien je gebruik maakt van het template ['Plannen insturen'](/openstad/manual/how-tos/new-site#template-website), staat er een email ingesteld met algemene informatie. Dit kun je aanpassen naar jouw projectgegevens.&#x20;

## Moderators gaan inzendingen uploaden

&#x20;<mark style="color:orange;">**work in progress (**</mark><mark style="color:orange;">beperkte functionaliteit)</mark>

* <mark style="color:orange;">Admin panel</mark>
* <mark style="color:orange;">Formulier (verwijzen naar bewoner-beschrijving, formulier mogelijk unpublished laten)</mark>


# Inzendingen weergeven

Er zijn grofweg twee verschillende manieren om inzendingen weer te geven:

* Met enkel een overzichtspagina. Hierop staan alle inzendingen, bestaande uit een tegel voor elke inzending. Als je op een tegel klikt, wordt er middels een uitklapper binnen de overzichtspagina een beperkte hoeveelheid informatie getoond.
* Met een combinatie van een overzichtspagina en een detailpagina. Op de detailpagina is ruimte voor uitgebreide gedetailleerde informatie van een enkele inzending. Er kan op een detailpagina ook een reactiemodule geplaatst worden, om website bezoekers te laten reageren op elke individuele inzending.

## Inzendingen overzichtspagina

Voor het weergeven van een overzicht van inzendingen wordt de ‘[Resource overview](/openstad/manual/modules/resource-overview)’-widget gebruikt. Deze kan op verschillende manieren ingezet worden:

* Als overzichtspagina van de inzendingen, waarbij de details van een inzending op een eigen detailpagina getoond worden.
* Als overzichtspagina van de inzendingen, waarbij de details van een inzending in een ‘uitklapper’ zichtbaar worden binnen dezelfde overzichtspagina.
* Als overzichtspagina van de inzendingen inclusief een stemmodule, waarbij op één van de inzendingen gestemd kan worden.

Zorg om te beginnen dat je een [pagina ](/openstad/manual/how-tos/new-page)hebt op welke het inzendingen overzicht getoond gaat worden. Voeg op deze pagina de [‘Resource overview’-widget](/openstad/manual/modules/resource-overview) toe. De belangrijkste instellingen worden hieronder beschreven, afhankelijk van welke manier gewenst is.&#x20;

{% hint style="info" %}
Let op: dit gaat alleen over het tonen van inzendingen. Als het gewenst is dat het een overzicht gecombineerd met stemfunctionaliteit is, kijk dan bij de [‘Stemmen’-how-to](/openstad/manual/how-tos/voting).
{% endhint %}

### Overzichtspagina met uitklapper, zonder losse detailpagina

Ook hier wordt er op de overzichtspagina voor elke inzending een tegel getoond. Het verschil met de andere manier, ‘Overzichtspagina met losse detailpagina’, is echter dat er niet wordt doorgelinkt naar een losse detailpagina als je op de tegel klikt. In plaats daarvan opent er onder de tegel, in de overzichtspagina zelf, een uitklapper met meer details van de inzending.

Om het overzicht op deze manier weer te geven zijn er twee instellingen van de ‘Resource overview’-widget belangrijk:

* Enable voting: Kies voor ‘No’.
* Display Type: Kies voor ‘Card in a grid - opens item into on the same page'

![Weergave van cards in a grid - opens same page](https://lh3.googleusercontent.com/XytYgxw-3K7AqJXAFf1ZO7ci4JX0TfUOgdYJre6StqDXl-qw70G264CiIE8T2wln4jPAnRwwD--jAdveRFTdpDjzb1VYbRw8j5Nz7bHhTlWsaSR5OfRt_A8g8qALNGQPnt9bKXvT)

### Overzichtspagina met losse detailpagina

In dit geval wordt er op de overzichtspagina voor elke inzending een tegel getoond, en kun je hier op klikken om doorgelinkt te worden naar een losse detailpagina waar de gehele inzending weergegeven wordt.

Om het overzicht op deze manier weer te geven zijn er drie instellingen van de ‘Resource overview’-widget belangrijk:

* Enable voting: Kies voor ‘No’.
* Display Type: Kies voor ‘Card in a row - linking to item on another page’.
* Url structure for the resource: hier vul je de ‘[slug](/openstad/manual/miscellaneous/terminology)’ van de detailpagina in, waar de tegel naartoe moet linken. Zorg dat dit overeenkomt met de URL van de detailpagina die je gaat gebruiken. Lees hierover meer onder het kopje ‘Inzending detailpagina’.

![Weergave van cards in a row linking to another page](https://lh3.googleusercontent.com/aW16RkDtD0VagNaIwhA_ONTfxTYdaU5vFpEIq81U0WV3SHH_6VJJp6uAwJoJ8pYM6UxlyMT-67rw6xzyzWNwdL5RVo6Kq80sHx2cFuoMuz8-pT3HU20hd6Iq4_EKuAc4V1cnfeAs)

### Inzending detailpagina

Dit is van toepassing als je hierboven, bij het kiezen van de opzet van de overzichtspagina, hebt gekozen om een losse detailpagina te gebruiken voor de uitgebreide details van een inzending (eerste optie). Zorg er voor dat je een [pagina ](/openstad/manual/how-tos/new-page)hebt waarop de detailpagina weergegeven wordt. In het instellingenscherm van een pagina zie je de ‘slug’, deze moet ingevuld worden in de [Resource overview](/openstad/manual/modules/resource-overview)-widget onder ‘Url structure for the resource’, zoals hierboven ook beschreven.

Je kunt de detailpagina op twee manieren opbouwen:

* In één vooraf bepaalde layout.
* Opgebouwd uit losse elementen, waarbij je zelf de layout van de pagina vorm kunt geven.

Bij beide manieren gebruik je de [Resource representation](/openstad/manual/modules/resource-representation)-widget.

Het is mogelijk om op de detailpagina ook een reactiemogelijkheid toe te voegen. Hoe dit moet wordt beschreven in de how-to ‘[Reacties en argumenten’](/openstad/manual/how-tos/arguments).

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FosR02E6LZu24kx7zgcKx%2Fafbeelding.png?alt=media&amp;token=ac11c479-729f-4b74-8441-f15038aca7a4" alt=""><figcaption><p>Voorbeeld detailpagina </p></figcaption></figure>

### Ontwerp je eigen manier om plannen weer te geven

Deze module biedt de mogelijkheid om eigen templates te maken voor de overzichtspagina. Lees meer over deze functionaliteit onder [Raw](/openstad/manual/miscellaneous/raw) en bekijk de lijst met beschikbare variabelen in de [Resource raw widget](/openstad/manual/modules/resource-raw-widget) documentatie.


# Filteren en categoriseren van inzendingen

Inzendingen kunnen op verschillende manieren gecategoriseerd worden: thema's, tags, en statussen. Maar let op: Je kan niet beide thema's en tags gebruiken, alleen een of het ander. Statussen kun je combineren met beiden.&#x20;

### Thema's en buurten

Thema's worden vaak gebruikt om inzendingen in te delen in categorieën. Het is een vaste indeling waaruit inzendingen kunnen kiezen. Bijvoorbeeld in een participatief begroten proces, omdat er budget specifiek beschikbaar is per thema. Of omdat je specifiek benieuwd bent naar inzendingen per thema (bijvoorbeeld groen, verkeer, afval, etc).&#x20;

Hetzelfde geldt voor buurten. Bijvoorbeeld in een participatief begroten proces die voor een heel stadsdeel loopt, worden gebruikers gevraagd om in te vullen voor welke buurt hun idee is. Of moet het idee binnen bepaalde buurten worden ingezonden.&#x20;

Per inzending kan maximaal 1 thema en 1 buurt gekozen worden. Je kan dus niet meerdere thema's of buurten gebruiken per inzending.&#x20;

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FnzMmnvswKAm4kPYNrWoA%2Fafbeelding.png?alt=media&amp;token=61b810cf-ff67-40b0-9306-999cd9d1fc20" alt=""><figcaption><p>Voorbeeld van plannen met thema's. In deze screenshot is gefilterd op plannen met het thema 'Armoede en schulden'.</p></figcaption></figure>

Meer informatie over de instellingen van thema's en buurten vind je via Global > [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global#themes-areas-and-idea-types).

Op moment dat je thema's hebt ingesteld op een website, kun je in bepaalde widgets met thema's ook filteren. Bijvoorbeeld met [Resource overview](/openstad/manual/modules/resource-overview) kun je een filter aanzetten voor thema's.

Vervolgens kun je in [Resource form](/openstad/manual/modules/resource-form) zorgen dat de thema's en buurten op een gewenste manier zijn ingesteld.

###

### Tags

Met tags kun je ook inzendingen categoriseren. Tags zijn labels die je aan inzendingen kan hangen om zoeken en categorisering vervolgens makkelijker te maken.&#x20;

Per inzending kun je met tags wel meerdere tags kiezen. Dit is dus handig voor als inzendingen aan meerdere thema's of categorieën kunnen voldoen.&#x20;

Meer informatie over de instellingen van tags vind je via beta admin/react admin >[Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#tags).

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FA01EPOdFQQ9Vrad2jzC4%2Fafbeelding.png?alt=media&amp;token=59143157-8622-43fd-97b2-651ca183c1eb" alt=""><figcaption><p>Voorbeeld van plannen ingestuurd met tags. In deze screenshot is gefilterd op tags 'Gelijke kansen &#x26; onderwijs' én 'Kunst &#x26; creativiteit'.</p></figcaption></figure>

Om tags toe te voegen gebruik je de [Resource form](/openstad/manual/modules/resource-form) widget:

* Edit widget > Algemeen > How do you want to organise the form? > Static with dynamic fields appended
* 'Edit form sections' komt vervolgens tevoorschijn. Klik hierop
* Vul velden voor *title* en *info* in op basis van de reden waarom je tags gebruikt. Bijvoorbeeld "Thema" en "Kies hier de thema's waar jouw plan aan voldoet"
* &#x20;Klik op 'Edit form fields'
  * Type: Tags
    * Het formulier pakt dan automatisch de tags die je hebt ingesteld via het [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin).
  * Key (one word) for example: ‘summary’ (for storing, must be unique, no spaces and special characters): vul hierin 1 woord, allemaal kleine letters, die de functie van jouw tags omschrijft. Bijvoorbeld: 'thema'
  * Info: hier kun je eventueel meer tekst toevoegen over de vraag, dit wordt getoond voor de invulllers.
  * Required: of het invullen van deze vraag verplicht is of niet.
  * Min length: leeg laten
  * Max length: leeg laten
  * Only show to moderators: No.

### Statussen van plannen&#x20;

Statussen worden ook gebruikt om inzendingen te categoriseren. Statussen zijn handig om inzendingen te categoriseren een tijdje nadat ze op de site zijn geüpload. Zo kun je bijvoorbeeld 90 dagen nadat plannen zijn ingestuurd een update van status voorzien. Of nadat is gestemd laten zien welke plannen worden uitgevoerd en welke niet.

Er zijn 6 verschillende statussen die vervolgens andere weergave hebben.&#x20;

* Open:
* Closed
* Denied
* Accepted
* Busy&#x20;
* Done

Op het moment dat een plan veranderd van status *Open* naar een van de andere statussen, is liken/stemmen op dat plan niet meer mogelijk. Argumenten aan of uitzetten is niet gelinked aan de statussen van plannen.&#x20;

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fj7JCxX5UYJ6K6J4R98AR%2Fafbeelding.png?alt=media&amp;token=6bbd4656-5062-4642-b0c4-49cb6077c728" alt=""><figcaption><p>In deze screenshot zie je de verschillende weergaves van statussen. </p></figcaption></figure>

De tekst van de label (het balk met tekst op de afbeelding) kun je per status veranderen. De labels worden pas zichtbaar op het moment dat je dat zo instelt via:

[Resource representation](/openstad/manual/modules/resource-representation) en [Resource overview](/openstad/manual/modules/resource-overview#labels) van [Resource overview](/openstad/manual/modules/resource-overview).

> Je kan ook kiezen om plannen automatisch te laten aanpassen van status. Kijk in dat geval bij [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin)[Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#ideas) > Automatically update status from OPEN to CLOSED when an idea is a given number of days old > en vul vervolgens in na hoeveel dagen dat moet gebeuren. Dit kan op moment van schrijven alleen automatisch van status open naar status closed.&#x20;

### Hidden thema's met een key&#x20;

Je kan ook onzichtbare thema's gebruiken. Via [Resource overview](/openstad/manual/modules/resource-overview) --> [Resource overview](/openstad/manual/modules/resource-overview#include-and-exclude-items) kun je pagina's inrichten om specifieke thema's wel of niet te laten zien. Dit is handig als je meerdere resource forms hebt op 1 website, en als je niet alle inzendingen in 1 overview wilt laten zien, maar verschillende. (Bijvoorbeeld: je kan een organisatie aanmelden voor het buurtbudget én een buurtplan indienen op de zelfde website. Dan wil je in 1 resource overview de organisaties laten zien, en in het andere overview de buurtplannen laten zien).&#x20;

Wat je dan moet doen is een 'hidden theme' toevoegen in elke formulier, waar je vervolgens mee kan filteOnly show idea including this theme (currently only works with one theme)ren in de resource overview.&#x20;

* Met de resource form widget:
  * Maak de 2 verschillende resource forms op de pagina's waar je ze wilt hebben.
  * In in van de forms, ga naar Algemeen > How do you want to organise the form? > Static with dynamic fields appended
  * 'Edit form sections' komt vervolgens tevoorschijn. Klik hierop
  * Laat de velden voor *title* en *info* leeg. Klik op 'Edit form fields'
    * Type: hidden
    * Key (one word) for example: ‘summary’ (for storing, must be unique, no spaces and special characters): vul hierin 1 woord, allemaal kleine letters, die jouw thema omschrijft. Bijvoorbeeld: buurtplan
    * Info: leeg laten
    * Default value (will be overwritten by url and resource value): leeg laten
    * Save field in root if data object and not in extraData, will only work if column exists in database): No
    * Only show to moderators: No.
  * Herhaal de bovenstaande stappen met het andere resource form en een andere key.&#x20;
* Ga vervolgens naar 1 van de resource overview paginas.
  * Edit widget > Include & exclude items
  * Only show idea including this theme (currently only works with one theme): vul hierin de key naam die je hebt gekozen voor deze formulier.&#x20;
* Ga naar het andere resrouce overview pagina
  * Edit widget > Include & exclude items
  * Exclude ideas with this theme: vul hierin de key naam van het **andere formulier**.&#x20;

Op het moment van schrijven kun je alleen 'include' 1 keer gebruiken, voor 1 key / hidden thema. Exclude kun je wel meerdere keren gebruiken.&#x20;


# Likes verzamelen

Likes zijn een veelgebruikte middel in verschillende participatieprocessen. Hieronder lees je de verschillende mogelijkheden met likes.

Als basis moet je eerst likes instellen via het Admin panel: Settings → Voting → What type of voting is available?: Likes

### Stemdrempel

Je kan likes inzetten als stemdrempel. Bijvoorbeeld, bij een participatief begroten proces, dat een plan minimaal 50 likes moet halen om door te gaan naar de haalbaarheidstoets.&#x20;

De voordelen hiervan zijn:

* Draagvlak toetsen: door likes te gebruiken krijg je een beeld van de draagvlak rond een plan.&#x20;
* Meer interactie: omdat indieners van plannen likes willen verzamelen, sturen ze hun plan rond naar hun hele netwerk. Veel van deze mensen gaan niet alleen dit ene plan liken, maar ook rondkijken op de hele site. Zo komen veel meer gebruikers en interactie op een site dan anders zou gebeuren.
* Proces stroomlijnen: er komen veel plannen binnen en het kan veel werk zijn om alle plannen te moeten toetsen. Door een stemdrempel te hebben ga je het vervolgproces alleen aan met bewoners die een bepaalde niveau van committment hebben en bereidheid om actief mee te doen.&#x20;

De nadelen zijn:

* Drempelverhogend. Minder digitaal vaardige bewoners kunnen minder goed hiermee omgaan.
* Mogelijk verwarrend. Met participatief begroten processen zie je af en toe verwarring over het verschil tussen de like- en stemronde.&#x20;

Een like-drempel kun je instellen via [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin) > [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#ideas). Vul dan het gewenste aantal in bij "Minimum votes needed for idea?"&#x20;

###

### Likes controleren op IP-adressen en postcodes

Lees voor meer informatie [/pages/cPX80qcEAOJGDePlW9um#4.-likes-bekijken-of-verwijderen](https://docs.openstad.org/openstad/manual/how-tos/pages/cPX80qcEAOJGDePlW9um#4.-likes-bekijken-of-verwijderen "mention").


# Reacties en argumenten

Een reactiemogelijkheid ([arguments](/openstad/manual/modules/arguments)) kun je toevoegen aan twee soorten pagina's:

* Een inzending detailpagina.
* Een zelf gemaakte pagina. \[ TODO - [Ian](mailto:undefined) kun jij deze hieronder toevoegen, dus die werkwijze met een 'nep' Id?]

{% hint style="info" %}
HIER SCREENSHOT VAN ARGUMENTS TOEVOEGEN?
{% endhint %}

### Reactiemogelijkheid op inzending detailpagina

Bij de how-to [inzendingen weergeven](/openstad/manual/how-tos/show-ideas) is beschreven hoe je een inzending detailpagina aanmaakt. Op die detailpagina kun je onder de widgets resource representation en resource admin buttons een nieuwe column section aanmaken. Voeg in die column section een of twee arguments widgets toe. Lees op de pagina [arguments](/openstad/manual/modules/arguments) meer over het configureren van deze widget. &#x20;

### Reactiemogelijkheid op zelf gemaakte pagina

\[ TODO - [Ian](mailto:undefined) kun jij hier beschrijving toevoegen, dus die werkwijze met een 'nep' Id?]


# Interactieve kaart

## Gebruik van de kaart

De ‘interactieve kaart’-widget kan onder andere op de volgende manieren ingezet worden:

* **Ter informatie punten op de kaart tonen** - Plaats punten op de kaart en voeg hier een afbeelding en tekst aan toe.
* **Reacties op punten op de kaart uitvragen** - Plaats punten op de kaart, met afbeelding en tekst, en vraag gebruikers van de website om op deze punten te reageren.
* **Gebruikers zelf punten op de kaart laten plaatsen** - Vraag gebruikers om een locatie op de kaart te selecteren, en hier een afbeelding en tekst aan toe te voegen. Optioneel kunnen andere gebruikers hier weer op reageren.

## Indeling van de kaart

De indeling van de ‘interactieve kaart’-widget bestaat uit 3 hoofdonderdelen:

* **Kaart (C)** - aan de rechterkant wordt de kaart getoond, met daarop de punten die vooraf zijn ingeladen, of door gebruikers zijn geplaatst.
* **Contentvlak (B)** - het contentvlak aan de linkerkant bestaat uit twee onderdelen. Bovenaan het selectievlak met grijze achtergrond (B1), welke meer informatie geeft over een geselecteerde locatie of inzending. Er onder een lijstweergave met inzendingen (B2). Zie hieronder [#verschillende-weergaves](#verschillende-weergaves "mention") voor meer informatie over de inhoud van het selectievlak en de lijstweergave in verschillende omstandigheden.
* **Zoek- en filterbalk (A)** - uitgestrekt bovenaan de lijst- en kaartweergave bevindt zich in de overzichtsweergave een grijze balk met daarin optioneel een zoekveld, filter-dropdown en een knop om alle punten op de kaart weer in beeld te krijgen.

Hierboven is de lay-out op brede schermen beschreven, zoals desktop en tablet. Op smallere schermen, zoals mobiel, wordt óf de kaart óf het contentvlak op de volle breedte van het scherm getoond.

![Indeling van de widget: (A) Zoek- en filterbalk, (B1 en B2) contentvlak, (C) kaart.](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FWsVFJkiInK2fi0itfNlZ%2FInteractieve%20kaart%20indeling.png?alt=media\&token=e9557726-56cb-43cf-8b5f-000e6c9d3d6b)

## Verschillende weergaves

Er kunnen verschillende weergaves onderscheiden worden. Ten eerste is er een verschil tussen de *overzichtsweergave* en de *detailweergave*.

In de *detailweergave* wordt alle informatie behorend bij één specifiek punt op de kaart volledig getoond, met eventueel bijbehorende reacties.

![Detailweergave](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FV33CzeiNfD0CKctA4OBc%2FInteractieve%20kaart%20-%20detailweergave.png?alt=media\&token=576ebfce-131a-4a57-b953-8ff902cf1a08)

In de *overzichtsweergave* worden meerdere punten op de kaart getoond. Dit kunnen alle punten zijn, maar het kan ook een selectie van alle punten zijn, bijvoorbeeld binnen een bepaald gebied en/of binnen een bepaald thema. Binnen de overzichtsweergave kunnen we nog 3 verschillende weergavemodi onderscheiden:

* **Niets geselecteerd** - dit is de weergave op het moment dat de widget vers geladen wordt. Op de kaart is niets geselecteerd. Optioneel wordt er in het grijze informatie/selectie-vlak algemene informatie getoond. In deze weergave kan dit vlak ook verborgen worden. Het contentvlak aan de linkerkant toont een lijst met tegels met alle punten die zichtbaar zijn op de kaart. Standaard worden bij het inladen van de widget alle punten op de kaart getoond, en worden deze dus ook in de lijst getoond. Als de gebruiker gaat inzoomen en schuiven met de kaart, dan kunnen er punten buiten de viewport vallen. Die punten verdwijnen ook uit de lijst. Oftewel; de lijst toont alleen de punten die op dat moment zichtbaar zijn op de kaart en dus binnen de viewport vallen. De gebruiker kan altijd terugkeren naar het totaaloverzicht door in de zoek- en filterbalk te klikken op de knop ‘Alles tonen’. Als de gebruiker klikt op een tegel in de lijst, dan opent de detailweergave van dat punt. Als de gebruiker klikt op een punt op de kaart, dan opent óf de detailweergave óf wordt de ‘punt geselecteerd’-weergavemodus getoond (zie hieronder), afhankelijk van de instellingen van de widget.
* **Punt geselecteerd (optioneel)** - als er op de kaart een (ingezonden) punt aangeklikt wordt, dan kan deze optioneel in de overzichtsweergave uitgelicht worden. In het contentvlak wordt dan bovenaan met grijze achtergrond het geselecteerde punt op de kaart als tegel getoond. Daaronder worden in de lijst de dichtstbijzijnde punten getoond, die dus geografisch het dichtst in de buurt liggen van het geselecteerde punt.
* **(Nieuwe) locatie geselecteerd** - dit is de weergavemodus als de gebruiker ergens op de kaart klikt, waar nog geen punt geplaatst is. In het contentvlak wordt een lijst met de dichtstbijzijnde punten vanaf de geselecteerde locatie getoond, vergelijkbaar met de ‘punt geselecteerd’-weergavemodus. Optioneel, afhankelijk van de instellingen van de widget, wordt er bovenaan in het contentvlak een knop getoond waarmee de gebruiker zelf op deze locatie een nieuw punt kan toevoegen aan de kaart.

![Niets geselecteerd](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F9oc2xIbT2tHKqrITbHht%2FInteractieve%20kaart%20-%20niets%20geselecteerd.png?alt=media\&token=e16ec450-ead9-4927-a492-c834a031a775) ![Punt geselecteerd](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FTMWsGDQHfQkQexMPriPV%2FInteractieve%20kaart%20-%20punt%20geselecteerd.png?alt=media\&token=96f5b839-188b-44cd-898e-36fc502178ea) ![(Nieuwe) locatie geselecteerd](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FXUrOrWXhkkotepHtfbhZ%2FInteractieve%20kaart%20-%20locatie%20geselecteerd.png?alt=media\&token=2f3272f0-0bc2-47a4-bb20-d256fecaca2a)

## Interactieve kaart inzetten op een website

Om de interactieve kaart in te kunnen zetten op een website, is het belangrijk dat op verschillende plekken de juiste instellingen staan.

### Column section

Zoals elke widget, wordt ook de kaart geplaatst in een *column section*. Het is in het geval van de kaart belangrijk dat de volgende instellingen van de column section goed ingesteld zijn:

| Instelling | Waarde                              |
| ---------- | ----------------------------------- |
| Columns    | Full screen (vertical & horizontal) |

{% content-ref url="/pages/pI5JSuio66HCLV1BlsFA" %}
[Columns](/openstad/manual/modules/section-columns)
{% endcontent-ref %}

### Page Settings

In combinatie met de 'full screen'-instelling van de column section, is het ook belangrijk dat de cookiebar gefixeerd onderaan de pagina getoond wordt. Zorg dat in de *Page Settings* van de pagina waarop je de kaart plaatst, het volgende staat ingesteld:

| Instelling                             | Waarde |
| -------------------------------------- | ------ |
| Hide the footer?                       | Yes    |
| Set the cookiebar fixed at the footer? | Yes    |

{% content-ref url="/pages/m4tstuTUTYKQxcUIFiZV" %}
[Page Settings](/openstad/manual/miscellaneous/page-settings)
{% endcontent-ref %}

### Global (optioneel)

Vanuit de globale instellingen van de website regel je twee verschillende zaken, die beide optioneel zijn; een *grens* om een bepaald gebied af te kaderen, en de verschillende *thema's* van de punten op de kaart.

Om een grens van een bepaald gebied aan te geven worden *polygonen* gebruikt. Lees in de volgende artikel meer over het gebruik van polygonen:

{% content-ref url="/pages/5etW2oxxMg5oAbPSzbxD" %}
[Polygonen](/openstad/manual/how-tos/polygonen)
{% endcontent-ref %}

Punten op de kaart kunnen gegroepeerd worden per thema, die je definieert in *Global*.

{% content-ref url="/pages/QjsFzmcmio5GEsYX4fIs" %}
[Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global)
{% endcontent-ref %}

In het geval van de interactieve kaart, kun je ook thema-specifieke iconen instellen. Lees meer in het volgende artikel:

{% content-ref url="/pages/QMiHPtvFd7HDaCORhwAa" %}
[Interactieve kaart thema iconen](/openstad/manual/miscellaneous/interactieve-kaart-thema-iconen)
{% endcontent-ref %}

### 'Ideeën op een kaart'-widget

De rest van de instellingen definieer je in de *Ideeën op een kaart*-widget.

{% content-ref url="/pages/aoHXeGVNhO72bQamBDu2" %}
[Ideeën op een kaart (Kaart applicatie)](/openstad/manual/modules/ideeen-op-een-kaart-kaart-applicatie)
{% endcontent-ref %}


# Polygonen

Een polygon voeg je toe om de grenzen van een buurt/gebied/stad aan te geven. Dit wordt getoond in de widgets die een kaart gebruiken, bijvoorbeeld [ideeën op een kaart](/openstad/manual/modules/ideeen-op-een-kaart-kaart-applicatie) en [ideas map](/openstad/manual/modules/idea-map).&#x20;

## **Gebied tekenen om JSON code te maken**

Bepaal eerst wat de grenzen van het gebied zijn. Gebruik, indien nodig, kaarten of een database van de gemeente om de juiste grenzen te vinden. Vervolgens moet je die grenzen aangeven in JSON code. Dat werkt als volgt:

1. Ga naar de website: <https://geojson.io/>. Op deze website ga je het gebied natekenen om de juiste code te kunnen downloaden.
2. Klik rechtsboven in de kaart op het vijfhoekige icoon

&#x20;

![Kaart tekenen](https://lh3.googleusercontent.com/TqZvJL0PV-Q1DgTEQkQYYG_tKXPaalifvInmWfP8UiOw23xlTxBfyT9Y4TpHIPYUU7pxKX494vv6oEeQa7R3Bkt1OH2YQrcWYQHQnYPvNxqiCocbymp4paKyT-VxNmfpqcN3kE-r)

3\. Nu kun je door te klikken het gebied omcirkelen waar het om gaat. Eindig altijd door het beginpunt aan te klikken en hiermee de gebiedsgrens te ‘sluiten’. Een omcirkeld gebied ziet er zo uit:

![omcirkeld gebied in geojson](https://lh6.googleusercontent.com/Qv059qDMR3cEE0ypacpThuCwWlQUmSMFkDiIqkL9o9PiRumxmM50Vd-sqNuRDOBblPCVpyZSoFSSFaLDRx6fAKW1VPjLVWCufoSX_jSWMVwkN5BOvL7Gl_Cpm-Ra44uq3zymbL71)

4\. Controleer of het gebied klopt. Wanneer je niet tevreden bent met het gebied klik je op het bewerken icoon. Je kunt dan de stippen die je hebt gezet aanpassen.

![Bewerken icoon](https://lh6.googleusercontent.com/5hCidviX5dps_RLNvTSjodEWrYAVV99sim3YHuLdB7Z0t39g7bwCLZtgjhZ6W-C6SJy4G3JUcM6Cu8J4gig3-m83LhZkjZ2UudvLB0HJt2YYlqJjgl9yX03DgD2GmSTSWJ5urNWW)

5\. Tevreden? Kopieer dan alle (JSON) code uit het rechter tabblad.

![gekozen gebied en JSON code](https://lh6.googleusercontent.com/sBtLAuzOw9SemXW6lp8C96-zBsACE7XI18sDcS1R3Us2qlG4_quGA3Is4djfsBaqTj9l4N1VZCo_ag3pSEnAerFwMVvQztyM6UV2q9uDI-f_Aw-TwScXF5ZzKgKXDUCS7ZX1LfH8)

6\. Die code ziet er zo uit (maar is waarschijnlijk langer):

![voorbeeld json code](https://lh4.googleusercontent.com/zt9tXgqCQZXR0d4tbLqvp2d_MIJ2h60JQyJpwmNVWUAJUe5JC17_l9KoFdAoIH_DD-jNv39pxRzQz5zrZTC2zkxMQBJO_2xnl6adeNZ_37uBa5X_mmFN6PYudawooCPtDr-t3LWc)

## **De polygoon (JSON) code toevoegen aan het OpenStad CMS.**

1. Ga naar je site in het OpenStad CMS en ga naar het admin panel door /admin achter de URL te zetten.&#x20;

* Als je nog niet ingelogd bent als admin of editor, kun je dat nu doen.&#x20;
* Klik links in het admin panel op de tab ‘Polygonen’&#x20;
* Nu zie je een lijst met bestaande polygonen. **Let op: Verwijder niks uit deze lijst, want dan zijn de polygonen ook niet meer bruikbaar voor andere websites!**

![Overzicht van polygonen in de admin panel](https://lh4.googleusercontent.com/XBhzSkB47-Iuv15wr-qsw3ToLLF51Ia89Y7pjvS0MldJRoo2J9gXD8w_SKCMd6dDD3mZ439B61ELjbF9PjXbJVJm5CnhHvoc8JguMIwRAsV-PamyjLVH6TBtzn5AuRFWslZ_MB7u)

2\. Klik rechts bovenin op ‘create’ om jouw Polygon toe te voegen met de code die je gekopieerd hebt.

* &#x20;Kies een herkenbare naam voor de Polygon. Bijvoorbeeld \[Stadsdeel] - \[Wijknaam] → **Zuid - Buitenveldert, Zuidas.**

![Aanmaken nieuwe polygon](https://lh3.googleusercontent.com/9w1-b84_NimSR-Dvy_9KM9ZZmTLVV6tUAAQPhOrqnOzpX1QJivQqCme2IQm1k5k5-3-SK75qu8Uhyeq-xUVZsca1pzvVRvwChdFsxm466DPBnFYwSXpwGvUTM4Xmlm51xkdykBjz)

* Scroll naar beneden en plak jouw ‘JSON code’ in het zwarte vlak.

![vlak waar je de JSON code kan plakken](https://lh6.googleusercontent.com/oCs1V8q8RzNuu5DU5i-MnL31-pQgOWAUf87Ysu40KfaBnSOZtERqKfx-KrO1fg1cSWvLM8adcp7Xqm8V7__J75tc3Qsw2lfBgbwwC-DyxnkPmzUJ08abIOR8SuIeJYmMBkJyfsuj)

* Klik op ‘Save’ en jouw Polygon is opgeslagen.

## Via global de juiste Polygon selecteren voor jouw site

Om nu de juiste Polygon te selecteren voor verschillende widgets, ga je naar Global > Map > en selecteer je bij ‘Selecteer een polygon’ de naam van de polygon die je zojuist toegevoegd hebt.

![](https://lh3.googleusercontent.com/Td8XlqcNtzBttt49O68YcU63clR63Q1tvLAxiWWhjuv2xUzKi6BYH0AANoeKuA3sMx8g_h80jLcRKwVRcUnt-iEVtaNJWN-TmlQ0JfXO9IMGo0rG6PGYjhV_M2FG0L_dpbX9JR3G)


# Newsletter

Een nieuwsbrief gebruik je om gebruikers op de hoogte te houden van het verloop van je project.&#x20;

## Newsletter aanzetten

Zet eerst je newsletter aan via [Adminpanel](/openstad/manual/miscellaneous/adminpanel#settings) in Admin Panel.&#x20;

Zorg dat "Is active?" op "Yes" staat.&#x20;

## Newsletter op je pagina toevoegen&#x20;

Voeg een newsletter toe op je site via een link of een button. In plaats van een url vul je "#newsletter" in. <br>

![Voorbeeld knop](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FAgRgFOcYx3pwugrcz99x%2Fimage.png?alt=media\&token=0d7d772d-04cf-47f6-80b7-8eaf4659595d)

![instellingen om newsletter zichtbaar te maken.](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FGKtKnugqaoVJ2JHtKIo5%2Fimage.png?alt=media\&token=77cb7d45-2dbf-4417-a4fb-0c66653ed047)

## Instellingen van de newsletter

Instellingen  pas je aan in Global > [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global#newsletter).&#x20;

Hiermee pas je de pop-up aan (de vragen die worden gesteld aan gebruikers om zich aan te melden).&#x20;

## Newsletter subscribers

Om een download te maken van de namen en mailadressen (of andere informatie wat je hebt verzameld) voor een nieuwsletter, gebruik je [Adminpanel](/openstad/manual/miscellaneous/adminpanel#newsletter-subscribers) in het Adminpanel of [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#nieuwsbrief) in React admin.&#x20;


# Moderatie

Wanneer gebruikers inzendingen en reacties kunnen achterlaten op een website, is het vaak wenselijk om te modereren. Het modereren bestaat uit vier onderdelen:

1. Controleren van inzendingen. Gebruikers sturen plannen, ideeën of andere inzendingen in. Het kan voorkomen dat er ongewenste afbeeldingen worden ingezonden of dat er ongewenste uitingen in een inzending worden gedaan. Moderatoren kunnen de inzendingen bewerken en verwijderen of erop reageren.&#x20;
2. Controleren van reacties. Gebruikers kunnen reacties plaatsen op de website. OpenStad is zo ingericht dat een goed gesprek kan plaatsvinden. Tegelijkertijd kunnen online gesprekken heftige emoties oproepen. Moderatoren kunnen controleren of er in de reacties sprake is van discriminerend, haatzaaiend, tot geweld aanzettend of grof taalgebruik.&#x20;
3. Stimuleren van reacties. Moderatoren kunnen de dialoog beter maken door vragen van bewoners te beantwoorden, actief deel te nemen aan het gesprek en positief te reageren op reacties (bijvoorbeeld door een compliment te geven: "Wat een goed idee!").&#x20;
4. Controleren van likes. Gebruikers kunnen inzendingen liken. Daarbij kun je instellen dat zij als vorm van authenticatie hun postcode moeten invullen. Moderatoren kunnen zien welke postcodes en IP-adressen verbonden zijn aan de likes en die waar nodig verwijderen.&#x20;
5. Plannen downloaden. Aan het einde van een planindien periode of stemperiode kunnen moderatoren deze overzicht inzien en downloaden, inclusief het aantal stemmen.&#x20;
6. Gebruikers aanpassen. Je kan de namen of mailadressen van gebruikers aanpassen, indien nodig.&#x20;
7. Nieuwsbrief downloaden. Je kan het overzicht van geregistreerde voor de nieuwsbrief downloaden, bijvoorbeeld aan de einde van het traject, om ze op de hoogte te houden van het verloop.
8. Statistieken inzien. Elk site genereert een aantal automatische statistieken, wat je kan inzien als moderator.&#x20;

Een moderatie account heeft speciale rechten op een website. Hieronder volgt de uitleg hoe een gebruiker moderatie rechten kan krijgen en welke rechten een moderator precies heeft.&#x20;

### Vooraf: Gebruikers moderatie rechten geven

Vraag een admin om een gebruiker, bijvoorbeeld de projectleider, moderatie rechten te geven. Dit verloopt via het [Adminpanel](/openstad/manual/miscellaneous/adminpanel).

### 1. Inzendingen bekijken, bewerken, verwijderen of moderator reactie toevoegen

{% hint style="info" %}
Zorg dat je (nadat je moderator rol hebt gekregen) dat je eerst inlogd op de site. Sommige sites hebben een "Inloggen" knop in de hoofdmenu. Maar als dat er niet is, kun je altijd inloggen door /admin toe te voegen aan de url van de website. Bijvoorbeeld: westbegroot.amsterdam.nl/admin.&#x20;
{% endhint %}

#### Inzendingen bekijken

Ga naar de detailpagina van de inzending. Je ziet daar de informatie die voor iedereen zichtbaar is. Je kunt meer informatie inzien door onder het subkopje 'Beheren' op 'Extra info' te klikken. Dan zie je informatie zoals e-mailadres, telefoonnummer en andere gegevens van de gebruiker die niet voor iedereen zichtbaar is.

#### Inzendingen bewerken en status wijzigen

Ga naar de detailpagina van de inzending. Klik op 'Bewerken' om de ingevulde gegevens bij de inzending te bekijken en te bewerken. Klik vervolgens onderaan op 'Opslaan' om wijzigingen te publiceren. Meestal gebruik je deze mogelijkheid wanneer een gebruiker vraagt of er iets aan een inzending kan worden gewijzigd of wanneer een inzending ongewenste taal of informatie bevat.

Klik onder het subkopje 'Beheren' op 'Status: <>" om de status van een inzending te wijzigen. Je kunt kiezen uit de statussen open, closed, denied, accepted, busy, done. Lees hier bij [statussen van plannen](broken://pages/lNZsGGhddgFl6PTvYHOr) meer over.&#x20;

#### Inzendingen verwijderen

Ga naar de detailpagina van de inzending. Klik op 'Verwijderen' om de inzending te verwijderen. Je krijgt een melding of je zeker weet dat je de inzending wilt verwijderen. Klik op 'Ok' om de inzending definitief te verwijderen.&#x20;

**Zo ziet het eruit:**

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FDDAhH1C6ZV4yeyStE0fl%2Fafbeelding.png?alt=media&amp;token=f5e80a42-7f5e-42b9-b216-2d04f388196b" alt=""><figcaption><p>De opties voor moderatoren op een plan/inzending pagina</p></figcaption></figure>

#### Moderator reactie toevoegen

Er verschijnt een algemene naam bij moderator reacties. Dit kan aangepast worden door jouw editor via *Global* en vervolgens *Algemene instellingen* om bij *Author of the modbreaks.* Hier kan je bijvoorbeeld de naam aanpassen naar de naam van jouw organisatie.

Ga daarna naar de detailpagina van de inzending. Klik onder het subkopje 'Beheren' op 'Moderator reactie' om een reactie als moderator toe te voegen. Vul een tekst in en klik op 'Opslaan'. De moderator reactie is nu voor alle gebruikers zichtbaar bij de inzending. De moderator reactie is handig om als moderator informatie te geven over de status van een inzending of hierbij commentaar te geven.&#x20;

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F0hZLobFElKukjCpBNHRq%2Fafbeelding.png?alt=media&amp;token=ae8f161a-fbfd-431e-a258-b2aeee88e364" alt=""><figcaption><p>Een modbreak op een planpagina </p></figcaption></figure>

### 2. Reacties bewerken of verwijderen

Als moderator kun je reacties van gebruikers bewerken en verwijderen. Ga naar de reactie die je wil bewerken en klik op de button met een potlood ('Argument bewerken') om te bewerken. Klik op de button met een prullenbak ('Argument verwijderen') om te verwijderen.&#x20;

Wees zorgvuldig in het bewerken of verwijderen van reacties. Controleer of er in de reacties echt sprake is van discriminerend, haatzaaiend, tot geweld aanzettend of grof taalgebruik. Neem altijd eerst contact op met de gebruiker en vraag of de gebruiker zijn/haar reactie wil wijzigen.

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FK5KwgmgGfD2rnYkoMyLV%2Fafbeelding.png?alt=media&amp;token=b9f836ce-c78a-4c02-90c9-2496970e53b0" alt=""><figcaption><p>Als moderator heb je knopjes om een opmerking aan te passen of verwijderen. </p></figcaption></figure>

### 3. Reacties plaatsen als moderator&#x20;

Als moderator kun je ook actief deelnemen aan het gesprek bij een inzending. Wanneer een moderator een reactie plaatst, wordt deze reactie herkenbaar als moderator reactie uitgelicht met een rode vlag naast de naam. Deze reacties kunnen bijvoorbeeld gebruikt worden om gesprekken te faciliteren of vragen te beantwoorden.

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FzdOA4N1mA5jATHbDKP9Y%2Fafbeelding.png?alt=media&amp;token=4de7eda4-a4f8-43ad-8392-3c2b8decc5d2" alt=""><figcaption></figcaption></figure>

### 4. Likes bekijken of verwijderen

Om een like uit te brengen op een inzending, maakt een gebruiker een anonieme account aan met een postcode. Als die zelfde gebruiker probeert meerdere malen 1 plan te liken met dat account, dan wordt de gebruiker herkent. Je kan dan alleen je al uitgegeven likes aanpassen.&#x20;

Dit is alleen niet waterdicht, waardoor er ook een mogelijkheid is om likes te controleren op IP-adressen en poscodes. Als moderator kun je dit inzien. Je zou dit kunnen nalopen op het moment dat er een verdachte situatie is (op 1 plan duizend likes, maar op de rest alleen rond de 50). Of als je een spelregel hebt dat alleen gebruikers vanuit bepaalde postcodes mee mogen doen met de like-ronde.&#x20;

Ga naar de detailpagina van een inzending en klik onder het kopje 'Beheren' op 'Stemoverzicht'. Je krijgt nu een overzicht van alle likes en welke postcodes en IP-adressen van gebruikers hieraan gekoppeld zijn.&#x20;

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FiDeUYkGQChvx7SYKYuGe%2Fafbeelding.png?alt=media&amp;token=148e751e-9919-43c9-985f-86e13a699f2a" alt=""><figcaption><p>Zo ziet het stemoverzicht (van likes) eruit.</p></figcaption></figure>

Indien je likes ongeldig wilt maken maken, kan dat ook via het "Stemoverzicht". Per like kun je het eventueel ongeldig maken door te klikken op het kruisje in het rechterkolom van het tabel. De rij van deze like is nu rood gearceerd en de like is verwijderd. Wil je een like toch weer geldig maken? Klik dan op het vinkje dat nu op de plaats van het kruisje staat.&#x20;

{% hint style="warning" %}
Let op: IP adres controle is niet nauwkeurig. Het zou bijvoorbeeld ook kunnen dat meerdere personen hebben gestemd via de computer in de bibliotheek. Laat niet alleen IP adres op zichzelf een reden zijn om likes ongeldig te maken.&#x20;
{% endhint %}

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FwQ7P3UmyIxf6bOrnpJiB%2Fafbeelding.png?alt=media&amp;token=d03f97ad-7865-4e32-aec7-7e49c7e0345b" alt=""><figcaption><p>In deze screenshot is het onderste like (rood gekleurde rij) ongeldig gemaakt.</p></figcaption></figure>

### 5. Plannen downloaden&#x20;

Ook kun je een aantal dingen inzien als moderator via het "react admin panel". Zorg eerst dat je bent ingelogd, en voeg daarna /admin toe aan de url. Klik dan, links in het menu, op **Plannen.**

In dit overzicht zie in een oogopslag alle ingestuurde plannen of inzendingen, de status die ze hebben, en "yes" (het aantal likes of stemmen voor) en "no" (het aantal likes of stemmen tegen).&#x20;

&#x20;

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F7ThL5M6t9Kbqy0POP3Ib%2Fafbeelding.png?alt=media&amp;token=21c4ca4a-8af9-4c8c-923a-29d87542bb72" alt=""><figcaption></figcaption></figure>

Je kan ook meer informatie downloaden via de knoppen rechtsboven het overzicht. Daarmee kun je alle informatie van de inzendingen downloaden. Dit is bijvoorbeeld heel handig bij het bepalen van de gekozen plannen na een participatief begroten stemfase, zodat je budget en stemmen kan optellen in 1 overzicht.&#x20;

### 6. Gebruikers aanpassen

Iets anders wat je kan zien via "react admin panel" zijn gebruikers. Zorg eerst dat je bent ingelogd, en voeg daarna /admin toe aan de url. Klik dan, links in het menu, op **Gebruikers.**&#x20;

In dit overzicht zie je alle geregistreerde gebruikers op jouw site. Je kan gebruikers ook toevoegen en aanpassen. Dit kan handig zijn als een planindiener hulp nodig heeft bij het veranderen van hun naam op de site, of als je een andere account wilt koppelen aan een al ingestuurde plan.&#x20;

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fh68O7N3WVUcbGWeMZ1u6%2Fafbeelding.png?alt=media&amp;token=094a79c0-a5c3-4332-9609-379bfb099f17" alt=""><figcaption></figcaption></figure>

### 7. Nieuwsbrief downloaden&#x20;

Iets anders wat je kan zien via "react admin panel" zijn gebruikers. Zorg eerst dat je bent ingelogd, en voeg daarna /admin toe aan de url. Klik dan, links in het menu, op **Nieuwsbrief**.&#x20;

Je ziet een overzicht van de gebruikers die zichzelf hebben opgegeven voor de nieuwsbrief. Je kan deze lijst downloaden als excel of csv met de knoppen rechtsboven het overzicht.&#x20;

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FcFXG4XyE20l0dibKgAJd%2Fafbeelding.png?alt=media&amp;token=84519673-23f5-44a9-97eb-8c0693524bf1" alt=""><figcaption><p>Hier zie je (geanonimiseerde) inschrijvers van de nieuwsbrief</p></figcaption></figure>

### 8. Statistieken inzien

Nogmaals via "react admin panel" kun je statistieken inzien van de website. Zorg eerst dat je bent ingelogd, en voeg daarna /admin toe aan de url. Je komt terecht op een pagina 'statistics'. Hier kun je, afhankelijk van de site, verschillende informatie inzien over de gebruik van de site.&#x20;

De statistieken die hier staan worden automatisch gegenereerd. Ze zijn niet altijd van toepassing voor elke site. Maar je kan de belangrijke onderdelen voor jouw project gebruiken, bijvoorbeeld voor een evaluatie of berichtgeving over het project.&#x20;


# Unieke stemcodes

Wanneer het wenselijk is dat er met grote zekerheid gezegd kan worden dat bezoekers uniek zijn en het projectteam wil kunnen selecteren welke bewoners er mogen stemmen, kun je unieke stemcodes gebruiken.

Het beheren van stemcodes doe je in het [Adminpanel](/openstad/manual/miscellaneous/adminpanel). Wanneer je in het admin panel bent ingelogd, zoek je de website op waarvoor je stemcodes wil gebruiken en klik je op ‘beheer’ om de instellingen van de website te beheren. In de linkerkolom klik je op ‘voting codes’. Je komt dan in het tabblad voor de stemcodes.

*Admin panel* → Zoek de juist website uit de lijst → *Beheer* → *Voting codes*

### Unieke stemcodes aanmaken

Stemcodes genereren doe je met ‘create unique codes’. Onder de uitklapper kies je hoeveel codes je wil genereren. Daarna klik je op *Create codes* en worden de unieke stemcodes gegenereerd.

Wanneer je stemcodes hebt aangemaakt komen die in de lijst te staan onder *Unique codes for voting*. In deze lijst kun je in de derde kolom zien of een code is gebruikt. Dat is bijvoorbeeld handig om te kunnen zien wanneer bewoners zich afvragen of het stemmen gelukt is. Ook kun je gebruikte stemcodes *resetten* om ze nogmaals te kunnen gebruiken, wanneer je de stemtool aan het testen bent bijvoorbeeld.

[Adminpanel](/openstad/manual/miscellaneous/adminpanel#voting-codes)→ Create unique voting codes → vul in gewenste Amount of codes → *Create codes*

![stemcodes overzicht](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F1bPJthyKr4Lk3H5GJVpO%2Fimage.png?alt=media\&token=517dff7d-e2ff-4ab2-a659-9ea01a46653e)

![stemcodes genereren ](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FlkeeC8Eoorbq0O3frOSw%2Fimage.png?alt=media\&token=2d19ce39-e791-4f67-a30b-376fab54c95a)

Als je veel stemcodes hebt aangemaakt, kan het een tijdje duren voordat ze allemaal zijn ingeladen. Ververs de pagina een aantal keer totdat je bovenaan de melding ziet dat alle codes zijn aangemaakt.&#x20;

### Stemcodes exporteren

Om de lijst met codes te kunnen versturen, kun je de codes exporteren. Dat doe je door op *Export unique codes* te klikken. Er opent dan een downloadscherm, die het bestand opslaat als een ‘comma separated file’. Wanneer je het bestand opent, kun je het opnieuw opslaan als een ‘excel workbook’ of bij ‘format’ aangeven dat iedere waarde tussen komma's in een aparte kolom wordt geplaatst.

![Stemcodes exporteren](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-baeb8614df32a8ee2b1e5616930f483c7cfb0782%2FStemcodes_Export_voting_codes.jpg?alt=media) ![Save as type](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-318bc8cea8b9078f445949e0b338580fe2de3ea9%2Fsave-as-type.png?alt=media)

### Verspreiden van codes

Verspreiden van de codes kan door bijvoorbeeld flyers of brieven te sturen naar bewoners of naar huizen. Je koppelt dan de adressen aan de stemcodes. Overleg met je drukker/verspreider over hoe je de adressen en codes het best kunt aanleveren.

### Instellingen voor stemmen met stemcodes

In het admin panel kun je onder het tabblad [Adminpanel](/openstad/manual/miscellaneous/adminpanel#authentification-and-security) de instellingen voor authenticatie veranderen. Om de stemcodes te selecteren als authenticatie methode klik je het vinkje *Unieke codes* aan. Daarna klik je op *Save*.

![Settings voor stemmen met stemcodes](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-b6ef8f50196ad7a74ba311d63b767b2bd7e6cbdc%2FStemcodes_settings.jpg?alt=media)

[Adminpanel](/openstad/manual/miscellaneous/adminpanel) → Zoek de juist website uit de lijst → *Beheer* → [Adminpanel](/openstad/manual/miscellaneous/adminpanel#authentification-and-security)→ Unieke codes → *Save*.

### Stemcodes testen

Met de authenticatie instelling op *unieke code*, kun je met je aangemaakte codes teststemmen uitbrengen in je stemmodule op je website en deze stemmen ook weer verwijderen: [Testen](/openstad/manual/miscellaneous/testing)


# Stemmen

Er worden verschillende manieren van stemmen op inzendingen/plannen/ideeën/ontwerpen ondersteund. Zie hieronder een overzicht van de verschillende stemmethoden en de bijbehorende widgets en instellingen die nodig zijn om dat voor elkaar te krijgen. De volgende manieren worden beschreven:

* Maximaal één inzending/plan kunnen kiezen
* Meerdere inzendingen/plannen kunnen kiezen, waaronder de volgende mogelijkheden vallen:
  * Begroten, aantal inzendingen/plannen kiezen tot een *maximaal bedrag*
  * Begroten per thema, aantal inzendingen/plannen kiezen tot een *maximaal bedrag binnen een thema*
  * *Maximaal aantal* inzendingen/plannen kiezen

Onderaan deze pagina wordt beschreven hoe het werkt met[#stemfase-sluiten](#stemfase-sluiten "mention").

Bij de beschrijvingen hieronder wordt er vanuit gegaan dat de inzendingen/plannen al in de database van de desbetreffende website zitten. Is dit nog niet het geval, lees dan hoe je dit doet in één van de volgende how-to’s:

* [Inzendingen uploaden](/openstad/manual/how-tos/upload-ideas); als je zelf handmatig enkele inzendingen wil uploaden, of bewoners zelf inzendingen wil laten uploaden.
* [Inzendingen exporteren en importeren](/openstad/manual/how-tos/importing-plans); als je de plannen via een spreadsheet-overzicht wil importeren. Dit gebruik je ook als je in een eerdere fase van het proces met een andere website een (grote) hoeveelheid plannen hebt opgehaald.

Lees meer over complete participatieprocessen en de bijbehorende stappen onder [Participatieprocessen](/openstad/manual/processes).

Het is daarnaast belangrijk om goed na te denken over de vorm van authenticatie die bij het stemproces gebruikt wordt. Lees meer over de mogelijkheden en overwegingen onder [Authenticatie methodes](/openstad/manual/miscellaneous/authentication-methods).

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_<br>

## Maximaal één inzending/plan kiezen

Deze manier van stemmen kan zowel gebruikt worden om bewoners één voorkeursvariant te laten kiezen tussen een relatief grote hoeveelheid opties (vaak ideeën/inzendingen van medebewoners), maar net zo goed uit een beperkte hoeveelheid keuzemogelijkheden (bijvoorbeeld 3 verschillende ontwerpen voor de herinrichting van een straat). Dit wordt vaak gebruikt voor [Wedstrijd](/openstad/manual/processes/contest) processen.&#x20;

Voor deze methode wordt de [Resource overview](/openstad/manual/modules/resource-overview)-widget gebruikt (in tegenstelling tot de hieronder beschreven stemmethodes onder ‘Meerdere inzendingen/plannen kiezen’). Dit is de widget die ook gebruikt wordt om een inzending overzicht weer te geven zonder stemmogelijkheid. Lees hier meer over in de how-to [Inzendingen weergeven](/openstad/manual/how-tos/show-ideas).

Plaats de [Resource overview](/openstad/manual/modules/resource-overview)-widget op een pagina. De volgende instelling is in dit geval de belangrijkste:

* ‘Enable voting’: Afhankelijk of het stemproces wel of niet open is.
* ‘Display Type’ (alleen beschikbaar als ‘Enable voting’ op ‘No’ staat): Kies voor ‘Card in a grid’ om de layout van de pagina overeen te laten komen met de situatie als ‘Enable voting’ wel op ‘Yes’ staat.

![Resource overview met voting enabled](https://lh5.googleusercontent.com/DqmoEbp07sShoVqQB3Mn7hCfG-InnhTvFr-1ktMKuCi1vruIRDYJnmepYnzPLo5qh-63-uPGyXQ2vPwAajW2X8h5MPwWfTWejUwo4zsYcVkm2X25dQ6LXeUrTlOxts0bBM8nN4q3)

Er zijn daarnaast ook bepaalde instellingen in het [Adminpanel](/openstad/manual/miscellaneous/adminpanel). De volgende instellingen zijn in dit geval de belangrijkste:

* Settings
  * Voting
    * ‘Is the vote count publicly available?’: Maak hier een bewuste keuze.
    * ‘Is voting active?’: Afhankelijk of het stemproces wel of niet open is.
    * ‘What type of voting is available?’: Kies voor ‘Count’.
    * ‘What is min amount users can vote for?’: Vul in ‘1’.
    * ‘What is max amount users can vote for?’: Vul in ‘1’.

##

## Meerdere inzendingen/plannen kiezen

Deze manier van stemmen wordt vaak gebruikt als er een relatief grote hoeveelheid inzendingen/plannen/ideeën is, waarvan bewoners kunnen kiezen welke daarvan tot uitvoering worden gebracht. De hoeveelheid inzendingen die uitgevoerd kunnen worden is vaak afhankelijk van het beschikbare budget en de kosten van elke individuele inzending. Dit wordt gebruikt voor [Participatief begroten](/openstad/manual/processes/participatory-budgeting) processen.&#x20;

Er worden hieronder drie verschillende varianten beschreven:

* Begroten
* Begroten per thema
* Maximaal aantal kiezen

### Begroten

Bij deze variant is er één budget beschikbaar voor alle inzendingen. Van elke inzending zijn de kosten bekend om het plan tot uitvoering te brengen. Bewoners kunnen inzendingen kiezen zolang de totale kosten van de gekozen inzendingen het beschikbare budget niet overschrijden. Als bewoners tevreden zijn over hun keuze en het stemproces afronden, krijgt elke door de bewoner gekozen inzending er één stem bij.

Voor deze methode wordt de [Participatory budgeting](/openstad/manual/modules/participatory-budgeting)-widget gebruikt. Plaats deze widget op een pagina. De volgende instellingen zijn in dit geval de belangrijkste:

* ‘Enable voting’: Afhankelijk of het stemproces wel of niet open is.
* Voting type: Budgeting
* Available Budget: vul hier het beschikbare budget in.

Er zijn daarnaast ook bepaalde instellingen in het [Adminpanel](/openstad/manual/miscellaneous/adminpanel). De volgende instellingen zijn in dit geval de belangrijkste:

* Settings
  * Voting
    * ‘Is the vote count publicly available?’: Maak hier een bewuste keuze.
    * ‘Is voting active?’: Afhankelijk of het stemproces wel of niet open is.
    * ‘What type of voting is available?’: Kies voor ‘Budgeting’.
    * ‘What is min budet users can vote for?’:&#x20;
    * ‘What is max budget users can vote for?’:&#x20;
* Let op: plannen moeten een budget hebben om dit goed te laten werken.&#x20;

### Begroten per thema

Bij deze variant is er bepaalde budget beschikbaar per thema. Van elke inzending zijn de kosten bekend om het plan tot uitvoering te brengen. Bewoners kunnen inzendingen kiezen per thema zolang de totale kosten van de gekozen inzendingen het beschikbare budget voor dat thema niet overschrijden. Als bewoners tevreden zijn over hun keuze en het stemproces afronden, krijgt elke door de bewoner gekozen inzending er één stem bij.

Voor deze methode wordt de [Participatory budgeting](/openstad/manual/modules/participatory-budgeting)-widget gebruikt. Plaats deze widget op een pagina. De volgende instellingen zijn in dit geval de belangrijkste:

* ‘Enable voting’: Afhankelijk of het stemproces wel of niet open is.
* Voting type: Budgeting per thema&#x20;
* Available Budget: vul hier het beschikbare budget in.

Voor deze vorm van stemmen zijn er belangrijke instellingen in [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global):

* Info > Thema’s. Voor elk thema:
  * (Name)
  * Wat is de kleur van dit thema (momenteel alleen voor Budgeting per thema): verwijzen naar HEX-kleuren
  * Available Budget (momenteel alleen voor Budgeting per thema)
  * Minimum budget that has to be selected (momenteel alleen voor Budgeting per thema). Als je minimum instelt, moet dat minimum bij deze thema gekozen worden.&#x20;

Er zijn daarnaast ook bepaalde instellingen in het [Adminpanel](/openstad/manual/miscellaneous/adminpanel). De volgende instellingen zijn in dit geval de belangrijkste:

* Settings
  * Voting
    * ‘Is the vote count publicly available?’: Maak hier een bewuste keuze.
    * ‘Is voting active?’: Afhankelijk of het stemproces wel of niet open is.
    * ‘What type of voting is available?’: Kies voor ‘Budgeting per thema’.
    * ‘What is min budet users can vote for?’: tel het totaal op, **niet** per thema!
    * ‘What is max budget users can vote for?’: tel het totaal op, **niet** per thema!
* Let op: plannen moeten een budget hebben om dit goed te laten werken. &#x20;

### Maximaal aantal kiezen

Bij deze variant is er bepaalde aantal inzendingen die bewoners mogen kiezen. Bewoners kunnen inzendingen kiezen zolang het totale aantal van de gekozen inzendingen het beschikbare aantal niet overschrijden. Als bewoners tevreden zijn over hun keuze en het stemproces afronden, krijgt elke door de bewoner gekozen inzending er één stem bij.

Voor deze methode wordt de [Participatory budgeting](/openstad/manual/modules/participatory-budgeting)-widget gebruikt. Plaats deze widget op een pagina. De volgende instellingen zijn in dit geval de belangrijkste:

* ‘Enable voting’: Afhankelijk of het stemproces wel of niet open is.
* Voting type: Count
* Maximum selectable ideas
* Minimum selectable ideas

Er zijn daarnaast ook bepaalde instellingen in het [Adminpanel](/openstad/manual/miscellaneous/adminpanel). De volgende instellingen zijn in dit geval de belangrijkste:

* Settings > Voting
  * ‘Is the vote count publicly available?’: Maak hier een bewuste keuze.
  * ‘Is voting active?’: Afhankelijk of het stemproces wel of niet open is.
  * ‘What type of voting is available?’: Kies voor ‘Count’.
  * ‘What is min amount of ideas users can vote for?’:&#x20;
  * ‘What is max amount of ideas users can vote for?’:&#x20;

## Stemfase sluiten

Als een stemfase ten einde komt, kan je op verschillende manieren de stemming sluiten.

* Een actie inplannen om automatisch te laten sluiten. Zie meer infomatie:[Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#acties)
* Handmatig de instelling "Is voting active?" aanpassen in  [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#site-settings)

Let op: hiermee sluit de 'achterkant' van de site en worden geen stemmen meer toegelaten. Maar op de voorkant van de site, de pagina, lijkt het misschien alsof je nog wel kan stemmen. Zorg dat je de nodige veranderingen doorvoert op de pagina's zelf, bijvoorbeeld in tekst of de widgets.&#x20;


# Gebruikersbeheer

{% hint style="info" %}
Dit artikel behandeld functionaliteiten die aan gebruikers zelf aangeboden kunnen worden. Er is daarnaast ook functionaliteit voor moderators/admins, om alle gebruikers van een website te anonimiseren. Zie daarvoor dit artikel:[Gebruikers anonimiseren per website](/openstad/manual/how-tos/gebruikers-anonimiseren-per-website).
{% endhint %}

## Verschillende functionaliteiten

'Gebruikersbeheer' is een breed begrip, waar onderstaande functionaliteiten onder worden verstaan.

### Activiteit

Het activiteitenoverzicht laat de activiteiten zien die met het ingelogde account gedaan zijn. Ook de activiteiten op andere websites, maar met hetzelfde account, worden getoond. De activiteiten die in dit overzicht getoond worden, zijn:

* inzendingen die gedaan zijn
* reacties die bij inzendingen geplaatst zijn
* stemmen die op inzendingen uitgebracht zijn

![Activiteitenoverzicht](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F8ZDzeF07iEvTqlu8l15B%2FActiviteit.png?alt=media\&token=1fc8345c-27e6-4248-9fee-6359459b38b3)

### Gegevens

Gebruikers kunnen hun gegevens aanpassen met een formulier. Optioneel kan per website voor gebruikers de mogelijkheid geactiveerd worden om een schermnaam (of *alias*) in te voeren, als een gebruiker niet onder diens eigen naam op een website actief wil zijn. Deze mogelijkheid kan ingeschekeld worden in het (beta) adminpanel: [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin).

![Formulier om gegevens in account te bewerken](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F2LUuu7sHskEBzlo6rXOV%2FGegevens.png?alt=media\&token=2b50e715-6f29-4cbb-b174-77c074b6c5ab)

### Andere websites

Het 'Andere sites'-overzicht toont de andere websites waar de gebruiker met het ingelogde account actief is geweest.

![Overzicht van andere websites waar de gebruiker dit account heeft gebruikt](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FYE7Lj7YlyMo2XXJIAlMD%2FAndere%20websites.png?alt=media\&token=3fcdfe37-7dd6-48e3-addf-5e304af4137f)

### Gegevens verwijderen

Gebruikers hebben de mogelijkheid om alleen voor specifieke projecten hun gegevens te verwijderen. Dit heeft wel gevolgen voor:

* **Inzendingen** - Inzendingen die de gebruiker heeft gedaan blijven bewaard en op de website staan, maar niet meer onder de naam van de gebruiker. Het zal voor de gebruiker niet meer mogelijk om de inzendingen te bewerken of te verwijderen.
* **Argumenten en reacties** - Argumenten en/of reacties die de gebruiker heeft geplaatst blijven bewaard en op de website staan, maar niet meer onder de naam van de gebruiker. Het zal voor de gebruiker niet meer mogelijk zijn om de argumenten en/of reacties te bewerken of te verwijderen.
* **Stemmen en likes** - Stemmen en/of likes van de gebruiker op inzendingen bij actieve projecten worden ongeldig gemaakt. Of een project als 'actief' beschouwd wordt, heeft te maken met de *Project has ended* instelling in het [(beta) adminpanel](/openstad/manual/miscellaneous/adminpanel-beta-react-admin). Als project is beëndigd, en de gebruiker verwijderd diens account, dan blijven stemmen en/of likes wel bewaard.

Om te voorkomen dat gebruikers per ongeluk hun gegevens verwijderen, wordt er gevraagd om een zin over te schrijven te bevestiging dat de gebruiker weet welke gevolgen de actie heeft.

![Interface om gegevens van account te verwijderen](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F95e0UKnjyZ7Urx1EvEsN%2FGegevens%20verwijderen.png?alt=media\&token=c366e4ac-064e-4808-895e-2efa0a72f0c3)

## Gebruikersbeheer toevoegen aan website

Omdat de verschillende gebruikersbeheer functionaliteiten elk uit hun eigen widgets opgebouwd moeten worden, kunnen deze naar wens flexibel worden ingezet.

### Page Settings

Om te beginnen is het belangrijk dat de pagina waarop de gebruikersbeheer widgets geplaatst worden, de juiste instellingen heeft.

Zorg in ieder geval dat je de volgende instellingen gebruikt:

| Instelling | Waarde      |
| ---------- | ----------- |
| Type       | Resource    |
| Resource   | Active User |

{% content-ref url="/pages/m4tstuTUTYKQxcUIFiZV" %}
[Page Settings](/openstad/manual/miscellaneous/page-settings)
{% endcontent-ref %}

### Column sections (optioneel)

Niet verplicht, maar speciaal voor gebruikersbeheer is er aan de 'column section'-widget de mogelijkheid toegevoegd om tabbladen te kunnen gebruiken. Dit is nodig om dezelfde opzet op te bouwen, zoals hierboven in dit artikel wordt getoond op de screenshots.

| Instelling | Waarde |
| ---------- | ------ |
| Columns    | Tabs   |

Vervolgens moet je de tabs nog instellen:

| Title                | Area name |
| -------------------- | --------- |
| Activiteit           | Area 1    |
| Gegevens             | Area 2    |
| Andere websites      | Area 3    |
| Gegevens verwijderen | Area 4    |

{% hint style="info" %}
Tip: gebruik ín elke tab nogmaals een *column* widget met een 66%-33% instelling, om de layout niet te breed te maken.
{% endhint %}

{% content-ref url="/pages/pI5JSuio66HCLV1BlsFA" %}
[Columns](/openstad/manual/modules/section-columns)
{% endcontent-ref %}

### Widgets voor verschillende functionaliteiten

#### Activiteit

Het activiteitenoverzicht kan getoond worden met een 'Resource representation'-widget met de volgende instellingen:

| Instelling     | Waarde        |
| -------------- | ------------- |
| Representation | User activity |

{% content-ref url="/pages/jnqtZf8p3qtuR1osIT8F" %}
[Resource representation](/openstad/manual/modules/resource-representation)
{% endcontent-ref %}

#### Gegevens

Het gegevensformulier kan getoond worden met een 'Resource form'-widget met de volgende instellingen:

| Instelling             | Waarde      |
| ---------------------- | ----------- |
| Resource (from config) | Active User |

{% content-ref url="/pages/RacgbV5yBHtx1fI2V27z" %}
[Resource form](/openstad/manual/modules/resource-form)
{% endcontent-ref %}

#### Andere websites

Het 'Andere websites'-overzicht kan getoond worden met een 'Resource representation'-widget met de volgende instellingen:

| Instelling     | Waarde            |
| -------------- | ----------------- |
| Representation | User active sites |

{% content-ref url="/pages/jnqtZf8p3qtuR1osIT8F" %}
[Resource representation](/openstad/manual/modules/resource-representation)
{% endcontent-ref %}

#### Gegevens verwijderen

Het 'Gegevens verwijderen'-formulier kan getoond worden met de volgende widget:

{% content-ref url="/pages/T2PWbnOWfWd60BNk5CMg" %}
[User remove form](/openstad/manual/modules/user-remove-form)
{% endcontent-ref %}


# Gebruikers anonimiseren per website

{% hint style="info" %}
Dit artikel behandeld functionaliteiten voor moderators/admins. Er is daarnaast ook functionaliteit die aan gebruikers zelf aangeboden kunnen worden, om hun account en gegevens te beheren. Zie daarvoor dit artikel: [Gebruikersbeheer](/openstad/manual/how-tos/gebruikersbeheer).
{% endhint %}

Het anonimiseren van alle gebruikers op een website gaat in twee stappen:

#### Project has ended

Voordat de gebruikersgegevens geanonimiseerd kunnen worden, moet ingesteld worden dat het project beëindigd is. Dit doe je in het (beta) adminpanel me volgende instelling:

| Instelling        | Waarde     |
| ----------------- | ---------- |
| Project has ended | Yes / True |

{% content-ref url="/pages/iBEoSt77vWsf8o15ZdQB" %}
[Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin)
{% endcontent-ref %}

#### Gebruikersgegevens anonimiseren

Als het project als 'beëindigd' is gemarkeerd, dan kan via het adminpanel de gebruikersgegevens geanonimiseerd worden.

{% hint style="danger" %}
**Pas op!** Zorg dat je weet wat je doet. Het anonimiseren van alle gebruikers van een website is onomkeerbaar. Als je gebruikers van een website anonimiseert, dan verwijder je bij die website alle persoonsgegevens. Daarmee verdwijnen alle gebruikersgegevens van de inzendingen, reacties en stemmen/likes. Daardoor kunnen gebruikers ook niet meer hun inzendingen, reacties en stemmen/likes nog bewerken of verwijderen. Ook verdwijnt het project uit het 'Actieve websites'-overzicht van het gebruikersaccount, zie [Gebruikersbeheer](/openstad/manual/how-tos/gebruikersbeheer).
{% endhint %}

{% content-ref url="/pages/5r9FfFjykBwrTnBqA0y8" %}
[Adminpanel](/openstad/manual/miscellaneous/adminpanel)
{% endcontent-ref %}


# Inzendingen exporteren en importeren

<figure><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FzoMe0Rct0OFBTe5iXcQH%2Fafbeelding.png?alt=media&amp;token=ad44fc11-2f76-4def-854a-8cab0279cfe1" alt=""><figcaption><p>Screenshot van react admin, waar je plannen kan importeren en exporteren</p></figcaption></figure>

## Inzendingen exporteren

De inzendingen die binnen komen op een site kun je met een druk op de knop exporteren.

* Ga naar [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin)&#x20;
  * [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#plannen) en [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#argumenten) kun je exporteren
* Export als XLSX of CSV
  * [Meer info over CSV bestanden](https://nl.wikipedia.org/wiki/Kommagescheiden_bestand)

### Uitleg over de verschillende kolommen&#x20;

<table><thead><tr><th width="246"></th><th></th></tr></thead><tbody><tr><td>id</td><td></td></tr><tr><td>siteId </td><td></td></tr><tr><td>userId </td><td></td></tr><tr><td>startDate </td><td></td></tr><tr><td>startDateHumanized </td><td></td></tr><tr><td>endDate </td><td></td></tr><tr><td>sort </td><td></td></tr><tr><td>typeId </td><td></td></tr><tr><td>status </td><td></td></tr><tr><td>viewableByRole </td><td></td></tr><tr><td>title </td><td></td></tr><tr><td>summary </td><td></td></tr><tr><td>description </td><td></td></tr><tr><td>budget </td><td></td></tr><tr><td>location </td><td></td></tr><tr><td>modBreak; modBreakUserId ; modBreakDate </td><td></td></tr><tr><td>no </td><td></td></tr><tr><td>yes </td><td></td></tr><tr><td>progress </td><td></td></tr><tr><td>createDateHumanized publishDate publishDateHumanized createdAt updatedAt deletedAt createdAtText</td><td></td></tr><tr><td>extraData.area</td><td></td></tr><tr><td> extraData.role </td><td></td></tr><tr><td>extraData.phone </td><td></td></tr><tr><td>extraData.theme </td><td></td></tr><tr><td>extraData.images </td><td></td></tr><tr><td>extraData.estimate </td><td></td></tr><tr><td>position.lat position.lng </td><td></td></tr><tr><td>user.id user.role user.displayName user.nickName user.firstName user.lastName user.email</td><td></td></tr></tbody></table>

Let op: er kunnen nog meer kolommen zijn indien je die heb toegevoegd als extra velden in je resource form!&#x20;

## Inzendingen importeren

Het is ook mogelijk om inzendingen te importeren. Dit wordt voornamelijk gebruikt in 2 verschillende situaties:

* Als burgers plannen hebben upgeload in een voorgaande fase en je een nieuwe site gaat inrichten met een nieuwe versie van deze plannen. Bijvoorbeeld de transitie van planindien fase naar stemfase van een participatief begroten proces.
* &#x20;en op een nieuwe site en deze, lees meer bij usecases hoe dit gebruikt wordt.

Importen kan via een CSV bestand. De bekende excel programma's kunnen exporteren naar CSV. De export verwacht dezelfde headers als de import, dit zijn:

* id
* siteId
* meetingId
* status
* title
* summary
* description
* budget
* location
* modBreak
* modBreakUserId
* modBreakDate
* extraData.area
* extraData.theme
* extraData.role
* extraData.estimate
* extraData.images

\##Fouten bij importeren door validatie Het kan gebeuren dat er bij importeren iets misgaat. Dit gebeurd bijvoorbeeld als een plan niet aan de ingestelde validatie regels voldoet.

\##Formaat fouten bij importeren Het geaccepteerde formaat voor importeren is CSV (comma seperated values) of TSV (tab seperated values). Excel, number (mac) en google drive kunnen allen exporteren naar dit formaat. In sommige gevallen gaat dit mis omdat een andere teken gebruikt wordt dan een comma. Bijv een ;. Dit kan je aangeven

\##Gekke tekens na importeren Het kan gebeuren dat na importeren (of exporteren) ineens gekke characters verschijnen. Dit heeft er mee te maken dat er verschillende "charsets" bestaan. In dit geval kies bij importeren (of exporteren) gekozen wordt voor utf-8,

* Importeren
  * CSV bestand
    * Korte uitleg en link naar wikipedia over bestandsformaat
  * Voorbeeld: exporteren vanuit Excel
    * Kort uitleggen, verwijzen naar externe bron met meer uitleg
    * Checken: delimiter teken
  * Verschil tussen toevoegen en updaten


# Vormgeving & logo aanpassen

There are several ways to style elements & the website: modules have CSS setting, there is a pallette that allows some colors to be changed and to upload a custom logo. For more complex styling changes it's possible to upload a custom CSS sheet.

The negative site of using CSS directly is that it's a bit more complex to learn. The positive site it's a very well known system with lot of only documentation.

## Aanpassen van een logo

Een logo kan online upgeload worden worden. Dit kan voor desktop en los voor mobiel, voor sommige steden waaronder Amsterdam. ![Logo in global](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-21a7d3d8001245430e356ce2b969e6cb47d972db%2Flogo-in-global.png?alt=media)

Let op: dit logo wordt gedeeld met de authenticatie applicatie en e-mails. Echter hebben dit gedeelte van de applicatie geen “draft” status zoals in het CMS beschikbaar is. Dit betekent dat logo pas zichtbaar is bij inloggen en e-mail zodra deze “commit” wordt.

## Customize basic styling with the palette (colors & logo)

![Palette in menu](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-ba1a123c2130f3f299d1afb9c3a819c085a10f82%2Fpalette-in-menu.png?alt=media)

![Palette open](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-ba54a98906a63b4caaf60a2983f173567f09de45%2Fpalette-open.png?alt=media)

## Customize widget styling with CSS

![Section layout](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-f9dcee717a0879b0f4a96c473f13c02c0e43ec53%2Fmodule-styles.png?alt=media)

## Customize site styling external stylesheet


# E-mail notificaties

Het is mogelijk om verschillende notificatie e-mails in te stellen:

1. Notificatie naar gebruiker bij inloggen.&#x20;
2. Notificatie naar gebruiker bij inzending.&#x20;
3. Notificatie naar gebruiker bij submission.
4. Notificatie naar admin bij nieuwe inzending.&#x20;
5. Notificatie naar admin bij nieuwe reactie.
6. Notificatie naar admin bij submission.

### 1. Notificatie naar gebruiker bij inloggen

De gebruiker ontvangt een e-mail met inloglink na het inloggen. De inhoud en vorm van deze e-mail kun je instellen in het [admin panel](/openstad/manual/miscellaneous/adminpanel) bij *Authentication & security*.

{% hint style="info" %}
HIER VOORBEELD VAN NOTIFICATIE E-MAIL TOEVOEGEN?
{% endhint %}

### 2. Notificatie naar gebruiker bij inzending

De gebruiker ontvangt een e-mail na het insturen van een inzending. De inhoud en vorm van deze e-mail kun je instellen in het [admin panel](/openstad/manual/miscellaneous/adminpanel) bij *Site settings* en vervolgens *Ideas.*

{% hint style="info" %}
HIER VOORBEELD VAN NOTIFICATIE E-MAIL TOEVOEGEN?
{% endhint %}

### 3. Notificatie naar gebruiker bij submission&#x20;

De gebruiker ontvangt een e-mail na het insturen van een submission. Een submission gebruik je bijvoorbeeld voor een inschrijfformulier. De inhoud en vorm van deze e-mail kun je instellen in de [resource form ](/openstad/manual/modules/resource-form)bij *Confirmation*.&#x20;

{% hint style="info" %}
HIER VOORBEELD VAN CONFIRMATION RESOURCE FORM TOEVOEGEN?
{% endhint %}

### 4. Notificatie naar admin bij nieuwe inzending

De admin ontvangt een e-mail bij elke inzending van een gebruiker. De inhoud en vorm van deze e-mail is geautomatiseerd en kun je niet zelf instellen in het admin panel of CMS.

Je kunt wel bepalen vanaf en aan welk e-mailadres de notificatie verstuurd wordt. Ga in het [admin panel](/openstad/manual/miscellaneous/adminpanel) naar *Site settings* en vervolgens *Admin notifications.* Vul bij 'To e-mail address' het e-mailadres van de admin in. Vul bij 'From e-mail address' de naam van jouw organisatie en het no-reply adres in, bijvoorbeeld: Mijn Organisatie <<noreply@openstadmijnorganisatie.nl>

{% hint style="info" %}
HIER VOORBEELD VAN NOTIFICATIE E-MAIL TOEVOEGEN?
{% endhint %}

### 5. Notificatie naar admin bij nieuwe reactie

De admin ontvangt een e-mail bij elke nieuwe reactie die een gebruiker plaatst bij een inzending. De inhoud en vorm van deze e-mail is geautomatiseerd en kun je niet zelf instellen in het admin panel of CMS.&#x20;

Je kunt wel bepalen vanaf en aan welk e-mailadres de notificatie verstuurd wordt. Zie de beschrijving hierboven.&#x20;

{% hint style="info" %}
HIER VOORBEELD VAN NOTIFICATIE E-MAIL TOEVOEGEN?
{% endhint %}

### 6. Notificatie naar admin bij submission.

De admin ontvangt een e-mail bij elke nieuwe submission van een gebruiker. De inhoud en vorm van deze e-mail kun je instellen in de [resource form ](/openstad/manual/modules/resource-form)bij *Confirmation*.&#x20;


# Widgets referentie

Bekijk in deze hoofdstuk welke widgets beschikbaar zijn en hoe ze werken.


# Accordeon

Met een *accordeon* kun je stukken tekst in-/uitklapbaar maken om ruimte te besparen op de pagina. Een *accordeon* wordt bijvoorbeeld vaak gebruikt voor ‘Veelgestelde vragen’-pagina’s.

![Accordeon](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fgit-blob-fa0d8e52bdd5e13b8f1d03211199d3c79002d11a%2Faccordeon.gif?alt=media)

Wil je uitgebreidere content kunnen in- en uitklappen? Gebruik dan de instelling *Toggle-section* van de widget [columns](/openstad/manual/modules/section-columns).

## Configuratie-opties

### General

* **Edit items:** Je voegt tekst toe aan het *accordeon* door items toe te voegen. Voor elk item vul je een *title* en *description* in. De *title* is altijd zichtbaar en bevat de titel of vraag. De *description* is alleen zichtbaar als je het accordeon uitklapt en bevat de omschrijving of het antwoord. &#x20;

### Styling

* **Styles for the container:** Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Agenda

Met een agenda kan je de planning/tijdlijn aangeven van het project. Het is belangrijk om dit transparant aan te geven zodat deelnemers van het project weten hoe het proces verloopt, waar ze in het proces staan, en wat er nog volgt.

![Voorbeeld agenda](https://lh6.googleusercontent.com/HLqwa0x7bUqs2H7ANls09iUcI2YzkprwvRXLLD4vvXTou-kwngsvlcGyXiUx0fVP_ODXMbOnXGZ42K6qTSwntZrWXKaNUdSK77w0fVXVb-tAIZGz5piTRsqQn3fcDqprtGI6Vmqq)

## Configuratie-opties

### General

* Items: je voegt data/periodes toe aan de agenda door items toe te voegen. Voor elk item, vul je een *title, description,* en of het een *period* of een *moment* is. Een *period* is een langere balk en geschikt voor een periode aan tijd, een *moment* is een witte stipje met blauwe grens en geschikt voor een specifiek dag of moment. Zie voorbeeld hierboven voor het verschil.&#x20;
* Optioneel kun je een *link* toevoegen bij een moment.&#x20;

### Styling&#x20;

* Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Arguments

Met *arguments* kan je een lijst aan argumenten tonen die geplaatst zijn op een idee, bijvoorbeeld als reactie vanuit andere gebruikers.&#x20;

{% hint style="info" %}
Voorheen waren arguments gebouwd uit de widgets "Arguments form old" (typen van reacties) en "Arguments old" (tonen van reacties). Deze zijn (op moment van schrijven) nog beschikbaar in de widgets lijst, maar je kan beter deze nieuwe widget gebruiken.&#x20;
{% endhint %}

![Voorbeeld argumenten widget in gebruik](https://lh4.googleusercontent.com/_Go6JNzbc8NMHIEFaqHGfNhmoBvAsN5-D2LtP9uvtSPRrr3qPD44W8_Ve4E_4I5um2VwexhyNToqQE_ILo0hnai3WuRDe3ledVhLWe-z3rfy-b34XsSItBqKavNxc1ve5cNQJOxU)

## Configuratie-opties

### General

* Algemeen:&#x20;
  * *sentiment* pas je aan als argumenten voor/tegen aparte formuliertjes zijn. Anders gebruik je *no sentiment,* dan zijn het gewoon opmerkingen.
  * *replying* of *voting for reactions:* Hiermee kun je instellen of gebruikers kunnen reageren op een geplaatst argument, en of ze een duimpje omhoog geven.&#x20;
* Lijst:
  * *Title*: De title die boven de argumenten komt
  * *Placeholder tekst*: de tekst die verschijnt als nog geen gebruikers een opmerking hebben geplaatst.
* Formulier
  * *Form intro*: optionele introductie tekst bovenaan waar gebruikers opmerkingen kunnen plaatsen.
  * *Placeholder tekst*: de tekst die verschijnt in het invul-balkje als een gebruiker nog niks heeft geschreven.
* Info:
  * Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)

## Sluiten mogelijkheid om argumenten te plaatsen

Aan het einde van de reactietermijn, kun je arguments 'uitzetten', zodat gebruikers geen reacties meer kunnen plaatsen. Dat gaat als volgt:

* via [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin) > Site settings > Arguments
* doe het schuifje aan: "Adding of arguments is closed?"


# Columns

*Columns* is een widget om secties en kolommen te creëren.&#x20;

Je maakt natuurlijk al *columns* bij het [vullen van een pagina](/openstad/manual/how-tos/edit-page#sections-en-columns), maar je kan ook kolommen binnen kolommen maken. Daarmee kan je de pagina precies opmaken zoals je wilt.&#x20;

{% embed url="<https://drive.google.com/file/d/1NkZsrcXylCNnFiKoiNs9LEwmVdyihdCg/view?usp=sharing>" %}
In dit filmpje zie je hoe je kolommen toevoegt als widget binnen bestaande kolommen
{% endembed %}

## Configuratie-opties

### Basic

* *Columns:* selecteer hoe je deze sectie wilt indelen. **Let op:** sommige widgets hebben een specifieke column indeling nodig. Indien dit het geval is wordt het benoemd bij de omschrijving van de widget.&#x20;

### Toggle section

* *Show section as toggle-section:*&#x20;
  * No - het is niet open en dicht te klappen.&#x20;
  * Yes - het is wel open en dicht te klappen (hiermee lijkt het op een accordeon).&#x20;
    * *Title of the toggle-section:* welk titel er boven aan de uitklapbare balk staat
    * *Toggle-section open by default?:* Indien yes, staat deze sectie automatisch open en kunnen gebruikers het dichtklappen. Indien nee, staat deze sectie niet automatisch open en kunnen gebruikers het dus openklappen.
    * *Show toggle-section on mobile only:* Hiermee kun je instellen dat het aan/uitklap functie alleen voor mobiele gebruikers is. Soms wil je een pagina anders inrichten voor gebruikers op mobiel, want die zien meer informatie geconcentreerd op een kleinere scherm. Met toggle sections kan hun ervaring prettiger worden.

![Voorbeeld toggle section](https://lh4.googleusercontent.com/XVQbr50t4CFpyWrO_EHaXwUkZ9TGevOhh6idUs7_NoG8E7CYP4qR0kaLWJfJPPPLJa6CRq3fSKyuLbOPzH01qzPSkybizBkbCBaRIoq4p16yKmNTS-M_SSwmEWIlRiPeE24iSrqv)

### Styling&#x20;

* Background color and background image: Hiermee kun je instellen of je een achtergrond foto of kleur wilt gebruiken voor je sectie.
* Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)

### Advanced

* *<mark style="color:orange;">Margin type:</mark>*&#x20;
* *<mark style="color:orange;">HTML ID:</mark>*
* *<mark style="color:orange;">HTML class:</mark>*

### Tabs

* *Tabs:* met tabs kun je tabbladen aanbrengen in je column.&#x20;
  * Edit tabs > Title: vul hier de titel in van je tabblad
  * Area name: Geef ieder tabblad een nieuwe area, oplopend. Dus als je 3 tabs gaat gebruiken, gebruik dan area 1, 2, en 3.&#x20;

![Voorbeeld tabbladen](https://lh6.googleusercontent.com/-vZ1mT56b5xzmq1I4cAAYydTa6YcJ3WnAFV7mlW0xADuIHiiU6ZsABHUTsguqcdsRUZYE-qmxl73o9pJ3irXhN2lBjVl7dRkYEVvY0ku96LptZd-lncxmPp167mo0-0ZIY6wNnjd)

### Info

* *Toggle arrow color:* selecteer hiermee welke kleur het pijltje is waarmee je een sectie open- en dichtklapt.


# Slider

Met de slider kun je meerdere afbeeldingen in een blok plaatsen. Met pijltjes links en rechts bekijk je de verschillende afbeeldingen.

### Configuratie-opties

### Edit items

Voeg de slider in en druk op Edit items. De eerste afbeelding voor in je slider kun je gelijk invullen.

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FFmUG1vEUFvEcf2Q3AROJ%2Fimage.png?alt=media\&token=f95f01b0-3c19-4f6f-b508-50c32c0af662)

Druk op Add item om een afbeelding toe te voegen.

### Voorbeeld van de slider

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FWWnJWGAIRN1uBP9Rqc6v%2Fimage.png?alt=media\&token=9e047eed-93b8-491f-8781-a6db85788dcc)

### Styling

Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Counter

Een *counter* widget kan een paar verschillende dynamische elementen tellen, zoals het aantal ideen of plannen die zijn ingestuurd op een website.&#x20;

![Voorbeeld counter](https://lh5.googleusercontent.com/e4Yb-6jrTeT9WS04gZjA3rvnSlVbQPN7JsOts7oilXUMDG_ob94_tADqeMv7bVmzEemCm7jaRo_Hv2369Wz2MnHLMbR3eFTx1jKOkNJSqy8p2Clt5cU7sLbIhSFVmwirY0m3Z1eM)

Met *counter* heb je maar een paar instellingen:

* *Label*: De tekst die verschjint naast de counter, zoals 'plannen'.
* *Url*: Optioneel kan je een url toevoegen, waar gebruikers naar toe worden geleid als ze de counter klikken.
* *Select dynamic counter*: Hier selecteer je wat geteld en getoond wordt.&#x20;
  * *Idea count*: het aantal [ingestuurde inzendingen](/openstad/manual/how-tos/upload-ideas)&#x20;
  * *Vote count*: het totaal aantal stemmen die binnen zijn. (Als gebruikers bijvoorbeeld op meerdere inzendingen mogen stemmen, en 1 persoon stemt op 3 inzendingen, dan telt dat als 3 stemmen).&#x20;
  * *Voted user count*: het aantal gebruikers die een stem hebben uitgebracht (Als 1 persoon op 3 inzendingen stemt, dan telt het als 1 *voted user*).
  * *Static count*: TODO&#x20;
  * *Choices guide count*: TODO&#x20;
* Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Date countdown bar

De *date countdown bar* is een dynamisch element wat je laat aftellen tot een bepaalde datum. Je kan het bericht die verschijnt in het balk instellen voor en na de gekozen datum.&#x20;

![Voorbeeld countdown bar](https://lh6.googleusercontent.com/DitdIpMFuIC178AjfrWxF5AQg9lKUOpvvtzyA56CM0RWRUxZTMuv5lJsrY8fw-TUhQ3Zqpz4eRW-hLzIK7omRX-9nWLVJ7q_43P60PWY21kd78nNDsx-vRcF4fy6UKOhbd_2vHW6)

## Configuratie-opties

### General

* *Date:* selecteer een dag op de kalender naar waar je aftelt.&#x20;
* *Text to show before the set date has passed:* De tekst die in de balk verschijnt als de datum nog niet voorbij is. Bijvoorbeeld: 'Plannen indienen kan t/m 3 juli  5️⃣5️⃣ dagen '
* *Text to show after the set date has passed:* De tekst die in de balk verschijnt als de datum voorbij is. Bijvoorbeeld: 'Plannen indienen kon t/m 3 juli 0️⃣ dagen'.

### Styling&#x20;

* Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Ideas map

De *ideas map* biedt een kaartweergave van de inzendingen die zijn ingestuurd.

{% hint style="info" %}
HIER EEN SCREENSHOT TOEVOEGEN VAN IDEAS MAP?
{% endhint %}

## Configuratie-opties

De *ideas map* heeft een aantal instellingen die configureerbaar zijn.

{% hint style="info" %}
HIER EEN SCREENSHOT TOEVOEGEN VAN 'EDIT IDEAS MAP'?
{% endhint %}

### Map

| Instelling                 | Toelichting                                                                                                                                                                                                                    |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Flag links to details page | <p><strong>Yes</strong>: als de gebruiker klikt op de locator in de kaart, dan opent de detailpagina van die inzending.</p><p><strong>No</strong>: als de gebruiker klikt op de locator in de kaart, dan gebeurt er niets.</p> |
| Enable auto center         | <p><strong>Yes</strong>: de positie van de kaart is gecentreerd op basis van de polygoon en locators </p><p><strong>No</strong>: de positie van de kaart is willekeurig</p>                                                    |

### Call-To-Action Button

| Instelling         | Toelichting                                                                                                              |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------ |
| Display CTA button | <p><strong>Yes</strong>: CTA button toont op de kaart.</p><p><strong>No</strong>: CTA button toont niet op de kaart.</p> |
| CTA url            | Kies de url waarnaar de call to action moet verwijzen. Bijvoorbeeld /inzending-insturen                                  |
| CTA text           | Kies de tekst voor de call to action. Bijvoorbeeld 'Stuur je inzending in'.                                              |

### Counter

| Instelling      | Toelichting                                                                                                        |
| --------------- | ------------------------------------------------------------------------------------------------------------------ |
| Display counter | <p><strong>Yes</strong>: counter toont op de kaart.</p><p><strong>No</strong>: counter toont niet op de kaart.</p> |
| Counter text    | Kies de tekst die achter het aantal van de counter toont. Bijvoorbeeld 'inzendingen'                               |

### Content

| Instelling                           | Toelichting                                                                                                                                                                                          |
| ------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Show only following ideas            | Voer de id's van specifieke inzendingen in als je alleen die inzendingen wilt tonen. Gebruik bij meerdere inzendingen altijd een komma als scheidingsteken. Bijvoorbeeld: 887, 901, 944, 957         |
| Exclude ideas with this theme        | Voer de naam van een thema in als je de inzendingen van een specifiek thema niet wilt tonen. Gebruik bij meerdere thema's altijd een komma als scheidingsteken. Bijvoorbeeld: fysiek, sociaal, sport |
| Only show idea including this theme: | Voer de naam van een thema in als je alleen inzendingen van een specifiek thema wilt tonen. Gebruik bij meerdere thema's altijd een komma als scheidingsteken. Bijvoorbeeld: fysiek, sociaal, sport  |


# Ideeën op een kaart (Kaart applicatie)

Zie de volgende how-to voor meer algemene informatie over het gebruik van deze widget:

{% content-ref url="/pages/rFm9Ak9B0XFWS1cXDscq" %}
[Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart)
{% endcontent-ref %}

## Widget settings

{% hint style="warning" %}
Na het aanpassen van de instellingen van deze widget moet je de pagina herladen om de widget met bijgewerkte instellingen te tonen.
{% endhint %}

### Algemeen

<table><thead><tr><th width="196.73798681314753">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Weergave</td><td>Zet deze op <em>Volledig</em>. De optie <em>Simpel</em> is voor toekomstig gebruik om de 'Ideas map'-widget (zie <a data-mention href="/openstad/manual/modules/idea-map">Ideas map</a>) te vervangen, maar momenteel nog niet volledig functioneel.</td></tr><tr><td>Naam voor ideas</td><td>De waarde die je hier invult wordt gebruikt in de titel bovenaan de lijstweergave. Als je dit veld leeg laat, dan wordt "Inzendingen" gebruikt: "Inzendingen in dit gebied (xx)"</td></tr><tr><td>Veld voor type inzending</td><td>Hiermee kies je op basis van welke groep je op de kaart een onderscheid wil kunnen maken. Binnen die groep kun je visueel onderscheid maken met verschillende iconen (zie <a data-mention href="/openstad/manual/miscellaneous/interactieve-kaart-thema-iconen">Interactieve kaart thema iconen</a>), en de filter functionaliteit werkt op basis van deze groep. Het is het gemakkelijkst om hier voor <em>Thema</em> te kiezen. Voor meer geavanceerde websites kun je kiezen voor <em>Idee type</em>. Zowel thema's als idee types moeten gedefinieerd worden in <em>Global</em> (zie <a data-mention href="/openstad/manual/miscellaneous/openstad-hoofdmenu/global">Global</a>).</td></tr><tr><td>Label voor type in filters</td><td>Vul hier de tekst in die getoond moet worden in de filter dropdown bovenaan de kaart, als alle inzendingen getoond worden. Bijvoorbeeld "Alle inzendingen".</td></tr><tr><td>Op mobiel opent de lijst van ideeën over de kaart</td><td>Op mobiele apparaten wordt óf de kaart óf de lijstweergave getoond. Standaard wordt bij het openen van de pagina eerst de kaart getoond. Met deze instelling kun je kiezen om eerst de lijstweergave te tonen.</td></tr></tbody></table>

### Kaart

Onderstaande instellingen hebben betrekking op de kaart zelf.

| Instelling                                 | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Variant                                    | Hiermee kies je de kaart 'achtergrond', of eigenlijk uit welke bron de tegels waaruit de kaart opgebouwd is moeten worden opgehaald. *NLMaps* werkt voor alle gemeenten in Nederland. Voor Amsterdam is het volgens huisstijl verplicht om *Amsterdam* te gebruiken. Met de optie *Geavanceerd* kun je handmatig een andere 'tiles server' instellen.                                                                                                                                                                                                                         |
| Url van de tiles server                    | Alleen zichtbaar als je hierboven bij *Variant* voor *Geavanceerd* kiest. Gebruik dit veld om handmatig een andere 'tiles server' in te stellen.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Subdomains van de tiles server             | Alleen zichtbaar als je hierboven bij *Variant* voor *Geavanceerd* kiest. Gebruik dit veld om handmatig een andere 'tiles server' in te stellen.                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Zoom en center op                          | Kies hoe de kaart getoond moet worden (zoomniveau en middelpunt) als de pagina geladen wordt. Kies voor *Polygon* als je het totale begrensde gebied wil tonen. Hiervoor moet een polygon ingesteld zijn (zie [Polygonen](/openstad/manual/how-tos/polygonen)). Kies voor *Markers* om op inzendingen op de kaart te focussen. Als er geen inzendingen getoond worden, wordt teruggevallen op de polygon. Als er geen polygon ingesteld is, wordt teruggevallen op de map-instellingen van *Global* (zie [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global)). |
| Default Location icon                      | Als een locatie op de kaart geselecteerd wordt (niet een inzending), dan wordt er op die locatie een icoon getoond. Met deze instelling kun je handmatig een ander icoon kiezen. Hoe dit werkt lees je in [Interactieve kaart thema iconen](/openstad/manual/miscellaneous/interactieve-kaart-thema-iconen).                                                                                                                                                                                                                                                                  |
| Gevoeligheid van clustering                | Afhankelijk van het zoomniveau van de kaart, kunnen inzendingen dicht bij elkaar komen te liggen. Als deze te dicht bij elkaar komen, dan worden inzendingen geclusterd in één cirkel-icoon met het cijfer met het aantal geclusterde inzendingen. Door de waarde van deze instelling aan te passen bepaal je hoe snel dit moet gebeuren.                                                                                                                                                                                                                                     |
| Op de kaart klikken selecteert een locatie | Kies of het mogelijk is om een locatie te selecteren door op de kaart te klikken. Voor meer informatie over verschillende weergaves, zie [Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart#verschillende-weergaves)                                                                                                                                                                                                                                                                                                                                            |
| Op een kaart klikken                       | Kies wat er gebeurt als je op een inzending op de kaart klikt. De optie *Selecteert een idee* laat de 'Punt geselecteerd'-weergave zien zoals beschreven in [Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart#verschillende-weergaves). De optie *Toon idee details* opent direct de detailweergave.                                                                                                                                                                                                                                                           |

### Content

Deze sectie van de instellingen gaat over de invulling van het selectievlak (bovenste deel van het contentvlak, met grijze achtergrond) in verschillende omstandigheden, zoals beschreven in [Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart). Er kan hiervoor gewoon tekst gebruikt worden, maar er is de mogelijkheid om meer styling toe te voegen door HTML en CSS te gebruiken.

![Het selectievlak boven de lijstweergave in het contentvlak](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FPxXHU4mRAiPOJ018kaO9%2Fselectievlak.png?alt=media\&token=79f1cb08-c098-4007-9d47-36fa39656be0)

In de toelichting hieronder wordt beschreven in welk geval welke content getoond wordt. Hier staat ook aangegeven of er aanvullende elementen gebruikt kunnen worden, bijvoorbeeld buttons, linkjes en adresgegevens.

De benoeming van de verschillende weergaves wordt in meer detail uitgelegd onder [Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart#verschillende-weergaves).

{% hint style="warning" %}
In sommige gevallen kunnen er adresgegevens getoond worden van de geselecteerde locatie. Het is hiervoor belangrijk dat staat ingesteld in welke gemeente naar deze adresgegevens gezocht moet worden. Dit kun je instellen onder [#filterbalk](#filterbalk "mention").
{% endhint %}

| Instelling                          | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| ----------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| noSelectionLoggedInHTML             | <p><strong>Weergave</strong>: Niets geselecteerd<br><strong>Gebruiker is ingelogd</strong>: Ja<br><strong>Optionele elementen</strong>: Je kunt <code>{addButton}</code> gebruiken om gebruikers naar het indienformulier te leiden, maar er is nog geen locatie geselecteerd. Dat moet nog gebeuren terwijl het formulier getoond wordt, maar de interface is hier nog niet voor geoptimaliseerd. Het is beter om deze knop te tonen als er wel een locatie geselecteerd is, zie de instelling <em>selectionActiveLoggedInHTML</em>. </p> |
| noSelectionNotLoggedInHTML          | <p><strong>Weergave</strong>: Niets geselecteerd<br><strong>Gebruiker is ingelogd</strong>: Nee<br><strong>Optionele elementen</strong>: Je kunt <code>{loginButton}</code> gebruiken om een inlog-knop te tonen.</p>                                                                                                                                                                                                                                                                                                                      |
| noSelectionHTML                     | **Let op**: deze instelling is verouderd. Dit invoerveld is verouderd en wordt in de toekomst helemaal vervangen door *noSelectionLoggedInHTML* en *noSelectionNotLoggedInHTML*. Gebruik deze twee invoervelden, als deze nieuwe invoervelden in gebruik zijn, dan wordt dit verouderde invoerveld overschreven.                                                                                                                                                                                                                           |
| Toon het noSelection blok op mobiel | Kies of *noSelectionLoggedInHTML* en *noSelectionNotLoggedInHTML* ook op kleinere schermen getoond moet worden.                                                                                                                                                                                                                                                                                                                                                                                                                            |
| selectionActiveLoggedInHTML         | <p><strong>Weergave</strong>: (Nieuw) punt geselecteerd<br><strong>Gebruiker is ingelogd</strong>: Ja<br><strong>Optionele elementen</strong>: Gebruik <code>{address}</code> om het geselecteerde adres te tonen, en gebruik <code>{addButton}</code> om een knop te tonen die naar het indienformulier leidt.</p>                                                                                                                                                                                                                        |
| selectionInactiveLoggedInHTML       | <p><strong>Weergave</strong>: (Nieuw) punt geselecteerd, maar buiten het <a href="/openstad/manual/how-tos/polygonen">begrensde gebied</a>.<br><strong>Gebruiker is ingelogd</strong>: Ja<br><strong>Optionele elementen</strong>: Gebruik <code>{address}</code> om het geselecteerde adres te tonen.</p>                                                                                                                                                                                                                                 |
| mobilePreviewLoggedInHTML           | <p><strong>Weergave</strong>: (Nieuw) punt geselecteerd, in de preview die op kleine schermen getoond wordt. <br><strong>Gebruiker is ingelogd</strong>: Ja<br><strong>Optionele elementen</strong>: Gebruik <code>{address}</code> om het geselecteerde adres te tonen.</p>                                                                                                                                                                                                                                                               |
| selectionActiveNotLoggedInHTML      | <p><strong>Weergave</strong>: (Nieuw) punt geselecteerd<br><strong>Gebruiker is ingelogd</strong>: Nee<br><strong>Optionele elementen</strong>: Gebruik <code>{address}</code> om het geselecteerde adres te tonen en gebruik <code>{loginButton}</code> om een inlog-knop of <code>{loginLink}</code> om een inlog-link te tonen. Bij die laatste wil je waarschijnlijk wat aanvullende HTML gebruiken, bijvoorbeeld <code>\<a href="{loginLink}">Klik hier om in te loggen\</a></code>.</p>                                              |
| selectionInactiveNotLoggedInHTML    | <p><strong>Weergave</strong>: (Nieuw) punt geselecteerd, maar buiten het <a href="/openstad/manual/how-tos/polygonen">begrensde gebied</a>.<br><strong>Gebruiker is ingelogd</strong>: Nee<br><strong>Optionele elementen</strong>: Gebruik <code>{address}</code> om het geselecteerde adres te tonen.</p>                                                                                                                                                                                                                                |
| mobilePreviewNotLoggedInHTML        | <p><strong>Weergave</strong>: (Nieuw) punt geselecteerd, in de preview die op kleine schermen getoond wordt. <br><strong>Gebruiker is ingelogd</strong>: Nee<br><strong>Optionele elementen</strong>: Gebruik <code>{address}</code> om het geselecteerde adres te tonen.</p>                                                                                                                                                                                                                                                              |

Als er een inzending op de kaart geselecteerd is, dan toont het selectievlak altijd een tegel van de geselecteerde inzending, tenzij is ingesteld dat direct de detailweergave getoond moet worden.

### Sorteren

In de 'Niets geselecteerd'-weergave (zie [Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart)) kan er bovenaan de lijstweergave een dropdown getoond worden met verschillende mogelijkheden om de lijst te sorteren. De instellingen in deze sectie gaan hierover.

| Instelling                 | Toelichting                                                                                                              |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| Select sorting available   | Kies welke sorteermogelijkheden je beschikbaar wil maken. Kies er minimaal twee, anders kun je beter niets selecteren.   |
| Select the default sorting | Kies welke sorteren er standaard gebruikt wordt. Zorg dat je deze ook hierboven bij *Select sorting available* aanvinkt. |

### Idee afbeeldingen

Onderstaande instellingen gaan over de afbeelding(en) die bij inzendingen horen.

| Instelling                         | Toelichting                                                                                                                      |
| ---------------------------------- | -------------------------------------------------------------------------------------------------------------------------------- |
| Meerdere afbeeldingen bij een idee | Geef aan of de inzendingen op de kaart meerdere afbeeldingen (kunnen) hebben.                                                    |
| Aspect ratio                       | Kies de verhouding waarin de afbeeldingen getoond worden. *16:9* is een standaard 'breedbeeld' verhouding, en *1:1* is vierkant. |
| Default afbeelding                 | Hier kun je een afbeelding uploaden die getoond wordt bij een inzending, als de inzending zelf geen specifieke afbeelding heeft. |

### Idee details

Onderstaande instellingen hebben betrekking op de *detailweergave* van de interactieve kaart, zoals beschreven in [Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart#verschillende-weergaves).

| Instelling                                                                                      | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                               |
| ----------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Metadata regel template                                                                         | <p>Pas hier de regel aan die in de detailweergave boven de samenvatting van een inzending getoond wordt. Je kunt hier HTML en CSS voor gebruiken.<br><br>De volgende variabelen zijn beschikbaar:<br>- <code>{username}</code> : gebruikersnaam van de indiener van de inzending<br>- <code>{createDate}</code> : datum en tijd waarop de inzending aangemaakt is<br>- <code>{theme}</code> : thema van de instelling</p> |
| Link naar gebruikerspagina                                                                      | Als je in de metadata regel de gebruikersnaam van een inzending toont, dan kun je die met deze instelling aanklikbaar maken. Tip: gebruik een relatieve URL, bijvoorbeeld `/gebruikers`. Achter deze URL wordt automatisch het user-id van de auteur van de inzending geplakt, dat wordt dan bijvoorbeeld `/gebruikers/110`.                                                                                              |
| Display share buttons?                                                                          | Kies of er knoppen getoond worden om de huidige inzending te delen via bijvoorbeeld social media of e-mail.                                                                                                                                                                                                                                                                                                               |
| Select which share buttons you want to display (if left empty all social buttons will be shown) | Specificeer welke knoppen er getoond worden. Als je niets selecteert, dan worden alle knoppen getoond.                                                                                                                                                                                                                                                                                                                    |

### Filterbalk

Onderstaande instellingen hebben betrekking op de zoek- en filterbalk.

| Instelling                                  | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Waar wordt in gezocht                       | Je kunt kiezen of er gezocht wordt in de titels van inzendingen en/of naar adressen. Als je die laatste kiest, is het belangrijk om de instelling *Gemeente waarin naar adressen wordt gezocht* in te vullen. Je kunt ook kiezen om het zoekveld te verbergen.                                                                                                                                                       |
| Placeholder tekst in het zoekveld           | Kies welke tekst er als placeholder in het zoekveld getoond wordt, als er door de gebruiker geen andere tekst ingevoerd is.                                                                                                                                                                                                                                                                                          |
| Gemeente waarin naar adressen wordt gezocht | <p>Kies hier in welke gemeente er naar adressen gezocht kan worden. De naam van de gemeente die je hier invult dient overeen te komen met een naam uit <a href="https://nl.wikipedia.org/wiki/Lijst_van_Nederlandse_gemeenten">deze lijst van Nederlandse gemeenten op Wikipedia</a>.<br><br>Deze instelling wordt ook gebruikt om de adresgegevens op te halen als er op een locatie op de kaart geklikt wordt.</p> |

### Reacties

Onderstaande instellingen hebben betrekking op de reacties die (optioneel) onder de inhoud van een inzending in de detailweergave getoond worden.

| Instelling                                       | Toelichting                                                                                                                                                                                                                                                                                                                                                                                          |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Toon reacties                                    | Kies of er reacties getoond moeten worden onderaan de detailweergave.                                                                                                                                                                                                                                                                                                                                |
| Titel boven reacties                             | Pas de tekst van de titel aan die boven de reacties getoond wordt.                                                                                                                                                                                                                                                                                                                                   |
| Tekst in leeg reactie invoerveld                 | Voer de placeholdertekst in dat getoond wordt als het reactieveld nog leeg is.                                                                                                                                                                                                                                                                                                                       |
| Tekst boven reactie invoerveld                   | Kies welke tekst er getoond wordt boven het reactie invoerveld.                                                                                                                                                                                                                                                                                                                                      |
| Ids van Ideas waarvoor reacties niet actief zijn | Hier kun je specificeren voor welke inzendingen er geen reacties getoond moeten worden. Dit doe je door de *id*'s van deze inzendingen in te voeren, gescheiden door een komma. Bijvoorbeeld: `1256,1257,1259`. Hierdoor worden eventuele bestaande reacties verborgen. Wil je bestaande reacties wel tonen, maar de mogelijkheid om nieuwe reacties toe te voegen uitschakelen? Kijk dan hieronder. |
| Reactiemogelijkheid is...                        | Kies of de reactiemogelijkheid voor alle inzendingen open is, voor alle inzendingen gesloten, of slechts voor bepaalde inzendingen gesloten. Bij de laatste optie is het belangrijk dat je de instelling *Ids van Ideas waarvoor reacties gesloten zijn* invult.                                                                                                                                     |
| Tekst boven gesloten reacties blok               | Voer de tekst in die boven de reacties getoond moet worden, als de optie om te reageren uitgeschakeld is.                                                                                                                                                                                                                                                                                            |
| Ids van Ideas waarvoor reacties gesloten zijn    | Vul hier in voor welke specifieke inzendingen de reactiemogelijkheid gesloten is. Dit doe je door de *id*'s van deze inzendingen in te voeren, gescheiden door een komma. Bijvoorbeeld: `1256,1257,1259`.                                                                                                                                                                                            |

### Idee formulier

| Instelling  | Toelichting                                                                                                                                                                                                                                                                                                                                                                     |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Form Url    | <p>De widget heeft een geïntegreerd formulier. Wil je deze liever niet gebruiken? Vul hier dan de (relatieve) URL in van de pagina met een ander formulier (waarschijnlijk een <a data-mention href="/openstad/manual/modules/resource-form">/pages/RacgbV5yBHtx1fI2V27z</a>).<br><br>Hiermee worden de instellingen bij <em>Form fields</em> (hieronder) niet gebruikt.</p>    |
| Form fields | <p>Hiermee kun je het geïntegreerde formulier configureren. Zie hieronder de toelichting bij het instellen van de <em>Form fields</em>. Als je deze instelling leeg laat, dan wordt er een standaard formulier getoond.<br><br><strong>Let op</strong>: Als er hierboven bij <em>Form Url</em> een waarde ingevuld is, dan wordt het geïntegreerde formulier niet gebruikt.</p> |

#### Form fields

Toelichting op de instellingen van *Form fields.*

{% hint style="info" %}
Laat *Form fields* leeg om een standaard formulier te tonen.
{% endhint %}

{% hint style="warning" %}
Als je handmatig het formulier instelt, is het belangrijk dat je op zijn minst de volgende velden aanmaakt:

* title
* summary
* description
  {% endhint %}

| Instelling                                    | Toelichting                                                                                                                                                                                                                                                            |
| --------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name of the database field                    | Kies hier voor welk onderdeel van een inzending (of *idea*) je een veld in het formulier wil aanmaken. Het is hierbij belangrijk dat je de juiste waarden in vult, zoals die vermeld staan in [Inzendingen (ideas)](/openstad/manual/miscellaneous/inzendingen-ideas). |
| Title                                         | Geef een titel van het veld in het formulier.                                                                                                                                                                                                                          |
| Beschrijving                                  | Geef een toelichting bij het veld in het formulier.                                                                                                                                                                                                                    |
| Type veld                                     | Kies wat voor een soort veld getoond moet worden.                                                                                                                                                                                                                      |
| Keuzes (enkel voor multiple choice of select) | Geef hier aan welke keuzemogelijkheden er voor dit veld zijn. Dit is niet bij elk veld van toepassing.                                                                                                                                                                 |
| Is verplicht                                  | Geef aan of dit veld in het formulier verplicht ingevuld moet worden.                                                                                                                                                                                                  |

### Info

| Instelling               | Toelichting                                                                              |
| ------------------------ | ---------------------------------------------------------------------------------------- |
| Styles for the container | Zie [Styles for the container](/openstad/manual/miscellaneous/styles-for-the-container). |


# iFrame

Een *iFrame* is een stukje HTML-code dat een frame uit een andere website op kan roepen en dus op jouw website kan plaatsen. Denk hierbij bijvoorbeeld aan een YouTube filmpje.

## Configuratie-opties

### General

* *Url:* Hier voer je het stukje HTLM-code in om de frame op te halen.

### Styling&#x20;

* Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Image

Plaats een afbeelding op je webpagina om de tekst te verduidelijken.

**Let op: maak de afbeelding eerst  in het gewenste formaat en de juiste resolutie in een fotobewerkingsprogramma.**

* Kies de sectie waar je de afbeelding wilt plaatsen
* Druk op +
* Kies Image
* Je ziet nu het onderstaande scherm

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FMgw0iuOgZSFet2fwmEba%2Fimage.png?alt=media\&token=25929e01-9554-4adc-a082-0bca4724f040)

* Upload het bestand (jpg of png, bij voorkeur niet groter dan 200kb)
* Een preview verschijnt
* Geef de afbeelding een titel en alt-tekst (voor toegankelijkheid, beschrijf de afbeelding)
* Wil je een link toevoegen? Kies dan Yes en voeg de url toe waarnaar de afbeelding moet linken
* Je kunt ook linken naar een grotere versie van de afbeelding:
  * Druk onder de preview van de afbeelding op view file
  * In het nieuwe tabblad, kopieer het deel van de url vanaf /uploads/...
  * Plak de url in het linkveld
* Kies hoe je de afbeelding wilt weergeven in de vooringestelde opties

### De afbeelding

Zorg dat de afbeelding van goede kwaliteit is, dus goed scherp. Voor paginagrote afbeeldingen kies je een resolutie van 1920x1080. Let op dat de afbeelding niet te groot is, dat gaat ten koste van de snelheid van de pagina.

Snijd de afbeelding in een fotobewerkingsprogramma bij op het juiste formaat. Dit kan niet na uploaden in OpenStad.

### Styling

Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Info bar

Info bar is een widget waarmee je informatie onder de aandacht kan brengen. Het is vaak bovenaan een pagina gebruikt.&#x20;

![Voorbeeld infobar](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FQenI2TqXQf8o0YdibXel%2Fimage.png?alt=media\&token=97d1704f-8507-445d-a1ee-7efbf49c1d70)

## Configuratie-opties

### General

* *Message:* vul hier in de tekst die je wilt tonen.
* *Removable:* Hiermee kan je instellen of je infobar weg te klikken is of niet. Indien 'yes' verschijnt er een kruisje en gebruikers kunnen het weg drukken nadat ze het hebben gelezen. Indien 'nee', blijft het staan op de pagina.

### Styling&#x20;

* Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Link or button

Plaats een link om te verwijzen naar een andere website, een van de webpagina's, een e-mailadres of telefoonnummer.

* Ga naar de sectie van de pagina waar je de link wil plaatsen
* Druk op +
* Kies voor Link or button
* Vul in welke tekst je wilt weergeven bij Label
* Vul de URL in
* Kies bij Advanced of je de link in een nieuw scherm wilt openen (gebruik dit als je naar en externe site verwijst)
* Klik op Save

### Styling

Je kunt van een link een button maken door bij styling de variant te kiezen.&#x20;

Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)

### URL soorten

Je kunt een volledige website linken (https\://...) of een interne pagina (/contact).

### Mailto: of tel:

Je kunt een link maken waarmee je gelijk kunt mailen of bellen. Voorbeeld: mailto:<info@denhaag.nl>. tel:0031612345678


# List

Gebruik een lijst als je dingen wilt opsommen. Het brengt overzicht.

![Voorbeeld van een lijst-item met vinkjes](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FFi4IOQayKYMvmhlKMKXA%2Fimage.png?alt=media\&token=ca7aa0e7-20ab-4f9c-af63-e091e2e992da)

* Ga naar de sectie waar je de lijst wilt invoegen
* Klik op +
* Kies List
* Je komt bij General
* Klik op Edit items
* Voeg elk lijstitem afzonderlijk toe
  * Kies of je een ordered list (1, 2, 3) of een unordered list (bullets) wilt
  * Kies je soort bullets (streepjes, blauwe bollen, vinkjes, enz)

### Styling

Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# Like

Met de 'like' module kun je een widget toevoegen (bijvoorbeeld aan een project of een formulier). Waar je een 'like' of een 'klap' kunt achterlaten. Zo zien mensen of een project wordt aangejuicht.&#x20;

![De 'like'/'klap' button](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FMb9jKCPU5ARjBYCFTHM3%2FLike-klap-button.jpg?alt=media\&token=d796d0bf-0553-40a4-b2b8-37a302827aa6)

* Geef in de Weergave aan of je de 'Claps' (klappen/applaus) module wilt of de 'Default likes/disklikes'.&#x20;
* Idea ID hoeft niet ingevuld te worden
* Bij 'Styles for the container' kun je nog de achtergrond kleur veranderen


# Location


# Participatory budgeting

Participatory budgeting (begroot) is de widget waarmee je participatief begroten mogelijk maakt. In het kort: gebruikers mogen kiezen welke inzendingen ze graag uitgevoerd willen zien. Dat kun je op verschillende manieren mogelijk maken.&#x20;

![Voorbeeld begroot widget met Voting type Budgeting ](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FtpOZUCw9MlRAaxpQ7A9G%2Fimage.png?alt=media\&token=01aa8a71-9e48-4454-941f-9904246a11bb)

## Configuratie opties

### Voting options:

| Instelling                                            | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ----------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enable voting (currently only works with for gridder) | <p><strong>Yes:</strong> gebruikers kunnen plannen aanklikken, toevoegen, en stemmen<br><strong>No:</strong> vormgeving van de widget wordt aangepast zodat de opties om te stemmen niet zichtbaar zijn</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Voting type                                           | <p><strong>Budgeting:</strong> Gebruikers mogen een bepaald budget besteden. Ze hebben dan een 'winkelmandje', die telt automatisch op hoeveel budget ze hebben besteed aan andere plannen.<br><strong>Budgeting per thema:</strong> Net zoals budgeting, maar dan is er een bepaald budget beschikbaar per thema. Gebruikers klikken door 'rondes' met elke keer een nieuw thema en budget. <br><strong>Count:</strong> Gebruikers mogen een bepaald aantal plannen kiezen. Hun 'winkelmand' telt het aantal geselecteerde plannen.<br><strong>Count per thema:</strong> Het zelfde als Count maar dan per thema een aparte ronde, waar een bepaald aantal plannen gekozen kunnen worden. </p> |
| Maximum selectable ideas                              | Indien je gebruik maakt van Count, vul dan je gewenste maximaal aantal plannen hier in.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Minimum selectable ideas                              | Indien je gebruik maakt van Count, vul dan je gewenste minimaal aantal plannen hier in om een stem te kunnen bevestigen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Available Budget                                      | Indien je gebruik maakt van Budgeting, vul hier in het totale budget wat beschikbaar is (het maximale budget wat een gebruiker kan besteden aan plannen).                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Minimum budget that has to be selected                | Indien je gebruik maakt van Budgeting, vul hier in het minimum bedrag wat gebruikers moeten besteden om hun stem te bevestigen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

### Display options:

| Instelling                | Toelichting                                                                                                                                                                                                                                                                         |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display ranking           | <p><strong>Yes</strong>: tonen van de rangschikking. Er verschijnt dan een klein trofee icoon bij elk plan met daarin welk nummer op de lijst het is geworden, op basis van het aantal stemmen.<br><strong>No</strong>: Er verschijnt geen icoon met rangschikking.</p>             |
| Display price label       | <p><strong>Yes</strong>: hoeveel het plan kost wordt getoond in een label per plan.<br><strong>No</strong>: er wordt geen prijs label getoond.</p>                                                                                                                                  |
| Show vote count           | <p><strong>Yes</strong>: het is openbaar hoeveel stemmen er zijn binnengekomen per plan.<br><strong>No</strong>: het is geheim hoeveel stemmen er zijn binnen gekomen per plan voor de gebruikers. Moderatoren kunnen dit nog wel inzien in hun admin panel. </p>                   |
| Unavailable button        | Vul hierin welke tekst er getoond moet worden in plaats van "Toevoegen" als de gebruiker het maximum van zijn/haar winkelmandje heeft bereikt.                                                                                                                                      |
| Display Original Idea Url | <p><strong>Yes</strong>: vul dan de url in van het origineel ingediend plan (zonder id nummer). Er verschijnt dan een link ''Bekijk het originele voorstel" en gebruikers kunnen hier naartoe navigeren.<br><strong>No</strong>: er is geen extra link naar het originele plan.</p> |

### Sorting options:

| Instelling                                                | Toelichting                                                                                                                                                                |
| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Select sorting available (check one or more)              | Bepaal hiermee hoe gebruikers de plannen kunnen sorteren.                                                                                                                  |
| Redirect Select the default sorting (needs to be checked) | Bepaal hiermee hoe plannen automatisch worden vertoond. **Aanbeveling voor de begroot widget:** Willekeurig. Hiermee zorg je dat de stemming zo eerlijk mogelijk verloopt. |

#### Explanation texts:

Met explanation texts vul je in de tekst die vertoond wordt bij het doorlopen van de verschillende stappen van het stemmen/participatief begroten.&#x20;

![In geel highlight zie je de explanation text in stap 2 van het begroten.](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FHudxKn9hS4JKF0NwNdOL%2Fimage.png?alt=media\&token=3807d26e-c36c-48f3-a35e-73f5e0069ae3)

| Instelling                           | Toelichting                                                                                                                                                                                                                               |
| ------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Step 1: intro                        | De tekst die gebruikers zien in de widget als ze voor het eerst op de pagina komen. In deze stap kunnen gebruikers plannen selecteren.                                                                                                    |
| Step 2: intro                        | Vul hierin de tekst die gebruikers zien als ze een overzicht van hun selectie krijgen te zien.                                                                                                                                            |
| Step 3: intro                        | Vul hierin de tekst die gebruikers zien als ze gevraagd worden om hun stemcode in te vullen.                                                                                                                                              |
| Step 3: succesfull auth              | Vul hierin de tekst die gebruikers zien als hun stemcode geldig is en ze alleen nog hun stem moeten bevestigen.                                                                                                                           |
| Thank you message                    | Vul hierin de tekst die gebruikers zien als ze succesvol hebben gestemd.                                                                                                                                                                  |
| Show newsletter button after voting? | <p><strong>Yes</strong>: Gebruikers krijgen een button te zien nadat ze hebben gestemd om een emailadres op te geven voor een nieuwsbrief<br><strong>No</strong>: Geen button wordt vertoond, alleen de tekst bij "Thank you mesage".</p> |
| Text on the newsletter button        | Vul hierin de tekst die moet verschijnen op de nieuwsbrief button.                                                                                                                                                                        |

### Authentification:

| Instelling                                                                                                                  | Toelichting |
| --------------------------------------------------------------------------------------------------------------------------- | ----------- |
| <mark style="color:orange;">Scroll back to budget block when returning from entering vote code in oAuth environment?</mark> |             |

### Labels:

Met labels kun je meer informatie toevoegen aan plannen. Bijvoorbeeld, na afloop van de uitslag, kun je in 1 oogopslag duidelijk maken welke plannen worden uitgevoerd.&#x20;

![Voorbeeld toepassing labels 'Dit plan wordt wel/niet uitgevoerd'](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FiTbC7Yc0PY5PIX9HjtYP%2Fimage.png?alt=media\&token=79440050-0d87-4690-8d29-7da09f8065a4)

| Instelling                | Toelichting                                                                                               |
| ------------------------- | --------------------------------------------------------------------------------------------------------- |
| Label for photo: OPEN     | Vul hierin de tekst die verschijnt in een donkerblauwe balk met een klok icoontje.                        |
| Label for photo: CLOSED   | Vul hierin de tekst die verschijnt in een grijze balk met een ronde stip.                                 |
| Label for photo: ACCEPTED | Vul hierin de tekst die verschijnt in een groene balk met een kalender icoontje.                          |
| Label for photo: DENIED   | Vul hierin de tekst die verschijnt in een grijze balk, de foto wordt ook vervaagd/krijgt een grijze tint. |
| Label for photo: BUSY     | Vul hierin de tekst die verschijnt in een lichtblauw balk met een ster icoontje.                          |
| Label for photo: DONE     | Vul hierin de tekst die verschijnt in een donkerblauwe balk met een ster icoontje.                        |

{% hint style="info" %}
Let op: om de labels te laten verschijnen bij de juiste plannen, moet je labels toekennen aan de plannen. Dit doe je handmatig in Admin panel > Plannen > Select plannen > Bulk edit > Status, en kies de Status label die overeen komt met de label. Je kan ook het bestand met plannen opnieuw importeren met een ingevulde kolom 'status'. Zie voor meer informatie [Broken mention](broken://pages/lNZsGGhddgFl6PTvYHOr).
{% endhint %}


# Keuzewijzer


# Keuzewijzer resultaten


# Rich text

Met Rich Text plaats je alle tekst op je webpagina.

* Ga naar de sectie van de pagina waar je tekst wilt plaatsen
* Druk op +
* Kies Rich Text

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fcx6vrj3Stn1Hlc3Xiw7F%2Fimage.png?alt=media\&token=8a0f790f-6f47-4b3a-82f4-41fa8324901f)

De icoontjes van de tekstverwerker staan voor vet, cursief, link invoegen, link verwijderen en opsomming invoegen. Kies de uitlijning van de tekst.


# Resource admin buttons

Met resource admin buttons kun je afhankelijk van je [rol](/openstad/manual/miscellaneous/roles) bepaalde elementen op de site bewerken. Je gebruikt deze widget met name bij een plan-instuur website op de plan-detail-pagina.

![Voorbeeld van Resource admin buttons bij een ingestuurde plan](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FmVx0Q2iSsisOqUhRLrVi%2Fimage.png?alt=media\&token=add3ce3c-7dff-4e8a-a2dc-dd3f3435e418)

### Configuratie opties:

| Instelling                            | Toelichting                                                                                                                                                                                                                                                                                                       |
| ------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Hide admin after first public action? | Deze instelling is gericht op members. Als dit op "Yes" staat, dan kunnen members hun inzendingen niet meer bewerken nadat een andere gebruiker een like of opmerkingen heeft geplaatst op de inzending. (Idee hierachter is dat het voorkomt wijzigingen in het plan, nadat er meningen over zijn uitgesproken). |
| Show edit button?                     | <p><strong>Yes</strong>: knop om te bewerken is zichtbaar, en kun je dus gebruiken<br><strong>No</strong>: knop om te bewerken is niet zichtbaar</p>                                                                                                                                                              |
| Hide vote overview?                   | <p>Vote overview is een overzicht van de likes (votes) op een inzending. Hiermee kun je inzien van welk IP adres en op welk tijdstip een like/vote is uitgebracht.<br><strong>Yes</strong>: Knop 'Vote overview' is zichtbaar, en kun je dus inzien<br><strong>No</strong>: knop is niet zichtbaar</p>            |
| Show delete button                    | <p><strong>Yes</strong>: knop om te verwijderen is zichtbaar, en kun je dus gebruiken<br><strong>No</strong>: knop om te verwijderen is niet zichtbaar</p>                                                                                                                                                        |
| Where to redirect to after delete?    | Vul hier in de pagina waar mensen op terugkomen nadat ze een inzending hebben verwijderd. Bijvoorbeeld, /plannen                                                                                                                                                                                                  |
| Edit url                              | Vul hier in de url waar een inzending wordt bewerkt. Bijvoorbeeld, /planformulier                                                                                                                                                                                                                                 |


# Resource overview

De *resource overview*-widget gebruik je om een overzicht te tonen van alle items van een bepaalde *gegevensbron (resource)* die opgeslagen zijn in de achterliggende database. In de meeste gevallen wordt deze widget gebruikt om alle *inzendingen* van een website te tonen. Zie [Inzendingen weergeven](/openstad/manual/how-tos/show-ideas) voor veelvoorkomende manieren om deze widget in te zetten.

## Widget settings

### General

| Instelling                                     | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Resource                                       | Kies met welke gegevensbron je de widget wil gebruiken. Zie [Resources](/openstad/manual/miscellaneous/resources) voor meer info.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Enable voting                                  | Is alleen beschikbaar als je bij *Resource* voor *Idea* hebt gekozen. Kies *Yes* als je vanuit het overzicht wil kunnen stemmen op inzendingen. Zie [Stemmen](/openstad/manual/how-tos/voting#maximaal-een-inzending-plan-kiezen) (onder [Stemmen](/openstad/manual/how-tos/voting)) voor meer informatie. Als je *Yes* kiest, wordt het overzicht weergegeven als *Card in a grid - opens item on the same page*, ongeacht wat je bij *Display Type* (hieronder) kiest.                                                                                                                                                                               |
| Display Type                                   | <p> Kies hoe de items in het overzicht getoond worden. Er zijn drie opties;<br>- <em>Card in a row</em>: deze optie toont tegels die doorlinken naar een detailpagina als je er op klikt. Geef bij <em>Url structure for the resource</em> aan onder welke URL deze detailpagina zich bevindt.<br>- <em>Card in a grid</em>: bij deze optie worden items op dezelfde pagina geopend als je er op klikt, in een 'uitklapper' direct onder de rij tegels van het desbetreffende item.<br> - <em>Raw</em>: als je deze optie kiest, verschijnt de optie <em>Raw input</em>. Lees die toelichting hieronder voor meer informatie.</p>                      |
| Url structure for the resource                 | Geef aan onder welke URL de detailpagina zich bevindt. Doe dit door de [slug ](https://developer.mozilla.org/en-US/docs/Glossary/Slug)in te vullen, oftewel het stuk van de URL áchter de basis-URL van de homepagina van de website. Voorbeeld: als de URL van de homepagina `www.openstadsite.org/indiensite` is, en de detailpagina draait onder `www.openstadsite.org/indiensite/detail`, dan vul je bij deze instelling `/detail` in als URL structuur / slug. Zie [Inzendingen weergeven](/openstad/manual/how-tos/show-ideas#inzending-detailpagina) (onder [Inzendingen weergeven](/openstad/manual/how-tos/show-ideas)) voor meer informatie. |
| Allow for liking on ideas directly in overview | Werkt alleen als je bij *Display Type* kiest voor *Card in a row*. Als je vervolgens bij deze optie voor *Yes* kiest, dan kun je op de tegel in het overzicht het item liken door op de 👍 te klikken.                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Raw input                                      | Is alleen beschikbaar als je bij *Display Type* voor *Raw* kiest. Gebruik hier HTML en variabelen om zelf de overzichtsweergave te ontwerpen. Zie [Raw](/openstad/manual/miscellaneous/raw) voor meer informatie.                                                                                                                                                                                                                                                                                                                                                                                                                                      |

### Image settings

| Instelling                       | Toelichting                                                                                                                   |
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
| Default image                    | Kies welke afbeelding op de tegel getoond moet worden in het geval dat een item zelf geen afbeelding heeft.                   |
| Aspect ratio for images in tiles | Kies in welke [beeldverhouding ](https://nl.wikipedia.org/wiki/Beeldverhouding)de afbeelding op de tegel getoond moet worden. |

### Display settings

Onderstaande instellingen kunnen afhankelijk van de weergave die gekozen is onder *General > Display Type* effect hebben op de *tegel* (indien gekozen voor *Card in a row*) en/of de '*uitklapper*' (indien gekozen voor *Card in a grid*).

| Instelling                       | Toelichting                                                                                                                                                                                                                                                                                                                        |
| -------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display Title                    | Toon de titel op de tegel of in de uitklapper.                                                                                                                                                                                                                                                                                     |
| Display ranking                  |                                                                                                                                                                                                                                                                                                                                    |
| Display Label                    |                                                                                                                                                                                                                                                                                                                                    |
| Display summary                  | Toon de samenvatting op de tegel of in de uitklapper.                                                                                                                                                                                                                                                                              |
| Display description              | Toon de beschrijving in de uitklapper.                                                                                                                                                                                                                                                                                             |
| Display arguments count?         | Toon het aantal reacties dat bij een inzending geplaatst is op de tegel. Zie [Arguments](/openstad/manual/modules/arguments) voor meer informatie rondom het plaatsen van reacties.                                                                                                                                                |
| Show vote counter (for gridder)  | Toon het aantal uitgebrachte stemmen in de uitklapper.                                                                                                                                                                                                                                                                             |
| Display Sharebuttons             | <p>Toon knoppen om een inzending te delen in de uitklapper.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FdLjhjOHxaWMifiON0CIi%2Fimage.png?alt=media&amp;token=384aa307-00e6-4958-a176-feb33d824ecc" alt=""></p>                            |
| Display edit link for Moderator? | Toon voor moderators onderaan in de uitklapper een link om de inzending te bewerken.                                                                                                                                                                                                                                               |
| Display caption in vote counter  | <p>Toon een (korte) tekst naast het aantal stemmen. Standaard wordt 'stemmen' getoond.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FEuln3MjvXPM7u8GGNglg%2Fimage.png?alt=media&amp;token=91033423-2b94-40f2-8060-c100e4722fb1" alt=""></p> |
| Caption for vote counter         | Kies een (korte) tekst naast het aantal stemmen, om de standaard 'stemmen' te overschrijven.                                                                                                                                                                                                                                       |

### Button and Title text

Onderstaande instellingen zijn alleen van toepassing als je bij *General > Display Type* kiest voor *Card in a grid*.

| Instelling                                      | Toelichting                                                                                                                                                                                                                                                                                                                      |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Text for hover on image                         | <p>Overschrijf de tekst van de 'Bekijk'-knop als je een mouse-over doet op de tegel.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FjaxZ2tjTOaUWq8SAJg6m%2Fimage.png?alt=media&amp;token=b3c80c52-4785-418b-9bec-419794f8c364" alt=""></p> |
| Text in vote button in open ideas               | <p>Overschrijf de tekst van de stemknop in de uitklapper.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FblRnezY4rJZF9j7BkU19%2Fimage.png?alt=media&amp;token=3ed1590d-b567-459f-b708-b7d26baf0d8e" alt=""></p>                            |
| Which field should be used as title for an idea | Standaard wordt de titel (*title*) van een inzending gebruikt om onder de afbeelding te weergeven. Je kunt er voor kiezen om hier een ander veld van een inzending te gebruiken. Zie [Inzendingen (ideas)](/openstad/manual/miscellaneous/inzendingen-ideas) voor de velden die je kunt gebruiken.                               |

### Styling

| Instelling                        | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| --------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Card style                        | <p>Weergave van de tegel. Kies uit:<br>- White card with shadow<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FLP6mag5hcIsXxYELiyF5%2Fafbeelding.png?alt=media&amp;token=5f8293c9-b7a8-4efe-a53e-47655402de3b" alt=""><br>- Grey card<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fo8fDrKVy0oeVVRKkhR3G%2Fafbeelding.png?alt=media&amp;token=63915d68-5aea-4191-a8dd-fb4685305589" alt=""></p> |
| Html class for the main container | Geef de overzichtsweergave een HTML class-naam mee, zodat je deze kunt stylen met eigen CSS-code. Deze kun je bijvoorbeeld invoeren via [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global#vormgeving) in het [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global) menu.                                                                                                                                                                                                                                                                        |

### Sorting

| Instelling                                       | Toelichting                                                                                                                                                                                                                                                                                                                   |
| ------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display sorting                                  | <p>Kies of je de sorteer optie wil tonen bovenaan de overzichtsweergave.<br><br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FBX0M7joOkDI9gVyqy0Ov%2Fafbeelding.png?alt=media&amp;token=0bff48a3-cded-4a00-b675-5341c08b5334" alt=""></p> |
| Select the default sorting (needs to be checked) | Kies hoe het overzicht standaard gesorteerd wordt. Deze optie moet ook geselecteerd worden in de 'Select sorting avialable'-setting hieronder.                                                                                                                                                                                |
| Select sorting available (check one or more)     | Kies welke sorteermogelijkheden je wil bieden.                                                                                                                                                                                                                                                                                |

### Pagination

Paginatie gaat over de paginanummers die getoond worden onderaan de widget als het aantal inzendingen een bepaalde hoeveelheid overschrijd.\
![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F1SSpGmO3Db7LCMGDKWgy%2Fafbeelding.png?alt=media\&token=c4520800-cfd6-42a4-94ac-457d23ca5034)

| Instelling                 | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Amount of items per page   | Kies hoeveel inzendingen je op één pagina wil tonen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Text for amount of results | <p>Kies welke tekst je bovenaan de overzichtsweergave wil tonen, om gebruikers te informeren over de hoeveelheid inzendingen. Gebruik de variabelen <code>\[visibleCount]</code> en <code>\[totalCount]</code> om respectievelijk het aantal zichtbare inzendingen op de pagina en het totale aantal inzendingen te gebruiken. Je kunt hiervoor opmaak HTML-tags gebruiken. Bijvoorbeeld: <code>Je ziet \<b>\[visibleCount]\</b> van in totaal \[totalCount] inzendingen</code>.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FGdSLp5f2GzYPDjpqWTRZ%2Fafbeelding.png?alt=media&amp;token=035925d2-5a66-4ecd-8051-c73d85c5b57e" alt=""></p> |

### Theme

| Instelling            | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Display theme filter? | <p>Kies of je de optie wil tonen om te filteren op thema.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fi1Dzww7IJboavcEtWMUa%2Fafbeelding.png?alt=media&amp;token=5fbf92bf-4716-4ca5-bae3-19ac6afe9804" alt=""><br><br>Zie ook <a data-mention href="/openstad/manual/miscellaneous/openstad-hoofdmenu/global#themes-areas-and-idea-types">/pages/QjsFzmcmio5GEsYX4fIs#themes-areas-and-idea-types</a> onder <a data-mention href="/openstad/manual/miscellaneous/openstad-hoofdmenu/global">/pages/QjsFzmcmio5GEsYX4fIs</a>.</p> |

### Area

| Instelling           | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display area filter? | <p>Kies of je de optie wil tonen om te filteren op gebied.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FVawknI69wazFY8CqNvOs%2Fafbeelding.png?alt=media&amp;token=f4113046-898d-4171-949d-196fb0ba0e47" alt=""><br><br>Zie ook <a data-mention href="/openstad/manual/miscellaneous/openstad-hoofdmenu/global#themes-areas-and-idea-types">/pages/QjsFzmcmio5GEsYX4fIs#themes-areas-and-idea-types</a> onder <a data-mention href="/openstad/manual/miscellaneous/openstad-hoofdmenu/global">/pages/QjsFzmcmio5GEsYX4fIs</a>.</p> |

### Search

| Instelling                    | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display search?               | <p>Kies of de zoekbalk getoond moet worden. Gebruikers kunnen zoeken op de titels van inzendingen.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fnjc2KiU4IxADbniPkbQY%2Fafbeelding.png?alt=media&amp;token=b97e6122-9a6e-4298-8016-600410f14e7d" alt=""></p>                                                                                                                                                                                                                                      |
| Text for active search result | <p>Kies welke tekst je bovenaan de overzichtsweergave wil tonen, om gebruikers te informeren over hun zoekactie. Gebruik de variabele <code>\[searchTerm]</code> om de ingevulde zoekterm te gebruiken. Je kunt hiervoor opmaak HTML-tags gebruiken. Bijvoorbeeld: <code>Je ziet de zoekresultaten voor: \<b>\[searchTerm]\</b></code>.<br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FJpm9epterJpbPueRjSqw%2Fafbeelding.png?alt=media&amp;token=317304b2-1990-45f6-baca-7396d38ad0f5" alt=""></p> |

### Tags

| Instelling           | Toelichting                                                                                                                                                                                                                                       |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display tag filters? | Kies of je het tags-filter wil tonen. Zie ook [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin#tags) onder [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin). |

### Include & Exclude items

| Instelling                                                                | Toelichting |
| ------------------------------------------------------------------------- | ----------- |
| Exclude ideas with this theme                                             |             |
| Only show idea including this theme (currently only works with one theme) |             |
| Show only following resources:                                            |             |

### Labels

| Instelling               | Toelichting |
| ------------------------ | ----------- |
| Label for status: \[...] |             |

### Info

| Instelling                            | Toelichting |
| ------------------------------------- | ----------- |
| Amount of characters for the summary  |             |
| Step 1: intro                         |             |
| Step 2: intro                         |             |
| Step 2: succesfull feedback in button |             |
| Step 2: succesfully authenticated     |             |
| Text in button for authenticating     |             |
| Auth form embedded                    |             |
| Placeholder when no item is selected  |             |
| Error for no selection                |             |
| Success title                         |             |
| Success description                   |             |
| Site ID                               |             |
| Auth form: Unique code label          |             |
| Auth form: Unique code button text    |             |
| Auth form: SMS label                  |             |
| Auth form: SMS button text            |             |
| Auth form: E-mail label               |             |
| Auth form: E-mail button text         |             |


# Resource form

Met de widget Resource form creëer je een formulier waarmee gebruikers een [inzending kunnen insturen](/openstad/manual/how-tos/upload-ideas).

### Configuratie-opties

In resource form zijn er verschillende settings voor elk vraag die je kan stellen in het formulier. Een aantal vragen zitten er standaard in, maar je kan altijd meer toevoegen of vragen weghalen.&#x20;

![Overview resource form widget](https://lh6.googleusercontent.com/8I3mkv2NgQju5IkkG986nq3eWcwVuSmDP7hzNZrOOyAFvnoYE4yVAD18aabskPhZbjKTMVDKm3F-oStw19b_Z8kB29YyFIS0anka0hON8lujnuepoLjyS_cB7AiBulMEDc_rBS5Z)

### Algemeen

| Instelling                                    | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| --------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Resource (from config)                        | Kies met welke gegevensbron je de widget wil gebruiken. Zie [Resources](/openstad/manual/miscellaneous/resources) voor meer informatie.                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Redirect after submit                         | Op welke pagina komen gebruikers terercht wanneer ze iets hebben ingezonden? Als je wilt dat ze hun eigen ingestuurde plan zien (in een planindien template website), vul dan in: /plan/:id                                                                                                                                                                                                                                                                                                                                                                                                                 |
| <mark style="color:orange;">Login text</mark> | TODO kan je leeg laten?                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| How do you want to organise the form?         | <p><strong>Static (default)</strong>: je gebruikt de default vragen voor het type resource form die je gebruikt. Bij 'ideas', zijn dat bijvoorbeeld vragen om een plan in te dienen voor een participatief begroten proces.<br><strong>Static with dynamic fields appended</strong>: je gebruikt (een aantal van) de default vragen in het formulier en je voegt nieuwe vragen daar aan toe</p><p><strong>Dynamic</strong>: je bouwt je eigen vragen en gebruikt geen default vragen van het formulier. <br>Lees meer over dynamic appended & dynamic <a href="#nieuwe-vragen-toevoegen">hieronder</a>.</p> |

### Instellingen die er voor elke vraag zijn

<table><thead><tr><th width="226.2255125284738"></th><th>Toelichting</th></tr></thead><tbody><tr><td>Label for [naam]</td><td>De naam van jouw vraag. Wordt weergegeven in bold, grote tekst.</td></tr><tr><td>Info for [naam]</td><td>Extra toelichting over jouw vraag, om te kunnen uitleggen waarom je dit vraagt/wat je precies wilt weten.</td></tr><tr><td>This field is required</td><td><strong>Yes</strong>: dit is een verplichte vraag, en indieners zullen een melding krijgen dat ze dit veld eerst moeten invullen voordat ze een plan kunnen insturen.<br><strong>No</strong>: dit is geen verplichte vraag.</td></tr></tbody></table>

Zo zien vragen er dan ongeveer uit. Met aanvullende instellingen kun je ook een aantal default vragen nog aanpassen.&#x20;

![Voorbeeld vragen](https://lh3.googleusercontent.com/WzbWotX43qlkCPcPPYz3Sf9fgVFd8iSUC9XKYFlepugC5NzudrpQSmwfc0cIItTS1nn_V3oL--EZknUdEfpdguxaObBc9Ts51DqxbXpunWcX34uejTmhXIfSRQlEboQD2fMCPtvP)

### Aanvullende instellingen

|                                                                              | Toelichting                                                                                                                                                                                                                                                                                                                                        |
| ---------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Field type                                                                   | <p><em>Onderdeel van: summary, estimate costs</em><br><strong>Text area:</strong> grotere veld om in te vullen, geschikt voor langere tekst<br><strong>Text bar</strong>: een veld van 1 regel, geschikt voor kortere tekst</p>                                                                                                                    |
| Use text editor                                                              | <p><em>Onderdeel van:</em> <em>description</em><br><strong>Yes</strong>: gebruikers kunnen hun tekst vormgeven met titels, bold, italics, hyperlinks, bulletpoints, genummerde lijst, en indents.<br><strong>Nee:</strong> gebruikers kunnen platte tekst invullen.</p>                                                                            |
| Allow multiple images to be uploaded                                         | <p><em>Onderdeel van: images</em><br><strong>Yes</strong>: maakt het mogelijk om meerdere afbeeldingen toe te voegen. Let op: de standaard resource overview (hoe het ingediende plan wordt getoond) is niet ingericht voor meerdere afbeeldingen<br><strong>No</strong>: alleen 1 afbeelding kan worden toegevoegd</p>                            |
| Display location                                                             | <p><em>Onderdeel van: location</em><br><strong>Yes</strong>: gebruikers krijgen deze vraag te zien<br><strong>No</strong>: gebruikers krijgen deze vraag niet te zien (vergeet dan niet om het niet verplicht te maken)</p>                                                                                                                        |
| Minimum/maximum number of characters needed                                  | <p><em>Onderdeel van: estimate costs, role, phone, tip</em><br>Vul hier het minimum of het maximum aantal karakters in voor het formulier veld. <br>Let op: wil je een min of max instellen voor title, summary of description? Pas dat aan via de <a href="/openstad/manual/miscellaneous/adminpanel">adminpanel</a> > Site settings > ideas.</p> |
| Text for button to submit/save                                               | <p><em>Onderdeel van: submitting</em><br><strong>To submit:</strong> tekst op de button wat mensen moeten klikken om hun inzending in te sturen<br><strong>To save:</strong> tekst op de button wat mensen moeten klikken om hun inzending op te slaan. Vaak niet van toepassing en kan je dus leeg laten.</p>                                     |
| <mark style="color:orange;">Display budget for moderators?</mark>            | <p><em>Onderdeel van: budget</em><br><em>TODO ik weet niet precies wat dit doet</em></p>                                                                                                                                                                                                                                                           |
| <mark style="color:orange;">Hide admin after the first public action?</mark> | <p><em>Onderdeel van: info</em><br><em>TODO ik weet niet precies wat dit doet</em></p>                                                                                                                                                                                                                                                             |

### Nieuwe vragen toevoegen

De widget is standaard ingericht met bepaalde vragen. Dit zijn vragen die je vaak gebruikt bij een participatief begroten proces, waarbij indieners een aantal basis dingen moeten toelichten over hun plan of initiatief.&#x20;

Maar je kunt ook nieuwe vragen toevoegen. Pas eerst de organisatie van het formulier aan: [Algemeen ](#algemeen)> How do you want to organise the form > Static with dynamic fields appended (hiermee gebruik je de standaard vragen én aanvullende vragen die jij bedenkt) **of** Dynamic (hiermee richt je helemaal zelf het formulier in).&#x20;

![Nieuwe vragen toevoegen via Form Sections](https://lh5.googleusercontent.com/laEAqbl9dzXsE-QlLJD4p9hQ7xaT7EnU1jhrWVlcJmywBKN8Z7yKBt4KalmG1hXRzxtQs2NVpR36kaGBVg8Vy0ObXy_23ZjU-kXG5e7FsyBmO6rgxFN8ezMaKtK4l6twhVAuy7Q5)

Om nieuwe vragen toe te voegen, klik je op Edit Form Sections. Geef je nieuwe vraag een titel. Vul eventueel Info in met een toelichting over de vraag.

![Naam invulen nieuwe vraag](https://lh4.googleusercontent.com/0deJrfwsPhByRttVqwE3AECVG6ur2K8H2hB8T2iC0AVXIAzSCadZHNnPPfjHJh7SxvRM1aSRh4D4IWmprWX373zk2SDv2CvtzyC5fOs902qmC9BxCvEokykqXC9kVZoRAFzi_5rZ)

Vervolgens geef je jouw nieuwe vraag vorm door te klikken op Form fields > Edit form fields.

![Editing form fields](https://lh3.googleusercontent.com/5eSvXco2gepEU96VhV5XYj64nVM-AFcgNdxs1ITAvBou-yCnsJ8EmCQHq8OuXuovQ1fRkM2o535tBo_iVvX6_mCqgU-KB7ZLX79SphSHHf-YOjzwaul0Q7rO2qOEJRnbHKoSZhUf)

### Instellingen van Form Fields

<table><thead><tr><th width="190.46304933528546"></th><th>Toelichting</th></tr></thead><tbody><tr><td>Type</td><td></td></tr><tr><td>Key (one word) for example: ‘summary’ (for storing, must be unique, no spaces and special characters)</td><td>Dit wordt de categorie van de antwoorden. In de excel/csv resultaten die je uiteindelijk krijgt, zul je de antwoorden op deze vraag onder deze key vinden.</td></tr><tr><td>Info</td><td>Dit is extra ruimte om de vraag toe te lichten.</td></tr><tr><td>Required</td><td>Is de vraag verplicht, ja of nee?</td></tr><tr><td>Minimum/maximum length</td><td>Vul hier het minimum of het maximum aantal karakters in voor het formulier veld. </td></tr><tr><td><mark style="color:orange;">Save field in root if data object and not in extraData, will only work if column exists in database)</mark></td><td>TODO hou deze op No?</td></tr><tr><td>Only show to moderators</td><td><em><mark style="color:orange;">Yes: de antwoorden op deze vraag worden alleen zichtbaar voor moderators?</mark></em><br><em><mark style="color:orange;">No: de antwoorden op deze vraag zijn zichtbaar voor alle gebruikers?</mark></em></td></tr></tbody></table>

{% hint style="warning" %}
Let op: Extra vragen die je zelf inricht zijn ongeschikt voor het opvragen/verzamelen van persoonsgegevens. Gebruik hiervoor alleen de hiervoor gebouwde vragen.
{% endhint %}

{% hint style="info" %}
De extra vragen die je via de resource form toevoegt worden zichtbaar in het formulier voor gebruikers. Om ze ook zichtbaar te maken in het resource representation (de weergave van ingezonden inzendingen) moet je daar ook wat aanpassingen maken. Lees meer in [resource representation](/openstad/manual/modules/resource-representation).
{% endhint %}


# Resource representation


# Resource raw widget


# Resource image


# Speech bubble

Met Speech bubble kun je een tekstballon toevoegen waar je andere content (Counter, List, Video (upload), Image, Rich text, Video (3d party, youtube), Link or button en Title) aan toe kan voegen.&#x20;

![De Speech bubble met verschillende content mogelijkheden](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FwFUTaRBqE93dtgnP8vOG%2FSpeech%20bubble.jpg?alt=media\&token=268df3c6-ee21-4365-909a-aabdd6c8ad17)

### General styling

* Border color - hier geef je aan welke kleur de omtrek van de speech bubble moet krijgen
* Background color - hier geef je aan welke achtergrond kleur de speech bubble moet krijgen

### Advanced styling

Hier kun je met verschillende CSS opties de speech bubble aanpassen

### Content toevoegen aan de speech bubble

Nu het opslaan van je speech bubble kun je doormiddel van op het paars/blauwe plusje content toevoegen aan je speech bubble. Dit kan zijn: Counter, List, Video (upload), Image, Rich Text, Video (3d party, youtube), Link or button en Title. Zie ook de afbeelding hierboven voor de opties.&#x20;


# Share widgets

Voeg *share widgets* toe op pagina's zodat gebruikers de pagina makkelijk kunnen delen via e-mail en socials zoals Facebook, Twitter en WhatsApp.&#x20;

{% hint style="info" %}
HIER SCREENSHOT VAN SHARE WIDGETS TOEVOEGEN?
{% endhint %}

## Configuratie-opties

De *share widgets* heeft een aantal instellingen die configureerbaar zijn.

{% hint style="info" %}
HIER SCREENSHOT VAN 'EDIT SHARE WIDGETS' TOEVOEGEN?
{% endhint %}

| Instelling                                     | Toelichting                                                                                                                                                |
| ---------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Weergave                                       | <p><strong>Square</strong>: kleine weergave van share widgets. </p><p><strong>Round</strong>: grote weergave van share widgets.</p>                        |
| Styles for the container                       | Deze widget beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container) |
| Select which share buttons you want to display | Selecteer welke share buttons je wil tonen. Als je niets selecteert blijven alle share buttons zichtbaar.                                                  |


# Title

Geef je tekst, pagina of element een pakkende titel. Zorg dat de lezer makkelijk de pagina kan scannen om te vinden wat die zoekt.

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FTEFjvUaCJ9vSVQS0yAVS%2Fimage.png?alt=media\&token=8140eedf-67a2-4ba4-ade9-8144e5c81cba)

* Kies waar je de titel wilt plaatsen
* Druk op +
* Kies Title
* Vul de tekst van je titel in
* Kies welke heading je titel moet zijn. Een goede webpagina heeft 1 H1 header en meerdere H2 subheaders. Voorbeeld:
  * H1
    * H2
    * H2
      * H3
    * H2
      * H3
      * H3
* Klik op Save

### Styling

Styles for the container: Deze module beschikt over de standaard CSS styling mogelijkheden, zie [styles for the container.](/openstad/manual/miscellaneous/styles-for-the-container)


# User remove form

Met een user remove form kan een gebruiker zijn gegevens van de site verwijderen.

Deze widget is uniek omdat er geen instellingen zijn om aan te passen.

**Let op**: het is wel belangrijk dat je bij Page Settings > Resource > Active user selecteert. Zie voor meer informatie [Gebruikersbeheer](/openstad/manual/how-tos/gebruikersbeheer).

![TODO CHECK DEZE SCREENSHOT. Voorbeeld van een user remove form](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FPgwyNQQkZZFwdh4rFce8%2Fimage.png?alt=media\&token=2f565146-74c6-4337-bbde-1099759525b8)


# Video upload

Video upload is een optie om video's vanaf je PC/tablet direct op de pagina te uploaden.&#x20;

## Configuratie-opties

### Video

* *Upload file:* Hier kun je vanuit je lokale bestanden een video uploaden.&#x20;

### Poster image

* *Upload file:* Hier kun je een zo gehete 'Thumbnail' toevoegen. Een foto die de bezoeker ziet als het filmpje stilstaat als deze nog niet op 'play' heeft gedrukt.


# Video 3d party

Via 3d party kun je gemakkelijk video's plaatsen door een link van YouTube of Vimeo in te voeren.

## Video URL

* Hier voer je de gewenste URL in van het YouTube of Vimeo filmpje om deze op de gewenste pagina te krijgen.


# Vorige volgende knoppen

Vorige volgende knoppen is een widget waar je 2 [Link or button](/openstad/manual/modules/link)'s tegelijkertijd kan plaatsen. Dit is een handige widget als gebruikers door bijvoorbeeld meerdere pagina's moeten klikken om een formulier in te vullen, of als je ze stapsgewijs wilt begeleiden.

![Voorbeeld Vorige volgende knoppen](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FlQF2wQZrW8FGc6f4Bpnp%2Fimage.png?alt=media\&token=4be6106c-631e-4d80-96f1-3a10a61ff05b)

## Configuratie-opties

| Instelling                    | Toelichting                                                                                                            |
| ----------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| Url achter de 'vorige' knop   | Vul hier de url in of extension waar gebruikers naartoe moeten om naar de vorige pagina te gaan. (Voorbeeld: /thema's) |
| Tekst op de 'vorige' knop     | Vul hier de tekst in die op de vorige knop moet verschijnen. (Voorbeeld: Terug)                                        |
| Url achter de 'volgende' knop | Vul hier de url in of extension waar gebruikers naartoe moeten om naar de volgende pagina te gaan. (Voorbeeld: /plan)  |
| Tekst op de 'volgende' knop   | Vul hier de tekst in die op de vorige knop moet verschijnen. (Voorbeeld: Stuur uw plan in)                             |
| Styles for the container      | Zie [Styles for the container](/openstad/manual/miscellaneous/styles-for-the-container).                               |


# Algemeen


# Terminologie

* Slug <https://developer.mozilla.org/en-US/docs/Glossary/Slug>
* Inzending - wordt soms ook naar gerefereerd als idea/idee, plan, …
* Basis URL
* verschillende type menus: hoofdmenu
* verschillende type admin panels (react en beta?)


# Waarschuwingen

\#Waarschuwingen in het CMS

Op een aantal plekken worden waarschuwingen gegeven voor beheerders van de website. Hier volgt een uitleg wat deze betekenen:

#### Participatory budgeting is turned on but the vote count is public!

#### Participatory budgeting is turned on but the site setting is not set to vote type budgeting

#### Voting is turnend on in this module, but not turned in site settings!

#### Voting type is not set to count in site settings

#### Resource page type is set but no active resource is found

resource page type is set but no active resource is found, probably because there is no id in the url. For users who are not logged in a 404 - not found page will be shown

#### Voting type is not set to likes in site settings but liking is turned on in resource overview

#### a resource representation widget won't work untill the page type is set to resource and a type of resource is selected, this can be fixed in page settings on the bottom of the page.

#### this template will only work properly with idea resource


# Adminpanel

https\://admin.openstad.amsterdam.nl/admin

Deze adminpanel is alleen beschikbaar voor admins.&#x20;

## Dashboard

## Settings

## Authentification & security

## Voting codes

## Edit site

## Ideas

## Votes

## Newsletter subscribers

## Export


# Adminpanel (beta)/React admin

Belangrijke instellingen voor een site die je aanpast via www\.website.nl/admin.

De admin panel van een site bereik je via [www.website.nl/admin](http://www.website.nl/admin). Dit noemen we adminpanel (beta) en/of React admin.&#x20;

De React admin kun je zien/bewerken alleen als je een moderator, editor, of admin bent (zie [Rollen](/openstad/manual/miscellaneous/roles)). Een admin kan rollen toekennen via de algemene OpenStad [Adminpanel](/openstad/manual/miscellaneous/adminpanel).

{% hint style="warning" %}
**Let op**: per rol zijn er verschillende rechten toegekend. Het kan dus zijn dat je niet al deze onderdelen kunt zien/bewerken.&#x20;
{% endhint %}

## Statistics

In statstics zie je een overview van de gebruik van jouw site. Onder andere lees je:

* Amount of ideas: aantal geüploade inzendingen
* Ideas submitted per day: een grafiek van wanneer de inzendingen precies zijn geüpload
* Amount of users that voted: het aantal gebruikers die een stem of een like heeft uitgebracht
* Amount of votes on ideas: het aantal stemmen op inzendingen (1 user kan 1 keer stemmen, maar bijvoorbeeld 6 stemmen op inzendingen uitbrengen tijdens een begroot proces. Dit gaat over het aantal inzendingen geselecteerd in totaal)
* Amount of votes for an idea: het totaal aantal likes op inzendingen&#x20;
* Amount of votes against an idea: het totaal aantal dislikes op inzendingen
* Amount of users that voted per day: een grafiek van wanneer stemmen zijn uitgebracht
* Amount of votes per day: aantal stemmen per dag
* Amount of arguments, total count: totaal aantal argumenten (positief en negatief) die zijn geplaatst
* Amount of arguments for an idea, total count: totaal aantal argumenten voor (positief gestemd) die zijn geplaatst
* Amount of arguments against an idea, total count: totaal aantal argumenten tegen (negatief gestemd) die zijn geplaatst
* Amount of choices guide results: aantal keer dat de keuzewijzer is ingevuld en opgestuurd

## Site settings

In site settings heb je verschillende tabbladen, waar je verschillende instellingen kunt aanpassen voor je hele site.&#x20;

### Info

| Instelling                    | Toelichting                                                                                                                                                                                                                                                 |
| ----------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Id                            | Dit wordt automatisch ingevuld bij het aanmaken van een site.                                                                                                                                                                                               |
| Title                         | De titel die je site heeft. Ook in te stellen via [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global).                                                                                                                                       |
| New users can log in?         | <p>Schuifje rechts & blauw = ja: Nieuwe gebruikers kunnen een account aanmaken en inloggen via de site<br>Schuifje links & grijs = nee: Nieuwe gebruikers kunnen niet inloggen/een account aanmaken.</p>                                                    |
| Can usuers create an alias?   | <p>Schuifje rechts & blauw = ja: gebruikers kunnen een alias/nickname gebruiken op de site. <br>Schuifje links & grijs = nee: gebruikers kunnen geen extra alias gebruiken op de site, maar gebruiken de naam die ze hebben opgegeven voor hun account.</p> |
| Possible to send in articles? | <p>Schuifje rechts & blauw = ja: je kan nieuwe <a data-mention href="/openstad/manual/miscellaneous/artikelen-articles">/pages/DlILnrdj8g1aiayVnmue</a>uploaden op de site<br>Schuifje links & grijs = nee: je kan geen artikelen uploaden op de site. </p> |
| Project has ended             | <p>Schuifje rechts & blauw = ja: Markeerd de site als 'klaar'. Door dit aan te klikken zet je automatisch een aantal instellingen uit zoals: 'Can add new ideas', 'Votes are active', etc.<br>Schuifje links & grijs = nee: Project is nog actief.</p>      |

### Ideas

| Instelling                                                                                 | Toelichting                                                                                                                                                                                                                                                                                                  |
| ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Possible to send in ideas?                                                                 | <p>Schuifje rechts & blauw = ja: gebruikers kunnen inzendingen uploaden. <br>Schuifje links & grijs = nee: gebruikers kunnen geen inzendingen uploaden.</p>                                                                                                                                                  |
| Minimum votes needed for idea?                                                             | Vul hier in het minimum aantal likes die nodig zijn                                                                                                                                                                                                                                                          |
| Minimum length of title                                                                    | Vul hier in het minimum aantal tekens dat de titel van een inzending moet hebben.                                                                                                                                                                                                                            |
| Maximum length of title                                                                    | Vul hier in het maximum aantal tekens dat de titel van een inzending moet hebben.                                                                                                                                                                                                                            |
| Minimum length of summary                                                                  | Vul hier in het minimum aantal tekens dat de samenvatting een inzending moet hebben.                                                                                                                                                                                                                         |
| Maximum length of summary                                                                  | Vul hier in het maximum aantal tekens dat de samenvatting een inzending moet hebben.                                                                                                                                                                                                                         |
| Minimum length of description                                                              | Vul hier in het minimum aantal tekens dat de beschrijving van een inzending moet hebben.                                                                                                                                                                                                                     |
| Maximum length of description                                                              | Vul hier in het maximum aantal tekens dat de beschrijving van een inzending moet hebben.                                                                                                                                                                                                                     |
| LET OP:                                                                                    | De andere min/max aantal tekens voor [Inzendingen uploaden](/openstad/manual/how-tos/upload-ideas) pas je direct in de widget aan, [Resource form](/openstad/manual/modules/resource-form).                                                                                                                  |
| Possible to add polls?                                                                     | <p>Momenteel alleen beschikbaar voor <a data-mention href="/openstad/manual/how-tos/interactieve-kaart">/pages/rFm9Ak9B0XFWS1cXDscq</a>.<br>Schuifje rechts & blauw = ja: je kan polls maken.<br>Schuifje links & grijs = nee: je kan geen polls maken.</p>                                                  |
| Automatically update status from OPEN to CLOSED when an idea is a given number of days old | <p>Schuifje rechts & blauw = ja: de status van een inzending wordt automatisch geüpdatet van 'Open' naar 'Closed' na een aantal dagen</p><ul><li>Vul dan vervolgens in na hoeveel dagen deze update moet gebeuren</li></ul><p>Schuifje links & grijs = nee: de status wordt niet automatisch aangepast. </p> |

### Arguments

| Instelling                                      | Toelichting                                                                                                                                                         |
| ----------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Adding of arguments is closed?                  | <p>Schuifje rechts & blauw = ja: gebruikers kunnen geen argumenten meer toevoegen.<br>Schuifje links & grijs = nee: gebruikers kunnen wel argumenten toevoegen.</p> |
| Text to show when adding of arguments is closed | Vul hierin de tekst die wordt getoond op het moment dat de instelling hierboven aan staat.                                                                          |
| Minimum length of description                   | Vul hier in het minimum aantal tekens dat een argument moet hebben.                                                                                                 |
| Maximum length of description                   | Vul hier in het maximum aantal tekens dat een argument moet hebben.                                                                                                 |

### Voting

| Instelling                                                        | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Is the vote count publicly available?                             | <p>Schuifje rechts & blauw = ja: het aantal stemmen/likes per inzendingen zijn publiekelijk zichtbaar. </p><ul><li>De voorkant van de site moet wel ingericht zijn om dit zichtbaar te maken. Daar zijn bijvoorbeeld instellingen voor in verschillende widgets. </li></ul><p>Schuifje links & grijs = nee: het aantal stemmen/likes per inzendingen zijn niet publiekelijk zichtbaar. </p>                                                                                                                                                                                                                                                                                 |
| Is voting active?                                                 | <p>Schuifje rechts & blauw = ja: gebruikers kunnen stemmen/likes uitbrengen.<br>Schuifje links & grijs = nee: gebruikers kunnen geen stemmen/likes uitbrengen.</p>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Should voting again replace previous vote? Or give an error?      | <p>Replace the vote: Indien gebruikers al een stem hebben uitgebracht voor een inzending waar ze opnieuw op willen stemmen, vervangt het nieuwste stem de eerdere stem. <br>Error: Indien gebruikers al een stem hebben uitgebracht voor een inzending waar ze opnieuw op willen stemmen, krijgen ze een errormelding te zien.</p>                                                                                                                                                                                                                                                                                                                                          |
| What type of voting is available?                                 | <p>Likes: Gebruikers kunnen een like of dislike geven op een plan.<br>Count: Gebruikers kunnen een minimum en maximum aantal inzendingen kiezen.</p><p>Budgeting: Gebruikers kunnen inzendingen kiezen die passen binnen een bepaald budget. </p><p>Count per theme: Gebruikers kunnen een minimum en maximaal aantal inzendingen kiezen per thema. <br>Budgeting per theme: Gebruikers kunnen voor elk thema inzendingen kiezen die passen binnen een bepaald budget. <br>Zie ook <a data-mention href="/openstad/manual/how-tos/voting">/pages/pBLiA6fxXPowcI8NpFwG</a>.</p>                                                                                              |
| <p>(indien je type voting: Likes) gebruikt:</p><p>Like button</p> | <p>Text on the button: Schrijf welk tekst zich moet vertonen op een like button.<br>Value of the button: Kies of het 'voor' of 'tegen' likes zijn. <br>Je kunt buttons toevoegen/weghalen door op 'Add' of 'Remove' te klikken. <br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FduFR0GnyjQL18vaL29KT%2Fimage.png?alt=media&amp;token=aa661eb6-3078-47d3-a8cb-58d9296d4416" alt=""></p>                                                                                                                                                                                                |
| What is max amount of ideas users can vote for?                   | Voor type stemmen Count: Vul hier het maximum aantal inzendingen die gebruikers moeten kiezen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| What is min amount of ideas users can vote for?                   | Voor type stemmen Count: Vul hier het minimum aantal inzendingen die gebruikers moeten kiezen.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| What is min budget users can vote for?                            | Voor type stemmen Budgeting: Vul hier het minimum budget die gebruikers moeten uitgeven met hun totaal stem.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| What is max budget users can vote for?                            | Voor type stemmen Budgeting: Vul hier het maximum budget die gebruikers moeten uitgeven met hun totaal stem.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Theme configuration for budget voting                             | <p><strong>Name of theme:</strong> Vul hier de naam van een thema in.<br><strong>Minimum ideas to vote for:</strong> Indien count, vul hier het minimum aantal inzendingen die gebruikers moeten kiezen <em>binnen dit thema.</em><br><strong>Maximum ideas to vote for</strong>: Indien count, vul hier het maximum aantal inzendingen die gebruikers moeten kiezen <em>binnen dit thema.</em><br><strong>Min budget</strong>: Indien budgeting, vul het minimum budget die gebruikers moeten gebruiken <em>binnen dit thema.</em><br><strong>Max budget</strong>: Indien budgeting, vul het maximum budget die gebruikers moeten gebruiken <em>binnen dit thema.</em></p> |

### Notifications

| Instelling    | Toelichting                                                                                       |
| ------------- | ------------------------------------------------------------------------------------------------- |
| Email to      | Email waar administrator notifications naar gestuurd worden, zoals bij het uploaden van een plan. |
| Email address | Email waar administrator notifications naar gestuurd worden, zoals bij het uploaden van een plan. |

### Password protection

| Instelling | Toelichting                                                                                                                                                                                      |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Is active? | <p>Schuifje rechts & blauw = ja: er zit een wachtwoord op de gehele site. Het is dus niet publiek zichtbaar.<br>Schuifje links & grijs = nee: er is geen wachtwoord om de site te bezoeken. </p> |
| User       | Vul hierin de username die je gebruikt.                                                                                                                                                          |
| Password   | Vul hierin de wachtwoord die je gebruikt.                                                                                                                                                        |

### Advanced

TODO&#x20;

## Plannen

![Voorbeeld Plan overzicht](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FS6q9yWCPtqn7U6EuFrEc%2Fimage.png?alt=media\&token=45d07b49-9051-4742-9d14-4e32a1710ffc)

| Instelling  | Toelichting                                                                                                                                       |
| ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| Add filter  | Sorteer voor jezelf de inzendingen met een filter                                                                                                 |
| Create      | Voeg hiermee een inzending toe.                                                                                                                   |
| Export csv  | Klik hierop om alle inzendingen te exporteren als csv bestand.                                                                                    |
| Export xlsx | Klik hierop om alle inzendingen te exporteren als excel bestand.                                                                                  |
| Import      | Importeer inzendingen, bijvoorbeeld voor een nieuwe site of om tegelijk alle [Broken mention](broken://pages/lNZsGGhddgFl6PTvYHOr) aan te passen. |

## Polygonen

Dit stuk admin panel gebruik je om een Polygon toe te voegen. Voor meer informatie over gebruik, zie: [Polygonen](/openstad/manual/how-tos/polygonen).

![Voorbeeld lijst met bestaande polygonen, en de optie om nieuwe toe te voegen.](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FKkq87IFUX8qLqfz0qR8W%2Fimage.png?alt=media\&token=1e23e662-18b2-45f2-9e08-23e07315a9ab)

## Tags

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F8fxxLZA4ZyQgbmS1w9z6%2Fimage.png?alt=media\&token=d82d68b4-0871-4cdb-bd77-b9976bbe564f)

Gebruik tags voor het [Filteren en categoriseren van inzendingen](/openstad/manual/how-tos/filter-ideas). Voeg ze toe met 'Create' en een naam.

## Argumenten

Hier zie je het overzicht van alle uitgebrachte argumenten op de site.

| Instelling                       | Toelichting                                                                                 |
| -------------------------------- | ------------------------------------------------------------------------------------------- |
| Export csv                       | Klik hierop om alle argumenten te exporteren als csv bestand.                               |
| Export xlsx                      | Klik hierop om alle argumenten te exporteren als excel bestand.                             |
| Export ideas with arguments csv  | Klik hierop om alle inzendingen en bijbehorende argumenten te exporteren als csv bestand.   |
| Export ideas with arguments xlsx | Klik hierop om alle inzendingen en bijbehorende argumenten te exporteren als excel bestand. |

## Stemmen

Bij Stemmen zie je een overzicht van de uitgebrachte stemmen. Hier worden de stemmen getoond per inzending, dus als 1 gebruiker 3 inzendingen heeft geselecteerd, zie je hier 3 stemmen.&#x20;

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FmqdqcUi0weBJNXX6yy3H%2Fimage.png?alt=media\&token=d11c1d84-0cc2-4bc0-824a-f905e06ced5e)

Uitleg:&#x20;

* Selectievakje: klik aan om eventueel stemmen te verwijderen. Bijvoorbeeld test stemmen.&#x20;
* ID: ieder stem krijgt een id toegewezen
* Opinion: welke waarde de stem heeft. Bij stemmen zal dit altijd "yes" zijn, bij dislikes zal het "nee" zijn.
* Zipcode: indien ingesteld, de postcode van de stemmer
* IP: ipadres van de stemmer
* Created at: Dag dat de stem is uitgebracht
* Approved: de stem is geldig verklaard, en telt mee.&#x20;
* Export CSV: exporteer het overzicht van alle stemmen in csv formaat.&#x20;
* Export Xlsx: exporteer het overzicht van alle stemmen in excel formaat.&#x20;

## Gebruikers

In Gebruikers zie je een overzicht van wie heeft ingelogd op je site. Ook hier kun je nieuwe gebruikers toevoegen, verwijderen, en het overzicht van gebruikers exporteren als csv of xlsx.&#x20;

## Nieuwsbrief

In Nieuwsbrief zie je de emailadressen van degene die zich hebben aangemeld voor de newsletter. Zie ook [Newsletter](/openstad/manual/how-tos/newsletter).

Ook deze gegevens kun je exporteren als csv of xlsx.&#x20;

## Keuzewijzers

In Keuzewijzers stel je in welk Keuzewijzer jouw site gebruikt.&#x20;

Selecteer 1 uit de lijst of creëer een nieuwe. Geef het een naam en een optionele beschrijving. Volg daarna de stappen in [Keuzewijzer](/openstad/manual/modules/keuzewijzer).

## Acties

Acties gebruik je om een instelling van de site op een vooraf ingeplande moment te veranderen. Dit is heel handig voor bijvoorbeeld het sluiten van&#x20;

\--> Om een nieuwe actie in te stellen, klik eerst op **Create**.

| Instelling         | Toelichting                                                                                                                                                                                                                                                                                                                                                                                                                             |
| ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| ID                 | Dit wordt automatisch ingevuld                                                                                                                                                                                                                                                                                                                                                                                                          |
| Name               | Geef jouw actie een naam om het te herkennen.                                                                                                                                                                                                                                                                                                                                                                                           |
| Type               | Selecteer 'once'.                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Run actions at     | Vul de dag en tijd in dat het actie uitgevoerd moet worden.                                                                                                                                                                                                                                                                                                                                                                             |
| Action             | Selecteer 'update resource'                                                                                                                                                                                                                                                                                                                                                                                                             |
| Resource to select | Selecteer 'Site (update active site)'                                                                                                                                                                                                                                                                                                                                                                                                   |
| Set: Key           | <p>Selecteer een instelling en geen met het schuifje aan of het aan of uit moet gaan op jouw gewenst moment.</p><p><strong>Can add new ideas:</strong> Openen of sluiten van de mogelijkheid om inzendingen in te sturen<br><strong>Voting count publicly available:</strong> Publiceren of verbergen van het aantal stemmen per inzending<br><strong>Voting is open:</strong> Openen of sluiten van de mogelijkheid om te stemmen.</p> |

{% hint style="info" %}
De instelling veranderd alleen aan de 'achterkant' van de site. Dus nadat de actie is uitgevoerd op de site zal het nog lijken bijvoorbeeld alsof je kan stemmen of een inzending uploaden. Echter op het moment dat gebruikers iets willen versturen, krijgen ze dan een foutmelding. Daarom is het nodig om nog daarna een aantal CMS aanpassingen te doen.&#x20;
{% endhint %}

## Mijn gegevens

Zie hier jouw gegevens op de site: welke rol je hebt, welk naam jouw account gebruikt, welk email eraan is gekoppeld, en welk postcode bij het account hoort.&#x20;


# Page Settings

Op elke pagina vind je linksonder onder Page Menu de Page Settings. Hier kun je metadata invullen, de url bepalen en bewerkingsrechten bepalen.

### Instellingen

**Basics**

* Title: Hier vul je de titel van de pagina in&#x20;
* Slug: Hier vul je de url in, dus wat na [www.gemeente.nl](http://www.gemeente.nl) komt. Bijvoorbeeld /contact.
* Type: <mark style="background-color:yellow;">Lees hier meer over de types pagina</mark>
* Resource: kies welke *gegevensbron (resource)* je voor deze pagina wil gebruiken. Zie [Resources](/openstad/manual/miscellaneous/resources) voor meer informatie.
* Redirect user when not logged in: Vul hier de url in waar deze pagina naar moet verwijzen voor bezoekers die niet zijn ingelogd. Bijvoorbeeld naar home: vul in "/".
* Published: Hiermee kun je je pagina publiceren en depubliceren. Zet dit bijvoorbeeld op nee als je pagina nog niet klaar is, maar je alle wijzigingen wel zochtbaar wilt voor mensen die kunnen inloggen.
* Trash: Hiermee kun je pagina weggooien.

**Meta settings**

* Meta title: De titel van je pagina die je zichtbaar wilt op Google (max 70 karakters)
* Meta Description: Beschrijf je pagina in maximaal 155 karakters. Dit wordt weergegeven op Google.
* Meta Tags:

**Permissions**

* Who can view this?: geef aan wie je pagina mag zien, iedereen, inloggen nodig of alleen specifieke mensen.
* These users can edit: Geef aan wie de pagina mag bewerken.
* These groups can edit: Geef hier aan welke groepen de pagina kunnen wijzigen, zoals admins, editors.
* Apply permissions to subpages now: Kies Yes om de permissions ook door te voeren op onderliggende pagina's.

**Info**

* Tags:
* Hide in navigation: Kies ja als je de pagina niet in het menu wilt zien.
* Hide the footer: Kies ja als je op deze pagina geen footer wilt.
* Set the cookiebar fixed at the footer: Kies ja om de cookiebar onderaan de pagina vast te zetten.


# OpenStad hoofdmenu

Het OpenStad hoofdmenu is het menu die [editors en admins ](/openstad/manual/miscellaneous/roles)gebruiken om bepaalde aanpassingen te maken in de site.&#x20;

Je komt in het hoofdmenu als je ingelogd bent op een site en op "OPENSTAD" klikt linksboven in je scherm.&#x20;

Je gebruikt met name "Global" vanuit dit menu. Sommige dingen in dit menu gebruik je helemaal niet, omdat ze instellingen zijn vanuit ApostropheCMS, en OpenStad zijn eigen instellingen daarvoor heeft gebouwd. In dat geval lees je bij die hoofdstukken "dit gebruiken we niet".&#x20;

![Het menu als je het open klikt](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F1zkFP3oUzXUnTOKkpku3%2Fimage.png?alt=media\&token=e7d56b1e-8a28-444d-8330-0e701fec90a3)


# Tags

Tags in de OpenStad Hoofdmenu gebruik je niet.&#x20;

Als je tags wilt gebruiken om bijvoorbeeld inzendingen te categoriseren, doe dat in react admin: [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin).


# Global

In global bewerk je instellingen die voor de hele site van toepassing zijn.

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Ffmn82xg0plW1lTIT0FNq%2Fimage.png?alt=media\&token=b3bd48a0-e594-4c49-a2bf-38c73f7eee39)

## Configuratie opties

#### Algemene instellingen

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Site title</td><td> De titel van de site. Bezoekers krijgen dit ook te zien. Dit komt tevoorschijn bijvoorbeeld: bovenin je window, in emails, in je admin panel, in een tabblad, etc. <br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FSHkSbFBbc44vzD3stjN6%2Fsite%20titel.PNG?alt=media&amp;token=6f304ab9-316e-4338-ac3b-0b9fb5225c09" alt=""></td></tr><tr><td>Hide the site title in the header?</td><td>Yes: je ziet de titel niet bovenaan de pagina.<br>No: de titel verschijnt naast de logo bovenaan de pagina. Zoals: <img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FeCotbEqHFSW60X0ImYAU%2Ftitle%20in%20site.png?alt=media&amp;token=2e55047f-c9d9-44f7-84cc-a3e6b5b0d082" alt=""></td></tr><tr><td>Default FB image when sharing pages (gets overwritten when sharing ideas)</td><td>Upload een afbeelding die tevoorschijn komt als je de url van de site deelt op Facebook. Indien je de url van een inzending deelt, wordt die vervangen door de afbeelding van de inzending (indien er een afbeelding is geupload).</td></tr><tr><td>Favicon</td><td>Upload hier een favicon. Dit is het icoontje wat in je tabblad verschijnt.  <br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FSHkSbFBbc44vzD3stjN6%2Fsite%20titel.PNG?alt=media&amp;token=6f304ab9-316e-4338-ac3b-0b9fb5225c09" alt=""><br>Meer weten? <a href="https://developer.mozilla.org/en-US/docs/Glossary/Favicon">Bekijk deze site.</a></td></tr><tr><td>Author of the modbreaks</td><td>Schijf hier welk naam tevoorschijn komt als je een modbreak invult. <br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FZ9mmHpzHcuL9I8VWO22A%2Fmodbreak%20naam.PNG?alt=media&amp;token=1214ff78-e9fd-44a4-8077-47dbe1c46ab7" alt=""></td></tr></tbody></table>

#### Analytics

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Analytics type</td><td>Kies welk type analytics je wilt gebruiken. </td></tr><tr><td>Google Analytics Property ID (like UA-xxxxx or G-xxxxx)</td><td></td></tr><tr><td>Google Tag Manager Property ID (like GTM-xxxxx)</td><td></td></tr></tbody></table>

#### Url & api instellingen

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Slug van idee pagina</td><td>Een slug (zie ook <a data-mention href="/openstad/manual/miscellaneous/terminology">Terminologie</a>) gebruik je om een pagina te identificeren. Het is meestal na het einde van de url, dus website.org/idee. De idee pagina is de pagina van een individuele inzending.</td></tr><tr><td>Slug van overzichts pagina</td><td>Zie hierboven. De overzichtspagina is de pagina waar alle inzendingen te zien zijn. </td></tr><tr><td>Url van de bewerk pagina</td><td>Zie hierboven. De bewerkpagina is waar je als gebruiker of moderator een inzending bewerkt. Dit is meestal een formulier (<a data-mention href="/openstad/manual/modules/resource-form">Resource form</a>).</td></tr><tr><td>Cache ideas? This optimises performance for sites, only works for sites where ideas are static, most voting sits</td><td></td></tr></tbody></table>

#### Cookie instellingen

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Use a cookie warning</td><td>Yes: gebruikers zien een pop-up om toestemming te vragen voor cookies<br>No: je gebruikt geen cookies dus gebruikers krijgen geen pop-up</td></tr><tr><td>Link to 'about cookies' page</td><td>Indien je hierboven <em>Yes</em> invult: Vul hier de url/slug in met uitleg over de cookies die je gebruikt. </td></tr></tbody></table>

#### Vormgeving

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Logo</td><td>Upload hier een logo die linksboven in de site header komt te staan.</td></tr><tr><td>Where do we want to link the logo towards? (leave empty for default app url)</td><td>Vul hier een slug of url waar gebruikers terecht komen als ze op de logo klikken. Als je het leeg laat, worden ze naar de homepagina van je site gestuurd.</td></tr><tr><td>External stylesheets</td><td></td></tr><tr><td>CSS</td><td></td></tr><tr><td>Apply palette styling</td><td>Zie ook <a data-mention href="/openstad/manual/miscellaneous/openstad-hoofdmenu/open-palette">Open palette</a></td></tr></tbody></table>

#### Footer

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Footer > edit footer</td><td>Title: Maak hiermee een sectie voor een aantal footer links, en geef het een titel. <br>Description: Dit kun je leeg laten voor footers.<br>Links > Edit links: Vul deze in als volgt:<br>> Label: De naam van de footer link<br>> Url: De url of slug van de link<br>> Open in new window: yes; als je erop klikt opent een nieuwe window/tab. no; als je erop klikt wordt je doorgeleid in je huidige browser. </td></tr></tbody></table>

![Voorbeeld footer. "Over deze site", "Meer informatie" en "Contact" zijn Titles; De links daaronder zoals "Privacyverklaring" is een Label. ](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FgDyuTpNxjWYO3HgOzgaW%2Fimage.png?alt=media\&token=330f1b50-aded-4ef1-95a0-6780e9833d24)

#### Map

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Map center Latitude</td><td>Indien je ergens een kaart gebruikt op je site, kan je hier de gewenste breedtegraad invullen.</td></tr><tr><td>Map center Longitude</td><td>Indien je ergens een kaart gebruikt op je site, kan je hier de gewenste lengtegraad invullen.</td></tr><tr><td>Map zoom level</td><td>Selecteer hoe ver je de kaart ingezoomd wilt hebben.</td></tr><tr><td>Openstreet Maps ServerUrl (not implemented yet)</td><td></td></tr><tr><td>Selecteer een polygon</td><td>Kies eventueel een polygon voor je kaart. Hiermee worden grenzen getoond. <br>Zie ook: <a data-mention href="/openstad/manual/how-tos/polygonen">Polygonen</a></td></tr><tr><td>Welke kleur vlag moet er getoond worden op de plattegrond in het begroten overzicht en op de planpagina?</td><td>Kies hiermee welke kleur vlaggetje wordt getoond op de kaart als inzendingen een specifieke locatie selecteren. </td></tr></tbody></table>

#### Hoofdmenu

<table><thead><tr><th width="286.2923880134157">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>How to display the main menu?</td><td><em>Display pages automatically</em>: Hiermee worden alle pagina's die gepubliceerd zijn opgenomen in de menubalk. Tenzij: in de <a data-mention href="/openstad/manual/miscellaneous/page-settings">Page Settings</a> van een pagina je hebt gekozen voor Info > Hide in Navigation > Yes. <br><em>Arrange menu items manually:</em> Hiermee selecteer je handmatig welk pagina's je in de main menu wilt hebben. Als je dit aanklikt krijg je een extra instelling te zien: menu items. Zie hieronder voor meer informatie. <br><em>Hide the menu items:</em> hiermee toon je niks in het menubalk. Let op: dit is alleen voor bezoekers. Als je bent ingelogd als moderator of admin, zie je alsnog de menu items. </td></tr><tr><td>Display login and logout link in top links?</td><td>Yes: rechtsboven in de site zie je een knopje "Inloggen"/ "Uitloggen". Dit is meestal goed om te doen als gebruikers van je site een account nodig hebben. <br>No: Inloggen/Uitloggen wordt niet getoond. <br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FpMn8TFXLZTIYWC9YTYoe%2Finloggen.PNG?alt=media&amp;token=dc99ee6a-32be-4888-a85b-0461988f40ba" alt=""></td></tr><tr><td>Menu items</td><td>Hiermee kun je handmatig onderdelen van de menu aanmaken.<br>> Label: De naam van de menu onderdeel<br>> Url: De url of slug van de link<br>> Open in new window: yes; als je erop klikt opent een nieuwe window/tab. no; als je erop klikt wordt je doorgeleid in je huidige browser. </td></tr><tr><td>CTA button text</td><td>CTA = Call To Action. Vul hier de tekst in die je wilt hebben op een button aan de rechter kant van het menubalk.<br>Hier is bijvoorbeeld de CTA tekst "Stuur je plan in". <br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FpMn8TFXLZTIYWC9YTYoe%2Finloggen.PNG?alt=media&amp;token=dc99ee6a-32be-4888-a85b-0461988f40ba" alt=""></td></tr><tr><td>CTA button url</td><td>Vul hier de url of slug in waar mensen naartoe worden geleid als ze op de CTA button klikken. </td></tr><tr><td>Top links</td><td>Vul hier in eventuele extra top links (links rechtsboven de menubalk) die je wilt hebben. <br>> Label: De naam van de link<br>> Url: De url of slug van de link<br>> Open in new tab: yes; als je erop klikt opent een nieuwe window/tab. no; als je erop klikt wordt je doorgeleid in je huidige browser. <br>>Display depending on user logged in status?: Kies hier of je de link wil laten zien aan bepaalde gebruikers. Sommige instellingen (zoals "Mijn account") kun je alleen aanpassen als je bent ingelogd, dus dan wil je die waarschijnlijk alleen laten zien aan ingelogde gebruikers. </td></tr><tr><td>Display my account in main menu?</td><td>Yes: Inloggen/Uitloggen link worden getoond rechts in het menubalk, na de CTA button.<br>No: Inloggen/Uitloggen link worden niet getoond in het menubalk. <br><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F2iTgIP50D9faqpU0HfWd%2Fmain%20menu.PNG?alt=media&amp;token=ce071916-2a42-4716-8530-38a6f9cc1062" alt=""></td></tr><tr><td>My account button text</td><td>Indien je "Yes" hebt gekozen bij Display my account in main menu? Vul hier in de tekst die je wilt tonen (als een gebruiker niet is ingelogd). Als je het leeg laat wordt automatisch "Mijn Account" getoond. </td></tr></tbody></table>

#### Roles & rights

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>What role is necessary to like an idea?</td><td>Kies of gebruikers ingelogd moeten zijn of als anoniem een inzending kunnen liken. </td></tr></tbody></table>

#### Newsletter

Als je bijvoorbeeld emailadressen wilt verzamelen om gebruikers op de hoogte te houden over het project, kan je Newsletter gebruiken. (Meer info: [Newsletter](/openstad/manual/how-tos/newsletter))

![Met de instellingen hieronder, verander je de tekst in deze pop-up. ](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FjcTAlMxvLUprmwIvhjyB%2Fimage.png?alt=media\&token=580930b5-ca7b-4b84-b54e-1ecd332ba25c)

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Title for the popup</td><td>Typ hier de titel die gebruikers zien als ze de Newsletter openen.</td></tr><tr><td>Description for the popup</td><td>Typ hier de uitleg die gebruikers zien bij het invullen van hun gegevens.</td></tr><tr><td>Newsletter form fields</td><td>Default value is voornaam &#x26; emailadres. Als je meer informatie wilt weten van aanmelders kun je hier meer velden toevoegen. </td></tr><tr><td>Submit button</td><td>Typ hier de tekst die getoond wordt op de button als mensen hun gegevens willen opsturen.</td></tr><tr><td>Cancel button</td><td>Typ hier de tekst die getoond wordt op de button als mensen toch niet willen aanmelden.</td></tr><tr><td>Use a captcha as protection?</td><td>Yes: om aan te melden moeten gebruikers een captcha code overtikken.<br>No: gebruikers kunnen zonder captcha code aanmelden voor de nieuwsbrief.</td></tr><tr><td>Captcha Label</td><td>Typ hier de tekst die getoond wordt boven het veld waarin mensen hun captcha code moeten overtikken.</td></tr><tr><td>Text for captcha refresh</td><td>Type hier de tekst waar gebruikers op kunnen klikken als ze een nieuwe captcha code willen.</td></tr></tbody></table>

{% hint style="warning" %}
Let op: je moet ook in [Adminpanel](/openstad/manual/miscellaneous/adminpanel) zorgen dat Newsletter open staat voor nieuwe registraties.&#x20;
{% endhint %}

#### Themes, areas & idea types

Met thema's en buurten kan je de inzendingen categoriseren. Hier stel je de opties in die gebruikers zien als ze de [Resource form](/openstad/manual/modules/resource-form) invullen.

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Thema's</td><td>Opmaak en instelling van de thema's. Zie <a data-mention href="#extra-info-themas">#extra-info-themas</a></td></tr><tr><td>Buurten</td><td>Typ hier de name van de buurten die je gebruikt.<br><strong>Let op:</strong> Indien je geen buurten gebruikt, verwijder dan alle items zodat buurten leeg is. Dan krijgen gebruikers de vraag ook niet te zien in de resource form.</td></tr><tr><td>Typen ideeën</td><td>Opmaak en instelling van inzendingen voor de <a data-mention href="/openstad/manual/how-tos/interactieve-kaart">Interactieve kaart</a>. Zie <a data-mention href="#extra-info-typen-ideeen">#extra-info-typen-ideeen</a></td></tr></tbody></table>

#### *Extra info Thema's --> vanuit* [#themes-areas-and-idea-types](#themes-areas-and-idea-types "mention")

|                                                                                    |                                                                                                                                                                                                                                                                                                                                                                            |
| ---------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Name                                                                               | Typ hier de naam van het thema. Dit kunnen gebruikers selecteren bij het insturen van hun inzending.                                                                                                                                                                                                                                                                       |
| Welke vlag moet er getoond worden bij dit thema?                                   | Kies de kleur vlag (als er een locatie op de kaart wordt gekozen bij het insturen van deze inzending)                                                                                                                                                                                                                                                                      |
| Upload een vlag (liefst png)                                                       | Upload eventueel een icoon voor de vlag.                                                                                                                                                                                                                                                                                                                                   |
| Map Flag Width                                                                     | Pas hiermee de breedte aan van de zelf geüploade icoon.                                                                                                                                                                                                                                                                                                                    |
| Map Flag height                                                                    | Pas hiermee de hoogte aan van de zelf geüploade icoon.                                                                                                                                                                                                                                                                                                                     |
| Icon op de kaart (JSON, momenteel alleen Kaartapplicatie)                          |                                                                                                                                                                                                                                                                                                                                                                            |
| Icon in de lijst (JSON, momenteel alleen Kaartapplicatie)                          |                                                                                                                                                                                                                                                                                                                                                                            |
| Wat is de kleur van dit thema (momenteel alleen voor Budgeting per thema)          | <p>Indien je gebruik maakt van<a data-mention href="/openstad/manual/modules/participatory-budgeting#voting-options">/pages/wehzhN0Fcz3pMVdYv2uD#voting-options</a> Voting type > Budgeting per thema: kies een kleur die de plannen met dit thema krijgen. <br>Gebruik de <a href="https://developer.mozilla.org/en-US/docs/Web/CSS/hex-color">hex color</a> format. </p> |
| Available Budget (momenteel alleen voor Budgeting per thema)                       | Indien je gebruik maakt van[Participatory budgeting](/openstad/manual/modules/participatory-budgeting#voting-options) Voting type > Budgeting per thema: kies het maximum bedrag die beschikbaar is voor plannen met dit thema.                                                                                                                                            |
| Minimum budget that has to be selected (momenteel alleen voor Budgeting per thema) | Indien je gebruik maakt van[Participatory budgeting](/openstad/manual/modules/participatory-budgeting#voting-options) Voting type > Budgeting per thema: kies het minimum bedrag die beschikbaar is voor plannen met dit thema.                                                                                                                                            |
| Maximum selectable ideas (momenteel alleen voor Budgeting - count per thema)       | Indien je gebruik maakt van[Participatory budgeting](/openstad/manual/modules/participatory-budgeting#voting-options) Voting type > Count per thema: kies het maximum aantal plannen die gebruikers kunnen kiezen voor plannen met dit thema.                                                                                                                              |
| Minimum selectable ideas (momenteel alleen voor Budgeting - count per thema)       | Indien je gebruik maakt van[Participatory budgeting](/openstad/manual/modules/participatory-budgeting#voting-options) Voting type > Count per thema: kies het minimum aantal plannen die gebruikers kunnen kiezen voor plannen met dit thema.                                                                                                                              |

#### *Extra info Typen ideeën --> vanuit* [#themes-areas-and-idea-types](#themes-areas-and-idea-types "mention")

|                                          |   |
| ---------------------------------------- | - |
| Naam                                     |   |
| Waarde                                   |   |
| Label op detail pagina                   |   |
| Tekst kleur, onder meer voor labels      |   |
| Achtergrondkleur, onder meer voor labels |   |
| Icon op de kaart                         |   |
| Icon in ideeën overzicht                 |   |
| Icon op buttons                          |   |
| Tekst op buttons                         |   |

####

#### Formatted (system use only, visible for debugging, will be hidden in future)

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Formatted CSS</td><td></td></tr><tr><td>Formatted Logo</td><td></td></tr></tbody></table>


# Open palette

Met palette kan je vormgeving van de site aanpassen.

Klik op Open palette om een menu aan de rechterhand van je scherm te openen.

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FE073YEXZI1zETSimOJdr%2Fimage.png?alt=media\&token=de9a1d99-a709-4770-8347-244ec192b7de)

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Logo</td><td>Pas hiermee de lengte en breedte van je logo rechtsboven aan. </td></tr><tr><td>Header</td><td>Pas hiermee de kleuren en spacing aan van de header en CTA button.</td></tr><tr><td>Buttons &#x26; links</td><td>Pas hiermee de kleuren en spacing aan van buttons die je toevoegt aan de site. </td></tr><tr><td>Footer</td><td>Pas hiermee de kleuren aan van de footer. </td></tr></tbody></table>

Als je klaar bent met palette bewerking, klik op OPENSTAD linksboven om de OpenStad hoofdmenu te openen. Dan kun je op 'Close palette' klikken.&#x20;


# Clear cache

Clear cache in de OpenStad Hoofdmenu gebruik je niet.&#x20;


# Pages

Via Pages kun je alle pagina's op je site bekijken en aanpassen.

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FdsksRjkP9J8aILJdxfyd%2Fimage.png?alt=media\&token=d7ef3591-a95a-4f04-aebd-03f341bb54e6)

* Hier zie je het overzicht van alle pagina's op je site.
* Om een nieuwe pagina aan te maken, klik je rechtboven op New Page. Zie [Nieuwe pagina's toevoegen](/openstad/manual/how-tos/new-page).
* Als je een pagina in het lijstje aan vinkt, heb je verschillende opties.&#x20;
  * Trash (weggooien);&#x20;
  * Rescue (herstellen);&#x20;
  * Publish (zichtbaar voor alle gebruikers);&#x20;
  * Unpublish (alleen zichtbaar voor bepaalde rollen, niet de basis member);&#x20;
  * Add tag to selected: dit gebruik je niet
  * Remove tag from selected: dit gebruik je niet
  * Submit: dit gebruik je niet
  * Commit (Als je op *Commit* drukt dan maak je zo een momentopname van de pagina. **De wijzigingen die je hebt gemaakt op de pagina en die tot dan toe alleen nog voor jou zichtbaar waren in de&#x20;*****Draft modus,*****&#x20;worden doorgevoerd en publiekelijk zichtbaar voor iedereen als je op&#x20;*****Commit*****&#x20;drukt.**)
  * Force export: dit gebruik je niet
* Je kan de instellingen per pagina bewerken via de Pages menu of op de individuele pagina. Bekijk  [Page Settings](/openstad/manual/miscellaneous/page-settings).


# Users

Users pas je niet aan of voeg je niet toe vanuit het OpenStad Hoofdmenu. Mocht je iets met users willen doen, kan dat via [Adminpanel](/openstad/manual/miscellaneous/adminpanel) of [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin).


# Images

Afbeeldingen die op de website via het CMS worden geüpload zie je hier.

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2Fba6Nd0In688a5EoRLVFO%2Fimage.png?alt=media\&token=719efe10-596f-4795-b830-c7c86d411300)


# Files

In files kun je bestanden toevoegen aan de site en vervolgens bewerken.

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FcqT2mL92Qgbb5Ontr5oj%2Fimage.png?alt=media\&token=b62e3562-bd05-4442-8d04-cc313478fe60)

Klik op Add File rechtsboven om een bestand te uploaden.&#x20;

#### Basics

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Title</td><td>Typ hier het titel van je bestand</td></tr><tr><td>Slug</td><td>Typ hier de slug voor je bestand</td></tr><tr><td>Published</td><td>Yes: het bestand is zichtbaar voor alle gebruikers<br>No: het bestand is alleen zichtbaar voor bepaalde gebruikers</td></tr><tr><td>Trash</td><td>Yes: Verwijder het bestand<br>No: Het bestand is niet verwijderd</td></tr><tr><td>Tags</td><td></td></tr><tr><td>View file (aan de rechter kant)</td><td>Open het bestand wat je hebt geupload. <br><strong>Tip:</strong> als je rechtsklikt op dit knop kun je "Linkadres kopieren" klikken. Hiermee kopieer je de link naar je bestand op deze site. Deze link kun je achter een button zetten zodat gebruikers je bestand zelf kunnen openen. </td></tr><tr><td>Upload File (aan de rechter kant) </td><td>Upload of vervang het bestand.</td></tr></tbody></table>

#### Info

<table><thead><tr><th width="274.78411910669973">Instelling</th><th>Toelichting</th></tr></thead><tbody><tr><td>Description</td><td>Vul een omschrijving in van je bestand.</td></tr><tr><td>Credit</td><td></td></tr><tr><td>Credit URL</td><td></td></tr></tbody></table>


# Workflow

Via workflow kun je de aanpassingen zien in de

Via **Submitted** kan je zien welke pagina's zijn submitted (al gebruiken we dit niet).&#x20;

Via **Manage** kan je aanpassingen maken op de hele site tegelijk. Het belangrijkste mogelijkheid hiermee is: Batch commit.&#x20;

* Klik alle documenten aan via de checkbox.
* Klik onderaan op 'Commit selected'.
* Klik op 'Batch commit'.&#x20;
* Nadat het laadt, zijn alle aanpassingen die je hebt gemaakt ge-commit.&#x20;


# Logout

Klik op Logout om de bewerkmodus uit te loggen.&#x20;


# Styles for the container

Styles for the container is een aanpassing die je onder Styling in contentblokken terugvindt. Je kunt hier een aantal eigenschappen van de widget aanpassen met CSS styling.

**CSS property**

Kies hier welke eigenschap je wilt aanpassen, bijvoorbeel marges, de grootte of positie. [Op deze site vind je handige info over CSS styling](https://www.w3schools.com/css/).

**CSS Value**

Kies hier de waarde van de eigenschap, dus bijvoorbeeld hoeveel pixels (..px) de marge of afmeting moet zijn of welke positie iets moet krijgen.

![In dit voorbeeld verschuift een kolom 23 pixels omhoog op zowel mobiel als desktop. Hierdoor is er bijvoorbeeld minder witruimte.](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FzLc6bPfzx3MYjMuSbXXO%2Fimage.png?alt=media\&token=e0102da4-86d7-4b07-894c-a191d318f9b2)

**Media Query**

Je kunt voor verschillende apparaten verschillende eigenschappen instellen. Heeft iets op mobiel bijvoorbeeld veel witruime, kies dan een aangepaste margin alleen voor Phone.&#x20;


# Interactieve kaart thema iconen

{% hint style="info" %}
Het gebruik van thema iconen op de kaart is een relatief technisch verhaal. In de toekomst zal dit gebruiksvriendelijker gemaakt worden, maar tot die tijd is er bepaalde kennis van webontwikkeling vereist.
{% endhint %}

Dit artikel is momenteel alleen van toepassing op de interactieve kaart, zie de how-to en widget referentie voor meer informatie:

{% content-ref url="/pages/rFm9Ak9B0XFWS1cXDscq" %}
[Interactieve kaart](/openstad/manual/how-tos/interactieve-kaart)
{% endcontent-ref %}

{% content-ref url="/pages/aoHXeGVNhO72bQamBDu2" %}
[Ideeën op een kaart (Kaart applicatie)](/openstad/manual/modules/ideeen-op-een-kaart-kaart-applicatie)
{% endcontent-ref %}

Daarnaast is dit artikel een aanvulling op het instellen van thema's op een website. De basis hiervoor wordt hier uitgelegd:

{% content-ref url="/pages/QjsFzmcmio5GEsYX4fIs" %}
[Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global)
{% endcontent-ref %}

Dit artikel gaat over de drie verschillende soorten iconen die in de interactieve kaart gebruikt worden; de markers die een inzending op de kaart aangeven, de icoontjes op de tegels in de lijstweergave, en de marker die een geselecteerde locatie op de kaart aan geeft.

![Twee verschillende soorten iconen in de interactieve kaart; links in de lijstweergave en rechts op de kaart.](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FmxuV7TnvRQBU9vHBr9vi%2FInteractieve%20kaart%20-%20iconen.png?alt=media\&token=3747474c-2e44-4f77-8a39-945685ba3ca5)

## Iconen definiëren

De iconen definieer je in het [JSON formaat](https://developer.mozilla.org/en-US/docs/Glossary/JSON).

Van alle iconen heeft het JSON object de volgende onderdelen:

| Key      | Toelichting                                                                                                                                                                                                            |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| "html"   | De afbeelding van het icoon in [SVG formaat](https://developer.mozilla.org/en-US/docs/Web/SVG). Vul de SVG in als een string. Let op: de SVG string moet je [escapen](https://www.freeformatter.com/json-escape.html). |
| "width"  | De hoogte van het icoon in aantal pixels, als [number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number).                                                                       |
| "height" | De breedte van het icoon in aantal pixels, als [number](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number).                                                                      |

In het geval van de inzendingen op de kaart en de geselecteerde-locatie-marker, is het ook nodig om het ankerpunt van het icoon aan te geven:

| Key      | Toelichting                                                                                                                                                                                                                                                                                                                    |
| -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| "anchor" | De positionering van het ankerpunt van de marker op de kaart, aangegeven met de x- en y-waarden in pixels, in een [array](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array) van twee [numbers](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number). |

In het geval van de geselecteerde-locatie-marker moet de volgende className toegeovegd worden:

| Key         | Waarde                  |
| ----------- | ----------------------- |
| "className" | "osc-ideas-on-map-icon" |

De iconen van inzendingen op de kaart en in de lijstweergave stel je in bij thema's in [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global), de geselecteerde-locatie-marker geef je aan in de widget-instellingen onder [Ideeën op een kaart (Kaart applicatie)](/openstad/manual/modules/ideeen-op-een-kaart-kaart-applicatie#kaart).

### Voorbeelden

#### Icoon in lijstweergave

<div align="center"><img src="https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2FrXGlRdy8GtbwjwDLNd8G%2Ficon-lijstweergave.svg?alt=media&amp;token=3ca5c303-1036-4030-a7be-5b645485e14e" alt=""></div>

```
{
  "html": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"34\" height=\"34\" viewBox=\"0 0 34 34\">  <g fill=\"none\" fill-rule=\"evenodd\">    <circle cx=\"17\" cy=\"17\" r=\"17\" fill=\"#EC0000\" fill-rule=\"nonzero\"/>    <path fill=\"#FFF\" d=\"M22,19.5 C23.0355,19.5 23.875,20.3395 23.875,21.375 C23.875,22.4105 23.0355,23.25 22,23.25 C20.9645,23.25 20.125,22.4105 20.125,21.375 C20.125,20.3395 20.9645,19.5 22,19.5 Z M11.375,19.5 C12.4105,19.5 13.25,20.3395 13.25,21.375 C13.25,22.4105 12.4105,23.25 11.375,23.25 C10.3395,23.25 9.5,22.4105 9.5,21.375 C9.5,20.3395 10.3395,19.5 11.375,19.5 Z M18.875,11.375 L23.25,15.75 L27,15.75 L27,21.375 L25.125,21.375 C25.125,19.6491 23.7259,18.25 22,18.25 C20.2741,18.25 18.875,19.6491 18.875,21.375 L14.5,21.375 C14.5,19.6491 13.1009,18.25 11.375,18.25 C9.64911,18.25 8.25,19.6491 8.25,21.375 L7,21.375 L7,15.75 L11.375,11.375 L18.875,11.375 Z M18.25,12.625 L15.125,12.625 L15.125,15.75 L21.3512,15.75 L18.25,12.625 Z M13.875,12.625 L12,12.625 L8.875,15.75 L13.875,15.75 L13.875,12.625 Z\"/>  </g></svg>",
  "width": 34,
  "height": 34
}
```

#### Icoon op de kaart

![](https://1929732892-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FteZWnRGpaZe4HXNXvrFs%2Fuploads%2F2boiixSi1xz8UjUKQDvE%2Ficon-kaart.svg?alt=media\&token=a0ceae64-09fa-4257-bf5c-c2e9957b2220)

```
{
  "html": "<svg xmlns=\"http://www.w3.org/2000/svg\" width=\"34\" height=\"45\" viewBox=\"0 0 34 45\">  <g fill=\"none\" fill-rule=\"evenodd\">    <path fill=\"#EC0000\" fill-rule=\"nonzero\" d=\"M17,0 C26.3917,0 34,7.53433 34,16.8347 C34,29.5249 19.3587,42.4714 18.7259,42.9841 L17,44.4938 L15.2741,42.9841 C14.6413,42.4714 0,29.5249 0,16.8347 C0,7.53575 7.60829,0 17,0 Z\"/>    <path fill=\"#FFF\" d=\"M22,19.5 C23.0355,19.5 23.875,20.3395 23.875,21.375 C23.875,22.4105 23.0355,23.25 22,23.25 C20.9645,23.25 20.125,22.4105 20.125,21.375 C20.125,20.3395 20.9645,19.5 22,19.5 Z M11.375,19.5 C12.4105,19.5 13.25,20.3395 13.25,21.375 C13.25,22.4105 12.4105,23.25 11.375,23.25 C10.3395,23.25 9.5,22.4105 9.5,21.375 C9.5,20.3395 10.3395,19.5 11.375,19.5 Z M18.875,11.375 L23.25,15.75 L27,15.75 L27,21.375 L25.125,21.375 C25.125,19.6491 23.7259,18.25 22,18.25 C20.2741,18.25 18.875,19.6491 18.875,21.375 L14.5,21.375 C14.5,19.6491 13.1009,18.25 11.375,18.25 C9.64911,18.25 8.25,19.6491 8.25,21.375 L7,21.375 L7,15.75 L11.375,11.375 L18.875,11.375 Z M18.25,12.625 L15.125,12.625 L15.125,15.75 L21.3512,15.75 L18.25,12.625 Z M13.875,12.625 L12,12.625 L8.875,15.75 L13.875,15.75 L13.875,12.625 Z\"/>  </g></svg>",
  "width": 34,
  "height": 45,
  "anchor": [17,45]
}
```


# Inzendingen (ideas)

### Database velden

{% hint style="info" %}
Sommige database velden beginnen met `extraData.` . Je bent zelf vrij om hier eigen velden aan toe te voegen. Let wel op: deze data is **niet** zorgvuldig afgeschermd, dus zorg dat je dit niet gebruikt voor gevoelige informatie zoals persoonsgegevens.
{% endhint %}

| Database veld        | Toelichting                | Voorbeeld                                                              |
| -------------------- | -------------------------- | ---------------------------------------------------------------------- |
| id                   |                            |                                                                        |
| title                |                            |                                                                        |
| summary              |                            |                                                                        |
| description          |                            |                                                                        |
| status               |                            |                                                                        |
| budget               |                            |                                                                        |
| location             | JSON formaat               | `{"type":"Point","coordinates":[52.37307089425847,4.899129867553712]}` |
| extraData.images     | URL string(s) in een array | `["https://image.server.com/image/g46387tyg674"]`                      |
| extraData.area       |                            |                                                                        |
| extraData.theme      |                            |                                                                        |
| extraData.originalId |                            |                                                                        |
| ...                  |                            |                                                                        |

{% hint style="info" %}
*Inzendingen (ideas)* zijn één van de beschikbare *gegevensbronnen (resources)*, voor meer info zie [Resources](/openstad/manual/miscellaneous/resources).
{% endhint %}


# Artikelen (articles)

Artikelen zijn een versimpelde afgeleide van [Inzendingen (ideas)](/openstad/manual/miscellaneous/inzendingen-ideas). Ze worden voornamelijk gebruikt door editors of moderators (zie [Rollen](/openstad/manual/miscellaneous/roles)) om content op een website te plaatsen, en zijn niet ontwikkeld om door willekeurige bezoekers van de website geplaatst/bewerkt te worden.

In tegenstelling tot *inzendingen (ideas);*

* hebben artikelen **geen** status.
* kan er **niet** op artikelen gestemd/geliked worden.
* kunnen er **geen** reacties onder artikelen geplaatst worden.

{% hint style="info" %}
*Artikelen (articles)* zijn één van de beschikbare *gegevensbronnen (resources)*, voor meer info zie [Resources](/openstad/manual/miscellaneous/resources).
{% endhint %}


# Gebruikers (users)

{% hint style="info" %}
*Gebruikers (users)* zijn één van de beschikbare *gegevensbronnen (resources)*, voor meer info zie [Resources](/openstad/manual/miscellaneous/resources).
{% endhint %}


# Authenticatie methodes

* Login link
* Stemcodes
* (Postcode)


# Rollen

Op deze pagina lees je meer over de verschillende rollen voor gebruikers in OpenStad.

### Anonymous

De eerste laag gebruikers zijn *anonymous*. Dit zijn gebruikers die wel zijn geregistreerd, maar alleen tijdelijk met informatie die hen anoniem houdt. Wel wordt het ip-adres geregistreerd. Dit zijn gebruikers van de website en dus deelnemers aan het traject.&#x20;

Bijvoorbeeld: het liken van een plan (waarbij je vaak een postcode moet invoeren) creëert een *anonymous* gebruiker.&#x20;

### Member

De volgende laag van gebruikers noemen we *members.* Dit zijn gebruikers van de sites die zich registreren met een account. Om een OpenStad account aan te maken moet je je registreren, bijvoorbeeld door een mailadres in te vullen, of je telefoonnummer voor een SMS code. Dit zijn gebruikers van de website en dus deelnemers aan het traject.&#x20;

Bijvoorbeeld: mensen die een plan hebben ingediend op een site zijn *members*. Gebruikers die een opmerking hebben geplaatst op een plan of een idee zijn ook *members.* Verder zijn gebruikers die zich registreren voor de nieuwsbrief ook *members.*&#x20;

*Het verschil in het kort: met een member account kun je later op de site terug komen en wordt je herkend. Als een anonymous user niet.*

### Moderator

Moderatoren zijn de eerste niveau van rollen aan de 'achterkant'. Dit is een belangrijke rol om het project te faciliteren. Daarmee kun je vooral aanpassingen maken op de inzendingen die members en anons insturen op de site.&#x20;

Voor een uitgebreide toelichting van hoe moderatie werkt, ga naar [Moderatie](/openstad/manual/how-tos/moderation).&#x20;

Meestal zijn moderatoren leden van het projectteam. Zij houden de site in de gaten tijdens de periode dat het live is.

### Editor

Editors zijn de volgende rol aan de 'achterkant'. Editors kunnen individuele sites opbouwen en aanpassen, widgets toevoegen en verwijderen, instellingen veranderen, tekst aanpassen, en nog meer. Editors passen instellingen aan via [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin).&#x20;

Alles wat staat beschreven in [Widgets referentie](/openstad/manual/modules) is de rol van editors. Ook kunnen editors heel veel van de [How-to's](/openstad/manual/how-tos) uitvoeren, al zijn een aantal bestemd voor admins.&#x20;

Meestal zijn editors webredacteuren of communicatieadviseurs.&#x20;

### Admin

Admins zijn de laatste niveau van de achterkant. Admins kunnen alles: sites aanmaken, verwijderen, anonimiseren, stemcodes aanmaken, en nog meer. Admins hebben 1 overzicht [Adminpanel](/openstad/manual/miscellaneous/adminpanel) met alle OpenStad sites, gebruikers, en benodigde instellingen.&#x20;

Meestal zijn webmasters, developers en beheerders degene met admin rechten.&#x20;


# URL's


# Testen

*Status: WIP*

Het is verstandig de websites altijd nog eens goed na te lopen en te testen voordat deze publiekelijk beschikbaar worden. Hiermee voorkom je dat je er achter komt dat teksten en instellingen niet goed staan op het moment dat de website al live is. Hier staan enkele tips beschreven die handig zijn tijdens het testen van de websites.

* Gebruik accounts met verschillende rollen (gebruiker, moderator, admin); gmail tip
* Ingediende plannen verwijderen, via site of admin panel
* Stemmen weer verwijderen via admin panel
* Unieke stemcodes: paar apart houden om te testen, daarna niet veregten stemmen te verwijderen
* ...

\[ TODO Wordt o.a. naar verwezen in de how-to ‘Unieke stemcodes’. Uitleggen hoe je stemcodes test en deze ook weer verwijderd voor livegang. ]


# Raw

Op verschillende plekken in de software kun je de mogelijkheid tegenkomen om ‘raw’ input in te voeren. Dit betekent dat er hier ruimte is om HTML met [Nunjucks templating code](https://mozilla.github.io/nunjucks/) in te voeren. Hiervoor is enige webontwikkeling ervaring vereist.

In de verschillende gevallen dat er ruimte is om zelf raw code in te voeren, kan er ook gebruik gemaakt worden van verschillende [variabelen die middels Nunjucks weergegeven kunnen worden](https://mozilla.github.io/nunjucks/templating.html#variables). Welke variabelen dat zijn, wordt in de desbetreffende [Widgets referentie](/openstad/manual/modules) op een rijtje gezet.


# Resources

Op verschillende plekken kom je de instelling tegen om een bepaalde *resource* te selecteren. Dit concept is geïntroduceerd om bepaalde widgets generiek bruikbaar te maken voor verschillende doeleinden.

*Resource* laat zich in het Nederlands vertalen naar *(hulp)bron* of *gegevensbron*. In dit geval is dat een bron van gegevens uit de achterliggende database; namelijk *inzendingen (ideas)*, *artikelen (articles)* of *gebruikers (users)*. Deze verschillende gegevensbronnen hebben dezelfde soort generieke functionaliteiten nodig, bijvoorbeeld om gegevens in te voeren of te bewerken in een *formulier (form)*, of de opgeslagen gegevens te tonen in een *overzicht (overview).* In deze en meer generieke functionaliteiten wordt voorzien door de 'resource ...'-widgets.

Bij sommige van deze widgets kies je in de instellingen van de widget zelf voor welke gegevensbron je de widget wil gebruiken, namelijk:

* [Resource form](/openstad/manual/modules/resource-form)
* [Resource overview](/openstad/manual/modules/resource-overview)

Daarnaast zijn er verschillende widgets die ook van een bepaalde resource gebruik maken, maar waarbij je in de widget zelf niet kunt instellen voor welke soort resource dat zou moeten zijn. Bij deze groep widgets wordt de resource gebruikt die op het niveau van de gehele pagina staat ingesteld in [Page Settings](/openstad/manual/miscellaneous/page-settings). Deze groep widgets bestaat uit:

* [Resource representation](/openstad/manual/modules/resource-representation)
* [Resource image](/openstad/manual/modules/resource-image)
* [Resource admin buttons](/openstad/manual/modules/resource-admin-buttons)
* [Resource raw widget](/openstad/manual/modules/resource-raw-widget)

### Resource keuzeopties

| Optie         | Toelichting                                                                                                                                                                                                                                                |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Idea          | Gebruik *inzendingen* als gegevensbron, zie [Inzendingen (ideas)](/openstad/manual/miscellaneous/inzendingen-ideas) voor meer info.                                                                                                                        |
| Article       | Gebruik *artikelen* als gegevensbron, zie [Artikelen (articles)](/openstad/manual/miscellaneous/artikelen-articles) voor meer info.                                                                                                                        |
| Active user   | Gebruik de *actieve/ingelogde gebruiker* als gegevensbron, zie [Gebruikers (users)](/openstad/manual/miscellaneous/gebruikers-users) voor meer info.                                                                                                       |
| Resource user | Gebruik een *specifieke gebruiker* als gegevensbron, aangeduid met een *gebruikers-id (user-id)*. Dit is dus onafhankelijk van de eventuele ingelogde gebruiker. Zie [Gebruikers (users)](/openstad/manual/miscellaneous/gebruikers-users) voor meer info. |




---

[Next Page](https://docs.openstad.org/openstad/llms-full.txt/1)

