CB Paid Subscriptions - Расширение Joomla

Руководство по настройке и применению CB Paid Subscriptions на Joomla-сайте

CB Paid Subscriptions стоит рассматривать не как обычную форму оплаты, а как систему управления доступом, подписками и платными сценариями вокруг Community Builder. В этом руководстве разберём, как подойти к установке, как спроектировать планы, какие настройки проверить после включения, как связать подписку с доступом к материалам и как диагностировать ситуации, когда оплата прошла, но пользователь не получил ожидаемые права.

Материал рассчитан на владельца Joomla-сайта, администратора клуба, автора закрытого контента, образовательный проект, поддержку с платным доступом или агентство, которое собирает членский раздел для клиента. Здесь нет инструкции по покупке самого расширения. Фокус - на рабочем применении уже имеющегося продукта, проверках и безопасном запуске на реальном сайте.

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

Какую задачу решает расширение и где оно особенно полезно

Главная задача CB Paid Subscriptions - связать пользователя Community Builder с планом подписки и на основании этого плана открыть или закрыть доступ к частям сайта. На практике это может быть платная база знаний, клубный раздел, закрытая категория статей, доступ к загрузкам, платная поддержка, обучение с постепенным открытием материалов, семейное или корпоративное членство, пожертвования и продажа отдельных услуг.

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

Наиболее сильная сторона продукта - не один конкретный экран, а связка нескольких механизмов. CB Paid Subscriptions может работать с планами разной длительности, первым платежом и продлением, скидками, семейными планами, интеграциями с полями и вкладками Community Builder, защитой Joomla-контента, URL-правилами, группами пользователей, рассылками, статистикой и платежными шлюзами. Поэтому хорошая настройка начинается не с кнопки Install, а с модели доступа.

Типовые сценарии применения

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

• Закрытый контент. Подписка открывает статьи, категории, меню, модули или отдельные URL, а незарегистрированный посетитель видит понятный путь к регистрации.
• Клубное членство. План действует ограниченный срок, допускает продления, может быть связан с группой пользователей Joomla и профилем Community Builder.
• Обучение и поэтапный доступ. Пользователь получает доступ к материалам не просто "всё сразу", а по логике периода подписки и статуса плана.
• Семейные или корпоративные планы. Один участник оплачивает план и делится доступом с ограниченным числом связанных пользователей.
• Платные услуги и пожертвования. Расширение может использоваться не только для классического членства, но и для отдельных покупок, товаров, сервисов и добровольных платежей, если такая модель подходит сайту.

Мини-итог: расширение полезно там, где важен управляемый статус подписчика. Если нужно просто принять один разовый платёж без учётной записи, продукт может оказаться сложнее, чем нужно.

Кому CB Paid Subscriptions подходит, а кому лучше выбрать проще

CB Paid Subscriptions сильнее всего раскрывается на сайтах, где Community Builder уже является центром пользовательских профилей. Если у вас есть расширенные профили, поля, вкладки, социальные функции, группы, история пользователя и несколько уровней участия, логично держать подписки рядом с этой моделью. Тогда план становится частью профиля, а не отдельной записью, которую нужно вручную синхронизировать.

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

Когда продукт будет удачным выбором

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

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

Когда лучше не усложнять сайт

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

Продукт также может не подойти команде, которая не хочет работать с Community Builder. CB Paid Subscriptions является CB-плагином, и его логика строится вокруг пользователей CB. Если сайт использует только стандартную регистрацию Joomla и не планирует расширенные профили, стоит сравнить альтернативы, где членство построено вокруг собственных форм и таблиц подписчиков.

Что проверить перед установкой: зависимости, доступ и безопасный старт

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

Платформа и базовые зависимости

Проверьте, что на сайте установлен и корректно работает Community Builder. Без него продукт теряет основной смысл. В документации и каталоге расширение описывается как решение для Joomla-сайта, использующего Community Builder. Также проверьте совместимость вашей версии Joomla, PHP и базы данных с текущим пакетом расширения. Точные номера лучше сверять на странице Joomla Extensions Directory и странице загрузок разработчика перед обновлением, потому что они меняются.

Для безопасного запуска подготовьте тестовую копию сайта. Это особенно важно, если уже есть действующие пользователи, кастомные группы, платный контент, сложные правила ACL или сторонние расширения рассылок. На тестовой копии можно создать один план, один тестовый материал, один способ оплаты в тестовом режиме и пройти весь путь без риска для настоящих подписчиков.

