Перепродажа расширений

Как перепродавать расширения

Этот метод применим для сценария, в котором вы хотели бы продавать новые экземпляры Plesk вместе с набором платных расширений. Этот метод также позволяет дополнительно предлагать расширения в вашем интернет-магазине для уже проданных экземпляров Plesk. Обратите внимание, что этот метод не обеспечивает совершения встроенных покупок. Другими словами, если ваши клиенты нажмут кнопку “Купить сейчас” в каталоге расширений в Plesk, они попадут в интернет-магазин Plesk, а не в ваш магазин.

Подробности реализации
  1. Необходимо, чтобы Plesk и расширения, которые вы хотите перепродавать, были доступны как товары в вашем интернет-магазине.
  2. Когда инициируется покупка, вам надо обратиться в KA через KA Partner API и запросить лицензии для приобретаемых товаров.
  3. KA создаст запрашиваемые лицензии и отправит вам единый код активации для этих лицензий. Обратите внимание, что в KA есть две версии Partner API: v1 и v3.
    1. a. v1:
      1. https://central.plesk.com/docs/partner-api/1.0/
      2. Может запрашивать основной ключ для Plesk и несколько дополнительных ключей для расширений в едином вызове (смотрите https://central.plesk.com/docs/partner-api/1.0/41090.htm).
      3. Единый ключ активации для основной лицензии Plesk и дополнительных лицензий.
      4. Считается устаревшей, рекомендуется вместо нее использовать версию v3.
    2. b. v3:
      1. https://central.plesk.com/docs/partner-api/3.0/
      2. Может запрашивать только один ключ (основной или дополнительный) в одном вызове (смотрите https://central.plesk.com/docs/partner-api/3.0/63401.htm).
      3. Единый ключ активации для основной лицензии Plesk и дополнительных лицензий (дополнительные лицензии, запрашиваемые в отдельных вызовах API, присоединяются к основной лицензии, и тот же ключ активации, что используется для основной лицензии Plesk, активирует большее количество лицензий).
      4. Последняя версия Partner API, рекомендуется к использованию вместо v1.
  4. После того как ваш магазин получит код активации, вы можете либо выдать код клиенту (через интерфейс интернет-магазина или по электронной почте), либо (предпочтительный вариант) активировать лицензии, запустив команду CLI на том экземпляре Plesk, который вы создали для клиента.

    Активация лицензий через CLI производится с помощью команды “license”. Детали использования этой команды можно посмотреть здесь: https://docs.plesk.com/en-US/17.0/cli-linux/using-command-line-utilities/license-license-keys.71029/

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

Описанный выше метод не охватывает сценария встроенных покупок. Другими словами, если ваши клиенты нажмут кнопку “Купить сейчас” в каталоге расширений в Plesk, они попадут в интернет-магазин Plesk, а не в ваш магазин. Чтобы решить эту проблему, мы добавили возможность указать имя хоста вашего магазина в файле panel.ini. Как только вы укажете имя хоста вашего магазина, все ссылки “Купить сейчас” и другие возможные ссылки на дополнительные предложения, отображаемые в интерфейсе расширения, будут вести напрямую в ваш интернет-магазин.

Чтобы изменить URL интернет-магазина, открываемого по ссылке "Купить сейчас", откройте для редактирования файл panel.ini и добавьте следующую строку в раздел [extensions]

[extensions]

buyUrl = "https://shop.com"

где "shop.com" - доменное имя вашего интернет-магазина.

Вот пример того, как это работает:

  • Исходный URL, используемый расширением:

https://go.plesk.com/buy-plesk-ext/extension-name?kn=PLESK.1234567890.0001

  • Измененный URL, используемый расширением после того как вы указали имя хоста вашего магазина в panel.ini:

https://myownstore.com/store?extension-id=extension-name&kn=PLESK.1234567890.0001

Примечание. Эта функциональность затрагивает только те расширения, которые продаются Plesk и используют “go.plesk.com” в качестве целевого имени хоста. Если расширение продается независимым поставщиком напрямую, используемые в нем ссылки “Купить сейчас” и другие возможные ссылки на дополнительные приложения не будут затронуты.

Как отрегулировать, какие расширения вы хотите показывать и продавать

Как только вы изменили URL для ссылок “Купить сейчас” (как описано выше), все платные расширения, включая те, что будут добавлены через каталог расширений в будущем, будут ссылаться на ваш магазин, даже если вы их ещё не настроили. Вы можете сделать так, чтобы ваши клиенты видели только те платные расширения, которые вы готовы продавать, настроив интеллектуальный прокси-сервер для каталога расширений Plesk. Этот прокси-сервер будет получать данные из каталога расширений, отфильтровывать расширения, которые вы не готовы продавать, и отправлять измененные данные на ваши установки Plesk.

Подробности реализации

  1. Установите сервер (физический или виртуальный), на котором будет работать прокси-сервер.
  2. Возьмите прокси-скрипт с https://github.com/plesk/extensions-catalog-proxy и поместите его на сервер. По этой ссылке можно найти инструкции, которые помогут вам понять, как работает прокси-скрипт, и как его использовать.
  3. Настройте прокси-сервер так, чтобы через него проходили только те платные расширения, которые должны быть видны на ваших серверах Plesk.

    Прокси-сервер работает, как белый список – вы указываете идентификаторы платных расширений, которые должны быть видны в Plesk, и остальные расширения становятся невидимыми. Вы можете просмотреть список расширений и их идентификаторов (“кодов”) здесь: https://ext.plesk.com/api/v4/packages.

    Важное примечание. Прокси-сервер действует только на те расширения, у которых кнопка “Купить сейчас” ведет на https://go.plesk.com. Бесплатные расширения и расширения, у которых кнопка “Купить сейчас” ведет в другое место, не учитываются при работе прокси-сервера – они продолжат быть видимыми в каталоге расширений на ваших серверах Plesk.

  4. Измените URL каталога расширений на всех ваших серверах Plesk так, чтобы он указывал на адрес прокси-сервера. Для этого добавьте в файл panel.ini следующую строку:

    [extensions]

    catalog.url = http://<proxy-address>:8080

  5. Когда в каталоге расширений станет доступно новое расширение, и вы настроите свой интернет-магазин на его продажу, измените настройки прокси-сервера, добавив идентификатор соответствующего расширения, чтобы это расширение проходило через прокси-сервер и было доступно вашим клиентам. Обратите внимание, что данные каталога кэшируются на серверах Plesk, и новые расширения не появятся сразу.
 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.