Приложение «Прокачка для MEMBERLUX»

Новости, анонсы и блог

Тематические чаты

Мои курсы Каталог

Блоки инструкции можно сворачивать и разворачивать. Состояние запоминается в браузере.

Зачем нужен плагин

MEMBERLUX закрывает доступ в полночь даты окончания, а не в конце последнего дня. Из-за этого клиент может потерять доступ раньше времени — особенно у подписок WooCommerce, где списание происходит в конкретный час дня.

MBL Upgrade состоит из независимых модулей. Их можно включать по отдельности. Подписки WooCommerce — не отдельный продукт: они входят в модуль «Сроки доступа» и без него не работают.

Что работает сразу (бесплатное ядро)

Часть функций бесплатного ядра — без лицензии. Патчи MEMBERLUX — в таблице на странице «Состояние и патчи».

  • Патчи MEMBERLUX (таблица на странице «Состояние и патчи») — отдельно: правят файлы member-luxe под корректные сроки доступа.
  • Описания способов оплаты на checkout: если при переключении оплаты видно только первое описание — ядро чинит конфликт jQuery MEMBERLUX ↔ WooCommerce. Фикс включён всегда, выключить его можно только кодом (фильтр mbu_checkout_wc_compat_enabled); если на сайте всё исправно, он ничего не меняет. Состояние видно первой строкой таблицы на странице «Состояние и патчи».
  • Предупреждения PHP 8: прогресс пустой папки, шаблон категории и вход через MEMBERBOT (параметры ссылки) — автопатчи в таблице на странице «Состояние и патчи».
  • Корректный title вкладки браузера для каталога, избранного и доступных курсов.
  • Защита от двойного оформления заказа и вид кнопки на checkout — не здесь: плагин «Соглашения» → Дизайн → Форма заказа.

Модули: включение и настройки

Все модули собраны на странице MBL Upgrade → Модули. Включайте только то, что нужно школе.

  • Переключатель «Включён / Выключен» срабатывает сразу, кнопку «Сохранить» нажимать не нужно. Настройки модуля при выключении не стираются.
  • Кнопка «Настроить» открывает страницу модуля. Если у модуля есть настройки, там «Сохранить» и «Сбросить» действуют только на этот модуль.
  • Если пока вы редактировали страницу модуля, его настройки изменил другой администратор (или вы во второй вкладке), сохранение не пройдёт: обновите страницу и внесите правки заново. Так чужие изменения не затираются.
  • Некоторые модули не работают вместе или требуют другой модуль. Это видно в строке модуля: «Нужен модуль …», «Не работает вместе с …». Включить конфликтующий модуль нельзя, пока не выключен первый.
  • Платного модуля нет в ключе — вместо переключателя кнопка «Купить»: она открывает страницу Upgrade на описании этого модуля. Если модуль был включён и ключ истёк, состояние «включён» сохраняется и вернётся после продления.
  • Фильтры над списком: «Включены», «Выключены», «Нужен ключ», «Пользовательские», «Есть проблема». Поиск ищет и по модулям, и по их расширениям; отдельный «Фильтр расширений» сужает расширения внутри найденных модулей. Расширения лежат под своим модулем и сворачиваются кнопкой, есть «Развернуть всё / Свернуть всё».
  • У каждого модуля на его странице (кнопка «Настроить») — своя часть инструкции. Вся инструкция целиком — MBL Upgrade → Инструкция.

Установка, обновление и удаление модулей

Платные модули и расширения приходят отдельными пакетами из центра ключей. Управление — кнопка «Управление модулями» над списком на странице MBL Upgrade → Модули.

  • «Проверить доступные по ключу» показывает, что можно установить или обновить. Ставятся только модули и расширения, которые есть в вашем ключе. Отметьте нужные галочками и нажмите «Установить выбранные» либо «Установить все доступные».
  • Если ключ выдан на конкретные модули, они устанавливаются сами (в течение нескольких часов или при заходе в админку). Если ключ «все модули», сами ничего не ставится: вы выбираете, что нужно школе. Модуль, который вы удалили вручную, сам не вернётся.
  • «Установить из ZIP» — для пакета, который вам прислали. Пакет должен быть подписан центром ключей, неподписанные и изменённые установщик отклоняет.
  • «Удалить» убирает модуль или расширение с сайта. Настройки остаются в базе, при повторной установке они вернутся. Модули, которые входят в плагин, удалить нельзя, их можно только выключить. Модуль удаляется вместе со своими расширениями после подтверждения.
  • Новые модули после установки выключены: включите нужные переключателем в списке.