Права доступа и структура контента

Составьте список объектов, которые будут закрываться подпиской. Не начинайте с общего правила "закрыть всё". Разделите материалы на уровни: публичное, доступно после регистрации, доступно по базовому плану, доступно по расширенному плану, доступно только администратору или редактору. Для Joomla это особенно важно, потому что у вас есть собственная система уровней доступа, группы пользователей, пункты меню, категории, статьи и модули.

Если вы планируете использовать встроенную защиту CBSubs, подготовьте отдельную категорию или несколько тестовых статей. Если будете связывать планы с Joomla ACL, заранее создайте группы пользователей и уровни просмотра. Не смешивайте оба подхода без причины: либо план управляет доступом через интеграции CBSubs, либо он назначает пользователя в понятную группу, которая уже открывает нужные материалы.

Платёжные сервисы и исходящая связь

Для платных планов проверьте, может ли сервер выполнять исходящие HTTPS-запросы. В support-обсуждениях по Stripe встречается симптом, когда пользователь возвращается с платёжной страницы, но подписка не активируется, потому что сайт не может связаться с платёжным сервисом или не получает уведомления. Это не всегда ошибка CB Paid Subscriptions. Причина может быть в хостинге, брандмауэре, настройках PHP, правилах безопасности или неверно настроенных вебхуках.

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

Установка и первичная проверка в админ-панели Joomla

Установка выполняется как для обычного Joomla-расширения, но важный нюанс в том, что основной пакет CB Paid Subscriptions является CB-плагином и устанавливается через систему Community Builder. Дополнительные интеграции и платёжные процессоры подключаются только тогда, когда они действительно нужны сценарию. Не включайте все плагины "про запас": чем больше активных интеграций, тем сложнее диагностика.

Последовательность первого запуска

1. Проверьте, что Community Builder установлен, опубликован и регистрация пользователей работает в выбранной модели сайта.
2. Установите основной пакет CB Paid Subscriptions через подходящий менеджер плагинов Community Builder, следуя документации разработчика.
3. Опубликуйте только основной плагин и те интеграции, которые нужны для первого сценария: например, защиту Joomla-контента, один платёжный шлюз, почтовые уведомления или связь с группами пользователей.
4. Откройте панель CBSubs в админ-панели и убедитесь, что видны разделы планов, подписок, платежей, корзин, настроек и журналов.
5. Создайте один тестовый план с безопасной ценой или бесплатным режимом и проверьте, что он отображается для пользователя там, где вы ожидаете.

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

Что должно быть видно после установки

В админ-панели у вас должен появиться набор управляемых областей: планы, подписки пользователей, платежи, настройки, интеграции и журналы. На публичной части сайта пользователь должен видеть доступный план или путь к подписке, если вы специально вывели пункт меню, форму регистрации или ссылку на план. На странице профиля Community Builder могут отображаться сведения о подписке, но не путайте пользовательскую вкладку с полной административной историей. В support-форуме разработчик уточняет, что полный журнал подписок смотрят в админ-панели через раздел подписок.

Проектирование планов: сроки, продления, эксклюзивность и понятный выбор

План подписки - центральный объект CB Paid Subscriptions. В нём сходятся длительность, цена, продление, отображение, доступ, интеграции, скидки и правила поведения после окончания периода. Если план спроектирован плохо, даже идеально настроенный платёжный шлюз не спасёт пользовательский опыт: человек оплатит не то, увидит не тот доступ или не поймёт, как продлить.

Начните с маленькой матрицы планов

Для первого запуска достаточно двух или трёх планов. Например: бесплатный зарегистрированный доступ, базовый платный доступ и расширенный доступ. Если у вас клуб, добавьте семейный или корпоративный вариант только после того, как базовая модель работает. Если у вас обучение, сначала настройте один план с доступом к закрытой категории, а поэтапное открытие материалов оставьте вторым этапом.

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

Сроки, льготный период и продление

Длительность плана должна соответствовать обещанию на странице сайта. Если вы обещаете месячный клуб, не делайте внутренний план с непонятной длительностью и ручным продлением. Если у проекта сезонное членство, заранее проверьте, как будет работать фиксированное окончание периода. Для подписок с автоматическим продлением особенно важно пройти тест: первая покупка, повторный платёж, окончание, отмена и ручное вмешательство администратора.

