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ê.
O 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 (imagecreatefromstring, imagejpeg) 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:
- Baixe o arquivo
.zipdo módulo (link no final do artigo) - No painel: Sistema → Instalar → Extensões
- Arraste o
.zipe clique em Carregar & Instalar - Vá em Conteúdo → Módulos, localize o
mod_image_editore publique - 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
Send download link to: