Категория:Plugins — различия между версиями

Введение

В данном руководстве описывается как пользоваться плагинами для OpenKore. Плагины - это небольшие Perl'овые пакеты с расширением .pl, которые расширяют возможности OpenKore. Эти плагины срабатывают на внутренние события в OpenKore, называемые хуками (hooks).

Загрузка

Большинство плагинов можно загрузить с официального репозитария плагинов OpenKore на сайте SourceForge:

• http://openkore.svn.sf.net/viewvc/openkore/plugins (руками)
• https://openkore.svn.sourceforge.net/svnroot/openkore/plugins (командой svn checkout)

Примечания:

• Советуется скачать всю папку с плагином - <pluginname>/trunk .
• Неофициальные источники небезопасны, чтобы с них качать плагины. В первую очередь имеются в виду различные сообщения на форумах.
• Использование плагинов из официального репозитария OpenKore помогает разработчикам править и поддерживать их, учитывая, что вы сообщаете о найденных ошибках и осуществляете обратную связь. Также вам будет легче обновлять плагины до свежих версий через svn.

Установка

Переименуйте папку trunk в <pluginname> и положите её в папку с плагинами OpenKore, например OpenKore/plugins/<pluginname>.

plugins/
	macro/
		<тут файлы из ^/plugins/macro/trunk>
	state/
		<тут файлы из ^/plugins/state/trunk>
	randomplugin/
		<тут файлы из ^/plugins/randomplugin/trunk>
	...

Примечания:

• OpenKore ищет плагины - файлы вида *.pl только непосредственно в папке plugins и внутри лежащих в папке plugins папках, но не далее. Например /plugins/<pluginname>/<pluginname.pl>.
• Возможно потребуется дополнительная настройка, чтобы плагин заработал. Так, например, в параметре файла sys.txt loadPlugins прописывается порядок загрузки плагинов.
• Можно настроить в какой папке OpenKore будет искать плагины, но в большинстве случаев это не нужно.

Использование svn

Чтобы установить при помощи svn плагин, например плагин example, следует ввести команду:

svn co https://openkore.svn.sourceforge.net/svnroot/openkore/plugins/example/trunk plugins/example

Чтобы обновить этот плагин example из репозитария svn, следует ввести команду:

svn up plugins/example

Чтобы обновить все плагины в OpenKore:

svn up plugins/*

Настройка

Каким образом следует настраивать определённый плагин под ваши нужды, можно найти на форумах, а также в некоторых случаях прямо в репозитарии - в папке с документацией <pluginname>/trunk/doc или прямо в файле с кодом плагина. На данный момент стоит задача обогатить вики такими руководствами, как это было сделано с плагинами Макро-плагин и wx captcha.