SPIP
Article validated
The article « Usando os plugins
(Usando os plugins - SPIP) » was validated by jack.
Usando os plugins
Monday 4 December 2023 , by Ricardo
Porto
Table of contents
- O que é um plugin?
- Organização de plugins
- Usar SVP o gestor de plugins do SPIP
- Gerir os repositórios
- Procurar e encontrar o plugin
- Incluir um plugin
- Atualizar um plugin
- Desativar, Desistalar e/ou Excluir
- Métodos alternativos para gerir os plugins
- Incluir um plugin manualmente via interface SVP
- Gestão de plugins por FTP
- Gestão de plugins pelo SPIP-Cli
- Criar o seu plugin
O que é um plugin?[|Back to the table of
contents](#s-O-que-e-um-plugin)
O SPIP é fornecido com um conjunto de funcionalidades padrão (o núcleo
ou « core »).
Frequentemente temos necessidade de funcionalidades complementares como,
por exemplo, um calendário, uma newsletter… Para responder a essas
necessidades particulares, o SPIP dispõe de um sistema de plugins (também
chamados de « extensões ») com uma API normatizada que possibilita o
acoplamento (« plug » em inglês) ao sistema para acrescer ou completar
funções.
Organização de plugins[|Back to the table of
contents](#s-Organizacao-de-plugins)
Existem dois tipos de plugins:
– Os plugins fornecidos por padrão no SPIP
Encontram-se no ditetório reservado ./plugins-dist/
. Estes
« plugins-dist » são bloqueados e não podem ser desinstalados. Eles são
atualizados a cada atualização do SPIP.
– Os plugins específicos do site
Encontram-se no diretório ./plugins/
Se você quer poder instalá-los e atualizá-los automaticamente,
precisará criar um subdiretório ./plugins/auto/
. (Este subdiretório é
criado automaticamente se você instalar o SPIP via spip-loader
(SPIP))
Usar SVP o gestor de plugins do SPIP[|Back to the table of
contents](#s-Usar-SVP-o-gestor-de-plugins-do-SPIP)
O SPIP dispõe de um sistema automatizado para gerir os plugins, chamado
SVP (acrónimo de « SerVidor de informação e de transferência de
Plugins »).
Ele permite gerir e atualizar os plugins diariamente.
A gestão de plugins é reservada aos administradores completos do site. A
inclusão, atualização e exclusão de plugins são restritas aos
webmasters.
Gerir os repositórios[|Back to the table of
contents](#s-Gerir-os-repositorios)
O SVP vai procurar pelos plugins disponíveis em um « repositório ». Durante
a primeira instalação, o webmaster deverá instalar o depósito e
validá-llo com as sua palavra-passe.
Por padrão o repositório « principal » « SPIP-Zone - Plugins » é sugerido.
É possível incluir outros repositórios. Alguns repositórios são
listados em Dépôts - Plugins SPIP
Por razões de segurança, é necessário informa a palavra-passe para
instalar um novo repositório.
Procurar e encontrar o plugin[|Back to the table of
contents](#s-Procurar-e-encontrar-o-plugin)
É possível procurar o plugin via a interface do SVP, « inclur um plugin ».
Pode ser útil procurar o plugin adequado às suas necessidades no site
dedicado aos plugins SPIP: https://plugins.spip.net/
Incluir um plugin|Back to the table of contents
Ao encontrar o seu plugin, você o seleciona e solicita a sua instalação
« transferir e instalar »; o SVP se oferecerá para instalar o plugin e todas
as dependências necessárias ao seu funcionamento.
Uma vez instalados, alguns plugins disponibilizam um botão « Configurar »
que permite aceder a um formulário de configuração.
Atualizar um plugin[|Back to the table of
contents](#s-Atualizar-um-plugin)
Um plugin tem um número de versão, no formato x.y.z onde
- z representa uma correção menor,
- y representa um acréscimo de funcionalidades,
- x representa uma alteração maior que apresenta riscos de
incompatibilidade.
Quando uma atualização fica disponível (e que a instalação tenha sido
feita pelo SVP) uma informação é exibida:
- Uma atualização corretiva está disponível (acima de z)
- Uma atualização funcional está disponível (acima de y)
- Uma atualização maior está disponível (X.0.0). Considere
verificar as incompatibilidades. (acima de x)
Desativar, Desistalar e/ou Excluir[|Back to the table of
contents](#s-Desativar-Desistalar-e-ou-Excluir)
Os webmasters têm várias opções para retirar um plugin instalado:
- **Desativar: ** o plugin passa para os plugins inativos,
- **Desinstalar: ** exclui os dados e os parâmetros de configuração do
plugin, o plugin passa para os plugins inativos,
Assim que um plugin fica inativo, é então possível:
- **Excluir: ** exclui os arquivos do plugin, mas não os dados;
- **Reativar: ** se o plugin tiver sido desativado (e não desinstalado)
encontrar-se-á todos os dados e parâmetros.
NB:
– Consequentemente, para se excluir completamente um plugin e os seus
dados, é necessário desinstalá-lo e em seguida excluí-lo.
– Atenção, lembre-se de que a desinstalação implica em perda de
dados.
Métodos alternativos para gerir os plugins[|Back to the table of
contents](#s-Metodos-alternativos-para-gerir-os-plugins)
Incluir um plugin manualmente via interface SVP[|Back to the table of
contents](#s-Incluir-um-plugin-manualmente-via-interface-SVP)
É possível instalar um plugin manualmente pela interface SVP, por
exemplo, de uma versão zip obtida em git.spip.net.
Por razões de segurança, é necessário informar a palavra-passe de
webmaster para todas as instalações de plugins por este modo.
Gestão de plugins por FTP[|Back to the table of
contents](#s-Gestao-de-plugins-por-FTP)
Pode-se transferir por FTP os arquivos dos plugins para o diretório
./plugins/
. Uma vez gravados no servidor, será necessário ativar os
plugins via SVP.
Atenção, este método não permite atualizar automaticamente os plugins.
Gestão de plugins pelo SPIP-Cli[|Back to the table of
contents](#s-Gestao-de-plugins-pelo-SPIP-Cli)
O SPIP-Cli permite gerir um site por linha de comando. Existem diversos
comandos dedicados à gestão dos plugins. Para saber mais, consulte a
documentação oficial do SPIP-Cli
Criar o seu plugin[|Back to the table of
contents](#s-Criar-o-seu-plugin)
Se você não encontrar o plugin adequado às suas necessidades, é sempre
possível criá-lo!
Para aprender a codificar os seus próprios plugins:
Nota: o plugin La fabrique permite criar, de um modo simples e rápido,
um plugin a partir do zero
— Sent by SPIP (https://www.spip.net/)