# 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 [show-ideas](https://docs.openstad.org/openstad/manual/how-tos/show-ideas "mention") 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](https://docs.openstad.org/openstad/manual/miscellaneous/resources "mention") 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 [#maximaal-een-inzending-plan-kiezen](https://docs.openstad.org/openstad/how-tos/voting#maximaal-een-inzending-plan-kiezen "mention") (onder [voting](https://docs.openstad.org/openstad/manual/how-tos/voting "mention")) 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 [#inzending-detailpagina](https://docs.openstad.org/openstad/how-tos/show-ideas#inzending-detailpagina "mention") (onder [show-ideas](https://docs.openstad.org/openstad/manual/how-tos/show-ideas "mention")) 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](https://docs.openstad.org/openstad/manual/miscellaneous/raw "mention") 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](https://docs.openstad.org/openstad/manual/modules/arguments "mention") 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&#x26;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&#x26;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&#x26;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&#x26;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](https://docs.openstad.org/openstad/manual/miscellaneous/inzendingen-ideas "mention") 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&#x26;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&#x26;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 [#vormgeving](https://docs.openstad.org/openstad/miscellaneous/openstad-hoofdmenu/global#vormgeving "mention") in het [global](https://docs.openstad.org/openstad/manual/miscellaneous/openstad-hoofdmenu/global "mention") 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&#x26;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&#x26;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&#x26;token=5fbf92bf-4716-4ca5-bae3-19ac6afe9804" alt=""><br><br>Zie ook <a data-mention href="../../miscellaneous/openstad-hoofdmenu/global#themes-areas-and-idea-types">#themes-areas-and-idea-types</a> onder <a data-mention href="../miscellaneous/openstad-hoofdmenu/global">global</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&#x26;token=f4113046-898d-4171-949d-196fb0ba0e47" alt=""><br><br>Zie ook <a data-mention href="../../miscellaneous/openstad-hoofdmenu/global#themes-areas-and-idea-types">#themes-areas-and-idea-types</a> onder <a data-mention href="../miscellaneous/openstad-hoofdmenu/global">global</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&#x26;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&#x26;token=317304b2-1990-45f6-baca-7396d38ad0f5" alt=""></p> |

### Tags

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

### 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         |             |