Интеграция с Yola

Материал из ISPWiki
Перейти к: навигация, поиск

Общее описание

Модуль предназначен для интеграции с конструктором сайтов Yola.

Поддерживается начиная с версии BILLmanager 5.85

Общая схема интеграции

Общая схема интеграции представлена на рисунке ниже.

Конструктор сайтов. Общая схема интеграции.

Для управления доменными именами, а также предоставления FTP-ресурсов для хранения сайта используется ISPmanager 5 Business.

На стороне конструктора сайтов при обработке услуг создаются пользовательские аккаунты и два вида подписок: основная (core subscription) и подписка на электронный магазин (ecom subscription).

Создание обработчика

Модуль обработки Yola относится к типу продуктов "Конструктор сайтов".

Создание обработчика. Шаг 1: выбор типа продукта

Внимание! Добавление модуля обработки для интеграции с Yola возможно только после приобретения соответствующего модуля на сайте my.ispsystem.com.

Внимание! После приобретения модуля на сайте my.ispsystem.com необходимо обновить файл лицензии вашего BIllmanager. При обновлении файл лицензии будет загружен заново. В него добавится информация о купленном модуле Yola.

Создание обработчика. Шаг 2 при отсутствии модуля

Кнопка "Добавить" на втором шаге визарда создания обработчика услуг станет активной.

На шаге 3 "Настройка интеграции" содержимое полей Subbrand ID, Subbrand API Key, Subbrand API URL заполняется автоматически на основе информации о купленном модуле из лицензии.

Создание обработчика. Шаг 3. Настройка интеграции

Для настройки интеграции заполните поля:

  • URL - url панели ISPmanager 5 Business
  • Имя пользователя - имя пользователя для интеграции с панелью ISPmanager 5 (уровень пользователя - администратор)
  • Пароль - пароль пользователя для интеграции с ISPmanager 5

Создание тарифного плана

Форма создания тарифного плана имеет свои особенности.

Создание тарифного плана

Обратите внимание на следующие поля:

  • Шаблон учетной записи - шаблон учетной записи в ISPmanager
  • Подписка - тип основной подписки (Starter, Preminum или Unlimited)
  • Бесплатная доменная зона - зона, в которой клиенту будет предоставлено бесплатное доменное имя третьего уровня в виде site@ID@.example.com, где @ID@ - идентификатор услуги, example.com - ваш домен; например - site1234.example.com

Смена основной подписки для услуги осуществляется через смену тарифного плана. Таким образом, для нормального функционирования необходимо создание трех тарифных планов - по одному на каждый тип подписки (Starter, Preminum, Unlimited).

Дополнение "Электронный магазин (eCom)" настраивается как дополнение к тарифному плану. После создания тарифа дополнение создается автоматически с включенным в тариф значением "Без eCom". Дополнение привязывается к перечислению "Yola eCom plan", значения которого представлены на рисунке ниже.

Значения перечисления "Yola eCom plan"

Внимание! Не рекомендуется изменять внутренние наименования значений перечисления - это приведет к отказу работоспособности дополнения и невозможности обработки заказов.

Внимание! Не задавайте для тарифа опцию "ежедневное списание", т.к. со стороны Yola оплата списывается сразу за месяц.

Список услуг "Конструктор сайтов"

Список услуг "Конструктор сайтов"

Описание кнопок:

Заказ новой услуги

Создание услуги "Конструктор сайтов"


При создании услуги фактически создаются следующие объекты:

  • на стороне ISPmanager 5:
    • пользователь
    • бесплатный WEB-домен
    • FTP-пользователь
    • если при заказе заполнено поле "Собственное доменное имя", то собственный домен прописывается в псевдонимы к бесплатному WEB-домену
  • на стороне Yola:
    • аккаунт (в настройки аккаунта передаются данные о FTP-подключении, доменное имя и пр.), имя аккаунта = <Subbrand ID> + имя пользователя в ISPmanager
    • основная подписка (core subscription)
    • если заказано - подписка на электронный магазин (ecom addon subscription)


Управление собственным доменом

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

Доступ к управлению доменным именем осуществляется при нажатии на кнопку "Домен" в списке услуг.

Управление собственным доменным именем

Описание полей:

  • Бесплатное доменное имя - домен, сгенерированный автоматически при заказе услуги
  • Дополнительное доменное имя - выбор типа дополнительного имени: собственный (уже имеющийся) домен, либо заказ нового домена
  • Доменное имя (доступно только при опции "Дополнительное доменное имя" = "Собственный домен") - собственное, уже имеющееся доменное имя

Если опция "Дополнительное доменное имя" = "Заказать новый домен", то появляется кнопка "Заказать домен", при нажатии на которую происходит перенаправление на визард заказа домена.

Управление доменным именем - заказ домена

Собственное доменное имя прописывается в ISPmanager 5 в список псевдонимов бесплатного доменного имени.

Продление услуги

Продление услуги возможно только на 1 месяц. При этом должно выполняться условие - дата окончания основной подписки после продления должна быть не позднее, чем через 2 месяца, начиная с текущей даты. Если условие не выполняется - генерируется ошибка.

Ошибка продления


Переход в конструктор сайтов

При нажатии на кнопку "Перейти" на уровне пользователя происходит переход в конструктор сайтов.

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

  • в ISPmanager 5
  • в конструктор сайтов
Переход в панель из-под администратора

Требования к серверу с ISPmanager

Рекомендуем добавить в реестр запрещенных доменов со стороны ISPmanager тот домен, который вы планируете использовать для серверов имен.


В соответствии с документацией по Yola, для корректного функционирования сайтов, необходимо:

  • наличие PHP версии не ниже 5.3
  • наличие установленной библиотеки php5-curl
  • наличие установленной библиотеки gettext
  • PHP-пользователи должны иметь права на запись в корневую директорию Web-домена

Для копирования файлов по FTP в список разрешенных должны быть включены следующие адреса:

  • 208.75.209.72
  • 208.75.209.73
  • 208.75.209.74
  • 208.75.209.75
  • 208.75.209.76
  • 208.75.209.190
  • 208.75.209.191
  • 208.75.209.199
  • 208.75.209.201
  • 208.75.209.202

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