Обновления и автообновление:

  • Раз в сутки (и при заходе в админку) плагин проверяет, нет ли новых версий установленных модулей. Если есть, на странице Upgrade появится уведомление, а у модуля кнопка «Обновить до v…».
  • Автообновление по умолчанию выключено. Включить его можно в панели «Управление модулями»: общий флажок для всех модулей и расширений, а в колонке «Автообновление» у каждого свой выбор — «Как для всех», «Включено», «Выключено».
  • Те же настройки есть в «Центре Verkoshka»: раскройте строку «Модули и расширения» у плагина. Менять можно там или здесь, значения общие.

«Verkoshka» и «Пользовательский»:

  • Бейдж «Verkoshka» значит, что подпись центра ключей проверена и файлы модуля не менялись. «Пользовательский» — модуль без подписи (например, положенный в папку вручную) или с изменёнными файлами.
  • Пользовательский модуль не запускается, пока вы не подтвердите запуск кнопкой в его строке. Подтверждайте только код, которому доверяете: модуль получает полный доступ к сайту. Изменили файл модуля — подтверждение нужно дать заново.

Лицензия

В меню MBL Upgrade есть пункт «Лицензия» — он открывает «Центр Verkoshka» (или «Лицензии Verkoshka», пока Центр не появился). Ключ проверяется на licenses.skizzi.pro. Пакетный ключ вводите один раз: откроются все подходящие продукты на этом сайте.

  • При активации Upgrade бесплатный «Центр Verkoshka» обычно ставится сам — отдельно его скачивать не нужно. Это общее место для ключей и (позже) витрины модулей.
  • Перенос на другой адрес сайта делает продавец в центре ключей. На сайте нельзя «сбросить» ключ самостоятельно.
  • Без ключа (lite): базовые сроки (до 23:59), «Комментарии админа в профиле», «Ссылка входа MEMBERLUX в профиле» и «Адреса WooCommerce в профиле». Расширенные сроки, защита от дублей и превью школы — только с лицензией.
  • Модули покупаются отдельно: в ключе могут быть сроки и защита от дублей, а превью школы — нет. Это не поломка. Жёлтое предупреждение «лицензия недоступна» бывает только если ключ истёк, заморожен или заблокирован.
  • Если центр ключей временно недоступен — запасной период несколько дней, затем остаются только lite-функции.
  • Блок «Что сейчас на сайте» (когда права урезаны): слева — что реально работает, справа — сохранённые настройки, которые вернутся после продления. Настройки при этом не стираются.
  • Клиент лицензии общий с другими плагинами Verkoshka (центр licenses.skizzi.pro). Пакетный ключ достаточно ввести один раз — Соглашения на этом сайте откроются сами.

Модуль «Сроки доступа»

Исправляет сроки MEMBERLUX: 23:59 вместо полуночи, точное время активации, дополнительные дни, синхронизацию с подписками WooCommerce, привязку ключей к заказам.

  • «До 23:59» — основной фикс: доступ до конца последнего дня, а не 00:00. Работает сразу для всех ключей, backfill не нужен. Входит в базовый (бесплатный) уровень модуля.
  • «От точного времени активации» и «Добавить дни» — расширенный уровень: это расширение «Расширенные сроки», оно ставится отдельным пакетом при наличии права в ключе (см. «Управление модулями»).
  • Подписки WooCommerce — часть этого же модуля. Без «Сроки доступа» подписки не синхронизируются. Продаются и включаются вместе.
  • Отзыв ключей при уходе заказа со статуса «Выполнен» — отдельный бесплатный модуль «Отзыв ключей по заказу». При отмене, возврате, удержании ключи, выданные заказом, банятся; повторное «Выполнен» выдаёт ключ заново.

