# Velora — Стил от висок клас за phpBB 3.3 + контролен панел

**Придайте на вашия phpBB форум външния вид и усещането на една съвременна платформа за общност.**
Velora е изцяло преработена версия на phpBB с изчистен интерфейс, наподобяващ този на мобилните приложения, истински тъмен режим и мощно разширение за контролния панел, което ви позволява да персонализирате всичко от ACP — без кодиране и без редактиране на шаблони.

Една покупка, всичко включено: **моделът „Velora“ + разширението „Velora Control Panel“.**

---

## Защо „Велора“?

- **Модерен дизайн от най-високо качество** — оформление на принципа на картички, меки сенки, плавни анимации и ясни векторни икони навсякъде. Не изглежда като „още една тема за phpBB“.
- **Светъл и тъмен режим** — автоматичен (съобразен със системата на посетителя) или избор на режим по подразбиране. Членовете могат да превключват с едно кликване.
- **Вашата марка за секунди** — изберете цвят на марката и цялата палитра (бутони, връзки, подчертавания, градиенти) се генерира автоматично за вас, както в светъл, така и в тъмен режим.
- **Напълно адаптивен** — проектиран с приоритет към мобилните устройства, с долна лента за навигация на телефоните и изскачащо меню.
- **Всичко в ACP** — логото, цветовете, главният банер, лентата с обяви, долната част на страницата, връзките в менюто, джаджите и функциите на общността — са настройки, а не код.
- **Вградени функции за общността** — реакции, решени теми, корици на профили, джаджи в страничната лента и други, без да са необходими допълнителни разширения.

---

## Характеристики

### Дизайн и оформление
- Пълно преработване на всяка страница: начална страница, форуми, теми, редактор за публикуване, лични съобщения, панел за управление на потребителя, списък с членове, профили, страница на екипа, търсене, често задавани въпроси, вход и регистрация
- Светъл и тъмен режим с незабавно превключване и без мигане при зареждането на страницата
- Инструмент за избор на цветове на марката с 12 предварително зададени настройки или произволен цвят по избор; пълната палитра се генерира автоматично
- Два варианта на оформление на форума: **класически списък** или **съвременна решетка от картички**
- Персонализирана икона и цвят за всеки форум, избрани измежду над 60 икони
- Аватари във форума и в списъците с теми, като за членовете, които нямат собствен аватар, се показват изчистени буквени аватари
- Опционално оформление на цялата ширина и фиксирано заглавие
- Банер „Герой“ на началната страница с ваше собствено заглавие, текст и фоново изображение (може да се показва само на гости)
- Лента с известия с 4 стила, която членовете могат да скрият
- Богато съдържание в долната част на страницата, включващо текст „За нас“, връзки към социални мрежи (Facebook, X, Instagram, YouTube, Discord, GitHub, TikTok, Telegram, Reddit, Twitch) и колони с персонализирани връзки
- Качете логото си, отделно лого за тъмен режим и фавикон директно от панела за администраторски контрол (ACP)
- Красиво оформление на печатните материали по теми

### Навигация и удобство на ползване
- Интелигентно заглавие, което се адаптира към наличното пространство, така че нищо никога не се отрязва или скрива
- Мобилна долна навигационна лента и изскачащо меню
- Картички при навеждане върху потребители: наведи курсора върху потребителско име, за да видиш аватара, ранга, публикациите и статуса на потребителя
- Клавишни комбинации: `/`за търсене, `j`/`k` за преминаване между публикациите, `r`за отговор, `d`за тъмен режим, `?`за помощ
- Индикатор за напредъка при четенето и бутон „Премини към първото непрочетено съобщение“ в темите
- Сгъваеми категории (запомняни за всеки посетител)
- Филтър за бързо търсене в раздела „Често задавани въпроси“

