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

<Info>
  Цю функцію спочатку розробили [davrot](https://github.com/davrot) і [yu-i-i/overleaf-cep](https://github.com/yu-i-i/overleaf-cep), а [ayaka-notes/overleaf-pro](https://github.com/ayaka-notes/overleaf-pro) доопрацював її, додавши OAuth. Вона доступна починаючи з v6.2.0. Функція досі перебуває в статусі бета-версії. Якщо у вас виникнуть проблеми, нам потрібен ваш відгук.
</Info>

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/img-b751b9f6.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=80eb902caf484c8cfc1c776017ac2c66" alt="" width="1802" height="372" data-path="images/on-premises/img-b751b9f6.png" />
</Frame>

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-40.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=6dc6bfdbc9f196d6b0e52e331dcebeb1" alt="" width="1524" height="1116" data-path="images/on-premises/image-40.png" />
</Frame>

### Налаштування інтеграції із Zotero

1. Відкрийте [це посилання](https://www.zotero.org/oauth/apps), щоб створити OAuth-клієнт Zotero (як показано на зображенні)
2. Виберіть **Application Type**: **Browser**
3. Укажіть Callback URL у вигляді `${OVERLEAF_SITE_URL}/user/zotero/oauth/callback`
4. Налаштуйте свій `config/variables.env`

<Frame>
  <img src="https://mintcdn.com/ayakaleaf-pro/x9kfDjtWlyyhG_mR/images/on-premises/image-41.png?fit=max&auto=format&n=x9kfDjtWlyyhG_mR&q=85&s=7b17a5456fed177a76d4adfe2daf8107" alt="" width="375" data-path="images/on-premises/image-41.png" />
</Frame>

```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=
```

### Примітки

<Warning>
  Під час оновлення наявної інсталяції, що містить пов'язані файли бібліографії Zotero, до перевипущеної версії 6.3.0 дотримуйтеся [інструкцій з міграції Zotero / Mendeley](/uk/on-premises/release-notes/release-notes-6.x.x#ayakaleaf-pro-6.3.0 "mention"). Для нових інсталяцій ця міграція не потрібна.
</Warning>

<Danger>
  Оскільки Ayakaleaf — це платформа для спільної роботи, з метою підвищення безпеки, починаючи з версії 6.3.0, оновлювати імпортований файл `bib` із посиланнями зможе лише його початковий автор.
</Danger>

Наприклад, припустімо, що власник проєкту, Користувач A, вмикає спільний доступ за посиланням і створює в проєкті файл `test.bib`, пов'язуючи його зі своїм обліковим записом Zotero. Якщо інший користувач, Користувач B, отримає доступ до проєкту через спільне посилання, він зможе читати й завантажувати `test.bib`, але не зможе оновити або повторно імпортувати файл із Zotero. Виконувати оновлення може лише Користувач A як початковий автор файлу з посиланнями. Інакше кажучи, право оновлювати файл `.bib` має лише його початковий автор.


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