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

Quem modera um fórum há mais de alguns meses já se deparou com o mesmo problema: os membros ligam a imagens alojadas em qualquer lado, esses links deixam de funcionar assim que o alojamento original apaga o ficheiro ou muda a estrutura, e os tópicos antigos vão-se enchendo de ícones de imagens quebradas. A solução a que a maioria dos fóruns chega é montar o seu próprio alojamento de imagens, o que troca um problema por outro: custos de servidor, limites de armazenamento e mais um sistema para manter atualizado e com cópias de segurança. Os plugins de fórum do YourImageShare oferecem um caminho intermédio: um botão real no editor de mensagens que carrega as imagens para o YourImageShare em vez de para o servidor do fórum, sem a carga de gerir o alojamento.

Como funciona, numa frase

Cada plugin adiciona um botão Carregar imagem junto à caixa de texto do editor de mensagens. Clique, escolha um ficheiro e um link direto é inserido automaticamente como BBCode na posição do cursor, usando a mesma API de carregamento documentada em yourimageshare.com/about/api. Sem separadores extra, sem copiar e colar manualmente um link vindo de outro sítio.

phpBB

O phpBB é uma das plataformas de fóruns mais utilizadas que continuam ativas e tem um sistema de extensões próprio para este tipo de acrescento. O plugin é uma extensão real para phpBB 3.2 e 3.3: descompacte-o na pasta ext da sua instalação, ative-o em Personalizar, Gerir extensões no painel de administração e depois cole a sua chave de API real no ficheiro de modelo da extensão, no lugar do marcador. A partir daí, o botão de carregar aparece automaticamente em todas as páginas com editor de mensagens, sem mais configurações.

SMF (Simple Machines Forum)

O SMF tem o seu próprio gestor de pacotes, criado para instalar mods como este. O plugin é um pacote SMF real, instalado da forma habitual em Admin, Gestor de pacotes, e o único passo que falta é substituir o marcador da chave de API por a sua chave real num único ficheiro de código. O sistema de pacotes do SMF regista a integração de forma limpa, sem ser preciso mexer diretamente nos ficheiros do tema do fórum.

MyBB

Os plugins do MyBB ficam numa pasta inc/plugins simples, e este é um plugin real para MyBB 1.8 que usa o sistema de hooks documentado do próprio MyBB. Copie o ficheiro do plugin para o local certo, ative-o em Configuração, Plugins no painel de administração e defina a sua chave de API no mesmo ficheiro. Tal como nos outros dois, o botão aparece depois automaticamente em todos os sítios onde há um editor de mensagens.

FluxBB, PunBB e ZetaBoards

Estas três plataformas não têm um sistema formal de plugins ou extensões como o phpBB, o SMF e o MyBB, por isso a integração faz-se com um pequeno fragmento de código para copiar e colar, em vez de um pacote instalável. No FluxBB e no PunBB, uma pequena etiqueta de script vai diretamente para o ficheiro de modelo do estilo ativo. No ZetaBoards, que é uma plataforma alojada e não algo que se instale, o mesmo fragmento vai para a secção Board Template do Admin CP, uma funcionalidade pensada para este tipo de personalização global sem precisar de acesso a ficheiros. As instruções completas para as três estão ligadas a partir da página de documentação da API.

Porque é melhor do que alojar as imagens no próprio fórum

Manter o seu próprio alojamento de imagens para um fórum significa pagar por um armazenamento que só cresce com o tempo, já que quase ninguém volta atrás para apagar anexos antigos, e significa mais um sistema que precisa de cópias de segurança, atualizações de segurança e monitorização. Apontar os carregamentos para o YourImageShare tira esse custo e essa manutenção do seu servidor. Os membros continuam a receber um link de imagem real, permanente e funcional inserido diretamente na mensagem, só que não fica guardado numa infraestrutura que tenha de manter.

Porque é melhor do que depender de alojamentos de terceiros aleatórios

A alternativa em que a maioria das comunidades acaba por cair, sem qualquer plugin, é cada membro escolher o alojamento de imagens que prefere e colar um link simples na mensagem. É exatamente isto que causa o problema dos links quebrados: cada membro usa um alojamento diferente, alguns deles acabam por encerrar ou começam a apagar conteúdo antigo das contas grátis, e os tópicos antigos vão apodrecendo. Um plugin de fórum uniformiza tudo num só alojamento para todos, com um formato de link direto consistente, carregado sempre da mesma maneira, diretamente a partir do editor e não num separador à parte que é fácil de ignorar.

Definir uma validade para os carregamentos no fórum

Nem todos os ficheiros carregados num fórum precisam de ser permanentes. Um anexo pontual para um tópico de suporte, uma captura de ecrã temporária que prova que existe um erro antes de ser corrigido, ou uma imagem promocional de um evento que já passou, nada disto precisa de ficar para sempre a ocupar espaço. A mesma funcionalidade de carregamentos com validade disponível na API aplica-se aqui, permitindo que um ficheiro desapareça discretamente passado um determinado tempo, em vez de ficar indefinidamente. Os detalhes completos sobre o funcionamento do prazo estão na página de referência da API.

Uma chave de API, todos os membros

Um pormenor a ter em conta: o plugin usa uma única chave de API configurada por quem o instala, normalmente o administrador do fórum, e não uma chave por membro. Isto significa que todos os carregamentos feitos através do plugin contam para os limites de utilização de uma só conta, o que em geral é suficiente para comunidades pequenas e médias, mas convém confirmar nos limites documentados se o fórum tiver muito tráfego. Os limites de utilização e a forma de ler os cabeçalhos de resposta que os indicam estão explicados na página de documentação da API.

Como começar

