 |
Краткое описание | Плагин Discourse Subscriptions позволяет владельцам сайтов продавать подписки с периодической оплатой и разовые покупки, которые предоставляют доступ к группе на сайте Discourse. |
 |
Руководство по установке | Этот плагин входит в состав ядра Discourse. Отдельная установка плагина не требуется. |
Плагин Discourse Subscriptions позволяет создавать разовые и периодические подписки, за которые пользователи могут платить для доступа к закрытому контенту. Это отличный способ покрыть расходы на хостинг вашего сообщества.
Возможности
Плагин Discourse Subscriptions поддерживает следующие функции:
- Создание новых продуктов и тарифных планов из панели администратора
- Отмена и возврат средств за подписки из панели администратора
- Создание планов разовой покупки или периодических подписок
- Добавление бесплатных пробных периодов для периодических подписок
- Поддержка SCA/3D Secure
- Добавление/удаление пользователей из групп тарифных планов при подписке/отмене
- Отмена подписки из профиля пользователя
- Отмена подписки в конце текущего периода подписки
- Дополнительная поддержка Stripe Checkout
- Автоматический расчет и сбор налога с продаж
- Пользователи могут обновлять данные карты для отдельных подписок
Кнопка «Подписаться» в верхней панели навигации перенаправит вас на страницу подписки /s, где будут перечислены подписки, которые вы настроили для своего сайта:
Когда пользователь нажимает на кнопку «Подписаться» для конкретного тарифа, открывается страница оплаты для этого тарифа:
После того как пользователь заполнит данные для оплаты и адрес и нажмет «Подписаться», ему будет показано сообщение «Спасибо!» и он будет перенаправлен на свою страницу выставления счетов:
Пользователь также автоматически добавляется в выбранную вами группу, чтобы вы могли легко видеть, кто из пользователей подписался, а также предоставлять закрытый контент в категориях, доступных только для этой группы.
Условия
- Подписка — Подписки представляют собой план периодических платежей, который позволяет вам контролировать доступ к контенту в вашем сообществе. При создании или удалении подписки пользователь добавляется или удаляется из группы пользователей, связанной с вашим тарифным планом. Подписка состоит из продукта и планов.
- Продукт — В терминах Stripe продукт — это то, что вы продаете. Продукт может содержать один или несколько планов.
- Чтобы добавить описание к вашему продукту, добавьте поле метаданных с именем «description» и используйте его. Вы можете использовать Markdown.
- План — План содержит цену, периодичность платежей и связан с группой, к которой получают доступ ваши подписчики.
Будьте очень осторожны и всегда храните свои закрытые ключи Stripe в безопасности.
Если вы выключите свой экземпляр Discourse, удалите этот плагин или ваш сайт станет недоступен, Stripe будет продолжать выставлять счета вашим клиентам за вашу услугу до тех пор, пока подписка не будет отменена.
Конфигурация
- Установите и включите плагин
- Настройте платежный шлюз (Stripe)
- Настройте Webhooks и события в Stripe
- Добавьте свои ключи Stripe (публичный, секретный, секрет webhooks) в разделе Администратор > Плагины > Установленные > Подписки > Настройки
/admin/site_settings/category/discourse_subscriptions?filter=plugin%3Adiscourse-subscriptions. - Создайте группу для подписчиков, которые присоединятся после покупки
- Создайте продукт и план в разделе Администратор > Плагины > Подписки
- Прибыль!
Настройте свой платежный шлюз.
Сначала вам понадобится аккаунт в платежном шлюзе Stripe. Чтобы начать, вы можете создать аккаунт в тестовом режиме и посмотреть, как все работает, не совершая реальных транзакций и не настраивая банковский счет. В плагине нет переключателя тестового режима; вместо этого обязательно используйте свои ключи разработчика (они начинаются с pk_test, sk_test)
Настройте Webhooks и события в вашем аккаунте Stripe
Webhooks необходимы для полной работы отмены подписок. Убедитесь, что они настроены правильно.
После создания аккаунта в Stripe вам нужно сообщить Stripe адрес вашего сайта, чтобы он мог уведомлять вас о определенных транзакциях. Вы можете ввести это в панели управления Stripe в разделе Конечные точки > URL.
Адрес Webhooks: [адрес вашего сервера]/s/hooks — где [адрес вашего сервера] — это URL вашего сайта Discourse.
Вам также нужно сообщить Stripe, о каких событиях он должен уведомлять вас через URL webhooks.
В настоящее время Discourse Subscriptions реагирует на следующие события:
customer.subscription.deletedcustomer.subscription.updatedcheckout.session.completed
Добавьте ключи API и Webhooks Stripe в настройки вашего плагина
Stripe необходимо авторизовать для связи с вашим сайтом. Для этого он публикует пару закрытых и открытых ключей API и секрет подписи для ваших webhooks.
Для авторизации webhooks добавьте ключи API и секрет webhook из Stripe на страницу настроек (в разделе Разработчики).
View test dataи получите ключиpk_testиsk_testв разделе Разработчики.
В настройках вашего аккаунта Stripe см.:
Добавьте эти ключи в соответствующие настройки в разделе Администратор > Плагины > Установленные > Подписки > Настройки /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 и секреты webhook на ключи для продакшена. Вам нужно будет создать новые продукты и планы в режиме реального времени.
Обратите внимание, что если вы неправильно настроите вебхуки Stripe и периодические платежи не будут обрабатываться по какой-либо причине (истекшая кредитная карта и т. д.), пользователи все равно будут иметь доступ к группе. Чтобы Stripe автоматически отменял подписки, обязательно настройте свои Управление неудачными платежами аналогично изображению ниже и настройте вебхуки, как описано выше.
Обновление платежной информации
Пользователи могут обновить карту, используемую для отдельных подписок, посетив страницу выставления счетов и нажав кнопку «Изменить» рядом с подпиской, что откроет этот экран:
Stripe Checkout с таблицами цен Stripe
Вы также можете отказаться от использования страниц продуктов и оформления заказа плагина Subscriptions и вместо этого использовать Stripe Checkout с Таблицами цен Stripe.
В вашей панели управления Stripe:
- После создания продуктов на Discourse перейдите в Продукты > Каталог продуктов
- Нажмите на продукт, который хотите включить в таблицу цен
- Нажмите
Изменить продукт Дополнительные опциии введите следующее в разделеМетаданные:- Ключ:
group_name - Значение: Имя группы в Discourse (например,
trust_level_0)
- Ключ:
- Нажмите
Обновить продукт, чтобы сохранить
Убедитесь, что имя группы совпадает с группой, выбранной в
User_Groupsв Discourse
Создайте таблицу цен Stripe
- Перейдите в Продукты > Таблицы цен
- Создайте новую таблицу и добавьте созданные вами продукты
- После публикации таблицы скопируйте идентификатор таблицы цен, найденный в коде встраивания (он начинается с
prctbl_...) - Вставьте идентификатор таблицы цен в ваш
discourse_subscriptions_pricing_table_idи включите настройку таблицы цен подписок. - Нажмите зеленые галочки, чтобы сохранить обе настройки.
Рекомендуемый шаг:
При настройке Таблицы цен внутри 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 | Секрет webhook 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 | Идентификатор продукта Stripe для отправки сторонников при нажатии кнопки на кампании. Если эта настройка пуста, сторонники будут перенаправлены на главную страницу продуктов. |
| discourse subscriptions campaign grant | Предоставляет пользователю бесплатный месяц подписок |
| discourse subscriptions pricing table 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
Хостится нами? Этот плагин доступен в наших планах хостинга Pro, Business и Enterprise