Документация ispmanager 6 lite, pro, host

APS-скрипты

Ispmanager поддерживает веб-скрипты формата Application Package Standard (APS) стандартов 1.0, 1.1, 1.2. По умолчанию подключён репозиторий с актуальными версиями CMS и другого ПО. Чтобы подключить свой репозиторий, добавьте в конфигурационном файле 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" описывает изображения веб-скриптов. Изображения отображаются под пользователем на форме Web-скрипты (в разделе Настройки) и CMS (в разделе Сайты). Атрибут "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".