O que é 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
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)
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
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 https://plugins.spip.net/spip.php?page=depots
Por razões de segurança, é necessário informa a palavra-passe para instalar um novo repositório.
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
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
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
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
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
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
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
https://contrib.spip.net/SPIP-Cli
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:
https://programmer.spip.net/-Developper-des-plugins-
Nota: o plugin La fabrique permite criar, de um modo simples e rápido, um plugin a partir do zero
https://contrib.spip.net/La-Fabrique