Главная/Документация/Сайт/Интеграции

Интеграции

Интеграции

Интеграции — это раздел административного кабинета, в котором подключаются внешние сервисы и дополнительные системы магазина.

С помощью этого раздела можно связать магазин с MagicByte Chat, FelixBot, WorkShop, FTP-доступом, Wargm и другими инструментами, которые расширяют возможности магазина и автоматизируют работу проекта.

Интеграции
Раздел управления интеграциями магазина

Основные элементы раздела

  1. Список интеграций

    На странице отображаются доступные интеграции, которые можно подключить к магазину.

  2. Статус подключения

    Справа у каждой интеграции отображается текущий статус:

    • зелёная иконка — интеграция включена или настроена;
    • красная иконка — интеграция отключена или не настроена.
  3. Редактирование

    Кнопка редактирования открывает страницу настройки выбранной интеграции.

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

После изменения настроек интеграции обязательно сохраняйте изменения и проверяйте работу подключения.


MagicByte Chat

MagicByte Chat — это интеграция с чат-виджетом MagicByte Chat.

Она позволяет подключить к магазину виджет обращений, чтобы пользователи могли писать в поддержку прямо с сайта.

Интеграция MagicByte Chat
Настройка интеграции MagicByte Chat

Назначение интеграции

MagicByte Chat собирает обращения пользователей из виджета на сайте в одном аккуратном окне.

Интеграция помогает:

  • быстрее отвечать пользователям;
  • принимать обращения прямо с витрины магазина;
  • не терять сообщения от игроков;
  • упростить поддержку проекта.

Настройки MagicByte Chat

  1. Интеграция с MagicByte Chat

    Включает или отключает интеграцию с чат-виджетом.

  2. ID сайта в MagicByte Chat

    Идентификатор сайта из панели MagicByte Chat.

  3. Identity Secret сайта в MagicByte Chat

    Секретный ключ сайта из панели MagicByte Chat.

Как подключить MagicByte Chat

  1. Откройте раздел Интеграции.
  2. Выберите MagicByte Chat.
  3. Включите параметр Интеграция с MagicByte Chat.
  4. Укажите ID сайта из панели MagicByte Chat.
  5. Укажите Identity Secret сайта.
  6. Нажмите Сохранить.
  7. Проверьте, что виджет появился на сайте магазина.

ID сайта и Identity Secret нужно копировать именно из панели MagicByte Chat. Если указать неверные данные, виджет может не подключиться.


FelixBot

FelixBot — это интеграция с Discord-ботом FelixBot.

Она используется для передачи токена и необходимых данных сервера, чтобы FelixBot мог корректно работать с магазином и связанными функциями.

Интеграция FelixBot
Настройка интеграции FelixBot

Назначение интеграции

Интеграция с FelixBot может использоваться для передачи данных между магазином и ботом.

Например, она может быть нужна для функций, связанных с сервером, пользователями, донат-системой или другими возможностями FelixBot.

Настройки FelixBot

  1. Интеграция с FelixBot

    Включает или отключает интеграцию.

  2. API Token сервера в FelixBot

    Токен сервера из FelixBot.

    Он используется для загрузки информации о сервере и корректной работы интеграции.

Как подключить FelixBot

  1. Откройте раздел Интеграции.
  2. Выберите FelixBot.
  3. Включите интеграцию.
  4. Укажите API Token сервера в FelixBot.
  5. Нажмите Сохранить.
  6. Проверьте, что интеграция работает корректно.

Храните API Token в безопасности. Не публикуйте его и не передавайте третьим лицам.


WorkShop

WorkShop — это интеграция с модификациями MagicByte.

Интеграция WorkShop
Страница интеграции WorkShop

Назначение интеграции

Модификация MagicByte не требует дополнительных параметров для настройки.
Подключение работает автоматически и готово к работе сразу после активации.


FTP интеграция

FTP интеграция — это подключение магазина к файловой системе сервера через FTP.

Она нужна для тех функций, где магазин должен читать или изменять файлы на сервере: например, работать с отдельными модификациями, путями пользователей, списками, хранилищами или файлами, которые не обрабатываются напрямую через DayZShop.

FTP интеграция
Настройка FTP-подключения

Структура раздела

Настройки FTP отображаются отдельно для каждого сервера магазина.

Внутри карточки сервера есть две вкладки:

  1. Подключение

    Основные параметры FTP-доступа.

  2. Пути модификаций

    Пути к папкам и файлам модификаций на FTP-сервере.


Подключение FTP

Во вкладке Подключение указываются базовые данные для доступа к FTP-серверу.

Поля подключения

  1. Включить FTP доступ

    Включает или отключает FTP-интеграцию для выбранного сервера.

  2. Хост FTP

    Адрес FTP-сервера.

    Например:

    ftp.example.ru
    
  3. Порт FTP

    Порт подключения к FTP.

    Обычно используется:

    21
    
  4. Имя пользователя FTP

    Логин FTP-пользователя.

  5. Пароль FTP

    Пароль FTP-пользователя.

  6. Использовать SSL

    Включает подключение через SSL, если ваш FTP-сервер поддерживает защищённое соединение.

  7. Проверить подключение

    Кнопка для проверки корректности введённых FTP-данных.

  8. Сохранить

    Сохраняет настройки FTP-подключения.


