# NexusRP – system zarządzania serwerem FiveM klasy premium


## Przegląd

NexusRP to w pełni funkcjonalny system CMS przeznaczony dla serwerów roleplayowych FiveM. Został stworzony przy użyciu PHP 8+, MySQL/PDO oraz TailwindCSS i zawiera dynamiczny system aplikacji z panelem administracyjnym, modułowymi plikami dołączanymi oraz zarządzaniem treścią opartym na bazie danych. Obejmuje to [NexusRP | Najlepszy szablon strony internetowej dla serwerów FiveM
](https://codestrike.store/resource/nexusrp-ultimate-fivem-server-website-template) + Funkcja aplikacji z panelem administracyjnym.

## Funkcje

- **6 stron interfejsu użytkownika** — Strona główna, Zasady, O nas, Kontakt, Historia zmian, Aplikacje
- **Panel administracyjny** — bezpieczny pulpit nawigacyjny pod adresem `/admin/`z funkcją logowania i zarządzania sesjami
- **Dynamiczny system aplikacji** — Twórz nieograniczoną liczbę kategorii aplikacji z niestandardowymi polami formularza
- **Kreator formularzy** — pola tekstowe, e-mailowe, numeryczne, adresów URL, pola tekstowe typu „textarea” oraz pola wyboru/rozwijane według kategorii
- **Menedżer zgłoszeń** — przeglądanie, zatwierdzanie/odrzucanie oraz filtrowanie zgłoszeń z poziomu panelu administracyjnego
- **Konfiguracja** — jedno miejsce na`config.php` nazwę witryny, adres URL, bazę danych oraz dane logowania administratora
- **Elementy modułowe** — wspólna nawigacja, stopka, połączenie z bazą danych, funkcje pomocnicze
- **Ochrona przed spamem** — 1 zgłoszenie z jednego adresu IP w każdej kategorii zgłoszeń
- **Ochrona przed atakami CSRF** — Wszystkie formularze administracyjne są zabezpieczone przed atakami typu „cross-site request forgery”
- **Ochrona przed atakami XSS** — eskapowanie danych we wszystkich treściach generowanych przez użytkowników
- **Gotowe instrukcje PDO** — brak możliwości wstrzyknięcia kodu SQL
- **Bezpieczeństwo sesji** — odnawianie identyfikatorów sesji, usuwanie plików cookie po wylogowaniu
- **Ciemny motyw** — Wysokiej jakości projekt z wykorzystaniem TailwindCSS, ikon Bootstrap oraz animacji AOS

## Wymagania

- PHP 8.0 lub nowsze
- MySQL 5.7+ / MariaDB 10.3+
- Serwer WWW (Apache / Nginx / IIS)
- Nie jest wymagany proces kompilacji (zależności CDN)

## Szybki start

### 1. Konfiguracja bazy danych
Prześlij plik do`nexusrp.sql` phpMyAdmin lub uruchom go za pomocą wiersza poleceń MySQL. Spowoduje to utworzenie wszystkich tabel i wprowadzenie przykładowych danych.

### 2. Skonfiguruj
Edytuj`config.php`:
```php
define('SITE_NAME', 'Your Server Name');
define('SITE_URL', 'https://yourserver.com/');
define('DB_HOST', 'localhost');
define('DB_NAME', 'nexusrp');
define('DB_USER', 'root');
define('DB_PASS', 'yourpassword');
define('ADMIN_USERNAME', 'admin');
define('ADMIN_PASSWORD', 'admin123');
```

### 3. Wdrożenie
Prześlij wszystkie pliki do katalogu publicznego swojego serwera internetowego. Wejdź na stronę, `/admin/`aby zarządzać treścią.

### 4. Zmień hasło administratora
Zaloguj się na stronie `/admin/login.php`przy użyciu domyślnych danych logowania, a następnie edytuj , aby`config.php` zmienić `ADMIN_PASSWORD`.

## Struktura plików

```
nexusrp/
├── config.php # Site name, URL, DB, admin credentials
├── nexusrp.sql # Database schema + seed data
├── index.php # Homepage
├── about.php # About Us
├── applications.php # Dynamic job applications
├── changelogs.php # Server updates
├── contact.php # Contact page
├── rules.php # Server rules
├── includes/
│ ├── navigation.php # Shared navbar (auto active state)
│ ├── footer.php # Shared footer
│ ├── database.php # PDO connection singleton
│ ├── functions.php # Helpers (CSRF, escaping, redirects)
│ └── submit_application.php # AJAX form submission handler
├── admin/
│ ├── includes/
│ │ ├── auth.php # Authentication & session management
│ │ └── header.php # Admin layout & sidebar
│ ├── index.php # Redirect to dashboard
│ ├── login.php # Admin login
│ ├── logout.php # Admin logout
│ ├── dashboard.php # Stats overview
│ ├── applications.php # CRUD application categories
│ ├── fields.php # Manage form fields per category
│ └── submissions.php # View & manage submissions
├── assets/
│ ├── css/style.css # Main stylesheet
│ ├── js/main.js # JavaScript functionality
│ └── img/hero.jpeg # Hero background
└── docs/
├── README.md # This file
└── docs.html # Full documentation
```

## Tabele bazy danych

| Tabela | Cel |
|-------|---------|
| `application_categories` | Wpisy dotyczące aplikacji (nazwa, ikona, status, opis, wymagania) |
| `application_fields` | Niestandardowe pola formularza dla poszczególnych kategorii (tekst, adres e-mail, lista wyboru, obszar tekstowy itp.) |
| `application_submissions` | Złożone wnioski (dane JSON, śledzenie adresów IP, status) |
| `admin_users` | Dodatkowi użytkownicy z uprawnieniami administratora |

## Panel administracyjny

Dostęp pod adresem `/admin/`— 7-dniowa sesja trwała, zabezpieczona przed atakami CSRF, responsywny układ strony.

**Pulpit nawigacyjny** — liczba kategorii, statystyki zgłoszeń, ostatnia aktywność
**Aplikacje** — tworzenie/edytowanie/usuwanie kategorii aplikacji z ikonami Bootstrap, status: otwarta/ograniczona/zamknięta
**Pola formularza** — narzędzie do tworzenia pól dla poszczególnych kategorii: dodawanie pól tekstowych, e-mailowych, liczbowych, adresów URL, pól tekstowych typu „textarea” oraz pól wyboru; zmiana kolejności; oznaczanie pól jako obowiązkowe
**Zgłoszenia** — filtruj według kategorii/statusu, wyświetl pełne odpowiedzi, zmień status (oczekujące/sprawdzone/zaakceptowane/odrzucone), usuń

## System aplikacji

Aplikacje są ładowane dynamicznie z bazy danych. Każda kategoria jest wyświetlana w postaci karty zawierającej:
- Ikona i nazwa Bootstrap
- Oznaczenie statusu: „Otwarte” / „Ograniczona liczba miejsc” / „Zamknięte”
- Opis i lista wymagań
- Przycisk „Zgłoś się teraz” → okno modalne z niestandardowymi polami formularza

Gdy użytkownik prześle zgłoszenie, rejestrowany jest jego adres IP. Blokowane są powtórne zgłoszenia w tej samej kategorii.

## Dostosowanie

### Zmień nazwę witryny
Edytuj →`config.php` `SITE_NAME`— automatycznie zaktualizowane wszędzie.

### Zmień kolory
Zmodyfikuj konfigurację Tailwind w `<script>`bloku i zmiennych CSS`style.css` każdej strony.

### Dodaj strony
Utwórz nowy plik`.php` w katalogu głównym, ustaw `$current_page`, dołącz `config.php`, `navigation.php`, oraz `footer.php`.

### Linki nawigacyjne
Edytuj `includes/navigation.php`→ tablica`$nav_links`.

## Uwagi dotyczące bezpieczeństwa

- Zmiana przed`config.php` rozpoczęciem`ADMIN_PASSWORD` produkcji
- Ustaw flagę bezpieczeństwa`session_set_cookie_params` na `true`podczas korzystania z protokołu HTTPS
- Warto rozważyć użycie `password_hash()`jako danych logowania administratora w środowisku produkcyjnym
- Wszystkie zapytania do bazy danych wykorzystują przygotowane instrukcje PDO
- Wszystkie dane wyjściowe przeznaczone dla użytkownika są generowane `htmlspecialchars()`za pomocą funkcji pomocniczej`e()`
- Wszystkie formularze POST zawierają tokeny CSRF

## Licencja i prawa autorskie

**2026 illusion @ CodeStrike.STORE — Wszelkie prawa zastrzeżone**

- Wykorzystaj to na swojej osobistej stronie internetowej poświęconej serwerowi FiveM
- Dostosuj do własnych potrzeb
- Zabrania się dalszego rozpowszechniania, odsprzedaży lub udzielania sublicencji
- Nie należy usuwać informacji o prawach autorskich
- Nie podawaj tego jako własnej pracy

**Zakup:** https://codestrike.store/resources

---

Stworzone przy współpracy z illusion @ CodeStrike.STORE