Рекомендуемые настройки:

  • По умолчанию: обычная выдача «До 23:59», доп. дни 0; подписки «До следующего списания», срок «От точного времени списания», буфер 6 ч.
  • Обычные товары с запасом: «Добавить дни», доп. дни — 1.
  • Подписки с запасом на сутки: «Добавить дни к дате списания», доп. дни — 1.

Подписки и таблица доступов

У ключа подписки «Начало» — начало оплаченного периода в цепочке. «Конец» — начало плюс один биллинг-цикл; буфер только на последнем ключе. Вторая оплата того же уровня удлиняет доступ, а не перезаписывает.

Ранняя оплата (до конца текущего периода): новый ключ стартует после текущего — без наложения. Поздняя оплата (после списания): период с момента оплаты, без дыры «ключ в профиле есть, папка с замком».

В профиле есть колонка ID ключей — по ней сверяют находки аудита. «Осталось» считается до фактического момента истечения, а не календарной разницы date_start/date_end.

Удалённые ключи (красный крестик) можно вернуть кнопкой «Вернуть» в той же колонке — без письма пользователю, как при новой выдаче. Удобно при ошибочном удалении или «заморозке» доступа с последующей активацией.

Отображение сроков и таймеров

В «Начало» и «Конец» — дата и время (UTC±…). Каталог, «Доступные курсы» и профиль используют один принцип точного окончания (последний день до 23:59 или exact_time). Переводы таймера: MEMBERLUX → Настройки → Общие → Тексты (г, мес, дн, час, мин, сек).

Уже выданные доступы и backfill

При «До 23:59» или «От точного времени» пересчёт сразу — кнопка не нужна. Backfill — только для режима «Добавить дни» и только для ключей, которые плагин ещё не обрабатывал.

Расширение «Расширенные сроки»

Дополняет модуль «Сроки доступа» тонкой настройкой того, когда заканчивается доступ. Базовый модуль даёт «до 23:59 последнего дня». Расширение добавляет остальные режимы и запас по времени.

  • «От точного времени активации» — доступ заканчивается ровно через заданный срок после выдачи ключа, в ту же минуту, а не в конце дня.
  • «Добавить дни» — к дате окончания прибавляется запас в днях (например, +1 день). Дни можно задать отдельно для обычных товаров и для подписок.
  • Режим срока подписки и буфер в часах — запас вокруг даты списания, чтобы доступ не обрывался на сутки раньше из-за задержки оплаты.
  • Блок «Уже выданные доступы» — разово доначисляет дни ключам, выданным раньше. Нужен только для режима «Добавить дни» и только для ключей, которые плагин ещё не обрабатывал.

Как включить:

  • Расширение ставится отдельным пакетом: «Модули» → «Управление модулями» → «Проверить доступные по ключу» → «Установить». Для этого в вашем ключе должно быть право на расширенные сроки.
  • После установки включите расширение переключателем в списке модулей или в его секции на странице «Сроки доступа». Его поля появятся в настройках модуля.

Если расширение выключено, удалено или ключа больше нет:

  • Ваши настройки не пропадают: они остаются в базе и вернутся, когда расширение снова заработает. На странице модуля видна сводка того, что сохранено.
  • Пока расширение не работает, сроки считаются по базовому правилу «до 23:59». Уже выданные ключи не меняются.

Модуль: Отзыв ключей по заказу

Если заказ ушёл со статуса «Выполнен» (отмена, возврат, удержание и т.д.), ключи доступа, которые выдал этот заказ, банятся. Повторное «Выполнен» выдаёт ключ заново.

  • Работает с заказами WooCommerce и с ключами подписок, оформленных через заказ.
  • Отключите, если отзыв мешает ручной работе с заказами.
  • Ключи, выданные до включения модуля, могут быть не привязаны к заказу и не будут отозваны.

Модуль: Комментарии админа в профиле

