CMS Инструкция (.md)
# Инструкция за мигриране на портала в CMS

## Общ преглед

Създадената CMS система ви позволява да управлявате цялото съдържание на публичния портал — заглавна страница, навигация, футър, медия и глобални стилове — без да променяте код. Системата работи с работни версии (draft) и публикувани версии (published), с възможност за връщане към предишна версия (rollback).

**Достъп:** Влезте в приложението като администратор и отворете **/admin/cms** (от менюто в Control Room → CMS).

---

## Стъпка 1: Миграция на съществуващото съдържание

При първо отваряне на CMS страницата ще видите съобщение **„CMS Migration Required“**.

1. Кликнете бутона **„Migrate Content to CMS“**.
2. Системата автоматично ще:
   - Създаде записи за всички страници (Home, Privacy, Terms, Impressum, Contact) от съществуващите преводи.
   - Пренесе всички редакции, направени през старата система (LandingContent), в новите CMS записи.
   - Създаде настройки за навигация, футър и тема (глобални стилове).
   - Публикува всичко веднага — сайтът продължава да работи без прекъсване.
3. След миграцията ще видите табовете: **Pages | Navigation | Footer | Media | Global Styles**.

> **Важно:** Миграцията е идемпотентна — ако я стартирате повторно, съществуващите записи няма да бъдат презаписани.

---

## Стъпка 2: Редактиране на страници (Pages)

### Избор на страница
- В левия панел виждате списък с всички страници.
- Зелена точка = публикувана; жълта точка = има непубликувани промени в черновата.
- Кликнете страница, за да я редактирате.

### Метаданни на страницата
- **Title** — вътрешно име на страницата.
- **Slug** — URL адрес (не се променя след създаване).
- **Display Order** — подредба в списъка.
- **Nav visible** — дали страницата да се показва в навигацията.
- **Footer visible** — дали страницата да се показва във футъра.

### Секции
Всяка страница е съставена от секции (Hero, Live Demo, Why, Features, Demo Tracks, Pricing, Downloads, Community, Docs и др.).

**Операции със секции:**
- **+ Add section** — добавя нова секция от падащото меню.
- **Eye / EyeOff** — показва/скрива секция (enabled/disabled).
- **↑ / ↓** — премества секцията нагоре/надолу (променя подредбата на живата страница).
- **Copy** — дублира секцията.
- **Trash** — изтрива секцията.

**Редактиране на елементи:**
- Всеки текстов елемент (заглавие, подзаглавие, бутон и др.) има 4 полета — **EN, DE, ES, BG**.
- Въведете превода за всеки език. Ако поле е празно, системата използва английския (EN) като резервен.

**Стилове на секцията:**
- Разгънете **„Section Styles“** за да зададете:
  - **Background** — цвят на фона.
  - **Text Color** — цвят на основния текст.
  - **Heading Color** — цвят на заглавията.

### Запазване и публикуване
- **Save Draft** — запазва промените в черновата (не се отразява на живия сайт).
- **Publish** — публикува черновата веднага (промените се появяват на живия сайт).
- **Rollback** — връща към предишната публикувана версия.

> **Важно:** Промените в черновата НЕ се виждат от посетителите. Трябва да кликнете **Publish**, за да ги публикувате.

---

## Стъпка 3: Редактиране на навигацията (Navigation)

