Sistema de plugins

O Sistema de Plugins do Koha permite que você adicione nova ferramentas e relatórios ao sistema que podem ser úteis para sua biblioteca. Plugins são instalados a partir de pacotes KPZ (Koha Plugin Zip). Um arquivo KPZ é apenas um arquivo .zip contendo os arquivos perl, templates e demais arquivos necessários para que o plugin funcione.

Aviso

Não há processo de verificação de plugins pela comunidade Koha. Cada plugin é mantido e testado pelo seu fornecedor e contribuidores. Use os plugins por sua própria conta e risco.

O sistema de plugins precisa de ser ativo por um administrador do sistema.

Configuração

Para configurar o sistema de plugins do Koha deve, primeiro, efectuar algumas modificações na sua instalação.

  • Altere a linha <enable_plugins>0</enable_plugins> para <enable_plugins>1</enable_plugins> no ficheiro koha-conf.xml

  • Se deseja permitir o carregamento de plugins na página de administração, tem também de desligar a configuração plugins_restricted definido-a como plugins_restricted>0</plugins_restricted>

  • Reinicie o seu servidor web

Na página das Ferramentas verá os plugins de Ferramentas e na página de Relatórios verá os plugins de Relatórios.

Instalar um repositório de plugins

No ficheiro koha-conf.xml deve haver uma etiqueta <plugin_repos>. A etiqueta é usada para definir quais os repositórios o Koha deve consultar para pesquisar por novos plugins.

Cada repositório individual está numa etiqueta <repo>. Dentro de cada etiqueta é inserida a informação do repositório.

  • <name> consiste no nome da empresa ou da pessoa a quem pertence o repositório.

  • <org_name> consiste no nome de utilizador da empresa ou individual no serviço git.

  • <service> consiste na plataforma git usada para hospedar o repositório.

Vários repositórios estão disponíveis no ficheiro de configuração por omissão. Pode comentar um ou todos os repositórios.

<plugin_repos>
  <repo>
    <name>ByWater Solutions</name>
    <org_name>bywatersolutions</org_name>
    <service>github</service>
  </repo>
  <repo>
    <name>Theke Solutions</name>
    <org_name>thekesolutions</org_name>
    <service>gitlab</service>
  </repo>
  <repo>
    <name>Open Fifth</name>
    <org_name>openfifth</org_name>
    <service>github</service>
  </repo>
   <repo>
     <name>Solutions inLibro</name>
     <org_name>inLibro</org_name>
     <service>github</service>
 </repo>
   -->
</plugin_repos>

Instalar e usar os plugins

Veja a secção de plugins no capítulo da administração deste manual para aprender como instalar e usar os plugins no Koha.