Resumo
Integração de upload de mídia ImgLink para Discourse com chaves de API com escopo, tratamento de novas tentativas e diagnósticos de administração.
Link do Repositório
https://github.com/imglink12x/discourse-plugin
Guia de Instalação
-
Conecte-se via SSH ao seu contêiner do Discourse:
-
Adicione o plugin ao seu
app.yml: -
Reconstrua o contêiner:
-
Configure sua chave de API ImgLink nas Configurações de Administração (veja Configuração abaixo)
Para configuração detalhada: https://imglink.cc/tools/forum-plugins
Funcionalidades
-
Upload Direto do Compositor — Envie imagens diretamente do editor de posts do Discourse
-
Chaves de API com Escopo Limitado — Utiliza credenciais de escopo limitado; sem acesso total à conta
-
Links Direto e do Visualizador — Retorna tanto links diretos de CDN quanto URLs do visualizador de imagens
-
Nova Tentativa + Idempotência — Lógica de nova tentativa automática para conexões instáveis; previne uploads duplicados
-
Diagnósticos de Administração — Verificações de integridade integradas para validar autenticação de API, conectividade e permissões de upload
-
Saída BBCode — Formatação BBCode automática para postagem incorporada
-
Registro de Erros — Logs detalhados para solução de problemas de falhas de upload
Configuração
Passo 1: Crie uma Chave de API ImgLink
-
Faça login no ImgLink (https://imglink.cc)
-
Navegue até Configurações → Chaves de API
-
Crie uma nova chave com estes escopos:
-
upload:create -
image:delete(opcional, para fluxos de trabalho de limpeza)
-
-
Copie a chave de API
Passo 2: Adicione às Configurações de Administração do Discourse
-
Vá para Administração → Configurações → Plugins
-
Role até Configurações do ImgLink
-
Cole sua chave de API no campo
imglink_api_key -
(Opcional) Defina
imglink_api_endpointse estiver usando uma instância ImgLink personalizada -
Salve
Passo 3: Execute os Diagnósticos
-
Vá para Administração → Plugins → Configurações do ImgLink
-
Clique em “Testar Conexão” para validar sua configuração
-
Você deverá ver “✓ Conexão bem-sucedida”
Configurações
| Nome da Configuração | Tipo | Padrão | Descrição |
|---|---|---|---|
imglink_api_key |
String | (vazio) | Sua chave de API ImgLink com escopo upload:create |
imglink_api_endpoint |
String | https://imglink.cc/api/v1 |
URL base da API ImgLink (deixe o padrão a menos que auto-hospedado) |
imglink_max_retries |
Inteiro | 3 |
Número de tentativas de nova tentativa para uploads com falha |
imglink_retry_delay |
Inteiro | 1000 |
Milissegundos de espera entre as tentativas de nova tentativa |
imglink_timeout_ms |
Inteiro | 30000 |
Tempo limite da solicitação de upload (30 segundos) |
imglink_enable_diagnostics |
Booleano | true |
Habilita ferramentas de diagnóstico de administração e logs |
imglink_enable_direct_links |
Booleano | true |
Retorna links diretos de CDN em vez de links com visualizador |
Compatibilidade de Versão: Discourse 2.8+ | Última Atualização: Março de 2026 | Suporte: https://imglink.cc/tools/forum-plugins