Блок комментариев под таблицей доступов в профиле пользователя.

  • Свободный комментарий — зачем выдали/удалили доступ, оплата на карту, подарок, возмещение.
  • Привязка к находке аудита, ID ключа или заказа — необязательно. Несколько ID можно указать через запятую.
  • Клик по метке ключа в комментарии подсвечивает строку в таблице доступов (работает без модуля дублей; не мешает цветной подсветке аудита). Клик по заказу открывает заказ в новой вкладке.
  • В таблице находок дублей — кнопка «Комментарий» (если оба модуля включены).
  • У комментария к находке — кнопка «Подсветить находку» (нужен модуль дублей): цветная подсветка связанных ключей, даже если находка уже «Обработано».
  • В плашке комментария тип находки показывается понятным текстом, а не техническим кодом.
  • Ненужные комментарии можно удалить.

Модуль: Совместимость сортировки рубрик

Нужен школам, где для порядка папок (рубрик материалов) стоит плагин Category Order and Taxonomy Terms Order (в админке он называется «Порядок таксономии», сокращённо TTO). Без него модуль ничего не делает. Бесплатный.

  • Порядок рубрик хранится в двух местах: TTO пишет своё поле, встроенная сортировка MEMBERLUX в списке «Рубрики» — своё. После обновления страницы показывался только порядок TTO, поэтому перетаскивание в списке «Рубрики» «откатывалось». Модуль переносит порядок из одного места в другое сразу после сохранения, и оба экрана показывают одно и то же.
  • На странице порядка TTO перетаскивание срабатывает по положению курсора: папку с подпапками теперь можно поставить выше или ниже соседних.
  • Плагины файловых папок, например FileBird, вешают на страницу свои обработчики перетаскивания, и из-за них перенос папки в TTO ломался (на её месте оставалась пустая полоса). На странице порядка модуль отключает эти обработчики.
  • Касается только рубрик материалов MEMBERLUX. Другие таксономии (товары, записи) модуль не трогает, их порядок остаётся за TTO.

Модуль: Адреса WooCommerce в профиле

MEMBERLUX умеет скрывать таблицы платёжного адреса и доставки в карточке пользователя. Но делает это не везде: CSS подключается, только если в адресе страницы есть user_id (редактирование другого пользователя) или открыт экран MEMBERLUX. На «своём» профиле (profile.php) или если CSS не загрузился — поля видны без всякого Upgrade.

  • Нужен активный WooCommerce.
  • Пока модуль выключен — Upgrade ничего не меняет (как решит MEMBERLUX / WooCommerce на этом экране).
  • После включения модуль сам прячет оба блока и показывает только отмеченные галочки (платёжный и/или доставка). Так поведение одинаковое на всех сайтах.
  • Доставку большинству школ можно не включать.
  • Платёжный email (billing_email) — это не почта аккаунта WordPress. Именно его WooCommerce подставляет в новые заказы, если клиент залогинен.
  • Обычный CSS в Admin CSS MU часто не помогает: стили MEMBERLUX подключаются позже с !important.

Защита от дублей доступов

Отдельный модуль: предотвращение и поиск дублей ключей и бонусов. Выключен по умолчанию — включайте на сайтах с подписками и риском двойной выдачи.

  • Block MBLP + автобан дублей подписки — mbl-payments не выдаёт ключ там, где должен mbl-subscriptions; лишний ключ с той же секунды активации банится.
  • Bonus for Woo — защита и аудит двойных начислений (отдельная галочка, если плагин установлен).
  • Аудит (ниже настроек на странице модуля): сканирование БД, находки по пользователям, переход в профиль, подсветка ключей (красная — дубль, зелёная — хвост цепочки после дубля, жёлтая — дыра между активными ключами), «Удалить дубль» и «Обработано».
  • Профиль: зелёная подсветка — активные ключи после дубля в цепочке; насыщенная зелёная с бейджем «удалять этот» — концевой ключ. Удалять лишний срок безопаснее с конца, не посередине.
  • Находка «Дыра в цепочке» — только между двумя одновременно активными ключами одного уровня (не между старой покупкой и новой). Если дыра намеренная (заморозка) — «Обработано» и комментарий.
  • Находка «Повтор по заказу» — только если у ключей одного заказа пересекаются оплаченные периоды (смена статуса заказа без отзыва старого ключа). Продления подписки в цепочку (конец одного ключа = начало следующего) дублем не считаются.
  • Бессрочные ключи («Не ограничено») не считаются дублями: сколько бы их ни оформили, доступ уже бесконечный.
  • «Удалить дубль» — только если период дубля ещё не начался и ключ не зажат между другими активными.
  • Настройки модуля сохраняются при временном отключении — можно выключить и включить без сброса галочек.
  • План (следующие версии): схлопывание цепочки после бана, вставка доступа в дыру, мастер исправления дублей.
  • Профиль пользователя (редактирование или свой профиль админа по /wp-admin/profile.php): при открытии — автосканирование только если у пользователя ещё нет находок в аудите; переход из таблицы находок не пересканирует и не сбрасывает кэш.
  • Ручное сканирование (аудит): две опции — несколько активных ключей с любыми сроками и только со схожим сроком (разница до 3 дн.).
  • Автопроверка в настройках модуля — не запускает полный скан сама по себе; показывает уведомление о находках из последнего скана и помогает допроцессить длинный ручной скан.

