Os temas e as extensões do Flarum 2 são pacotes do Composer. Este guia mostra o caminho completo, da instalação à remoção, e os tropeços mais comuns. Os exemplos usam o ramon/chat, mas o processo é o mesmo para qualquer extensão.
Antes de começar, confira se o servidor atende aos requisitos do Flarum 2 e faça um backup do banco de dados. Uma migration não se desfaz sozinha.
1. Instalar
Entre na pasta do Flarum (a que tem o arquivo flarum e o composer.json) e rode:
composer require ramon/chat
php flarum migrate
php flarum cache:clear
Depois, abra o painel de administração, vá em Extensões e habilite a extensão. Temas também são extensões: o Canela e o Avocado se habilitam do mesmo jeito.
2. Atualizar
composer update ramon/chat --with-dependencies
php flarum migrate
php flarum cache:clear
O --with-dependencies deixa o Composer atualizar também as bibliotecas que a extensão usa. Para ver o que tem versão nova antes de atualizar, use composer outdated.
3. Remover
- Desabilite a extensão no painel de administração.
- Se quiser apagar também as tabelas e os dados dela, use a opção de desinstalar da página da extensão desabilitada. Isso é definitivo.
- Remova o pacote:
composer remove ramon/chat
php flarum cache:clear
Pelo painel, sem terminal
Com a extensão Extension Manager (flarum/extension-manager) habilitada, o administrador instala, atualiza e remove extensões pelo próprio painel. Ela precisa que o servidor consiga rodar o Composer, então em hospedagens mais limitadas o terminal continua sendo o caminho mais seguro.
Agendador
Algumas extensões fazem tarefas em segundo plano: o Canela, por exemplo, usa o agendador para os lembretes dos marcadores e os emblemas diários. Para isso funcionar, coloque no cron do servidor:
* * * * * cd /caminho/do/flarum && php flarum schedule:run >> /dev/null 2>&1
O php flarum info mostra se o agendador está ativo.
Problemas comuns
- Erro de permissão ao instalar ou ao enviar imagens. Rode os comandos com o mesmo usuário do servidor web, ou ajuste o dono das pastas
storage e public/assets. Evite rodar o Composer como root.
- O Composer fica sem memória. Use
COMPOSER_MEMORY_LIMIT=-1 composer require ....
- "Your requirements could not be resolved". A extensão provavelmente pede outra versão do Flarum ou do PHP. Leia a mensagem até o fim: ela diz qual pacote está em conflito.
- A extensão não aparece ou o visual não mudou. Rode
php flarum cache:clear e recarregue a página sem cache (Ctrl + F5).
- Erro 500 depois de habilitar. Veja o arquivo mais recente em
storage/logs/ e conte o erro em Bugs.
Ficou preso em algum passo? Abra uma discussão em Instalação com o comando que rodou e a mensagem completa que apareceu.
