> For the complete documentation index, see [llms.txt](https://docs.cootje.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cootje.com/cootje-api/recruitment/vacatures/iframe.md).

# iFrame

De gepubliceerde vacatures van jullie omgeving tonen op je eigen website met één regel HTML.

Met de vacature-iFrame toon je alle gepubliceerde vacatures van jullie omgeving op je eigen website, zonder zelf iets te bouwen. Je plaatst één regel HTML; Cootje houdt het overzicht actueel.

* **Token:** niet nodig. De pagina in de iFrame is openbaar
* **Verplicht:** `env` in de URL
* **Optioneel:** `theme`, `view` en `searchbar` in de URL

In het overzicht staan alleen vacatures die [gepubliceerd](https://docs.cootje.com/cootje-api/recruitment/vacatures/publiceren.md) zijn en waarvan de sluitingsdatum nog niet voorbij is.

## De code

Plak deze regel op de plek in je website waar het overzicht moet komen, en vervang `voorbeeldzorg` door de naam van jullie omgeving:

```html
<iframe src="https://mijn.cootje.com/vacatures?env=voorbeeldzorg&theme=%2327acc9&view=grid&searchbar=1" style="width:100%;min-height:720px;border:none;border-radius:12px" loading="lazy"></iframe>
```

In Cootje staat dezelfde code klaar bij de publicatie-instellingen van een vacature, onder **Vacature iframe**. Daar kies je de weergave en kopieer je de code met één klik.

## Instellingen in de URL

| Veld        | Verplicht | Toelichting                                                                                                                                                                                     |
| ----------- | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `env`       | ja        | De technische naam van jullie omgeving. Dat is de waarde van `environment` uit `GET /iam/auth/userinfo`                                                                                         |
| `theme`     | nee       | De accentkleur van het overzicht, als kleurcode. Het hekje schrijf je in een URL als `%23`: `%2327acc9` staat voor `#27acc9`. Zonder dit veld krijgt het overzicht de standaardkleur van Cootje |
| `view`      | nee       | `grid` toont de vacatures als tegels (standaard), `list` toont ze onder elkaar                                                                                                                  |
| `searchbar` | nee       | `1` toont een zoekbalk (standaard), `0` verbergt hem                                                                                                                                            |

Zonder `env` toont de iFrame de melding "Geen omgeving opgegeven voor de vacaturebank."

## Wat bezoekers zien

* Per vacature de titel, de plaats, het aantal uren per week, de duur in maanden, de sluitingsdatum en het begin van de omschrijving.
* Met de zoekbalk zoekt een bezoeker op de titel van de vacature.
* De knop bij een vacature opent de openbare vacaturepagina in een nieuw tabblad. Daar leest de bezoeker de hele vacature en schrijft hij zich in.
* Staat er geen enkele vacature gepubliceerd, dan toont de iFrame "Er staan momenteel geen gepubliceerde vacatures."

## Opmaak op je eigen website

* De achtergrond van het overzicht is doorzichtig. Het neemt dus de achtergrond van je eigen pagina over.
* De iFrame past zijn hoogte niet vanzelf aan het aantal vacatures aan. Stel de hoogte zelf in met `min-height` of `height` in het onderdeel `style`.
* De breedte staat op `100%`: het overzicht vult de ruimte die je er op je pagina voor vrijmaakt.

## Voorbeelden

Tegels met zoekbalk, in de kleur `#27acc9`:

```html
<iframe src="https://mijn.cootje.com/vacatures?env=voorbeeldzorg&theme=%2327acc9&view=grid&searchbar=1" style="width:100%;min-height:720px;border:none;border-radius:12px" loading="lazy"></iframe>
```

Een lijst zonder zoekbalk, in de standaardkleur:

```html
<iframe src="https://mijn.cootje.com/vacatures?env=voorbeeldzorg&view=list&searchbar=0" style="width:100%;min-height:720px;border:none" loading="lazy"></iframe>
```
