# Инструкция за мигриране на портала в 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*