Не откатывает старые ошибочные баллы и не удаляет истёкшие дубли — только предотвращает новые и помогает найти активные.

Видимость материалов

Управляет скрытием папок и уроков на страницах школы MEMBERLUX. Навигатор для работы модуля не требуется.

  • «Скрывать папки без доступных уроков»: если у ученика в папке остались только уроки под замком, папка пропадает из школы и библиотеки. Одного доступного урока достаточно, чтобы папка осталась.
  • «Учитывать описание папки»: папка с описанием не скрывается, даже если все уроки в ней закрыты.
  • «Скрывать уроки без доступа»: закрытые уроки внутри папок не показываются. Папка с доступными уроками остаётся и показывает только их. Если в папке не осталось ничего, ученик видит подсказку «Нет доступных материалов»; её текст, цвет, размер и жирность можно изменить в этом же разделе.
  • «Скрывать бесплатные уроки и папки»: бесплатный урок не привязан ни к одному уровню доступа и открыт всем. По умолчанию такие уроки не скрываются, а папка с ними остаётся. Если включить, бесплатные уроки считаются недоступными и скрываются так же, как закрытые.
  • «Применять авто-скрытие к гостям» и «Не применять к тренерам»: определяют, для кого действуют правила. Тренер видит папки и уроки как есть; содержимое закрытых уроков ему покажет только модуль «Превью доступа».
  • «Переход по прямой ссылке в скрытую папку»: на страницах школы и в библиотеке такая папка не показывается. Режим влияет только при переходе по ссылке: доступные уроки снова проверяются по уровням, либо все уроки делаются некликабельными и бледными.
  • «Свой текст вместо продажи доступа»: клик по карточке закрытого урока ведёт на страницу урока, а там срабатывает правило прямой ссылки. По умолчанию это «Продажа доступа» или адрес из уровня. Выберите «Что видит ученик по умолчанию»: стандартное поведение или свой текст из редактора (с картинками, кнопками, шорткодами). Это правило можно переопределить у конкретного уровня доступа (поле «Закрытый материал по прямой ссылке» в уровне) и у конкретного материала (блок «Видимость материалов: закрытый материал» под «Дополнительными параметрами страницы»; там можно также задать свой текст только для этого урока). Приоритет: материал, уровень, общее правило. Страницы самих уровней доступа не меняются. Текст показывается только там, где выбран свой текст; пустой редактор — стандартное поведение. Для текста, для «Продажи доступа» уровня и для своего текста материала можно задать ширину контейнера (узкая 820px или широкая 100%): она переопределяет «Ширину контента» самого материала, пока ученик видит закрытый урок. В настройках Навигатора под строкой «Ссылка у закрытого материала» показывается, как сейчас настроена прямая ссылка.
  • В настройках каждой рубрики есть поле «Видимость материалов»: «Как в общих настройках», «Применять только настройки видимости рубрики» (игнорировать автоскрытие) или «Скрыть со страниц школы и из библиотеки». Оно переопределяет общие правила для этой рубрики. Поле «Карточка в библиотеке» рядом относится к плагину «Навигатор» и нужно только для склейки модулей в одну карточку.

Превью школы

