 |
Сводка | Плагин Discourse Subscriptions позволяет владельцам сайтов продавать подписки с регулярными и разовыми платежами, предоставляющими доступ к группе на инстансе Discourse. |
 |
Руководство по установке | Этот плагин входит в ядро Discourse. Отдельная установка плагина не требуется. |
Плагин Discourse Subscriptions позволяет создавать разовые, а также регулярные подписки, за которые пользователи могут платить для доступа к защищенному контенту. Это может быть отличным способом покрыть расходы на хостинг вашего сообщества.
Функции
Плагин Discourse Subscriptions поддерживает следующие функции:
- Создание новых продуктов и тарифных планов из админ-панели
- Отмена и возврат средств за подписки из админ-панели
- Создание тарифных планов с разовым платежом или регулярными подписками
- Добавление бесплатных пробных периодов для регулярных подписок
- Поддержка SCA/3D Secure
- Добавление/удаление пользователей из групп тарифных планов при их подписке/отмене
- Отмена подписки из профиля пользователя
- Отмена подписки в конце периода подписки
- Необязательная поддержка Stripe Checkout
- Автоматический расчет и сбор налога на продажи
- Пользователи могут обновлять свои карты для отдельных подписок
Кнопка «Подписаться», расположенная в верхней навигации, перенаправит вас на страницу подписки /s, где перечислены настроенные вами для сайта подписки:
Когда пользователь нажимает на одну из кнопок «Подписаться» для конкретного тарифного плана, открывается страница оплаты для этого плана:
После того, как пользователь заполнит свои платежные данные и адрес и нажмет «Подписаться», ему будет показано сообщение «Спасибо!» и он будет перенаправлен на свою страницу выставления счетов:
Пользователь также автоматически добавляется в выбранную вами группу, чтобы вы могли легко видеть, какие пользователи подписались, а также предоставлять защищенный контент в категориях, видимых только этой группе.
Термины
- Подписка (Subscription) - Подписки — это план регулярных платежей, который позволяет вам контролировать доступ к контенту в вашем сообществе. Когда подписка создается или удаляется, пользователь добавляется или удаляется из группы пользователей, связанной с вашим тарифным планом подписки. Подписка состоит из продукта и тарифных планов.
- Продукт (Product) - В терминологии Stripe продукт — это то, что вы продаете. Продукт может содержать один или несколько тарифных планов.
- Чтобы добавить описание к вашему продукту, добавьте поле метаданных с именем «description» и используйте его вместо этого. Вы можете использовать Markdown.
- Тарифный план (Plan) - Тарифный план содержит цену, цикл регулярных платежей и ассоциируется с группой, к которой получают доступ ваши подписчики.
Будьте очень осторожны и всегда храните ваши приватные ключи Stripe в безопасности.
Если вы закроете ваш инстанс Discourse, удалите этот плагин или ваш сайт выйдет из сети, Stripe продолжит выставлять счета вашим клиентам за вашу услугу, пока подписка не будет отменена.
Конфигурация
- Установите и включите плагин
- Настройте платежный шлюз (Stripe)
- Настройте вебхуки и события в Stripe
- Добавьте ваши ключи Stripe (публичный, секретный, секрет вебхука) в разделе Админ > Плагины > Установленные > Subscriptions > Настройки
/admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions. - Создайте группу, в которую пользователи будут вступать посредством покупки
- Создайте продукт и тарифный план в разделе Админ > Плагины > Subscriptions
- Зарабатывайте!
Настройте ваш платежный шлюз.
Во-первых, вам понадобится аккаунт в платежном шлюзе Stripe. Чтобы начать, вы можете настроить аккаунт в режиме тестирования и посмотреть, как все работает, не совершая реальных транзакций и не создавая банковский счет. В плагине нет переключателя режима тестирования; вместо этого убедитесь, что вы используете свои ключи разработчика (они начинаются с pk_test, sk_test)
Настройте вебхуки и события в вашем аккаунте Stripe
Вебхуки необходимы для полной работы отмены подписок. Убедитесь, что вы настроили их правильно.
Когда у вас будет аккаунт в Stripe, вам нужно будет сообщить Stripe адрес вашего сайта, чтобы он мог уведомлять вас о определенных транзакциях. Вы можете ввести это в вашей панели Stripe в разделе Endpoints > URL.
Адрес вебхука: [адрес вашего сервера]/s/hooks – где [адрес вашего сервера] — это URL вашего инсталляции Discourse.
Вам также нужно будет сообщить Stripe, о каких событиях он должен уведомлять вас через URL вебхука.
В настоящее время Discourse Subscriptions реагирует на следующие события:
customer.subscription.deletedcustomer.subscription.updatedcheckout.session.completedcheckout.session.async_payment_succeeded
Добавьте ключи API и вебхука Stripe в настройки вашего плагина
Stripe должен быть авторизован для общения с вашим сайтом. Для этого он публикует пару приватных и публичных ключей API и секрет подписи для ваших вебхуков.
Чтобы авторизовать вебхуки, добавьте ключи API и секрет вебхука из Stripe на вашу страницу настроек (в разделе Developers).
View test dataи получили ключиpk_testиsk_testв разделе Developers.
В настройках вашего аккаунта Stripe см.:
Добавьте эти ключи в соответствующие настройки в разделе Админ > Плагины > Установленные > Subscriptions > Настройки /admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions.
Настройте ваши группы пользователей в Discourse
Когда пользователь успешно подписывается на ваше приложение Discourse, после обработки транзакции по кредитной карте, он добавляется в группу пользователей. Назначая пользователей группе пользователей, вы можете управлять тем, к чему имеют доступ ваши пользователи на вашем сайте. Группы пользователей являются основной функцией Discourse, и этот плагин ничего с ними не делает, кроме добавления и удаления пользователей из группы, которую вы ассоциировали с вашим Тарифным планом.
Создайте один или несколько продуктов с тарифными планами.
В разделе Админ > Плагины > Subscriptions, нажмите «Добавить новый продукт». После сохранения продукта вы можете добавить к нему тарифные планы. Помните, что цены и интервалы выставления счетов тарифных планов не могут быть изменены после их создания. Это сделано, чтобы избежать путаницы в управлении подписками.
Если вы посмотрите на вашу Панель Stripe, вы увидите, что все эти продукты и тарифные планы перечислены там. Discourse Subscriptions не создает их локально. Они создаются в Stripe.
Тестирование
Тестируйте с этими номерами кредитных карт:
- 4242 4242 4242 4242
- 4111 1111 1111 1111 (без необходимости аутентификации)
- 4000 0027 6000 3184 (требуется аутентификация)
Для получения дополнительных тестовых номеров карт: Test card numbers | Stripe Documentation
Посетите /s и введите несколько тестовых транзакций.
Переход в боевой режим
Когда вы будете готовы перейти в боевой режим, измените ваши ключи API и секреты вебхука на ключи production. Вам нужно будет создать новые продукты и тарифные планы в живом режиме.
Обратите внимание, что, если вы не правильно настроите вебхуки Stripe, и регулярные платежи не будут обработаны по какой-либо причине (истекшая кредитная карта и т.д.), пользователи все равно будут иметь доступ к группе. Чтобы Stripe автоматически отменял подписки, убедитесь, что ваши настройки Управление неудачными платежами подобны изображению ниже, и настройте вебхуки, как описано выше.
Обновление платежных данных
Пользователи могут обновлять свою карту, используемую для отдельных подписок, посетив страницу выставления счетов и нажав кнопку редактирования рядом с подпиской, что откроет этот экран:
Stripe Checkout с таблицами ценообразования Stripe
Вы также можете выбрать замену страниц продукта и оформления заказа плагина Subscriptions и вместо этого использовать Stripe Checkout с таблицами ценообразования Stripe.
В вашей панели Stripe:
- После создания продуктов в Discourse, перейдите в Products > Product catalog
- Нажмите на продукт, который вы хотите включить в таблицу ценообразования
- Нажмите
Edit product More Optionsи введите следующее в разделеMetadata:- Key:
group_name - Value: Название группы в Discourse (например,
trust_level_0)
- Key:
- Нажмите
Update product, чтобы сохранить
Убедитесь, что название группы совпадает с группой, выбранной в
User_Groupsв Discourse
Создайте вашу таблицу ценообразования Stripe
- Перейдите в Products > Pricing tables
- Создайте новую таблицу и добавьте только что созданные продукты
- После публикации таблицы скопируйте ID таблицы ценообразования, найденный внутри кода встраивания (он начинается с
prctbl_...) - Вставьте ID таблицы ценообразования в
discourse_subscriptions_pricing_table_idи включите настройку таблицы ценообразования подписок. - Нажмите зеленые галочки, чтобы сохранить обе настройки.
Рекомендуемый шаг:
При настройке таблицы ценообразования внутри Stripe рекомендуется перенаправлять пользователя на ваш сайт после завершения оформления заказа, иначе он останется на странице подтверждения Stripe без ссылки на ваш сайт.
Перенаправление на https://<ваш-сайт>/my/billing/subscriptions — хороший выбор для подписок. Для разовых платежей вы можете напрямую связать с https://<ваш-сайт>/my/billing/payments.
Автоматический сбор налогов
Чтобы включить автоматический сбор налогов, отметьте флажок настройки сайта discourse_subscriptions_enable_automatic_tax.
Если вы включите его, но не правильно настроите ваш инстанс Stripe для сбора налогов, пользователи могут увидеть это всплывающее окно после завершения процесса оформления заказа:
Есть это руководство для получения дополнительной информации, но делать не должно быть много, так как плагин теперь передает соответствующий параметр automatic_tax[enabled]=true (шаг 5).
Убедитесь, что вы также настроили ваши регистрации (шаг 4):
Вот пример транзакции плагина подписки Discourse в 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 | Включает более подробное журналирование для помощи в отладке. Пожалуйста, не оставляйте это включенным постоянно в production. |
Хостинг у нас? Этот плагин доступен в наших планах хостинга Pro, Business и Enterprise Subscriptions | Discourse - Civilized Discussion
