# NexusRP – CMS за премиум FiveM сървъри


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

NexusRP е CMS с пълен набор от функции за FiveM сървъри за ролеви игри. Създадена с PHP 8+, MySQL/PDO и TailwindCSS, тя включва динамична система за приложения с административен панел, модулни включения и управление на съдържанието, базирано на база данни. Това включва [NexusRP | Шablon за уебсайт на FiveM сървър „Ultimate“
](https://codestrike.store/resource/nexusrp-ultimate-fivem-server-website-template) + Приложенията работят с админ панел.

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

- **6 страници на потребителския интерфейс** — Начало, Правила, За нас, Контакти, История на промените, Приложения
- **Административен панел** — защитен контролен панел на `/admin/`с вход и управление на сесиите
- **Динамична система за кандидатстване** — Създавайте неограничен брой категории за кандидатстване с персонализирани полета във формулярите
- **Инструмент за създаване на формуляри за кандидатстване** — полета за текст, имейл, номер, URL, текстово поле, списък за избор/падащо меню по категории
- **Мениджър на заявките** — преглед, одобрение/отхвърляне и филтриране на заявките от административния панел
- **Конфигурационно управлявано** — Единен `config.php`за името на сайта, URL адреса, базата данни и данните за вход на администратора
- **Модулни компоненти** — обща навигация, долна част на страницата, връзка с база данни, помощни функции
- **Антиспам** — по 1 заявка на IP адрес за всяка категория на кандидатстване
- **Защита срещу CSRF** — Всички административни формуляри са защитени срещу фалшифициране на заявки между сайтове
- **Защита срещу XSS** — Екраниране на изходните данни за цялото съдържание, създадено от потребителите
- **PDO** — **предварително подготвени заявки** — без SQL-инжектиране
- **Сигурност на сесията** — Прегенерирани идентификатори на сесията, изтриване на „бисквитките“ при излизане от системата
- **Тъмна тема** — Премиум дизайн с TailwindCSS, икони от Bootstrap, анимации от AOS

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

- PHP 8.0 и по-нови версии
- MySQL 5.7+ / MariaDB 10.3+
- Уеб сървър (Apache / Nginx / IIS)
- Не се изисква процес на компилиране (зависимости от CDN)

## Бързо стартиране

### 1. Настройка на базата данни
Качете файла в`nexusrp.sql` phpMyAdmin или го изпълнете чрез MySQL CLI. Това ще създаде всички таблици и ще въведе примерни данни.

### 2. Настройка
Редактиране`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. Разгръщане
Качете всички файлове в публичната директория на уеб сървъра си. Влезте в системата, за`/admin/` да управлявате съдържанието.

### 4. Промяна на администраторската парола
Влезте в `/admin/login.php`с потребителските данни по подразбиране, след което редактирайте , за`config.php` да промените `ADMIN_PASSWORD`.

## Структура на файловете

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

## Таблици в базата данни

| Таблица | Цел |
|-------|---------|
| `application_categories` | Елементи на приложението (име, икона, статус, описание, изисквания) |
| `application_fields` | Персонализирани полета във формулярите за всяка категория (текст, имейл, списък за избор, текстово поле и др.) |
| `application_submissions` | Подадени заявки (данни в JSON, проследяване на IP адреси, статус) |
| `admin_users` | Допълнителни потребители с администраторски права |

## Административен панел

Достъп на `/admin/`— 7-дневна постоянна сесия, защита срещу CSRF, адаптивен дизайн.

**Табло** — брой категории, статистика за публикациите, последни действия
**Кандидатури** — създаване/редактиране/изтриване на категории кандидатури с икони на Bootstrap, състояние „отворена“, „с ограничен достъп“ или „затворена“
**Полета във формуляра** — инструмент за създаване на полета по категории: добавяне на полета за текст, имейл, число, URL, текстово поле, списък за избор; промяна на реда; маркиране като задължителни
**Подадени предложения** — филтриране по категория/статус, преглед на пълните отговори, промяна на статуса (в очакване/прегледано/одобрено/отхвърлено), изтриване

## Система за кандидатстване

Приложенията се зареждат динамично от базата данни. Всяка категория се показва под формата на карта, съдържаща:
- Икона и име на Bootstrap
- Значка със статус „Отворено“ / „Ограничен брой места“ / „Затворено“
- Описание и списък с изисквания
- Бутон „Кандидатствай сега“ → модално прозорче с персонализирани полета във формуляра

Когато даден потребител изпрати информация, неговият IP адрес се записва. Повторните подавания в една и съща категория се блокират.

## Персонализиране

### Промяна на името на сайта
Редактиране →`config.php` `SITE_NAME`— автоматично се актуализира навсякъде.

### Промяна на цветовете
Променете конфигурацията на Tailwind в блока`<script>` и `style.css`CSS променливите на всяка страница.

### Добавяне на страници
Създайте нов файл`.php` в кореновата директория, задайте `$current_page`, включете `config.php`, `navigation.php`, и `footer.php`.

### Връзки за навигация
Редактиране `includes/navigation.php`→ масив`$nav_links`.

## Забележки относно сигурността

- Промяна `ADMIN_PASSWORD`в етапа преди`config.php` производството
- Задайте флага за сигурност`session_set_cookie_params` на `true`при използване на HTTPS
- Обмислете да използвате `password_hash()`за администраторските данни за достъп в производствената среда
- Всички заявки към базата данни използват подготвени изрази на PDO
- Всички изводи, предназначени за потребителя, се осъществяват `htmlspecialchars()`чрез `e()`помощната функция
- Всички POST формуляри съдържат CSRF токени

## Лиценз и авторски права

**2026 illusion @ CodeStrike.STORE — Всички права запазени**

- Използвайте го за уебсайта на вашия личен FiveM сървър
- Адаптирайте го според собствените си нужди
- Забранява се преразпространението, препродажбата или предоставянето на сублицензи
- Не премахвайте бележките за авторски права
- Не представяйте чуждата работа като своя

**Покупка:** https://codestrike.store/resources

---

Създадено с помощта на illusion @ CodeStrike.STORE