Нужен тренерам, авторам и редакторам: смотреть уроки как ученик, не становясь администратором и не проходя автотренинг.

  • Модуль платный: в ключе лицензии должно быть право «Превью школы» (mbl.preview-access). Без права вместо переключателя — кнопка «Купить модуль»: другим сайтам после обновления модуль сам не откроется.
  • Включите модуль и найдите пользователей поиском (email, логин, имя, фамилия или ID) — они появятся карточками, лишних убирайте крестиком. ID можно поправить и вручную через запятую. Эти люди видят все папки и уроки — в том числе рубрики с ограничением видимости по уровням. Автотренинг не блокирует следующие уроки.
  • Товары в каталоге с ограничением видимости по уровням по умолчанию не открываются. Если нужно проверить витрину и подписки — включите отдельную галочку «Показывать товары с ограничением видимости».
  • Роль остаётся прежней (например, «Клиент MEMBERLUX»). Редактировать курсы они не могут — только смотреть фронтенд.
  • Домашние задания остаются как у обычного ученика: вкладка видна, ответы можно отправлять. Отдельный режим «только смотреть без ответов» появится позже.
  • После обновления MEMBERLUX откройте настройки Upgrade — плагин заново наложит нужные патчи. Статус патчей — на странице «Настройки».

Выключение, обновление MEMBERLUX, проблемы

  • Выключить «Сроки доступа» переключателем — сроки снова как в MEMBERLUX (полночь), подписки не синхронизируются.
  • Деактивация плагина — патчи в файлах остаются с function_exists; meta и настройки сохраняются.
  • После обновления member-luxe / mbl-catalog / mbl-subscriptions / MEMBERBOT — проверьте таблицу патчей (ok/applied).
  • Если сроки сбились на тесте — удалите ключ в профиле; при необходимости строку в wp_mbu_key_access_meta.

Свои модули (для разработчиков)

В Upgrade можно добавить свой модуль файлами — без отдельного плагина. Он появится на странице «Модули» с переключателем.

  • Папка: wp-content/verkoshka-modules/mbl-upgrade/{id}/, внутри файл module.php. Эта папка вне плагина, поэтому при обновлении Upgrade не стирается.
  • {id} — латиница, цифры и подчёркивание (например school_calendar). Совпадает с Module ID в шапке.
  • Шапка module.php — комментарий в начале файла, как у плагинов WordPress: Module ID, Module Name, Description, Version, Requires Upgrade (минимальная версия), Requires Modules (через запятую), Conflicts (через запятую), Icon (имя иконки uicons, например clock).
  • Файл должен вернуть объект модуля: класс с методами id(), label(), boot() (подключает хуки, вызывается только у включённого модуля) и disable_cleanup() (уборка при выключении). В конце файла — return new Мой_Модуль();
  • Нужна своя страница настроек — добавьте в класс методы render_settings($settings) (поля с именами mbu_module[ключ]) и sanitize_settings($input, $stored) (вернуть очищенные настройки). Сохранение, кнопки и защиту от чужих правок Upgrade сделает сам.
  • Инструкция модуля — файл views/instructions.php в папке модуля: блоки div с классом mba-instructions-block, внутри заголовок h2 и текст (как в инструкциях встроенных модулей). Upgrade сам покажет их на странице модуля и добавит в общую «Инструкцию» — отдельно ничего регистрировать не нужно. У выключенного внешнего модуля инструкция не показывается (его файлы не загружаются).
  • Пример: wp-content/verkoshka-modules/mbl-upgrade/school_calendar/module.php (шапка + класс), views/settings.php (поля), views/instructions.php (инструкция).
  • Код модуля не выполняется, пока модуль выключен. Ошибка в файле не роняет сайт: модуль пропускается, причина видна на странице «Модули».
  • Если свой модуль всё же сломал сайт — добавьте в wp-config.php строку define("MBU_DISABLE_EXTERNAL_MODULES", true); и все внешние модули отключатся.

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

  1. Откройте MBL Upgrade → Состояние и патчи — патчи применяются автоматически.
  2. Сохраните настройки модулей.
  3. Проверьте разовую покупку и продление подписки: один ключ и одно начисление баллов на заказ.
  4. Проверьте «Начало», «Конец», «Осталось» в профиле, на /wpm/activation/ и в каталоге.