Se você usa Joomla e já precisou que um cliente ou colaborador fizesse o upload de uma imagem no site com o mínimo de esforço — sem abrir o Gerenciador de Mídia, sem precisar de Photoshop, sem sair da página — esse módulo foi feito para você.

mod_image_editor é um módulo Joomla totalmente gratuito e open source, compatível com Joomla 4 e 5, que entrega uma experiência completa de upload e edição de imagens direto no navegador.


O que ele faz?

Assim que o módulo é publicado em qualquer posição do seu template, o usuário vê uma área de upload simples e intuitiva. Ele pode clicar para selecionar uma imagem ou simplesmente arrastar e soltar um arquivo JPG, PNG, GIF ou WebP direto na tela.

Depois do upload, um editor completo abre automaticamente com tudo o que o usuário precisa para preparar a imagem antes de salvar no servidor:

  • Recorte livre ou em proporção fixa — Livre, 1:1, 16:9, 4:3, 3:4, 9:16
  • Zoom com slider de 10% a 300%
  • Rotação 90° para esquerda ou direita
  • Espelhamento horizontal e vertical
  • Dimensões manuais do recorte em pixels (W × H)
  • Pré-visualização em tempo real do recorte enquanto edita
  • Salvar no servidor com um clique via AJAX (sem recarregar a página)

Tudo isso sem sair do Joomla, sem instalar nada além do próprio módulo, e sem depender de serviços externos.


Por dentro da tecnologia

O módulo usa a biblioteca Cropper.js 1.6.2, uma das mais sólidas e mantidas bibliotecas JavaScript de edição de imagem do mundo open source. Ela cuida de toda a parte visual — canvas, recorte, zoom, rotação — com uma API limpa e bem documentada.

No lado do servidor, o PHP recebe a imagem já recortada em formato base64 via requisição AJAX, converte para JPEG usando as funções nativas GD do PHP (imagecreatefromstringimagejpeg) e grava no servidor com nome único gerado automaticamente. Se você configurou uma largura máxima nos parâmetros do módulo, o redimensionamento acontece automaticamente antes de salvar.

A segurança segue o padrão do próprio Joomla: o token CSRF é gerado pelo Session::getFormToken() e validado no servidor com Session::checkToken('request'), que verifica tanto parâmetros GET quanto POST — solução robusta para o ambiente assíncrono do com_ajax.


Como instalar

A instalação é idêntica a qualquer extensão Joomla:

  1. Baixe o arquivo .zip do módulo (link no final do artigo)
  2. No painel: Sistema → Instalar → Extensões
  3. Arraste o .zip e clique em Carregar & Instalar
  4. Vá em Conteúdo → Módulos, localize o mod_image_editor e publique
  5. Configure os 3 parâmetros disponíveis:
Parâmetro Descrição Padrão
Pasta de Upload Caminho relativo à raiz do site images/uploads
Largura Máxima (px) Redimensiona automaticamente ao salvar. 0 = sem limite 1920
Tamanho Máximo (KB) Limite de tamanho do arquivo antes do upload 5120

Depois disso é só posicionar o módulo onde quiser no template. Ele funciona em qualquer posição.


Para quem é esse módulo?

  • Agências que entregam sites Joomla para clientes e precisam de uma solução simples de upload sem treinar o cliente no Gerenciador de Mídia
  • Sites de anúncios ou portais onde o usuário cadastrado precisa enviar foto do produto ou perfil
  • Intranets e sistemas internos onde colaboradores precisam fazer upload de imagens documentos
  • Desenvolvedores que querem um ponto de partida sólido para construir algo mais completo

Requisitos

  • Joomla 4.x ou 5.x
  • PHP 7.4+ com extensão GD habilitada (padrão na grande maioria dos servidores)
  • jQuery (incluído por padrão no Joomla)
  • Permissão de escrita na pasta de destino do servidor

É realmente gratuito?

Sim. Sem limite de uso, sem versão “Pro”, sem assinatura, sem marca d’água. O código é aberto — você pode modificar, adaptar e usar em qualquer projeto comercial ou pessoal.

Se o módulo te ajudar, compartilha esse post com outros desenvolvedores Joomla. A comunidade cresce quando a gente compartilha o que constrói. 🚀


Download: InsiraaquiolinkdoGitHuboudoseusiteInsiraaquiolinkdoGitHuboudoseusite
Compatibilidade: Joomla 4 e 5
Licença: GPL v2 ou posterior
Dependência: Cropper.js 1.6.2 (carregada via CDN, zero configuração)

Modulo Edição de Imagens

FREE DOWNLOAD

Send download link to: