# Установка 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/ru/docs/editing.md) ·
[Клиентский доступ](https://qixoo.app/ru/docs/client-access.md)
