Плагин подписок Discourse

[Discourse]

	Краткое описание	Плагин Discourse Subscriptions позволяет владельцам сайтов продавать подписки с периодической оплатой и разовые покупки, предоставляющие доступ к группе на экземпляре Discourse.
	Руководство по установке	Этот плагин включен в ядро Discourse. Отдельная установка плагина не требуется.

Поскольку это #официальный плагин, поддерживаемый командой Discourse, запросы на #поддержку, сообщения об #ошибках, предложения по улучшению ux и запросы на #новые функции можно направлять в соответствующие категории на Meta, помечая их подходящим тегом плагина. Нажмите на ссылку ниже, чтобы начать.

Поддержка Ошибка UX Функция

Плагин Discourse Subscriptions позволяет создавать как разовые, так и периодические подписки, за которые пользователи могут платить, чтобы получить доступ к закрытому контенту. Это отличный способ покрыть расходы на хостинг вашего сообщества.

Возможности

Плагин Discourse Subscriptions поддерживает следующие функции:

• Создание новых продуктов и тарифов из панели администратора
• Отмена и возврат средств по подпискам из панели администратора
• Создание разовых покупок или тарифов с периодической оплатой
• Добавление бесплатных пробных периодов к периодическим подпискам
• Поддержка SCA/3D Secure
• Добавление/удаление пользователей из групп тарифов при подписке/отмене
• Отмена подписки из профиля пользователя
• Отмена подписки в конце периода действия
• Опциональная поддержка Stripe Checkout
• Автоматический расчет и сбор налога с продаж
• Пользователи могут обновлять данные карты для отдельных подписок

Кнопка «Подписаться» в верхней навигации ведет на страницу подписки /s, где отображаются настроенные для вашего сайта подписки:

После того как пользователь нажмет на кнопку «Подписаться» для конкретного тарифа, откроется страница оплаты этого тарифа:

После того как пользователь заполнит свои платежные данные и адрес и нажмет «Подписаться», ему будет показано сообщение «Спасибо!», и он будет перенаправлен на страницу биллинга:

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

Термины

• Подписка — это план периодической оплаты, который позволяет контролировать доступ к контенту на вашем сообществе. При создании или удалении подписки пользователь добавляется в группу или удаляется из неё, связанной с вашим тарифом. Подписка состоит из продукта и тарифов.
• Продукт — в терминологии Stripe это то, что вы продаете. Продукт может содержать один или несколько тарифов.
  • Чтобы добавить описание к продукту, добавьте поле метаданных с именем «description» и используйте его. Вы можете использовать Markdown.
• Тариф — тариф содержит цену, периодичность и связывается с группой, к которой получают доступ подписчики.

Будьте предельно осторожны и всегда храните ваши приватные ключи Stripe в безопасности.

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

Конфигурация

1. Установите и включите плагин
2. Настройте платежный шлюз (Stripe)
3. Настройте вебхуки и события в Stripe
4. Добавьте ваши ключи Stripe (публичный, секретный, секрет вебхука) в разделе Администрирование > Плагины > Установленные > Подписки > Настройки /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
5. Создайте группу, в которую будут вступать пользователи через покупку
6. Создайте продукт и тариф в разделе Администрирование > Плагины > Подписки
7. Получайте прибыль!

Настройка платежного шлюза.

Сначала вам понадобится аккаунт в платежном шлюзе Stripe. Чтобы начать, вы можете создать аккаунт в тестовом режиме и посмотреть, как всё работает, не совершая реальных транзакций и не открывая банковский счет. В плагине нет переключателя тестового режима; вместо этого обязательно используйте ключи разработчика (они начинаются с pk_test, sk_test)

Настройка вебхуков и событий в вашем аккаунте Stripe

Вебхуки необходимы для полной работы отмены подписок. Убедитесь, что они настроены правильно.

После создания аккаунта в Stripe вам нужно сообщить Stripe адрес вашего сайта, чтобы он мог уведомлять вас о определенных транзакциях. Это можно сделать в панели управления Stripe в разделе Endpoints > URL.

Адрес вебхука: [ваш адрес сервера]/s/hooks – где [ваш адрес сервера] — это URL вашего установочного файла Discourse.

Вам также нужно указать Stripe, о каких событиях он должен уведомлять вас через URL вебхука.

В настоящее время Discourse Subscriptions реагирует на следующие события:

• customer.subscription.deleted
• customer.subscription.updated
• checkout.session.completed

Добавление ключей API и вебхука Stripe в настройки плагина

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

Чтобы авторизовать вебхуки, добавьте ключи API и секрет вебхука из Stripe на страницу настроек (в разделе Developers).

Добавление продакшн-ключей приведет к реальным платежам. Если вы планируете тестирование, обязательно переключитесь в режим View test data и получите ключи pk_test и sk_test в разделе Developers.

В настройках аккаунта Stripe посмотрите:

• https://dashboard.stripe.com/apikeys
• https://dashboard.stripe.com/webhooks

Добавьте эти ключи в соответствующие настройки в разделе Администрирование > Плагины > Установленные > Подписки > Настройки /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.

Настройка групп пользователей в Discourse

Когда пользователь успешно подписывается на ваше приложение Discourse, после обработки транзакции по кредитной карте он добавляется в группу пользователей. Назначая пользователей в группу, вы можете управлять тем, к чему у них есть доступ на вашем сайте. Группы пользователей — это основная функциональность Discourse, и этот плагин ничего не делает с ними, кроме как добавляет и удаляет пользователей из группы, связанной с вашим тарифом.