### Функции на общността
- **Реакции към публикациите** — 👍 ❤️ 😂 😮 😢 🙏 без презареждане на страницата, като се показва точно кой е реагирал („Ти, Мария и още 3 души“)
- **Решени теми** — авторът на темата или модераторът маркира най-добрия отговор като решение. Той се подчертава в темата и получава значка „Решено“ в списъка с теми. Тази функция може да се активира за всеки форум поотделно, което е идеално за форуми за поддръжка.
- **Корици за профила** — членовете избират една от 7 корици с градиент или качват собствена снимка
- **Личен акцентен цвят** — всеки член може да избере свой собствен цвят за таблото
- **Миниатюри на теми** — първата картинка от дадена тема се показва като миниатюра в списъка с теми
- **Виджети в страничната лента** — най-новите теми, най-активните потребители и аватарите на онлайн потребителите на началната страница

### Административен панел за управление
- Три празни страници на ACP: **„Настройки на стила“**, **„Функции“** и **„Връзки в менюто и долния колонтитул“**
- Предварителен преглед на цвета на марката в реално време по време на редактирането
- Мениджър на връзки в менюто и долната част на страницата: добавяне на връзки към главното меню или към някоя от колоните в долната част на страницата, с икона, настройка за видимост (всички / членове / гости) и опция за отваряне в нов прозорец
- Всяка функция може да се включва или изключва поотделно

### Качество
- Запазва **всички събития на шаблоните на phpBB**, така че разширенията, които се свързват с шаблоните, продължават да работят
- Поддръжка на езици, които се пишат отдясно наляво (RTL)
- Достъпна маркировка: навигация с клавиатура, състояния на фокуса, етикети за екранни четци и поддръжка на режим с ограничено движение
- Сигурност още при проектирането: проверки на правата за достъп, защита срещу CSRF и валидиране на качваните файлове на всеки етап
- Пълно премахване: деактивирането и изтриването на данните на разширението премахва всичко, което то е добавило
- Самохостван шрифт „Inter“ и SVG икони, без външни заявки към Google или CDN-и

---

## Изисквания

| | |
|---|---|
| phpBB | 3.3.x |
| PHP | 7.2 или по-нова версия (препоръчва се 8.x) |
| Браузъри | Актуалните версии на Chrome, Edge, Firefox и Safari (за настолни компютри и мобилни устройства) |

Velora използва съвременен CSS. Много старите браузъри (например Internet Explorer или Safari с версия по-стара от 16.4) не се поддържат.

---

## Какво съдържа опаковката

```
upload/
styles/velora/ the Velora style
ext/velora/veloracp/ the Velora Control Panel extension
developer-source/ CSS source files for developers (not needed for installation)
README.md this document
CHANGELOG.md version history
LICENSE.txt licence
```

---

## Инсталиране

1. **Качете** съдържанието на `upload`папката в кореновата директория на вашия phpBB форум (папката, която съдържа `config.php`). Това добавя и`styles/velora` `ext/velora/veloracp`.
2. **Инсталирайте стила:** ACP → *Персонализиране* → *Управление на стиловете* → *Инсталиране на стилове* → кликнете върху **„Инсталирай“** до *„Velora*“.
3. **Настройте го като стил по подразбиране (по избор):** ACP → *Общи* → *Настройки на форума* → задайте *„Стил по подразбиране“* на **„Velora**“. Ако искате всеки член да го вижда, задайте *„Заместване на стила на потребителя“* на **„Да**“.
4. **Активирайте разширението:** ACP → *Персонализиране* → *Управление на разширенията* → кликнете върху **„Активирай“** до *„Velora Control Panel*“.
5. **Настройки:** ACP → раздел *„Разширения“* → **стил „Velora**“.

> **Качени файлове:** логотипите, фавиконите и кориците на профилите се съхраняват в `images/velora/`. При повечето хостинг доставчици тази папка се създава автоматично. Ако качването не успее, създайте `images/velora`и `images/velora/covers`и им задайте права за запис (обикновено права 755).

> **Съвет:** ако след промяна на настройките не забележите промяната, изчистете кеша (ACP → *Общи* → *Изчисти кеша*) и обновете браузъра си.