Todos os plugins, com os passos de instalação exatos para cada plataforma, estão ligados a partir de yourimageshare.com/about/api, em Forum Plugins. Vai precisar primeiro de uma chave de API, gerada em menos de um minuto em A minha conta depois de iniciar sessão em yourimageshare.com, e os limites do plano grátis são generosos o suficiente para a maioria dos fóruns de comunidades, sem necessidade de subir de plano.

Testar antes de lançar à comunidade

Antes de anunciar um novo botão de carregar a todo o fórum, convém testar o plugin instalado, de preferência num fórum de testes privado ou só para a equipa, se tiver um. Publique uma mensagem de teste, clique no botão de carregar, confirme que o link resultante funciona e é apresentado corretamente, e depois apague a mensagem de teste. Isto permite detetar cedo os dois erros de configuração mais comuns: uma chave de API colada incorretamente, que normalmente mostra um erro de autenticação à primeira tentativa de carregamento, e um plugin copiado para a pasta errada, o que normalmente significa que o botão nunca aparece. Ambos são fáceis de corrigir quando apanhados nos testes, e muito menos visíveis do que descobri-los através de um membro confuso a escrever no fórum de ajuda depois do lançamento.

Uma nota sobre moderação

Todos os ficheiros carregados no YourImageShare, seja através do site, diretamente pela API ou por um destes plugins, passam pela mesma verificação automática de moderação aplicada a qualquer outro carregamento na plataforma. Isto não substitui a política de moderação que o seu fórum já tenha, o comportamento dos membros e o conteúdo das mensagens continuam a ser da responsabilidade da sua comunidade, mas significa que o próprio alojamento de imagens não é um sítio completamente sem moderação, o que importa se estiver a escolher entre esta opção e um alojamento de terceiros verdadeiramente anónimo e sem moderação para os seus membros.

Introduzir isto junto dos hábitos de alojamento de imagens já existentes

A maioria dos fóruns que já funcionam há algum tempo tem membros com hábitos instalados: uns ligam a imagens do seu alojamento pessoal, outros ao alojamento grátis que sempre usaram. Um plugin não obriga ninguém a mudar de comportamento, limita-se a acrescentar uma opção mais rápida e fiável mesmo ao lado da caixa de texto. Na prática, depois de os membros experimentarem algumas vezes o botão de carregar com um clique e perceberem que o link nunca se estraga como acaba por acontecer a uma imagem antiga ligada de fora, a adesão tende a acontecer por si, sem migração forçada nem alteração de regras. Fixar um tópico curto de anúncio a explicar o novo botão, com um link para a página de documentação da API para quem tenha curiosidade em saber como funciona, costuma ser suficiente.

Se o seu software de fórum não estiver na lista

O phpBB, o SMF, o MyBB, o FluxBB, o PunBB e o ZetaBoards cobrem uma grande parte dos fóruns ainda ativos, mas não são as únicas opções. Qualquer software de fórum que consiga apresentar um pequeno fragmento de HTML e JavaScript no modelo das suas páginas, o que abrange a esmagadora maioria das plataformas de fóruns auto-alojadas, pode usar o mesmo widget das integrações do FluxBB e do PunBB: um botão no editor que carrega através da API e insere BBCode automaticamente. Os detalhes técnicos completos sobre o endpoint que chama estão documentados em yourimageshare.com/about/api, para quem se sinta à vontade para adaptar o fragmento a outra plataforma.

O que os membros veem na realidade

Do ponto de vista de um membro, nada muda ao publicar, a não ser um botão novo. Não precisa de uma conta em yourimageshare.com, não precisa de saber que o carregamento se faz através de um serviço externo e não precisa de mais instruções do que "clique neste botão para adicionar uma imagem". O link gerado comporta-se exatamente como qualquer outro link de imagem colado numa mensagem, com pré-visualização normal e a funcionar da mesma maneira anos depois, que é precisamente a propriedade que faz com que valha a pena configurar tudo isto.

Incentivar a adesão sem obrigar

Uma mensagem curta fixada a explicar o novo botão, com um link para o YourImageShare para quem tenha curiosidade em saber o que está agora a alojar as imagens, costuma ser tudo o que é preciso. Forçar uma migração dos hábitos antigos raramente corre bem numa comunidade estabelecida, enquanto uma opção realmente mais rápida mesmo ao lado da caixa de texto tende a conquistar as pessoas por si só em poucas semanas.

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

Uma comparação rápida para ter à mão

Se os membros perguntarem porque é que o fórum deixou de permitir que cada um ligasse a imagens de onde quisesse, a resposta curta é fiabilidade. Um link gerado através do YourImageShare continua a funcionar porque a plataforma existe precisamente para alojar esse ficheiro a longo prazo, tal como o yourimageshare.com funciona para quem carrega diretamente pelo site. Um link para o sítio onde um membro tinha conta há cinco anos não tem essa garantia, e uma parte significativa das imagens antigas quebradas na web tem origem exatamente nesse padrão.

Se os membros do fórum também beneficiarem de carregar diretamente a partir de uma ferramenta de capturas de ecrã em vez de um ficheiro guardado, este artigo complementar explica como configurar as integrações com ShareX, Flameshot e Greenshot, que combinam bem com um plugin de fórum para quem documenta erros, partilha capturas de ecrã ou responde a pedidos de suporte com provas visuais.

Nada disto exige mexer no software base do fórum, o que importa a quem desconfia de tudo o que possa complicar futuras atualizações.

Se o que precisa é de uma referência sobre a formatação BBCode em si (e não do passo de carregar), consulte BBCodes, etiquetas HTML e frames incorporáveis. Para um carregamento em massa por script em vez de um plugin, consulte automatizar carregamentos com a API.