# NexusRP — премиум-система управления контентом для серверов FiveM


## Обзор

NexusRP — это полнофункциональная система управления контентом (CMS) для ролевых серверов FiveM. Система, разработанная на базе PHP 8+, MySQL/PDO и TailwindCSS, включает динамическую систему приложений с панелью администратора, модульными включениями и управлением контентом на основе базы данных. Сюда входит [NexusRP | Универсальный шаблон сайта для сервера FiveM
](https://codestrike.store/resource/nexusrp-ultimate-fivem-server-website-template) + Приложения, работающие с панелью администратора.

## Особенности

- **6 страниц интерфейса** — Главная, Правила, О нас, Контакты, Журнал изменений, Заявки
- **Административная панель** — защищённая панель управления на сайте с`/admin/` функциями входа в систему и управления сессиями
- **Система динамических приложений** — создавайте неограниченное количество категорий приложений с настраиваемыми полями форм
- **Конструктор форм** — поля «Текст», «Электронная почта», «Номер», «URL», «Текстовое поле», «Выбор/Выпадающий список» по категориям
- **Менеджер заявок** — просмотр, одобрение/отклонение и фильтрация заявок из панели администратора
- **Настройка через конфигурацию** — единый файл для`config.php` названия сайта, URL, базы данных и учетных данных администратора
- **Модульные компоненты** — общая навигация, нижний колонтитул, подключение к базе данных, вспомогательные функции
- **Защита от спама** — 1 заявка с одного IP-адреса на каждую категорию заявки
- **Защита от CSRF** — все административные формы защищены от межсайтового подделывания запросов
- **Защита от XSS** — экранирование вывода всего пользовательского контента
- **Подготовленные запросы PDO** — отсутствие SQL-инъекций
- **Безопасность сеанса** — перегенерированные идентификаторы сеанса, удаление файлов cookie при выходе из системы
- **Темная тема** — премиум-дизайн с использованием TailwindCSS, значков Bootstrap и анимаций AOS

## Требования

- PHP 8.0 и выше
- MySQL 5.7 и выше / MariaDB 10.3 и выше
- Веб-сервер (Apache / Nginx / IIS)
- Процесс сборки не требуется (зависимости от CDN)

## Быстрый старт

### 1. Настройка базы данных
Загрузите файл в`nexusrp.sql` phpMyAdmin или запустите его через командную строку MySQL. При этом будут созданы все таблицы и загружены примерные данные.

### 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` начала производства
- При`true` использовании HTTPS установите флаг безопасности`session_set_cookie_params` в положение
- Рекомендуется использовать `password_hash()`в качестве учетных данных администратора в производственной среде
- Во всех запросах к базе данных используются подготовленные запросы PDO
- Весь вывод, предназначенный для пользователя, осуществляется `htmlspecialchars()`с помощью helper`e()`
- Все формы POST содержат токены CSRF

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

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

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

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

---

Создано с помощью Illusion @ CodeStrike.STORE