Расширение, готовое к распространению, представляет собой архив ZIP, который содержит организованную специальным образом структуру папок и файл с метаданными, описывающими программное обеспечение. Быстрый способ создать и установить расширение – запуск утилиты командной строки extension (читайте о ней подробнее в главе Утилита для управления расширениями). Основные шаги описаны ниже.

Шаг 1. Создание нового расширения Plesk можно начать с создания новой заготовки – набора файлов, необходимых для нового расширения. Для этого войдите на компьютер, на котором установлен Plesk, и наберите следующую команду:

plesk bin extension --create <EXTENSION_NAME>

Здесь <EXTENSION_NAME> следует заменить на название расширения. Например:

plesk bin extension --create my_extension

Эта команда создаст новое расширение с названием my_extension. Она также предоставит информацию о местоположении составных частей расширения в файловой системе.

Шаг 2. Следующий шаг – зарегистрировать расширение в Plesk. Выполните следующую команду:

plesk bin extension --register my_extension

В результате новое расширение будет отображаться в списке расширений на странице Расширения в интерфейсе Plesk:

image-79722.png

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

plesk bin extension --pack my_extension

В результате будет создан архив с необходимой файловой структурой. Читайте больше об организации файлов расширений в разделе Структура расширений.

Шаг 4. Теперь вы можете обновлять файлы расширения так, как это необходимо. Читайте другие разделы этого руководства, чтобы узнать, как разрабатывать расширения. Для ускорения разработки рекомендуем использовать заглушки API.

Примечание: Вы можете продолжать разработку на компьютере, на котором установлен Plesk, но более удобный способ – вести разработку на своем компьютере и регулярно синхронизировать исходный код с установкой Plesk. Дополнительную информацию смотрите в статье блога разработчиков Plesk: Extensions: Development Environment.

Шаг 5. После окончания разработки установите расширение. Вы можете сделать это в интерфейсе Plesk или с помощью команд CLI.

Чтобы установить расширение из файла в интерфейсе Plesk:

  1. Добавьте следующие строки в файл panel.ini:

    [ext-catalog]
    extensionUpload = true
    
  2. Нажмите Расширения и перейдите в раздел Мои расширения.

  3. Нажмите Загрузить расширение. Выберите файл, содержащий упакованное расширение, которое вы разработали, и нажмите OK.

Для установки расширения из файла используйте следующую команду:

plesk bin extension -i <EXTENSION_PATH>

Здесь <EXTENSION_PATH> следует заменить на путь к ZIP-архиву расширения. Например:

plesk bin extension -i C:\Users\Administrator\my_extension-1.0-1.zip

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