﻿# Промпт Cursor: подключить YouOnline24 CDN в проект

**Публичная ссылка:** https://cdn.youonline24.ru/docs/v1/cursor-integrate.html  
**Документация по интеграции:** https://cdn.youonline24.ru/docs/v1/integration.html

Скопируйте этот текст в чат Cursor, когда ИИ-разработчику нужно внедрить YouOnline24 CDN-блоки в новый/существующий проект.

---

## Контекст

CDN base: **https://cdn.youonline24.ru**

Подключаемые файлы:

- CSS tokens: `https://cdn.youonline24.ru/design/v1/yo24-tokens.css`
- CSS base: `https://cdn.youonline24.ru/blocks/v1/yo24-base.css`
- JS loader: `https://cdn.youonline24.ru/blocks/v1/yo24-blocks.js`

Демо: https://cdn.youonline24.ru/demo/v1/

---

## Цель

Сайт/приложение должно использовать общие блоки YouOnline24 **через Web Components**, без копипасты HTML футера/доната/лицензии.

---

## Ограничения (строго)

- **Bootstrap:** используй последнюю стабильную версию **Bootstrap 5.x** для верстки UI проекта (через CDN jsDelivr), если проект не закреплён на другой системе. Пример подключения:

```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.3/dist/css/bootstrap.min.css" crossorigin="anonymous">
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.11.3/font/bootstrap-icons.min.css">
```

- **Только светлая тема.** Не добавляй dark mode, `prefers-color-scheme: dark`, тёмные фоны.
- **Палитра:** `#5a189a`, `#ff9e00`, `#000`, `#fff`, `#f7f7f7`.
- **Не копируй** HTML копирайта/лицензии вручную — только `<yo24-footer>`.

---

## Что сделать в проекте

### 1) Найди общий layout

Определи, где вставляется общий код страниц:

- `index.html` / `layout.html`
- шаблон: `base.php`, `layout.php`, `*.twig`, `*.blade.php`
- общий React/Vue layout (например `App.tsx`, `Layout.tsx`)

### 2) Подключи CSS в `<head>`

Добавь (или эквивалентно для вашего стека):

```html
<link rel="stylesheet" href="https://cdn.youonline24.ru/design/v1/yo24-tokens.css">
<link rel="stylesheet" href="https://cdn.youonline24.ru/blocks/v1/yo24-base.css">
```

### 3) Вставь блоки в конец `<body>`

Минимум:

```html
<yo24-donate project="PROJECT_SLUG" lang="ru"></yo24-donate>
<yo24-footer project="PROJECT_SLUG" lang="ru"></yo24-footer>
<script type="module" src="https://cdn.youonline24.ru/blocks/v1/yo24-blocks.js"></script>
```

Рекомендуется:

```html
<yo24-tools-nav lang="ru" exclude="PROJECT_SLUG"></yo24-tools-nav>
```

Опционально (если в проекте есть хранение снимков/чувствительных данных):

```html
<yo24-consent project="PROJECT_SLUG" lang="ru"></yo24-consent>
```

### 4) Удали дубли

Найди и удали старые блоки:

- ручной футер (копирайт YouOnline24, лицензия)
- ручной донат
- любые дубли `<footer>` с тем же смыслом

### 5) Настрой `project` и `lang`

- `PROJECT_SLUG` — латиница + дефисы, например `my-new-tool`
- `lang` должен соответствовать языку страницы (`ru`/`en`)

Если slug ещё не добавлен в `projects.json`, временно можно поставить `curl-test` **только для проверки**, затем создать задачу «добавить slug в projects.json и задеплоить config».

---

## Проверки (без отчёта)

- Страница загружается без ошибок в консоли
- Файлы с CDN отдают 200:
  - `/design/v1/yo24-tokens.css`
  - `/blocks/v1/yo24-blocks.js`
- Видны блоки `yo24-footer` и `yo24-donate`, нет дублей

---

## Если не хватает данных

Если ты не видишь проектные файлы/шаблон, или непонятно где общий layout — перечисли, какие файлы нужны для продолжения.