Если сервер находится на вашем компьютере или выделенной машине, FTP-сервер нужно настроить самостоятельно.

Как установить и настроить FTP сервер в Windows

Перед сохранением рекомендуется нажать Проверить подключение, чтобы убедиться, что магазин может подключиться к FTP-серверу.

Если проверка подключения показывает ошибку, проверьте хост, порт, логин, пароль, SSL и права FTP-пользователя.

Не используйте основной административный доступ к серверу, если можно создать отдельного FTP-пользователя с ограниченными правами только на нужные папки.


Пути модификаций

Во вкладке Пути модификаций указываются пути к папкам и файлам, с которыми должны работать отдельные модификации.

Пути модификаций FTP
Настройка путей модификаций

Доступные блоки путей

  1. MagicSkins

    Путь к папке пользователей для MagicSkins.

    Пример:

    DayZ_2402-profiles/MBS/users
    
  2. Gelik bodybag

    Путь к папке базы данных Gelik bodybag.

    Пример:

    profiles/Gelik_Mods/Gelik_BodyBag/db
    
  3. Текстура Gelik

    Путь к директории пользовательских текстур Gelik.

    Пример:

    profiles/Gelik_Mods/Gelik_BodyBag
    
  4. Персональные хранилища

    Путь к директории персональных хранилищ.

    Пример:

    DayZ_2402-Profile/PersonalChest
    
  5. SpawnSelectionClient

    Директория и список пользователей SpawnSelectionClient.

    Пример пути:

    profiles/SpawnSelectionClient
    

    В поле SpawnSelectionClient list можно указать UID или SteamID, если это требуется для работы модификации.

Синхронизация путей

У некоторых блоков может отображаться статус синхронизации.

Например:

  • Синхронизировано — путь проверен и используется системой;
  • Не синхронизировано — путь ещё не был проверен или требуется повторная синхронизация.

Пути должны указываться относительно структуры файлов на FTP-сервере. Перед заполнением проверьте, где именно хранятся данные нужной модификации.

Если путь указан неверно, интеграция может не найти нужные файлы и не сможет корректно работать с модификацией.

FTP-интеграция используется для доступа к файлам сервера. Заполняйте пути внимательно и не указывайте лишние директории, которые не относятся к нужной модификации.


Wargm

Wargm — это интеграция для автоматизации получения товаров.

Она позволяет связать магазин с Wargm через ID магазина и API-ключ.

Интеграция Wargm
Настройка интеграции Wargm

Назначение интеграции

Интеграция с Wargm используется для синхронизации покупок и передачи данных между магазином и внешней системой.

Настройки Wargm указываются отдельно для выбранного сервера.

Настройки Wargm

  1. ID магазина в Wargm

    Идентификатор магазина в системе Wargm.

  2. API ключ магазина в Wargm

    API-ключ магазина, который используется для подключения и синхронизации.

Как подключить Wargm

  1. Откройте раздел Интеграции.
  2. Выберите Wargm.
  3. Откройте настройки нужного сервера.
  4. Укажите ID магазина в Wargm.
  5. Укажите API ключ магазина в Wargm.
  6. Нажмите Сохранить.
  7. Проверьте корректность работы интеграции.

ID магазина и API-ключ должны быть указаны без ошибок. Если данные неверные, синхронизация с Wargm работать не будет.

API-ключ является служебным доступом к интеграции. Не публикуйте его и не передавайте третьим лицам.


Как подключить интеграцию

Общий порядок подключения большинства интеграций:

  1. Откройте раздел Интеграции.
  2. Выберите нужную интеграцию.
  3. Нажмите кнопку редактирования.
  4. Включите интеграцию, если для неё есть переключатель.
  5. Заполните обязательные поля.
  6. Нажмите Сохранить.
  7. Проверьте статус интеграции в общем списке.
  8. Проверьте работу интеграции на сайте или сервере.

Рекомендации

Перед подключением интеграций рекомендуется:

  • сначала настроить серверы магазина;
  • проверить товары и выдачу покупок;
  • убедиться, что нужные модификации установлены на сервере;
  • подготовить токены, ключи и ID из внешних сервисов;
  • использовать отдельные технические доступы там, где это возможно;
  • проверять интеграцию после каждого изменения.

Интеграции расширяют возможности магазина, но каждая из них должна быть настроена только после понимания, для чего она используется.

Если после подключения интеграции что-то работает некорректно, проверьте не только данные в панели, но и настройки внешнего сервиса, сервера или модификации.

Не публикуйте токены, API-ключи, FTP-логины, пароли и другие служебные данные. Эти данные дают доступ к интеграциям и могут повлиять на безопасность магазина или сервера.