Льготный период полезен, когда пользователь может просрочить платёж, но вы не хотите мгновенно закрывать доступ. Однако эта настройка требует аккуратности: в changelog/roadmap встречаются исправления, связанные с кнопками продления и состояниями подписок. Поэтому после включения льготного периода проверьте не только доступ, но и интерфейс пользователя: предлагает ли сайт продлить план в правильный момент, не показывает ли лишние действия для автоматического продления.

Эксклюзивные и параллельные планы

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

Практическое правило: если план меняет уровень доступа, продумайте путь обновления и отката. Если план продаёт отдельную услугу, не привязывайте его к исключающей логике без причины.

Доступ к контенту: статьи, категории, меню, модули и профиль Community Builder

CB Paid Subscriptions может ограничивать доступ к разным типам объектов Joomla и Community Builder. Это одна из причин, почему расширение выбирают для сложных членских сайтов. Но именно здесь чаще всего появляются ошибки проектирования: план создан, платежи работают, а закрытая статья всё равно видна гостю или, наоборот, платный пользователь видит сообщение об отказе.

Два подхода к ограничению доступа

Первый подход - использовать интеграции CBSubs для защиты конкретных объектов: статей, категорий, URL, модулей, вкладок и полей профиля. Это удобно, когда правила доступа завязаны именно на план подписки и не должны расползаться по стандартным группам Joomla.

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

На практике часто используют гибрид, но начинать лучше с одного основного метода. Например, для закрытой категории статей используйте CBSubs Content и CBSubs bot. Для глобального доступа к разделу сайта через меню и модули - Joomla ACL. Для полей профиля и вкладок Community Builder - интеграцию Fields/Tabs Protection.

Что закрывать в первую очередь

Начинайте с наиболее понятного объекта. Закрытая категория статей обычно проще, чем набор отдельных URL и модулей. Создайте категорию "Для подписчиков", добавьте одну тестовую статью, привяжите доступ к одному плану и проверьте три состояния: гость, зарегистрированный пользователь без подписки, подписчик с активным планом. Эта тройная проверка быстрее выявляет ошибку, чем тест только под администратором.

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

Сообщение об отказе и путь к подписке

Страница отказа в доступе не должна быть тупиком. Пользователь должен понять, почему материал закрыт и какой план его откроет. В официальном описании JED отмечается, что CB Paid Subscriptions может предлагать доступный план для защищённого объекта. Если используете эту возможность, проверьте текст, ссылку и отображение для разных языков сайта.

Если текст отказа выглядит неуместно, безопаснее использовать штатные языковые переопределения Joomla или настройки сообщения в расширении, а не править файлы продукта. Языковые переопределения сохраняются при обновлениях и позволяют изменить формулировку без вмешательства в код.

Платежи, корзина и уведомления: как не потерять связь между оплатой и доступом

Платёжная часть CB Paid Subscriptions состоит не только из выбора шлюза. Между пользователем и активной подпиской есть корзина, выбранный план, платёжный процессор, возврат с платёжной страницы, уведомления от провайдера, журнал событий и итоговое состояние подписки. Если один участок цепочки ломается, пользователь может считать оплату успешной, а сайт не выдаст доступ.

Выбор платёжного шлюза для первого теста

Официальная страница продукта перечисляет множество платёжных процессоров, включая Stripe, PayPal, Authorize.net, 2Checkout, офлайн-оплату и тестовые варианты. Для первого запуска выберите один онлайн-шлюз и один безопасный способ тестирования. Не подключайте одновременно несколько провайдеров, пока не прошли полный сценарий: оформление, возврат, уведомление, активация подписки, письмо, отображение в профиле и отмена.

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

Вебхуки и входящие уведомления

Для Stripe и похожих сервисов критична настройка уведомлений. Если платёж прошёл у провайдера, но вебхук не дошёл до сайта или не сопоставился с корзиной, подписка может не активироваться. В support-ответах разработчик советует проверять настройки вебхуков, URL, секрет подписи, журнал уведомлений CBSubs, историю и логи на стороне Stripe.

