# 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.md) 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.md) 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.md#maximaal-een-inzending-plan-kiezen) (onder [Stemmen](/openstad/manual/how-tos/voting.md)) 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.md#inzending-detailpagina) (onder [Inzendingen weergeven](/openstad/manual/how-tos/show-ideas.md)) 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.md) 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.md) 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="/files/pMdXMVSK7qbVIVq9GDWy" 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="/files/BF168MOvspFFlF6ISw86" 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="/files/q547lN5Qm9jaeb4VzAXq" alt=""></p>                                                                                                                                                            |
| Text in vote button in open ideas               | <p>Overschrijf de tekst van de stemknop in de uitklapper.<br><img src="/files/vydHqLtpQ7d3CcD3f9jc" 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.md) 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="/files/TRTLygseNANLJHKghdVN" alt=""><br>- Grey card<br><img src="/files/8KZLQ62d58TburWUXW7Q" 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.md#vormgeving) in het [Global](/openstad/manual/miscellaneous/openstad-hoofdmenu/global.md) menu. |

### Sorting

| Instelling                                       | Toelichting                                                                                                                                    |
| ------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Display sorting                                  | <p>Kies of je de sorteer optie wil tonen bovenaan de overzichtsweergave.<br><br><img src="/files/uapmH01GLfvV4fbdUpvm" 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.\
![](/files/QHDpBTIIbxICE2tFir1g)

| 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="/files/6qA2Ut5HPNvAw8YQmz7e" alt=""></p> |

### Theme

| Instelling            | Toelichting                                                                                                                                                                                                                                                                                                                                                         |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Display theme filter? | <p>Kies of je de optie wil tonen om te filteren op thema.<br><img src="/files/8an8GkjMjnNr6T1Nku9T" alt=""><br><br>Zie ook <a data-mention href="/pages/QjsFzmcmio5GEsYX4fIs#themes-areas-and-idea-types">/pages/QjsFzmcmio5GEsYX4fIs#themes-areas-and-idea-types</a> onder <a data-mention href="/pages/QjsFzmcmio5GEsYX4fIs">/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="/files/PnnP7cNmBtpdARFBJIPA" alt=""><br><br>Zie ook <a data-mention href="/pages/QjsFzmcmio5GEsYX4fIs#themes-areas-and-idea-types">/pages/QjsFzmcmio5GEsYX4fIs#themes-areas-and-idea-types</a> onder <a data-mention href="/pages/QjsFzmcmio5GEsYX4fIs">/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="/files/98m8Z6XA17BGosq6Z7Bq" 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="/files/LG7ooQzdwKcpq1Lb9WOy" 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.md#tags) onder [Adminpanel (beta)/React admin](/openstad/manual/miscellaneous/adminpanel-beta-react-admin.md). |

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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.openstad.org/openstad/manual/modules/resource-overview.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
