Adicione um botão de upload de imagens ao seu fórum phpBB, SMF ou MyBB

Quem modera um fórum há mais de alguns meses já passou pelo mesmo problema: os membros usam imagens de qualquer site que seja conveniente, os links quebram assim que o host original apaga o arquivo ou muda a estrutura, e os tópicos antigos vão se enchendo de ícones de imagem quebrada. A solução a que a maioria dos fóruns acaba chegando é montar a própria hospedagem de imagens, o que troca um problema por outro: custos de servidor, limites de armazenamento e mais um sistema para atualizar e manter com backup. Os plugins de fórum do YourImageShare oferecem um meio-termo: um botão de upload de verdade dentro do editor de posts, que envia a imagem para o YourImageShare em vez do servidor do fórum, sem o trabalho de manter uma hospedagem.

Como funciona, em uma frase

Cada plugin adiciona um botão Upload Image ao lado da caixa de texto do editor. Clique, escolha um arquivo e um link direto é inserido automaticamente como BBCode na posição do cursor, usando a mesma API de upload documentada em yourimageshare.com/about/api. Sem outra aba e sem copiar e colar o link de outro lugar.

phpBB

O phpBB é uma das plataformas de fórum mais usadas ainda hoje e tem um sistema de extensões feito para esse tipo de recurso. O plugin é uma extensão real para phpBB 3.2 e 3.3: descompacte na pasta ext da sua instalação, ative em Customise, Manage extensions no painel de administração e cole sua chave de API real no arquivo de template da extensão, no lugar do texto provisório. A partir daí, o botão de upload aparece automaticamente em todas as páginas com editor de posts, sem mais nenhuma configuração.

SMF (Simple Machines Forum)

O SMF tem um gerenciador de pacotes próprio, feito para instalar mods como este. O plugin é um pacote SMF de verdade, instalado do jeito normal em Admin, Package Manager. Depois, basta trocar a chave de API provisória pela sua em um único arquivo de código. O sistema de pacotes do SMF registra a integração direitinho, sem que você precise mexer nos arquivos de tema do fórum.

MyBB

Os plugins do MyBB ficam no diretório inc/plugins, e este é um plugin real para MyBB 1.8 que usa o sistema de hooks documentado do próprio MyBB. Copie o arquivo do plugin para o lugar certo, ative em Configuration, Plugins no painel de administração e defina sua chave de API no mesmo arquivo. Como nos outros dois, o botão aparece automaticamente em todo lugar que tenha um editor de posts.

FluxBB, PunBB e ZetaBoards

Essas três plataformas não têm um sistema formal de plugins ou extensões como phpBB, SMF e MyBB, então a integração é feita com um pequeno trecho de código para copiar e colar, em vez de um pacote instalável. No FluxBB e no PunBB, uma tag script curta entra diretamente no arquivo de template do estilo ativo. No ZetaBoards, que é uma plataforma hospedada e não algo que você instala, o mesmo trecho vai na seção Board Template do Admin CP, um recurso feito para esse tipo de personalização em todo o site, sem precisar de acesso a arquivos. As instruções completas para as três estão linkadas na página de documentação da API.

Por que isso é melhor do que hospedar as imagens no próprio fórum

Manter a própria hospedagem de imagens para um fórum significa pagar por um armazenamento que só cresce, já que quase ninguém volta para apagar anexos antigos, além de mais um sistema que precisa de backups, correções de segurança e monitoramento. Direcionar os uploads para o YourImageShare tira todo esse custo e essa manutenção do seu servidor. Os membros continuam recebendo um link de imagem real, permanente e funcional direto no post, só que ele não fica armazenado em uma infraestrutura que você precise manter.

Por que isso é melhor do que depender de hosts de imagem aleatórios

A alternativa com que a maioria das comunidades acaba, sem plugin nenhum, é cada membro escolher o host de imagens que prefere e colar o link direto no post. É exatamente isso que causa o problema dos links quebrados: cada um usa um host diferente, alguns desses hosts fecham ou passam a apagar conteúdo antigo do plano grátis, e os tópicos antigos vão apodrecendo. Um plugin de fórum padroniza um único host para todos, com um formato de link direto consistente, enviado sempre da mesma forma, direto do editor de posts em vez de uma aba separada que é fácil de pular.

Definindo expiração para uploads no fórum

Nem todo upload no fórum precisa ser permanente. Um anexo de uso único em um tópico de suporte, uma captura de tela temporária que prova um bug antes de ele ser corrigido, ou a imagem de divulgação de um evento que já aconteceu: nada disso precisa ficar para sempre ocupando espaço. O mesmo recurso de uploads com expiração disponível na API vale aqui também, permitindo que um arquivo desapareça sozinho depois de um tempo definido, em vez de ficar parado indefinidamente. Os detalhes de como funciona o prazo estão na página de referência da API.

Uma chave de API, todos os membros

Um detalhe que vale planejar: o plugin usa uma única chave de API, configurada por quem o instala, normalmente o administrador do fórum, e não uma chave para cada membro. Isso significa que todos os uploads feitos pelo plugin contam nos limites de uso de uma só conta, o que em geral é suficiente para comunidades pequenas e médias, mas vale conferir os limites documentados se o fórum tiver muito tráfego. Os limites de uso e como ler os cabeçalhos de resposta que os informam estão explicados por completo na página de documentação da API.

Como começar

