Um plugin é um programa que permite melhorar ou incluir funcionalidades ao SPIP. É escrito especificamente para o SPIP e respeita um formalismo (uma API) que lhe permite interagir com o sistema. O termo plugin vem do inglês to plug (conectar), pois deve ser bem fácil conectá-lo ao SPIP mas também desconectá-lo. A existência dos plugins dá-se principalmente pela necessidade de evitar a hipertrofia do núcleo do SPIP — especialmente por razões de manutenção — facilitando grandemente as possibilidades de personalização extendida do seu funcionamento.
O site dos plugins do SPIP é https://plugins.spip.net
Recuperar e instalar o plugin
Cada plugin apresenta-se na forma de um diretório com o seu nome, que contém um conjunto de ficheiros.
Instale esse diretório no diretório /plugins na raiz do site. Esse diretório não existe por padrão, quando o SPIP é instalado, precisa criá-lo. Pode também criar subdiretórios para organizar à sua vontade os plugins que instalar.
- Instalação automática
Ativação do sistema:
a instalação de plugins pode ser feita automaticamente. Para isso, é preciso criar um subdiretório plugins/auto/, e conceder ao servidor autorização de escrita nesse diretório.
Se não tiver criado os diretórios plugins/auto/, verá a mensagem
uma vez criados, a página será exibida assim
Pode-se, com a instalação automática:
- incluir plugins individuais, indicando oURL de um ficheiro Zip (qualquer que seja a sua origem), (Nota: esta ação exige fornecer a palavra-passe do webmaster que realiza a ação);
- incluir plugins por lote;
- incluir listas de plugins catalogados num fluxoRSS;
- atualizar os plugins usados pelo seu site.
Encontrar plugins:
Três ambientes permitem aos utilizadores encontrar plugins de acordo com diferentes abordagens (desenvolvedores, contributiva, referência):
- todos os plugins desenvolvidos na Zona podem aparecer, por iniciativa dos seus autores, no repositório http://files.spip.org/spip-zone/ ;
- SPIP-Contrib foi adaptado para melhorar a busca de plugins;
- O site Plugins.spip oferece um referênciamento mais detalhado, por tema, por compatibilidade de versão do SPIP, por idiomas…
Repare que, enquanto não tiver informado o endereço de um repositório (clique simplesmente em "adicionar"), verá
Os sites «Plugins.spip» e «SPIP-contrib» oferecem fluxos RSS diretamente utilizáveis para a instalação automática de plugins compatíveis.
Ativar o plugin
A área restrita, o submenu «gerir plugins» do menu «configuração» permite ativar / desativar, instalar / desinstalar e atualizar os plugins.
Para aceder ao menu, é preciso ser webmaster ou administrador.
Verá aparecer a lista dos plugins. Marque os que desejar ativar ou atualizar, desmarque os que quer desativar. Ao clicar no nome do plugin, poderá ver:
- versão e status de desenvolvimento
- autores
- créditos
- licença do plugin
- diretório de instalação
- descrição do plugin
- link para uma página de informação
- se necessário, o nome dos plugins suplementares requeridos para o funcionamento do seu plugin.
Se o plugin permitir ajustes adicionais, um botão «configurar» estará visível, dando acesso ao formulário de configuração.
Se houver uma atualização disponível para o plugin, uma mensagem de aviso será exibida abaixo do nome do plugin e a opção «Atualizar...» será exibida no topo do menu flutuante «Ações». Ao clicar na opção, o plugin será atualizado.
Nota: alguns plugins são fornecidos nativamente pelo SPIP; poderá encontrá-los na aba dos plugins "bloqueados"
Desativar, desinstalar e/ou excluir
Os webmasters têm várias opções para remover um plugin instalado:
- Desativar: o plugin passa para os plugins inativos,
- Desinstalar: suprime os dados e as configurações do plugin, que passa para os plugins inativos,
Quando o plugin está inativo, pode-se, então:
- Excluir: suprime os ficheiros do plugin, mas não os dados;
- Reativar: se o plugin foi desativado (e não desistalado) todos os dados e configurações serão recuperados ao ser reativado.
Nota:
- Consequentemente, para remover completamente um plugin e seus dados, é preciso desinstalá-lo e, em seguida, excluí-lo.
- Atenção: não se esqueça de que a desinstalação provoca a perda de dados
Aviso
Atenção: como para qualquer software, é fortemente recomendado ter atenção para não instalar qualquer coisa no seu servidor. Um plugin pode estar numa fase do seu desenvolvimento que traga riscos com o seu uso. Umplugin apresentado como estável também pode conter erros e, assim, abrir falhas de segurança no seu site.
Note também que é possível, em certos casos, que dois plugins não sejam compatíveis entre si.
Se você notar o que parece ser um erro do SPIP, mas estiver usando plugins, deve verificar imperativamente se o erro é reproduzível sem nenhum plugin ativado antes de reportá-lo.
Se o erro desaparecer sem os plugins, procure o plugin defeituoso ativando-os um por um para identificar a configuração em que o bug foi constatado. Sem estas precauções, a resolução do seu problema pela comunidade será mais imprevisível.
