Удалить все

ЗАГРУЗКА ...

Джанго мидлвари для управления донатными ссылками от BTCPay

13.03.2026

16.03.2026

Джанго приложение

Теги:

Тип Django приложения:

Мидлвари

Примеры

Изображение примера использования приложения

Описание

Данное приложение помогает управлять всеми донатными ссылками сгенерированными на собственном биткойн узле, на основе BTCPay Server. Минимальные требования к установке, управление через записи в базах данных и лёгкое размещение на сайте.

django-btcpay-donation это Джанго приложение созданное для того, чтобы легко следить и управлять созданными ссылками на BTCPay сервере для использования в качестве посредника создания инвойсов. Оно позволяет централизованно хранить все созданные тобой ссылки, группировать их по локациям на сайте и переключаться между этими группами используя стандартную админку от Django.

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

Особенности

Менеджмент УРЛ-ами. Сохраняет и автоматически форматирует BTCPay ссыли на инвойсы, переписывая доменное имя и ИД магазина, через настройку в settings.py
Группировка локаций. Привязывает донатные ссылки к конкретным разделам вашего сайта (например, «SIDEBAR», «FOOTER»).
Гибкость конфигурирования. Создавате наборы адресов ссылок и переключайте конфигурации одним щелчком мыши.
Автоматическое внедрение контекста. Особый мидлвари предоставляет вашим шаблонам активные донатные ссылки без ручного обновления представлений.

Установка и настройка

Устанавливаем пакет через pip:

pip install django-btcpay-donation

Дальше тебе нужно обновить файл settings.py, и добавить новоустановленное приложение в INSTALLED_APPS:

INSTALLED_APPS = [ ..., 'django_btcpay_donation.apps.BtcpaydonationConfig', ..., ]

Так же нужно подключить кастомный мидлвари в MIDDLEWARE для активации автоматической вставки контекстных переменных в шаблон:

MIDDLEWARE = [ ..., 'django_btcpay_donation.middleware.BTCPayDonationMiddleware', ..., ]

Вы также можете задать глобальные параметры для вашего сервера BTCPay. Если они заданы, приложение автоматически заменит домен и идентификатор магазина во всех сохраненных ссылках, чтобы они соответствовали этим значениям:

# The domain of your BTCPay Server BTCPAY_DOMAIN = "https://btc-node.of.by" # Your specific Store ID BTCPAY_STORE_ID = "YourStoreID"

Осталось только произветси миграцю базы данных:

python manage.py makemigrations python manage.py migrate

Использование

Настраиваем локации и контекст

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

А затем использовать его следующим образом:

{% if isBTCPayDonationMiddlewareConnected %} {% for location in donation_link_locations %} {% if location.linklocation_name == "FOOTER" %} <a href=""> Donate </a> {% endif %} {% endfor %} {% endif %}

Обратите внимание, что "FOOTER" — это всего лишь название, указывающее на местоположение этой кнопки. Вы можете ввести любое название по своему усмотрению.

Или, если вы хотите добавить резервный вариант по умолчанию, если местоположение не указано:

{% load checkLocation %} {% if isBTCPayDonationMiddlewareConnected %} {% with location=donation_link_locations|checkLocation:"MAIN-ABOVE-THE-FOLD" %} {% if location %} <a href=""> {% trans "Или поддержать проект" %}> </a> {% else %} <a href="/ru/"> {% trans "Или вернуться на главную" %} </a> {% endif %} {% endwith %} {% else %}

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

Давайте обсудим последовательность добавления новых кнопок пожертвований в ваше приложение Django. Прежде всего, всегда проверяйте, подключена ли мидлвари, то есть isBTCPayDonationMiddlewareConnected. Затем используйте автоматически добавляемый в контекст шаблона donation_link_locations.

При переборе с помощью тега for или шаблонного тега checkLocation, это не имеет значения, вы получите объект location с двумя свойствами:

link - фактическая сохраненная ссылка
linklocation_name - имя местоположения для проверки

Настройка записей и модели

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

BTCPayDonationLink: Добавьте URL-адреса ваших счетов BTCPay.
BTCPayDonationLinkLocation: Назначьте ссылки на определенные именованные местоположения (например, FOOTER).
BTCPayDonationConfiguration: Создайте именованную группу местоположений. А также выберите созданные местоположения.
BTCPayDonationCurrentConfiguration: Выберите, какая конфигурация в данный момент активна на сайте.

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