---
url: https://docs.ogmabox.com/pt/app/plugins.md
description: >-
  Instale, gerencie, atualize e desenvolva plugins do Ogma a partir de pacotes
  locais, pastas, arquivos ZIP e do marketplace.
---

# Plugins {#plugins}

Os plugins ampliam o Ogma com páginas de interface personalizadas, processamento de backend, hooks de eventos e painéis de configurações, tudo limitado às permissões declaradas pelo plugin.

## O que os plugins podem adicionar {#what-plugins-can-add}

* Páginas de interface personalizadas acessíveis pela navegação à esquerda.
* Rotas de backend que processam requisições ou respostas.
* Hooks de eventos acionados pelo tráfego capturado.
* Páginas de configurações específicas do plugin.
* Comandos que podem ser registrados na paleta de comandos.

## Instalar a partir de uma pasta {#install-from-folder}

1. Clique em **Instalar** na visualização Plugins.
2. Escolha **Pasta**.
3. Selecione o diretório raiz do plugin. O diretório deve conter um manifesto de plugin válido e os arquivos que ele declara.
4. O Ogma valida o pacote e o registra.
5. Ative o plugin para colocá-lo em funcionamento.

## Instalar a partir de um arquivo ZIP {#install-from-zip-archive}

1. Clique em **Instalar** na visualização Plugins.
2. Escolha **Zip**.
3. Selecione o arquivo `.zip` do plugin.
4. Revise o nome e a versão do plugin detectados.
5. Clique em **Instalar** e depois ative o plugin.

As instalações ZIP são copiadas para o diretório de plugins gerenciado pelo Ogma. O arquivo original pode ser excluído após a instalação.

## Avisos de compatibilidade {#compatibility-warnings}

Após instalar, o Ogma pode exibir avisos na página de detalhes do plugin. Eles são informativos e não impedem a execução do plugin.

Avisos comuns:

* **Arquivos não referenciados**: arquivos presentes no pacote que o manifesto não declara.
* **Camada de compatibilidade de execução ausente**: o plugin usa uma API que exige uma camada de compatibilidade não presente nesta versão do Ogma.

Revise os avisos antes de ativar um plugin desconhecido.

## Ativar e desativar {#enable-and-disable}

Use a opção **Ativado** na linha do plugin para ativá-lo ou desativá-lo. Plugins desativados continuam instalados, mas não são executados. Reativar restaura o plugin sem reinstalá-lo.

## Abas de detalhes do plugin {#plugin-detail-tabs}

Selecione um plugin para abrir seu painel de detalhes. O painel tem as abas a seguir.

| Aba | Conteúdo |
|-----|----------|
| Visão geral | Nome, versão, autor, descrição e origem do plugin. |
| Avisos | Problemas de compatibilidade detectados na instalação ou ativação. |
| Permissões | O que o plugin solicitou e o que o Ogma concedeu em tempo de execução. |
| Arquivos | A lista de arquivos no pacote do plugin. |
| Logs | Saída de execução do plugin, com destaque de sintaxe para linhas de log estruturadas. |
| Interface | A página personalizada do plugin, renderizada dentro do painel. |

## Permissões {#permissions}

A aba Permissões lista cada permissão declarada pelo plugin em seu manifesto e o estado atual da concessão. As chamadas de backend são controladas no servidor. A interface reflete o estado atual de cada permissão.

Se um plugin não estiver se comportando como esperado, confira na aba Permissões se as permissões necessárias foram concedidas.

## Modo de desenvolvimento {#dev-mode}

Plugins instalados a partir de uma pasta mostram um selo **Desenv.** e um botão **Recarregar**.

Clique em **Recarregar** para aplicar alterações de código sem reinstalar. O plugin reinicia e registra novamente todos os hooks e rotas. Esse é o ciclo de iteração padrão para autores de plugins.

Plugins em modo de desenvolvimento continuam vinculados à pasta de origem. Alterações nos arquivos dessa pasta entram em vigor no próximo recarregamento.

## Marketplace {#marketplace}

A aba **Marketplace** lista plugins da comunidade do registro Awesome Ogma Plugins.

1. Explore ou pesquise a lista de plugins.
2. Clique em um plugin para ver sua descrição, versão e metadados de compatibilidade.
3. Clique em **Instalar** para instalá-lo diretamente.
4. Se uma versão compatível mais recente estiver disponível para um plugin instalado pelo marketplace, a ação muda para **Atualizar**.

As instalações do marketplace exigem conexão de rede para baixar o pacote.

## Páginas relacionadas {#related-pages}

* [Início rápido de plugins](/pt/plugins/quickstart)
* [SDK de backend](/pt/plugins/backend-sdk)
* [SDK de frontend](/pt/plugins/frontend-sdk)