# Velora — styl premium dla phpBB 3.3 + panel administracyjny

**Nadaj swojemu forum phpBB wygląd i styl nowoczesnej platformy społecznościowej.**
Velora to całkowicie przeprojektowana wersja phpBB z przejrzystym interfejsem przypominającym aplikację mobilną, prawdziwym trybem ciemnym oraz rozbudowanym rozszerzeniem panelu administracyjnego, które pozwala dostosować wszystko bezpośrednio z poziomu ACP — bez konieczności pisania kodu ani edytowania szablonów.

Jeden zakup, wszystko w cenie: **styl Velora + rozszerzenie Velora Control Panel.**

---

## Dlaczego Velora?

- **Nowoczesny, ekskluzywny projekt** — układ oparty na kartach, delikatne cienie, płynne animacje i wyraźne ikony wektorowe w całym motywie. Nie wygląda to na „kolejny zwykły motyw phpBB”.
- **Tryb jasny i ciemny** — automatyczny (dostosowuje się do systemu użytkownika) lub wybór trybu domyślnego. Członkowie mogą przełączać się między trybami jednym kliknięciem.
- **Twoja marka w kilka sekund** — wybierz kolor marki, a cała paleta (przyciski, linki, akcenty, gradienty) zostanie wygenerowana za Ciebie, zarówno w trybie jasnym, jak i ciemnym.
- **W pełni responsywna** — zaprojektowana z myślą o urządzeniach mobilnych, z dolnym paskiem nawigacyjnym na telefonach oraz wysuwanym menu.
- **Wszystkie elementy serwisu ACP** — logo, kolory, główny baner, pasek ogłoszeń, stopka, linki w menu, widżety i funkcje społecznościowe — to ustawienia, a nie kod.
- **Wbudowane funkcje społecznościowe** — reakcje, rozwiązane tematy, zdjęcia profilowe, widżety na pasku bocznym i wiele innych, bez konieczności instalowania dodatkowych rozszerzeń.

---

## Funkcje

### Projekt i układ graficzny
- Całkowita przebudowa każdej strony: strony głównej, forów, wątków, edytora postów, prywatnych wiadomości, panelu użytkownika, listy członków, profili, strony zespołu, wyszukiwarki, sekcji FAQ, logowania i rejestracji
- Tryb jasny i ciemny z natychmiastowym przełączaniem bez efektu migotania podczas ładowania strony
- Próbnik kolorów marki z 12 gotowymi ustawieniami lub dowolnym kolorem niestandardowym; pełna paleta jest generowana automatycznie
- Dwa układy forum: **klasyczna lista** lub **nowoczesna siatka kart**
- Indywidualna ikona i kolor dla każdego forum, do wyboru spośród ponad 60 ikon
- Awatary na forum i w listach wątków, z eleganckimi awatarami w postaci liter dla użytkowników, którzy nie mają własnego
- Opcjonalny układ na całą szerokość i przyklejony nagłówek
- Baner bohatera na stronie głównej z własnym tytułem, tekstem i obrazem w tle (może być wyświetlany wyłącznie gościom)
- Pasek ogłoszeń z 4 stylami, który członkowie mogą ukryć
- Bogata stopka zawierająca informację „O nas”, linki do mediów społecznościowych (Facebook, X, Instagram, YouTube, Discord, GitHub, TikTok, Telegram, Reddit, Twitch) oraz kolumny z niestandardowymi linkami
- Prześlij swoje logo, osobne logo do trybu ciemnego oraz favikonę bezpośrednio z panelu administracyjnego (ACP)
- Piękny układ graficzny poszczególnych tematów

### Nawigacja i użyteczność
- Inteligentny nagłówek, który dostosowuje się do dostępnej przestrzeni, dzięki czemu nic nigdy nie jest ucięte ani ukryte
- Mobilny dolny pasek nawigacyjny i wysuwane menu
- Karty informacyjne użytkowników: po najechaniu kursorem na nazwę użytkownika wyświetla się awatar, ranga, liczba postów i status aktywności
- Skróty klawiaturowe: `/`– wyszukiwanie, `j`/`k` – przechodzenie między wpisami, `r`– odpowiadanie, `d`– tryb ciemny, `?`– pomoc
- Pasek postępu czytania oraz przycisk „przejdź do pierwszego nieprzeczytanego” w wątkach
- Składane kategorie (zapamiętywane dla każdego użytkownika)
- Filtr szybkiego wyszukiwania w sekcji FAQ

