Plugins Automated Installation в TotalcmdWiki.

Автоматическая установка плагинов - функция, появившаяся в Total Commander 6.5. Её назначение - копирование файлов из дистрибутивных архивов в каталог Total Commander с последующим подключением к программе.
Функция изначально разрабатывалась для установки плагинов, но позже была расширена, и стала использоваться в расширенном пакете русификации и некоторых программах, имеющих отношение к TC.

Процесс установки

В случае, если в Total Commander разрешена автоматическая установка плагинов, а устанавливаемый архив содержит необходимую информацию, достаточно просто открыть архив в Total Commander. Появится диалог подтверждения установки плагина:

Автоматическая установка контентного плагина

Жмём Yes, выбираем каталог для установки, подтверждаем установку. Если у вас уже установлена другая версия плагина, то появится примерно следующий диалог:

Плагин с таким именем уже существует

Если хотите обновить плагин – жмите Yes, если вы что-то напутали, и плагин обновлять не надо – всегда можно отказаться от установки, нажав Cancel.

После установки появится диалог настройки плагинов соответствующего типа, например:

Список контентных плагинов

Закрываем его, нажав кнопку OK, плагин установлен.

В случае, если требуется открыть архив без включения автоустановщика, это необходимо сделать сочетанием Ctrl+PgDown.

pluginst.inf

Для того, чтобы TC распознал инсталляционный архив, требуется, чтобы он содержал файл pluginst.inf, являющийся простым ini-файлом, содержащим ключи, по которым TC проведёт установку содержимого.
Ниже даны пример и описание всех ключей такого файла:

[plugininstall]
description=Description of your plugin
descriptiondeu=German description
descriptionrus=Russian description
type=wcx
file=pluginname.wcx
defaultdir=pluginsubdir
defaultextension=ext,ext2

• description - ключ, содержащий описание на английском языке (описание по умолчанию), показываемой пользователю при открытии инсталляционного архива. Для того, чтобы добавить описания для других языков, нужно добавить ключи descriptionlng, где lng - обозначение используемого языка, например ru. В случае, если в файле есть описание для текущего языка TC, то будет отображено оно, в противном случае отобразится описание по умолчанию.
• type - тип устанавливаемого плагина: wcx, wfx, wlx или wdx. Также поддерживается тип lng, предназначенный для установки языковых пакетов.
• file - название файла устанавливаемого плагина.
• defaultdir - подкаталог, в который будет устанавливаться плагин. Если ключ установлен, путь установки будет выглядеть как pluginbasedir\[wcx|wfx|wlx|wdx]\defaultdir, в противном случае см. описание ключа настройки pluginbasedir.
• defaultextension - поле, применяемое только для архиваторных плагинов. В нём указывается, с какими расширениями необходимо ассоциировать плагин. Перечисляемые расширения должны разделяться запятой.

wincmd.ini

Все ключи находятся в секции [configuration]

• AutoInstallPlugins - ключ, разрешающий (AutoInstallPlugins=1) или запрещающий (AutoInstallPlugins=0) автоматическую установку плагинов. Значение по умолчанию: 1.
• pluginbasedir - ключ, содержащий путь к общему каталогу установки плагинов. При установке нового плагина TC добавляет к пути подкаталоги "тип_плагина" и — по умолчанию — "имя_плагина". Пример:

PluginBaseDir=%COMMANDER_PATH%\plugins

Предлагаемый путь для архиваторного плагина "sample_packer":

%COMMANDER_PATH%\plugins\wcx\sample_packer\

Значение по умолчанию: %COMMANDER_PATH%\plugins

Ошибки и ограничения

• Известна ошибка, при которой автоустановщик не работает, если имя файла pluginst.inf имеет символы в верхнем регистре и установачный архив запакован архиватором RAR.
• В некоторых случаях файлы из устанавливаемого дистрибутива могут переписать имеющиеся без предупреждения.
• TC имеет ошибку, из-за которой пути установки плагинов могут быть определены неверно.