Проверяйте не только успешный платёж. Сделайте тест отказа, отмены, повторной попытки и возврата. Администратор должен понимать, где смотреть состояние: список платежей, корзины, подписки, уведомления, история пользователя, журнал платёжного провайдера. Если вы используете автоматическое продление, отдельный тест нужен для повторного платежа и отмены.

Налоги, валюты и адреса

CB Paid Subscriptions имеет интеграции для налогов и мультивалютности. Это сильная возможность, но для первого запуска она может стать источником ошибок, если вы не знаете, какие правила нужны. Не включайте автоматическую конвертацию валют и сложные налоговые зоны без реальной необходимости. Если сайт продаёт доступ в одной стране и одной валюте, начните проще, проверьте корректность суммы в корзине, счета и письма, а затем расширяйте модель.

Подробная настройка после установки: от минимального плана к рабочему членскому разделу

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

Глобальные настройки

В глобальных настройках проверьте базовые параметры отображения, маршруты, регистрацию, поведение корзины, формат цен, сообщения и включённые интеграции. Если интерфейс показывает состояние установленной и доступной версии, не игнорируйте предупреждения. Support-кейсы со Stripe показывают, что ошибки связи с сервером обновлений и внешними сервисами иногда имеют общую причину - сервер не может выполнять исходящие HTTPS-запросы.

На типовом сайте сначала оставьте только необходимые интеграции. Для закрытой категории материалов обычно достаточно основного продукта, интеграции контента, нужного платёжного процессора и писем. Для семейного плана понадобятся Family Plans и связанные поля Community Builder. Для маркетинга - Promotions и Mailer, но их лучше подключать после базового сценария.

Настройки плана

У плана проверьте название, описание, длительность, цену, правило продления, эксклюзивность, отображение, CSS-класс и связанные интеграции. Название должно быть понятно пользователю, а не только администратору. Описание должно объяснять, что именно откроется после подписки. Если план скрытый, например для семейного участника или служебного назначения, отметьте это в документации проекта, чтобы будущий администратор не удалил его как "лишний".

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

Как проверить, что план работает

1. Создайте тестового пользователя без административных прав.
2. Откройте публичный путь к плану и убедитесь, что план виден именно тому типу пользователя, которому он предназначен.
3. Оформите подписку в тестовом режиме или через бесплатный план, если проверяете доступ без платежа.
4. Проверьте админ-панель: подписка появилась, состояние активно, пользователь связан с правильным планом.
5. Откройте защищённый материал под этим пользователем и убедитесь, что доступ появился без ручного сохранения профиля.
6. Выйдите из аккаунта или используйте гостевой режим и проверьте, что закрытый материал не стал публичным.

Письма и напоминания

CBSubs Mailer позволяет отправлять автоматические письма по условиям: регистрация, оплата, срок окончания, продление и другие состояния. Сначала настройте минимальный набор: подтверждение подписки, предупреждение перед окончанием и сообщение после окончания. Письмо должно отвечать на вопросы пользователя: что он купил, где войти, что делать при проблеме, как продлить, когда доступ завершится.

Не превращайте письма в рекламную рассылку. Для членского сайта важнее ясность. Если у вас есть AcyMailing или другая рассылочная система, проверьте интеграцию отдельно: подписка на письмо не должна ломать активацию платного плана, а ошибка рассылки не должна оставлять пользователя без доступа.

Безопасное изменение текстов

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

Откат спорной настройки: меняйте один параметр за раз, фиксируйте его в заметках проекта и проверяйте результат тестовым пользователем. Если поведение ухудшилось, верните предыдущую настройку, очистите кеш Joomla и повторите проверку без изменения других параметров.

Практический пример: закрытая база знаний для платных участников

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

Цель

Нужно создать раздел "Материалы клуба", где часть статей доступна всем, а подробные инструкции и архив доступны только пользователям с активным планом. При окончании подписки доступ закрывается без ручного удаления пользователя. Администратор должен видеть, у кого активен план, а пользователь - понимать, как продлить доступ.

Подготовка

Создайте тестовую категорию Joomla и одну статью внутри неё. Подготовьте тестового пользователя Community Builder. Включите только необходимые интеграции CBSubs: основной плагин, защиту контента, нужный способ оплаты или тестовый бесплатный план. Если используете ACL, заранее создайте группу и уровень доступа, но не включайте одновременно два разных способа ограничения без записанной причины.

