Документация

Подключение подписок к сайту

Добавить свой сайт

Заходим в личный кабинет по адресу https://linber.me/lk/
Переходим в раздел «Добавить проект»
Выбираем тип проекта «Веб-сайт»
Перед нами появляется форма для добавления сайта.
Заполняем «Адрес сайта» (нужно указывать только доменное имя)
Если адрес указан корректно, то появится ссылка для скачивания проверочного файла.
Скачайте этот файл и поместите в корневую директорию вашего сайта на хостинге
Теперь нужно создать хотя бы 1 тариф для подписки.
Для этого нажмите на кнопку «Добавить тариф» и заполните появившуюся форму
После заполнения формы ваши тарифы будут отображаться в списке. Вы можете добавить несколько тарифов
Нажимаем на кнопку «Завершить добавление».
Если все выполнено верно — система сообщит, что проект успешно добавлен и отправлен на проверку.
По завершении проверки вы получите соответствующее уведомление

Заполнить анкету

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

Переходим в раздел «Анкетные данные»
Заполняем все указанные поля формы
После заполнения форма будет отправлена на проверку.
По завершении проверки вы получите соответствующее уведомление

Подождать проверку проекта и анкеты

Обычно модерация занимает не более 2 часов.
Если процесс занимает больше времени, свяжитесь с нами через раздел «Поддержка» и уточните статус.

Разместить код на своем сайте

Данный шаг нужно делать уже после того, как проект и анкета успешно пройдут модерацию

Переходим в раздел «Мои проекты»
Находим в списке нужный проект и выбираем в меню «Настроить»
Из поля «Код для публичной части сайта» копируем содержимое и размещаем на всех страницах своего сайта (так же как со счетчиками от «Яндекс Метрики» ® или «Google Analytics» ®).
Домен сайта, на котором вы размещаете код, должен совпадать с доменом, указанным при добавлении сайта.

«Приватный ключ»
Секретный ключ, который необходим при обращении к API. Также с помощью этого ключа подписываются данные. Он не должен быть доступен пользователям вашего сайта. Если вы не обращаетесь к API напрямую, то ключ вам не понадобится
«Компактный вид»
Если включено, то js-код будет сжат до одной строки
«Кнопка в шапке сайта»
Если включено, то на вашем сайте будет отображаться кнопка «Оформить подписку»
Этот параметр можно также установить прямо в js-коде:
```
window.linber.settings.buttonSubscribe.show = true;
```
Если выключено, то для показа виджета оформления подписки необходимо вызвать js-метод:
```
window.linber.methods.openWindow();
```
«Справа сверху»
Положение на веб-странице, где будет отображаться кнопка «Оформить подписку»
Этот параметр можно также установить прямо в js-коде:
```
window.linber.settings.buttonSubscribe.position = 'top-right';
```
Подробнее об API можно прочитать в разделе «Описание API»

Показать/скрыть контент для подписчиков

Этот шаг показывает лишь механизм. Что конкретно предлагать пользователям за подписку и как обрабатывать ее наличие/отсутствие — зависит от вас

Есть 3 механизма проверки наличия подписки:

Установка атрибута data-linber-has-subscription для html-элементов, которые нужно показывать только подписчикам
Установка атрибута data-linber-no-subscription для html-элементов, которые нужно показывать только пользователям без подписки
```

<div data-linber-has-subscription>Какой-то блок</div>


<div data-linber-no-subscription>Какой-то блок</div> 
```
Проверка через Javascript SDK API. Посмотреть пример
Рекомендуем
Проверка через PHP SDK API. Посмотреть пример

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

Проверить все настройки сайта и корректность работы подписок можно в режиме «Тестирование и отладка»

Интеграция завершена

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

Тестирование и отладка

Режим тестирования и отладки позволяет проверить корректность работы подписок и вашего сайта на тестовых данных

Включить режим отладки

Для этого в js-код, который вы разместили у себя на сайте, необходимо добавить параметр настройки isDebug: true.

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

Домен сайта, на котором вы размещаете код, должен совпадать с доменом, указанным при добавлении сайта.

Пример включения отладки:

<script>
    (function () {
        window.linber = {
            id: '3dabec23-d944-4329-8406-768bab99f8d3',
            settings: {
                isDebug: true,
            },
        };
...
</script>

Проверить, что все работает корректно

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

Оформите тестовую подписку. Она действует в течение 1 дня.
Для этого не требуется реальной оплаты, а саму подписку можно отменить/оформить снова в любой момент.

После успешного оформления вы можете проверить и настроить работу своего сайта при наличии или отсутствии подписки у пользователя (в данном случае у вас самих)

Отключить режим отладки

После того как вы убедитесь, что все работает корректно, необходимо удалить флаг isDebug. После удаления флага ваши пользователи вновь смогут оформлять подписки