# Встановлення Qixoo на наявний сайт

Підключення Qixoo займає близько хвилини й нічого не змінює ні в тому, як зроблений
твій сайт, ні в тому, де він розміщений.

## Сніпет

```html
<script src="https://qixoo.app/qixoo.js" data-key="ТВІЙ_SITE_ID" defer></script>
```

Встав його **один раз, перед `</head>`, на кожній сторінці**. Потім опублікуй або
задеплой сайт як зазвичай.

`ТВІЙ_SITE_ID` — це Site ID, показаний на картці сайту в панелі: натисни іконку
копіювання поруч із ним.

## Покроково

1. Увійди на `https://qixoo.app/dashboard/`. Магічне посилання на пошту або Google —
   без пароля. Новим адресам акаунт створюється автоматично на тарифі Free.
2. **Sites → + Add site** → вкажи назву та URL сайту.
3. На новій картці відкрий **Connect → Install**.
4. Скопіюй сніпет і встав у свій HTML — або скопіюй **AI install prompt** і віддай його
   своєму кодовому асистенту (Cursor, Claude, v0, Lovable): він вставить тег за тебе.
5. Опублікуй сайт і натисни **Open editor** на картці. Твій живий сайт відкриється із
   шаром редагування поверх.

Для відвідувачів нічого не змінюється, доки ти не зробиш правку й не збережеш її.

## Куди вставляти, за платформами

- **HTML, написаний руками** — у `<head>` кожної сторінки.
- **Фреймворк або генератор статичних сайтів** — у спільний layout чи шаблон, щоб тег
  потрапив на всі сторінки.
- **Конструктори сайтів** — майже в усіх є налаштування «Custom code → head»,
  користуйся ним.
- **Webflow** — Site Settings → Custom Code → Head Code. Потрібен платний тариф сайту у
  Webflow.
- **WordPress** — `header.php` теми або будь-який плагін для скриптів у шапці.

## Site ID — це секрет?

Ні, і це не пароль. Site ID лише ідентифікує, **про який** сайт говорять редактор і
публічний API контенту. Він не може нікого залогінити, не може змінити твій контент і
не може розкрити нічого, що вже не є публічним на твоїй сторінці. Для редагування
потрібен вхід в акаунт Qixoo, а редактор використовує окремий короткоживучий токен,
якого у твоєму HTML ніколи немає. Site ID у вихідному коді сторінки такий самий
безневинний, як і сама адреса сторінки.

В API контенту для розробників HTTP-заголовок і далі буквально називається
`X-API-Key` — це формат передачі, і він несе те саме значення Site ID.

## Нотатки

- Сайти, підключені раніше зі старою назвою скрипта `vibe-cms.js`, продовжують
  працювати; робити нічого не треба.
- Завантажувач важить близько 3 КБ, не ставить кукі, нічого не відстежує й нікому не
  надсилає дані відвідувачів.
- Односторінкові застосунки, які перемальовують DOM після завантаження, підтримуються
  в міру можливості. Перевір одну сторінку, перш ніж щось обіцяти клієнту. Надійний
  випадок — HTML із серверним рендером і статичний експорт.

Далі: [Редагування](https://qixoo.app/uk/docs/editing.md) ·
[Клієнтський доступ](https://qixoo.app/uk/docs/client-access.md)