Шаги настройки

1. Создайте план "Клубный доступ" с ограниченным сроком действия и понятным описанием результата.
2. Привяжите план к доступу к тестовой категории или статье через интеграцию CBSubs Content, либо через Joomla-группу, если выбрали ACL-модель.
3. Настройте сообщение для пользователя без подписки: коротко объясните, что материал доступен участникам, и укажите путь к плану.
4. Проверьте отображение плана в регистрации, в отдельном пункте меню или в профиле Community Builder - в зависимости от выбранного пользовательского пути.
5. Оформите подписку тестовым пользователем и сохраните результат в админ-панели: состояние подписки, платеж, корзина, журнал и доступ к статье.
6. Смоделируйте окончание или деактивацию плана на тестовой копии и проверьте, что доступ закрывается, а сообщение остаётся понятным.

Проверка результата

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

Нюанс, который часто мешает

Если после оплаты доступ не появился, не спешите вручную назначать пользователя в группу и считать проблему решённой. Ручное сохранение профиля может замаскировать сбой автоматической активации. Сначала проверьте, создалась ли подписка, изменилось ли её состояние, пришло ли уведомление от платёжного сервиса, нет ли ошибок в журнале CBSubs и не блокирует ли кеш старое состояние страницы.

Продвинутые сценарии: семейные планы, купоны, рассылки и интеграции

Когда базовая покупка и доступ работают, можно добавлять расширенные сценарии. У CB Paid Subscriptions много интеграционных плагинов: Family Plans, Promotions, Mailer, AcyMailing, GroupJive, Fields/Tabs Protection, SQL Actions, URL, Tax, аналитика и платёжные процессоры. Их сила в том, что подписка становится событием, на которое можно реагировать. Но каждая интеграция должна иметь понятную задачу.

Семейные и корпоративные планы

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

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

Купоны и промо-условия

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

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

Группы, поля и вкладки Community Builder

Fields/Tabs Protection позволяет управлять видимостью полей и вкладок профиля по подписке. CB Fields integration может менять значения полей при активации или деактивации плана. GroupJive integration позволяет связать план с участием в группе. Эти возможности полезны, если сайт строится как сообщество, а не только как платный архив статей.

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

Проверка результата: как понять, что подписки работают правильно

Проверка результата должна быть отдельным этапом, а не быстрым просмотром под аккаунтом администратора. Администратор часто видит больше, чем обычный пользователь, поэтому проверка под Super User почти ничего не доказывает. Нужны минимум три роли: гость, зарегистрированный пользователь без плана и активный подписчик. Для платёжных сценариев добавьте пользователя с просроченным планом и пользователя после отмены.

Контрольный маршрут пользователя

1. Гость открывает закрытую страницу и видит понятное объяснение, а не системную ошибку.
2. Гость переходит к регистрации или выбору плана, если ваш сценарий это разрешает.
3. Зарегистрированный пользователь выбирает план, проходит оформление и возвращается на сайт.
4. Подписка появляется в админ-панели, а пользователь получает нужный доступ без ручного вмешательства.
5. Письмо приходит на адрес пользователя и не содержит устаревших или неверных ссылок.
6. После окончания или деактивации плана доступ закрывается, но профиль пользователя остаётся корректным.

Что смотреть в админ-панели

Проверяйте не только список подписок. Смотрите платежи, корзины, уведомления, историю и журналы. Если используются внешние шлюзы, сопоставьте данные в CBSubs с данными в кабинете провайдера. Если используется Joomla ACL, проверьте назначение группы или уровень доступа. Если используется защита контента, откройте саму статью, категорию, пункт меню и прямой URL.

Для кеша применяйте отдельную проверку. Закрытый контент не должен попадать в публичный кеш так, чтобы его увидел гость. Если на сайте включены системный кеш, CDN или оптимизатор, тестируйте доступ после очистки кеша и в приватном окне. Для членских сайтов лучше исключать критичные страницы подписки, корзины, профиля и отказа в доступе из агрессивного кеширования.

Как документировать итоговую конфигурацию

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

Диагностика частых проблем и безопасные способы исправления

Проблемы CB Paid Subscriptions чаще всего возникают на стыке нескольких систем: Community Builder, Joomla ACL, интеграции контента, платёжного шлюза, почты, кеша и хостинга. Поэтому диагностику нужно вести по цепочке, а не менять настройки наугад.

