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

Каталог веб-скриптов

Веб-скрипты позволяют автоматизировать установку системы для управления содержимым сайта (CMS), системы управления взаимоотношениями с клиентами (CRM) и другого программного обеспечения.

Управление веб-скриптами


Список доступных скриптов отображается в Настройки web-сервера → Каталог Web-скриптов:

  • нажмите Список, чтобы увидеть все доступные версии скрипта. Каждую версию скрипта можно Установить, Разрешить или Запретить использовать пользователям. Также версию скрипта можно сделать версией По умолчанию. Эта версия будет установлена, если пользователь выберет Быструю установку скрипта. Подробнее об установке см. в статье Установка скрипта.
  • нажмите Обновить, чтобы актуализировать список доступных веб-скриптов. При обновлении списка веб-скриптов ISPmanager закачивает файлы из подключённых репозиториев и сохраняет информацию о них в базе данных. При этом одни скрипты могут быть удалены из списка, а другие добавлены;
  • пользователю доступны для установки только скрипты, разрешённые администратором. Нажмите Разрешённые, чтобы увидеть их список.

При первой установке веб-скрипта необходимый пакет загружается на сервер. После этого он устанавливается в директорию, указанную пользователем. При последующих установках этого скрипта, используется уже загруженный пакет.

Репозитории веб-скриптов


ISPmanager поддерживает веб-скрипты формата Application Package Standard (APS) стандартов 1.0, 1.1, 1.2. Подробнее о формате см. на официальном сайте. По умолчанию подключён основной официальный репозиторий APS. Чтобы подключить свой репозиторий, добавьте в конфигурационном файле ISPmanager (по умолчанию /usr/local/mgr5/etc/ispmgr.conf) путь:

ApsExtRepository <путь до XML-описания репозитория>

Например:

ApsExtRepository http://my.web.aps/repo.xml

Тонкая настройка веб-скриптов


Для тонкой настройки отредактируйте файл /usr/local/mgr5/etc/templates/aps_settings.xml.

Пример файла aps_settings.xml
<doc>
  <imagemapping defimg="aps.png">
    <apsimg name="Drupal">drupal.png</apsimg>
    <apsimg name="joomla">joomla.png</apsimg>
    <apsimg name="WordPress">wordpress.png</apsimg>
    <apsimg name="Prestashop">prestashop.png</apsimg>
    <apsimg name="phpBB">phpbb.png</apsimg>
  </imagemapping>
  <updaterules>
    <onupdate name="Drupal" type="latest"/>
    <onupdate name="joomla" type="latest" quantity="1"/>
    <onupdate name="WordPress"/>
    <onupdate name="Prestashop" quantity="2"/>
    <onupdate name="phpBB" force="yes"/>
  </updaterules>
  <defverrules>
    <defver name="Drupal"/>
    <defver name="joomla" type="latest"/>
    <defver name="WordPress"/>
    <defver name="Prestashop"/>
    <defver name="phpBB"/>
  </defverrules>
</doc>

Секция "imagemapping" — описывает изображения веб-скриптов. Изображения отображаются под пользователем в WWW → Каталог Web-сриптов и WWW → WWW-домены → Скрипты. Атрибут "defimg" определяет изображение по умолчанию, которое используется, если не найдено изображение с именем скрипта. Изображения должны быть в формате формате PNG, размером 32*32 dpi и расположены в директории /usr/local/mgr5/skins/common/img. Каждый элемент "apsimg" содержит имя изображения для веб-скрипта, имя которого указано в атрибуте "name".

Секция "updaterules" — описывает правила обновления списка доступных пользователю веб-скриптов. Каждый элемент "onupdate" содержит правило обновления для веб-скрипта. Атрибуты элемента "onupdate":

  • name — имя веб-скрипта, к которому применяется правило;
  • type — тип автоматического выбора пакетов: Возможные значения: "latest"  — использовать последние, самые новые версии; "earliest" — использовать самые старые, самые ранние версии; "definite" — использовать конкретную версию. В случае если значение атрибута — "definite", в значении элемента "onupdate" укажите версию веб-скрипта. Например:

    файл aps_settings.xml
    <onupdate name="Drupal" type="definite">7.31-36</onupdate>

    Если тип не указан, то по умолчанию используется значение "latest";

  • quantity — количество пакетов веб-скриптов. Применимо, если атрибут "type" имеет значение "latest" или "earliest". При значении, отличном от единицы, будет разрешено указанное количество пакетов. Например, комбинация type="latest" и quantity="3" приводит к разрешению трёх последних версий пакетов веб-скриптов. Если количество не указано, то по умолчанию используется значение "1";
  • force — без указания этого атрибута наборы правил применяются, только если в списке пакетов конкретного веб-скрипта не осталось ни одного пакета, доступного пользователям. Значение атрибута, указанное как "yes" (force="yes"), позволяет при каждом обновлении переопределять версии разрешённых пакетов в соответствии с правилом. Ранее доступные версии могут при этом стать недоступными.

Секция "defverrules" — описывает порядок выбора версии пакета "по умолчанию" из списка доступных пользователям. Каждый элемент "defver" содержит правило автоматического выбора версии по умолчанию. Атрибуты элемента "defver":

  • name — имя веб-скрипта, к которому применяется правило;
  • type — тип автоматического выбора пакетов. Возможные значения: "latest"  — использовать последние, самые новые версии; "earliest" — использовать самые старые, самые ранние версии; "definite" — использовать конкретную версию. В случае если значение атрибута — "definite", в значении элемента "onupdate" укажите версию веб-скрипта. Например:

    файл aps_settings.xml
    <onupdate name="Drupal" type="definite">7.31-36</onupdate>

    Если тип не указан, то по умолчанию используется значение "latest".

Правила из секции "defverrules" также применяются при работе администратора с разрешениями веб-скриптов для пользователей. Например, если администратор запрещает использование версии веб-скрипта пользователями и в списке есть ещё доступные версии, то одна из них будет автоматически выбрана как версия по умолчанию в соответствии с правилами из секции "defverrules".