Módulos

Um módulo acrescenta uma função ao site, como posts, comentários ou SEO. A tela Módulos mostra os módulos instalados e deixa você ligar, desligar e configurar cada um. Para a lista completa dos módulos oficiais, veja Módulos oficiais.

Os módulos são instalados pela linha de comando do projeto, com slash module add <nome>. A tela só liga, desliga e configura os que já estão instalados. Para ver a lista deles na linha de comando, use slash module list.

A tabela de módulos

A tabela Módulos instalados tem uma linha por módulo:

Coluna	O que mostra
Módulo	O nome, a descrição e o identificador do módulo.
Versão	A versão instalada.
Depende de	Os módulos de que ele precisa para funcionar. Quando não há, aparece —.
Ativo	A chave que liga e desliga o módulo.

Cada linha tem a ação Configurar.

Ligar e desligar

Clique na chave da coluna Ativo. A tela abre uma confirmação:

• Para ligar, o título é Ativar «Título do módulo»?, e o texto diz que o módulo volta a aparecer no menu e que suas telas voltam a abrir.
• Para desligar, o título é Desativar «Título do módulo»?, e o texto diz que o módulo some do menu, que suas telas deixam de abrir e que os dados guardados continuam.

Confirme com Ativar ou Desativar. Para desistir, clique em Cancelar. Depois da confirmação, a tela mostra Módulo ativado. ou Módulo desativado.. A mudança vale na hora, sem reiniciar o painel.

Quando um módulo não pode mudar

Alguns módulos dependem de outros. Nesses casos, a chave fica travada e a coluna Ativo mostra o motivo:

• «<módulo>» depende deste módulo.: outros módulos ligados precisam dele. Desligue-os antes.
• Ative «<módulo>» antes.: ele precisa de um módulo desligado. Ligue-o antes.

Se a mudança é recusada mesmo assim, a tela mostra o motivo e não altera nada:

• Não dá para ativar «<módulo>»: depende de «<módulo>», que está desativado.
• Não dá para desativar «<módulo>»: «<módulo>» depende dele.

Configurar um módulo

Clique em Configurar para abrir a tela Configurar Título do módulo.

• Se o módulo tem ajustes, a tela mostra um formulário. Ele se salva com Salvar configurações, e a tela confirma com Configurações salvas.. Voltar aos módulos volta para a lista.
• Se o módulo não tem ajustes, a tela mostra Este módulo não tem configurações, com a explicação Ele funciona sem nenhum ajuste..

O cartão Sobre o módulo, ao lado, mostra o Id, a Versão, o Núcleo exigido, os módulos de que ele Depende de e as permissões de cada ação, na forma <módulo>.<ação>, e os papéis que a têm. Nesse cartão também está o botão Ativar ou Desativar, com a mesma confirmação da lista.

Telas desta página

Para quem implanta ou estende: as rotas desta tela.

Método	Caminho	Dono	Título	Permissão	Sem sessão
GET	/painel/modulos	core	Módulos	core.modules	Não
POST	/painel/modulos/:id/ativo	core	Módulos	core.modules	Não
GET	/painel/modulos/:id	core	Módulos	core.modules	Não
POST	/painel/modulos/:id	core	Módulos	core.modules	Não