> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Zotero-integratie

> Laat gebruikers een .bib-bestand uit hun Zotero-bibliotheek in een project importeren.

> [!NOTE]
>
> Deze functie is oorspronkelijk ontwikkeld door [davrot](https://github.com/davrot) en [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), en aangepast door [ayaka-notes/ayakaleaf-pro](https://github.com/ayaka-notes/ayakaleaf-pro) met OAuth. Ze is beschikbaar vanaf v6.2.0. De functie is nog in bèta. We horen graag je feedback als je problemen tegenkomt.

![](https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-b751b9f6.png?fit=max\&auto=format\&n=x9kfDjtWlyyhG_mR\&q=85\&s=80eb902caf484c8cfc1c776017ac2c66)

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-41.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=366c8e9396506163e23ffdc92fbe8c02)

### Zotero-integratie instellen

1. Open [deze link](https://www.zotero.org/oauth/apps) om een Zotero OAuth-client aan te maken (zoals in de afbeelding)
2. Kies als **Application Type**: **Browser**
3. Stel de Callback URL in op je `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. Configureer je `config/variables.env`

![](https://mintcdn.com/ayakaleaf-pro/UZ_4Jfz7cU6MnXtE/images/on-premises/image-42.png?fit=max\&auto=format\&n=UZ_4Jfz7cU6MnXtE\&q=85\&s=7b2ed79ba28f7d77bc07711068ca71fc)

```dotenv title="config/variables.env" theme={null}
#################
#    Zotero     #
#################
# 'zotero' must be in ENABLED_LINKED_FILE_TYPES (set in develop/docker-compose.yml)
ENABLED_LINKED_FILE_TYPES=project_file,project_output_file,url,zotero

# From a Zotero OAuth client (register at https://www.zotero.org/oauth/apps)
# Application Type: Browser 
# Callback URL -> ${OVERLEAF_SITE_URL}/user/zotero/oauth/callback
ZOTERO_CLIENT_ID=
ZOTERO_CLIENT_SECRET=
# Encrypts the Zotero API key in mongo (set in dev to avoid writing a key file
# to /var/lib/overleaf/data, which the dev web container can't create)
# How to generate: `openssl rand -hex 32`
ZOTERO_CIPHER_PASSWORD=dev-zotero-cipher-password
# Optional: route the module's server-side Zotero requests (OAuth + API) through
# an HTTP proxy (must be reachable from the web container; same as github-sync)
# http://10.0.0.1:10808
# (Optional) ZOTERO_PROXY_URL=
```

### Opmerkingen

> [!WARNING]
>
> Wanneer je een bestaande installatie met aan Zotero gekoppelde bibliografiebestanden upgradet naar de opnieuw uitgebrachte 6.3.0, volg dan de [#ayakaleaf-pro-6.3.0](https://ayakaleaf-pro.mintlify.site/nl/on-premises/release-notes/release-notes-6.x.x.md#ayakaleaf-pro-6.3.0 "mention"). Nieuwe installaties hebben deze migratie niet nodig.

> [!CAUTION]
>
> Omdat Ayakaleaf een samenwerkingsplatform is, mag vanaf versie 6.3.0 ter verbetering van de beveiliging alleen de oorspronkelijke maker van een `bib`-referentiebestand het geïmporteerde bestand bijwerken.

Stel bijvoorbeeld dat de projecteigenaar, gebruiker A, het delen via een link inschakelt en een bestand `test.bib` in het project aanmaakt dat aan zijn eigen Zotero-account is gekoppeld. Als een andere gebruiker, gebruiker B, het project via de gedeelde link opent, kan gebruiker B `test.bib` nog steeds lezen en downloaden, maar mag hij het bestand niet bijwerken of opnieuw uit Zotero importeren. Alleen gebruiker A, als oorspronkelijke maker van het referentiebestand, kan updates uitvoeren. Kortom: alleen de oorspronkelijke maker van het `.bib`-bestand heeft het recht om het bij te werken.

### Vragen en antwoorden

> [accordion] Hoe gebruik ik Zotero in een project?
>
> **Antwoord:** Nadat je Zotero hebt gekoppeld in **Account Settings**, open je een project en klik je op **New file → From Zotero**. Kies een bestandsnaam, standaard `zotero.bib`, en de bibliotheek, en maak vervolgens het bestand aan. Citeer de items ervan zoals gebruikelijk, bijvoorbeeld met `\bibliography{zotero}`.
>
> Het bestand is alleen-lezen in de editor. Open na het wijzigen van je Zotero-bibliotheek het bestand en klik op **Refresh** om het opnieuw te importeren.

> [accordion] Waarom is 'Main bibliography file for this project' leeg of uitgeschakeld?
>
> **Antwoord:** Deze instelling toont alleen `.bib`-bestanden die in de editor kunnen worden bewerkt. Bestanden die uit Zotero zijn geïmporteerd, zijn alleen-lezen en worden daarom niet getoond. Dit is verwacht gedrag: je kunt de items ervan nog steeds citeren.

> [accordion] Moet mijn instantie bereikbaar zijn vanaf internet?
>
> **Antwoord:** Nee. Het koppelen van Zotero verloopt via de browser van de gebruiker, dus alleen de server hoeft Zotero te kunnen bereiken. Als daarvoor een proxy nodig is, stel dan `ZOTERO_PROXY_URL` in.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.