[SPIP] Proposé : Usando os plugins

SPIP

Article proposé

L’article « Usando os plugins
(SPIP) » est proposé
à la publication depuis segunda-feira 20 de Novembro de 2023.


Usando os plugins

segunda-feira 20 de Novembro de 2023 , por Ricardo
Porto

Sommaire

  • 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?|Retour au sommaire

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|Retour au sommaire

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[|Retour au

sommaire](#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|Retour au sommaire

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[|Retour au

sommaire](#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|Retour au sommaire

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|Retour au sommaire

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[|Retour au

sommaire](#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[|Retour au

sommaire](#s-Metodos-alternativos-para-gerir-os-plugins)

Incluir um plugin manualmente via interface SVP[|Retour au

sommaire](#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[|Retour au

sommaire](#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[|Retour au

sommaire](#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|Retour au sommaire

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

— Enviado por SPIP (https://www.spip.net/)