Оплата прошла, но подписка не активировалась

Симптом: пользователь видит успешную оплату у платёжного сервиса, но на сайте остаётся без доступа. В админ-панели подписка может быть неактивной, корзина не завершена или уведомление отсутствует.

Возможная причина: вебхук не дошёл до сайта, секрет подписи указан неверно, сервер не выполняет исходящие HTTPS-запросы, платёжный шлюз настроен не полностью, URL возврата заблокирован правилами безопасности или уведомление не сопоставилось с корзиной.

Что проверить: журнал CBSubs Notifications, History Log, список платежей, корзину, URL вебхука в кабинете провайдера, логи провайдера, доступность сайта по HTTPS и ограничения хостинга. Для Stripe отдельно проверьте webhook Signing Secret и URL, который показывает CBSubs Stripe.

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

План не отображается при регистрации или в профиле

Симптом: план создан, но пользователь не видит его на странице регистрации, в профиле или на странице планов.

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

Что проверить: публикацию плана, родительский план, эксклюзивность, условия показа, меню, регистрацию Community Builder и права пользователя. Тестируйте не под администратором, а под обычным аккаунтом.

Как исправить: временно упростите план: сделайте его опубликованным, видимым и без сложных условий. Если он появился, возвращайте условия по одному и после каждого шага проверяйте отображение.

Подписчик не видит закрытый материал

Симптом: активная подписка есть, но пользователь получает отказ в доступе к статье, категории, меню, модулю или вкладке профиля.

Возможная причина: доступ настроен через другой механизм, интеграция не опубликована, CBSubs bot отключён, пользователь попал не в ту Joomla-группу, материал закрыт другим уровнем доступа, кеш показывает старое состояние.

Что проверить: выбранный метод защиты, активность интеграции, настройки статьи и категории, пункт меню, группу пользователя, состояние подписки, прямой URL материала и кеш.

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

Гость видит материал, который должен быть закрыт

Симптом: закрытый материал доступен без подписки или через прямой URL.

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

Что проверить: доступ у статьи, категории, меню и модуля отдельно. Откройте страницу в приватном окне, очистите кеш и проверьте прямой адрес.

Как исправить: применяйте правило на уровне объекта, который реально отдаёт контент. Если контент открывается через компонент, закрывайте компонентный URL или соответствующий уровень доступа, а не только пункт меню.

Письма не приходят или приходят не тем пользователям

Симптом: подписка активна, но письмо подтверждения, напоминание или сообщение об окончании не приходит. Иногда письмо приходит при неправильном состоянии плана.

Возможная причина: не настроен отправитель Joomla, почтовый сервер блокирует отправку, условие Mailer слишком широкое или слишком узкое, письмо привязано не к тому событию, пользователь заблокирован или отключён.

Что проверить: глобальную отправку почты Joomla, журнал отправки, условия Mailer, состояние пользователя, шаблон письма и тестовый адрес. Если используется AcyMailing, проверьте, не ломает ли интеграция основной сценарий подписки.

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

Обновление плана или переход между планами ведёт себя неожиданно

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

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

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

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

Когда стоит использовать CB Paid Subscriptions на своём сайте

CB Paid Subscriptions будет удачным выбором, если ваш Joomla-проект строится вокруг Community Builder и требует не просто оплаты, а управляемого членства: планы, продления, доступ к контенту, профили, поля, вкладки, семейные сценарии, промо-условия, письма и журналы. Это не самый простой путь для одностраничного сбора платежей, но сильный вариант для сайтов, где подписка является частью пользовательской системы.

Перед запуском держите фокус на одном рабочем сценарии. Создайте минимальный план, привяжите его к одному защищённому объекту, проведите тестовую оплату, проверьте уведомления, доступ и окончание подписки. Только после этого добавляйте купоны, семейные планы, автоматические письма, аналитику и сложные правила обновления.

Если после проверки вы видите, что модель подходит сайту, можно скачать последнюю версию CB Paid Subscriptions и разворачивать расширение на тестовой копии. Для живого сайта сначала сохраните резервную копию, проверьте совместимость пакета и опишите внутреннюю карту планов, чтобы будущие изменения не ломали доступ пользователям.