### Funkcje społecznościowe
- **Reakcje na posty** — 👍 ❤️ 😂 😮 😢 🙏 bez konieczności odświeżania strony, z dokładnym wskazaniem, kto zareagował („Ty, Maria i 3 inne osoby”)
- **Tematy rozwiązane** — autor tematu lub moderator oznacza najlepszą odpowiedź jako rozwiązanie. Jest ona wyróżniona w temacie i otrzymuje oznaczenie „Rozwiązane” na liście tematów. Funkcję tę można włączyć dla poszczególnych forów, co idealnie sprawdza się na forach pomocy technicznej.
- **Okładki profilowe** — użytkownicy wybierają jedną z 7 okładek z efektem gradientu lub przesyłają własny obrazek
- **Indywidualny kolor akcentujący** — każdy użytkownik może wybrać własny kolor dla tablicy
- **Miniatury tematów** — pierwszy obrazek danego tematu jest wyświetlany jako miniatura na liście tematów
- **Widżety w pasku bocznym** — najnowsze tematy, najaktywniejsi użytkownicy i awatary użytkowników online na stronie głównej

### Panel administracyjny
- Trzy przejrzyste strony ACP: **Ustawienia stylu**, **Funkcje** oraz **Menu i linki w stopce**
- Podgląd na żywo koloru marki podczas edycji
- Menedżer linków w menu i stopce: dodawaj linki do menu głównego lub do jednej z kolumn stopki, wraz z ikoną, ustawieniami widoczności (wszyscy / członkowie / goście) oraz opcją otwierania w nowym oknie
- Każdą funkcję można włączyć lub wyłączyć osobno

### Jakość
- Zachowuje **wszystkie zdarzenia szablonów phpBB**, dzięki czemu rozszerzenia wykorzystujące te szablony nadal działają
- Obsługa języków pisanych od prawej do lewej (RTL)
- Znaczniki ułatwiające dostępność: nawigacja za pomocą klawiatury, stany fokusu, etykiety dla czytników ekranu oraz obsługa trybu ograniczonego ruchu
- Bezpieczeństwo wbudowane w projekt: sprawdzanie uprawnień, ochrona przed atakami CSRF oraz weryfikacja przesyłanych plików na każdym etapie
- Czyste odinstalowanie: wyłączenie i usunięcie danych rozszerzenia powoduje usunięcie wszystkich elementów, które zostało przez nie dodane
- Czcionka „Inter” i ikony SVG hostowane na własnym serwerze, bez zewnętrznych żądań kierowanych do Google lub sieci CDN

---

## Wymagania

| | |
|---|---|
| phpBB | 3.3.x |
| PHP | wersja 7.2 lub nowsza (zalecana wersja 8.x) |
| Przeglądarki | Aktualne wersje przeglądarek Chrome, Edge, Firefox i Safari (wersje na komputery stacjonarne i urządzenia mobilne) |

Velora wykorzystuje nowoczesny CSS. Bardzo stare przeglądarki (na przykład Internet Explorer lub Safari w wersji starszej niż 16.4) nie są obsługiwane.

---

## Co znajduje się w opakowaniu

```
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
```

---

## Instalacja

1. **Przenieś** zawartość `upload`folderu do katalogu głównego forum phpBB (folderu zawierającego `config.php`). Spowoduje to dodanie plików oraz`styles/velora` `ext/velora/veloracp`.
2. **Zainstaluj styl:** ACP → *Dostosuj* → *Zarządzanie stylami* → *Zainstaluj style* → kliknij **„Zainstaluj”** obok pozycji *„Velora*”.
3. **Ustaw jako domyślny (opcjonalnie):** ACP → *Ogólne* → *Ustawienia forum* → ustaw opcję *„Domyślny styl”* na **„Velora**”. Jeśli chcesz, aby wszyscy użytkownicy widzieli ten styl, ustaw opcję *„Zastąp styl użytkownika”* na **„Tak**”.
4. **Włącz rozszerzenie:** ACP → *Dostosuj* → *Zarządzaj rozszerzeniami* → kliknij **„Włącz”** obok pozycji *„Velora Control Panel*”.
5. **Konfiguracja:** ACP → zakładka *„Rozszerzenia”* → **styl Velora**.

> **Pliki przesłane:** logo, favikony i zdjęcia profilowe są przechowywane w folderze `images/velora/`. U większości dostawców usług hostingowych folder ten jest tworzony automatycznie. Jeśli przesłanie plików nie powiedzie się, utwórz foldery `images/velora`i `images/velora/covers`oraz nadaj im uprawnienia do zapisu (zazwyczaj uprawnienia 755).

> **Wskazówka:** jeśli po zmianie ustawień zmiany nie są widoczne, wyczyść pamięć podręczną (ACP → *Ogólne* → *Wyczyść pamięć podręczną*) i odśwież stronę w przeglądarce.

---

## Aktualizacja do nowej wersji