1. Отидете на таб **Navigation**.
2. **Brand Text** — текстът на логото (по подразбиране „CROSSCUE“).
3. **Logo URL** — URL на изображение за лого (оставете празно за текстово лого).
4. **Navigation Items** — списък с линкове в навигацията:
   - Кликнете **+ Add** за нов елемент.
   - За всеки елемент въведете:
     - **URL** — адрес (напр. #features, /studio, https://...)
     - **Label** — етикет за всеки език (EN, DE, ES, BG)
     - **Enabled** — дали да се показва
   - Използвайте кошчето за изтриване.
5. **Save Draft** → **Publish** за да приложите промените.

---

## Стъпка 4: Редактиране на футъра (Footer)

1. Отидете на таб **Footer**.
2. **Tagline, Subtitle, Rights** — основни текстове на футъра (многоезични).
3. **Columns** — колони с линкове във футъра:
   - **+ Add Column** — добавя нова колона.
   - За всяка колона въведете заглавие (многоезично) и линкове.
   - Всеки линк има URL и многоезичен етикет.
   - **+ Add link** — добавя линк към колоната.
4. **Legal Links** — правни линкове (Privacy, Terms, Contact и др.):
   - Всеки има URL и многоезичен етикет.
   - **+ Add legal link** — добавя нов.
5. **Save Draft** → **Publish**.

---

## Стъпка 5: Медийна библиотека (Media)

1. Отидете на таб **Media**.
2. **Upload** — изберете изображение от компютъра си.
   - Изображението се качва и се създава запис в библиотеката.
3. За всяко изображение можете да редактирате:
   - **Title** — заглавие.
   - **Alt text** — текст за достъпност (важно за SEO и достъпност).
   - **URL** — копирайте този URL, за да го използвате в секции или стилове.
4. **Copy** — копира URL адреса в клипборда.
5. **Trash** — изтрива изображението от библиотеката.

---

## Стъпка 6: Глобални стилове (Global Styles / Theme)

1. Отидете на таб **Global Styles**.
2. **Colors** — глобална цветова палитра:
   - background — фон на целия сайт
   - contentBg — фон на картите/секциите
   - primary — основен акцентен цвят (бутони, линкове)
   - secondary — вторичен цвят
   - accent — акцентен цвят
   - text — цвят на основния текст
   - heading — цвят на заглавията
   - muted — цвят на вторичен/приглушен текст
   - border — цвят на рамки
3. **Typography** — типографски настройки за 5 роли:
   - **Body** — основен текст (семейство, размер, тегло, междуредие)
   - **Heading** — заглавия (семейство, размер, тегло, междуредие, разстояние между букви, трансформация)
   - **Navigation** — навигационен текст
   - **Button** — текст на бутони
   - **Footer** — текст във футъра
4. **Save Draft** → **Publish** за да приложите стиловете глобално.

---

## Стъпка 7: Многоезична поддръжка

Цялата CMS система поддържа 4 езика: **English (EN), Deutsch (DE), Español (ES), Български (BG)**.

- Всеки текстов елемент има отделно поле за всеки език.
- Ако даден превод липсва, системата автоматично използва английския като резервен.
- Посетителите виждат съдържанието на езика, избран в браузъра им или чрез превключвателя на езици.

---

## Стъпка 8: Workflow за публикуване

1. **Редактирайте** — правите промени в черновата (Save Draft).
2. **Прегледайте** — проверете всички промени в админ панела.
3. **Публикувайте** — кликнете Publish, за да ги пуснете на живо.
4. **Върнете ако нужно** — ако нещо не е наред, кликнете Rollback за предишната версия.

> **Безопасност:** Само администратори могат да редактират CMS. Обикновените потребители и посетителите виждат само публикуваното съдържание.

---

## Често задавани въпроси

**В: Може ли миграцията да се стартира повторно?**
О: Да, тя е идемпотентна. Съществуващите записи няма да бъдат презаписани.

**В: Какво се случва ако не публикувам?**
О: Промените остават в черновата и не се виждат от посетителите.

**В: Мога ли да върна промените?**
О: Да, чрез бутона Rollback се връща към предишната публикувана версия.

**В: Работи ли с мобилни устройства?**
О: Да, административният панел е адаптивен, но за най-добро преживяване използвайте десктоп.

**В: Влияе ли CMS на Studio (DJ приложението)?**
О: Не, CMS управлява само публичния портал. Studio работи независимо.

---

*Документ създаден: септември 2026*