Todos os plugins, com os passos exatos de instalação para cada plataforma, estão linkados em yourimageshare.com/about/api, em Forum Plugins. Primeiro você vai precisar de uma chave de API, gerada em menos de um minuto em My account, depois de entrar em yourimageshare.com. Os limites do plano grátis são generosos o bastante para a maioria dos fóruns de comunidade, sem necessidade de upgrade.

Testando antes de lançar para a comunidade

Antes de anunciar um novo botão de upload para o fórum inteiro, vale testar o plugin instalado você mesmo, de preferência em uma área de testes privada ou só para a equipe, se o seu fórum tiver uma. Publique uma mensagem de teste, clique no botão de upload, confirme que o link gerado funciona e é exibido corretamente e depois apague o post de teste. Isso pega cedo os dois erros de configuração mais comuns: uma chave de API colada errada, que costuma mostrar um erro de autenticação na primeira tentativa de upload, e um plugin copiado para o diretório errado, o que geralmente faz o botão nem aparecer. Os dois são fáceis de corrigir quando descobertos no teste, e bem menos visíveis do que ser avisado por um membro confuso no fórum de ajuda depois do lançamento.

Uma observação sobre moderação

Todo arquivo enviado ao YourImageShare, seja pelo site, direto pela API ou por um destes plugins, passa pela mesma verificação automática de moderação aplicada a qualquer outro upload na plataforma. Isso não substitui a política de moderação que o seu fórum já tem, pois o comportamento dos membros e o conteúdo dos posts continuam sendo responsabilidade da sua comunidade, mas significa que a própria hospedagem de imagens não é um depósito sem nenhuma moderação, o que importa se você estiver escolhendo entre isto e um host de terceiros totalmente anônimo e sem moderação para seus membros usarem.

Lançando junto com os hábitos atuais de hospedagem de imagens

A maioria dos fóruns que já existem há algum tempo tem membros com hábitos formados: uns usam hospedagem pessoal, outros o host de imagens grátis que sempre usaram. O plugin não obriga ninguém a mudar isso, apenas oferece uma opção mais rápida e confiável bem ao lado da caixa de texto. Na prática, depois que os membros experimentam o botão de upload com um clique algumas vezes e notam que o link gerado não quebra como uma imagem antiga de outro site acaba quebrando, a adesão costuma acontecer sozinha, sem migração forçada nem mudança de regras. Fixar um tópico curto de aviso explicando o novo botão, com um link para a página de documentação da API para quem tiver curiosidade de saber como funciona, geralmente é suficiente.

Se o software do seu fórum não está na lista

phpBB, SMF, MyBB, FluxBB, PunBB e ZetaBoards cobrem boa parte dos fóruns ainda ativos hoje, mas não são as únicas opções. Qualquer software de fórum que consiga exibir um pequeno trecho de HTML e JavaScript no template da página, o que inclui a grande maioria das plataformas de fórum auto-hospedadas, pode usar o mesmo widget das integrações do FluxBB e do PunBB: um botão no editor da página que envia pela API e insere o BBCode automaticamente. Os detalhes técnicos do endpoint que ele chama estão documentados em yourimageshare.com/about/api, para quem se sentir à vontade para adaptar o trecho a outra plataforma.

O que os membros realmente veem

Do ponto de vista do membro, nada muda na hora de postar, a não ser um botão novo. Ele não precisa de conta no yourimageshare.com, não precisa saber que o upload passa por outro serviço e não precisa de nenhuma instrução além de "clique neste botão para adicionar uma imagem". O link gerado se comporta como qualquer outro link de imagem colado em um post, com pré-visualização normal e funcionando do mesmo jeito anos depois, e é justamente isso que faz a configuração valer a pena.

Incentivando a adesão sem forçar

Um post curto fixado explicando o novo botão, com um link para o YourImageShare para quem tiver curiosidade de saber o que hospeda as imagens agora, costuma ser tudo de que você precisa. Forçar uma migração dos hábitos antigos raramente dá certo em uma comunidade consolidada, enquanto uma opção realmente mais rápida bem ao lado da caixa de texto tende a conquistar as pessoas sozinha em algumas semanas.

A configuração leva alguns minutos por plataforma e, depois de pronta, fica pronta, sem manutenção contínua além das atualizações do painel de administração que um fórum já precisa de tempos em tempos.

Uma comparação útil para ter à mão

Se os membros perguntarem por que o fórum deixou de permitir que cada um use links de onde quiser, a resposta curta é confiabilidade. Um link gerado pelo YourImageShare continua funcionando porque a plataforma existe justamente para hospedar esse arquivo a longo prazo, do mesmo jeito que o yourimageshare.com funciona para quem envia direto pelo site. Um link para o lugar onde o membro tinha conta há cinco anos não tem essa garantia, e boa parte das imagens quebradas pela web vem exatamente desse padrão.

Se os membros do fórum também se beneficiariam de enviar direto de uma ferramenta de captura de tela, em vez de um arquivo salvo, este post complementar explica como configurar as integrações com ShareX, Flameshot e Greenshot, que combinam bem com um plugin de fórum para quem documenta bugs, compartilha capturas de tela ou responde dúvidas de suporte com provas visuais.

Nada disso exige mexer no software principal do fórum, o que importa para quem desconfia de qualquer coisa que complique futuras atualizações.

Se o que você precisa é de uma referência sobre a formatação BBCode em si (e não sobre o upload), veja BBCodes, tags HTML e frames incorporáveis. Para um upload em massa por script, em vez de um plugin, veja como automatizar uploads com a API.