1. Wyłącz rozszerzenie (ACP → *Dostosuj* → *Zarządzaj rozszerzeniami* → **Wyłącz**). **Nie** klikaj *opcji „Usuń dane*”, ponieważ spowoduje to utratę Twoich ustawień.
2. Przenieś nowy `upload`folder, zastępując nim stare pliki.
3. Włącz ponownie rozszerzenie.
4. Wyczyść pamięć podręczną.

## Odinstalowywanie

1. ACP → *Dostosuj* → *Zarządzaj rozszerzeniami* → **Wyłącz** panel sterowania Velora, a następnie kliknij **„Usuń dane”,** aby usunąć wszystkie ustawienia, reakcje i zmiany w bazie danych.
2. ACP → *Dostosuj* → *Zarządzanie stylami* → **Odinstaluj** Velora (najpierw zmień domyślny styl).
3. Usuń `styles/velora`, a`ext/velora` jeśli nie potrzebujesz już przesłanych zdjęć, `images/velora`.

---

## Korzystanie ze stylu bez rozszerzenia

Ten styl działa samodzielnie i wygląda tak samo po instalacji. Rozszerzenie dodaje panel sterowania oraz funkcje społecznościowe (reakcje, rozwiązane tematy, okładki, widżety, linki, pliki do przesłania itp.). Aby w pełni korzystać z funkcji, zainstaluj oba elementy.

---

## Najczęściej zadawane pytania

**Czy moje obecne rozszerzenia będą działać z Velorą?**
W większości przypadków tak. Velora zachowuje wszystkie zdarzenia szablonów z prosilver – domyślnego stylu phpBB – więc rozszerzenia, które dodają treść za pośrednictwem tych zdarzeń, będą wyświetlać się we właściwych miejscach. Rozszerzenia, które zawierają własne szablony przeznaczone wyłącznie dla prosilver, mogą wymagać niewielkich poprawek stylistycznych.

**Czy mogę używać własnych kolorów?**
Tak. Wystarczy wybrać dowolny kolor w *ustawieniach stylu,* a Velora automatycznie stworzy pasującą paletę barw dla trybu jasnego i ciemnego.

**Czy to zostało przetłumaczone?**
Interfejs korzysta z pakietów językowych własnych phpBB, dzięki czemu działa z każdym zainstalowanym językiem. Ustawienia i funkcje rozszerzenia są dostępne w **języku** **angielskim** i **bułgarskim**. W przypadku innych języków domyślnym językiem jest angielski, a dodanie tłumaczenia wymaga jedynie skopiowania folderu`language/en`.

**Czy to działa na urządzeniach mobilnych?**
Tak. Aplikacja Velora została zaprojektowana z myślą przede wszystkim o urządzeniach mobilnych – posiada dedykowany dolny pasek nawigacyjny oraz elementy sterujące dostosowane do obsługi dotykowej.

**Czy mogę zmodyfikować kod CSS?**
Tak. Możesz edytować kod bezpośrednio`styles/velora/theme/stylesheet.css` lub skorzystać z plików źródłowych Tailwind znajdujących się w `developer-source`folderze, aby ponownie skompilować projekt.

**Czy mogę usunąć informację o linii kredytowej w stopce?**
Prosimy o jej zachowanie. Pomaga to wspierać dalszy rozwój Velory. Jeśli potrzebujesz licencji typu „white label”, skontaktuj się z nami za pośrednictwem CodeStrike.STORE.

---

## Pomoc techniczna

Pytania, zgłoszenia błędów i zlecenia niestandardowe: **[codestrike.store](https://codestrike.store)**

Zgłaszając problem, prosimy o podanie wersji phpBB, wersji PHP, listy zainstalowanych rozszerzeń oraz, jeśli to możliwe, linku do forum.

---

## Licencja i podziękowania

Velora (styl i rozszerzenie) © 2026 illusion @ [CodeStrike.STORE](https://codestrike.store).
Udostępniono na licencji GNU General Public License w wersji 2 (GPL-2.0), podobnie jak sam phpBB.

Zawiera:
- Czcionka [Inter](https://rsms.me/inter/) — Licencja SIL Open Font License 1.1
- Ikony [Lucide](https://lucide.dev) — licencja ISC
- Ikony marki [Simple Icons](https://simpleicons.org) — CC0 1.0 (nazwy marek i logo są znakami towarowymi ich odpowiednich właścicieli)
- Stworzone przy użyciu [Tailwind CSS](https://tailwindcss.com) — licencja MIT

phpBB® jest zarejestrowanym znakiem towarowym firmy phpBB Limited. Velora nie jest powiązana z firmą phpBB Limited ani nie jest przez nią wspierana.