---

## Актуализиране до нова версия

1. Деактивирайте разширението (ACP → *Персонализиране* → *Управление на разширенията* → **Деактивиране**). **Не** натискайте *„Изтриване на данни“*, тъй като в противен случай настройките ви ще бъдат загубени.
2. Качете новата `upload`папка върху старите файлове.
3. Активирайте разширението отново.
4. Изчистете кеша.

## Деинсталиране

1. ACP → *Персонализиране* → *Управление на разширенията* → **Деактивиране на** контролния панел на Velora, след което кликнете върху **„Изтриване на данни“,** за да премахнете всички настройки, реакции и промени в базата данни.
2. ACP → *Персонализиране* → *Управление на стилове* → **Деинсталиране** на Velora (първо сменете стила по подразбиране).
3. Изтрийте `styles/velora`, `ext/velora`а ако вече нямате нужда от качените изображения, `images/velora`.

---

## Използване на стила без разширението

Темата работи самостоятелно и изглежда по същия начин веднага след инсталирането. Разширението добавя контролния панел и функциите на общността (реакции, решени теми, корици, джаджи, връзки, качвания и т.н.). За да се възползвате от пълния набор от функции, инсталирайте и двете.

---

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

**Ще работят ли вече наличните ми разширения с Velora?**
В повечето случаи – да. Velora запазва всички събития на шаблоните от „prosilver“ – стандартния стил на phpBB – така че разширенията, които добавят съдържание чрез събития, ще се показват на правилните места. Разширенията, които предлагат свои собствени шаблони само за „prosilver“, може да се наложи да претърпят леки корекции в стила.

**Мога ли да използвам свои собствени цветове?**
Да. Изберете който и да е цвят в *настройките за стил* и Velora автоматично ще създаде подходяща палитра за светлия и тъмния режим.

**Преведено ли е?**
Интерфейсът използва собствените езикови пакети на phpBB, така че работи с всеки инсталиран език. Настройките и функциите на разширението са достъпни на **английски** и **български**. При други езици се използва английският, а за добавяне на превод е необходимо само копиране на папката`language/en`.

**Работи ли на мобилни устройства?**
Да. Velora е проектирана с приоритет към мобилните устройства, със специална долна навигационна лента и елементи за управление, удобни за докосване.

**Мога ли да променя CSS-а?**
Да. Можете да редактирате `styles/velora/theme/stylesheet.css`директно или да използвате изходните файлове на Tailwind в `developer-source`папката, за да го прекомпилирате.

**Мога ли да премахна текста за кредитите в долната част на страницата?**
Моля, запазете го. Това спомага за поддържането на по-нататъшното развитие на Velora. Ако се нуждаете от лиценз за „white-label“, свържете се с нас чрез CodeStrike.STORE.

---

## Поддръжка

Въпроси, сигнали за грешки и поръчки по избор: **[codestrike.store](https://codestrike.store)**

Когато съобщавате за проблем, моля, посочете версията на phpBB, версията на PHP, списък с инсталираните разширения и, ако е възможно, линк към вашия форум.

---

## Лиценз и благодарности

Velora (стил и разширение) © 2026 illusion @ [CodeStrike.STORE](https://codestrike.store).
Публикувано съгласно Общата публична лицензия GNU версия 2 (GPL-2.0), както и самият phpBB.

Включва:
- Шрифт [„Inter“](https://rsms.me/inter/) — Лиценз за отворени шрифтове на SIL 1.1
- Икони [„Lucide“](https://lucide.dev) — Лиценз ISC
- Икони на марката [„Simple Icons“](https://simpleicons.org) — CC0 1.0 (наименованията на марките и логотипите са търговски марки на съответните им собственици)
- Създаден с [Tailwind CSS](https://tailwindcss.com) — Лиценз на MIT

phpBB® е регистрирана търговска марка на phpBB Limited. Velora не е свързана с phpBB Limited и не се ползва с нейната подкрепа.