Создание одного или нескольких продуктов с тарифами.

В разделе Администрирование > Плагины > Подписки нажмите «Добавить новый продукт». После сохранения продукта вы можете добавить к нему тарифы. Помните, что цены и интервалы выставления счетов тарифов нельзя изменить после их создания. Это сделано для избежания путаницы при управлении подписками.

Если вы посмотрите на свою панель управления Stripe, вы увидите, что все эти продукты и тарифы перечислены там. Discourse Subscriptions не создает их локально. Они создаются в Stripe.

Тестирование

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

• 4242 4242 4242 4242
• 4111 1111 1111 1111 (авторизация не требуется)
• 4000 0027 6000 3184 (требуется авторизация)

Для получения дополнительных тестовых номеров карт: Test card numbers | Stripe Documentation

Посетите /s и выполните несколько тестовых транзакций.

Переход в режим реальных платежей

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

Обратите внимание, что если вы неправильно настроите вебхуки Stripe и периодические платежи не будут обработаны по какой-либо причине (истекшая карта и т. д.), пользователи всё ещё будут иметь доступ к группе. Чтобы Stripe автоматически отменял подписки, убедитесь, что вы настроили управление неудачными платежами аналогично изображению ниже, и настроили вебхуки, как описано выше.

Обновление платежной информации

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

Stripe Checkout с таблицами цен Stripe

Вы также можете заменить страницы продуктов и оформления заказа плагина подписки и вместо этого использовать Stripe Checkout с таблицами цен Stripe.

В вашей панели управления Stripe:

1. После создания продуктов в Discourse перейдите в Products > Product catalog
2. Нажмите на продукт, который вы хотите включить в таблицу цен
3. Нажмите Edit product
4. More Options и введите следующее в разделе Metadata:
   • Key: group_name
   • Value: Название группы в Discourse (например, trust_level_0)
5. Нажмите Update product, чтобы сохранить

Убедитесь, что название группы совпадает с группой, выбранной в User_Groups в Discourse

Создание вашей таблицы цен Stripe

1. Перейдите в Products > Pricing tables
2. Создайте новую таблицу и добавьте созданные вами продукты
3. После публикации таблицы скопируйте ID таблицы цен, найденный в коде встраивания (он начинается с prctbl_...)
4. Вставьте ID таблицы цен в discourse_subscriptions_pricing_table_id и включите настройку таблицы цен подписок.
5. Нажмите зеленые галочки, чтобы сохранить обе настройки.

Рекомендуемый шаг:

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

Перенаправление на https://<your-site>/my/billing/subscriptions — хороший выбор для подписок. Для разовых платежей вы можете напрямую ссылаться на https://<your-site>/my/billing/payments.

Автоматический сбор налогов

Чтобы включить автоматический сбор налогов, установите флажок настройки сайта для discourse_subscriptions_enable_automatic_tax.

Если вы включите эту опцию, но не настроите ваш экземпляр Stripe правильно для сбора налогов, пользователи могут увидеть это всплывающее окно после завершения процесса оформления заказа:

Существует это руководство для получения дополнительной информации, но делать нужно немного, так как плагин теперь передает соответствующий параметр automatic_tax[enabled]=true (шаг 5).

Также убедитесь, что вы настроили свои регистрации (шаг 4):

Вот пример транзакции плагина Discourse Subscription в Stripe, показывающий, что налог был автоматически собран:

Настройки

Название	Описание
discourse subscriptions enabled	Включить плагин Discourse Subscriptions.
discourse subscriptions extra nav subscribe	Отображать кнопку подписки в основной навигации
discourse subscriptions public key	Публичный ключ Stripe
discourse subscriptions secret key	Секретный ключ Stripe
discourse subscriptions webhook secret	Секрет вебхука Stripe
discourse subscriptions currency	Код валюты по умолчанию. Это можно переопределить при создании тарифа подписки.
discourse subscriptions campaign enabled	Включает баннер кампании для продвижения финансовой поддержки этого сообщества.
discourse subscriptions campaign goal	Целевое числовое значение для вашей кампании поддержки (подписчики или собранная сумма).
discourse subscriptions campaign type	Выбор типа кампании (подписчики или ежемесячная собранная сумма).
discourse subscriptions campaign banner location	Выбор расположения баннера кампании (верх или боковая панель).
discourse subscriptions campaign banner bg image	Загрузите собственное изображение для использования в качестве фона баннера кампании.
discourse subscriptions campaign banner shadow color	Выбор цвета тени баннера кампании.
discourse subscriptions campaign show contributors	Отображать аватары последних покупок продуктов подписки.
discourse subscriptions campaign product	ID продукта Stripe, который будет отправлен сторонникам при нажатии кнопки на кампании. Если эта настройка пуста, сторонники будут перенаправлены на главную страницу продуктов.
discourse subscriptions campaign grant	Предоставляет пользователю бесплатный месяц подписки
discourse subscriptions pricing table id	ID таблицы цен Stripe из кода встраивания
discourse subscriptions pricing table enabled	Включает использование таблицы цен Stripe и заменяет существующую страницу подписки
discourse_subscriptions_enable_automatic_tax	Переключатель сбора налога с продаж. Требует некоторой настройки в Stripe.
discourse_subscriptions_enable_verbose_logging	Включает более подробное ведение журнала для отладки. Пожалуйста, не оставляйте эту опцию постоянно включенной в продакшн-среде.

Хостинг от нас? Этот плагин доступен в наших тарифах Pro, Business и Enterprise Subscriptions | Discourse - Civilized Discussion