Introdução
O Lithio é o serviço de otimização de imagens da GoCache.
Informações importantes
O Lithio funciona somente em conjunto com a CDN, por esta razão é necessário a configuração da CDN GoCache antes da ativação da otimização de imagens (Veja como fazer a configuração inicial da CDN GoCache).
O uso do Lithio incorre em cobranças adicionais, verifique os valores disponíveis na página de planos.
Ativação inicial
As configurações de otimização de imagens somente estão disponíveis no painel GoCache após o aceite dos termos de uso.
Para fazer o aceite siga os seguintes passos:
- Acesse no painel GoCache a página de Configurações de qualquer um de seus domínios.
- Acesse a aba Performance e na seção "Lithio - Otimização de Imagens" você verá a opção de aceitar os termos de uso.
- Após ler e concordar com os termos, digite "concordo" na caixa de texto central e clique no botão "Confirmar".
Após o aceite inicial, a otimização de imagens estará disponível para todos os domínios de sua conta. O aceite precisa ser feita apenas uma vez.
Critérios gerais de otimização de imagens
Independente de configurações, para a otimização de imagens ser efetiva, as imagens deverão obedecer os seguintes critérios:
- Tamanho máximo de 1,5 MB (1536 KB). Imagens maiores não são otimizadas.
- O cache deve estar ativado para a imagem. Imagens em caminhos com o cache desativado não são otimizadas.
- Imagem não deve estar previamente otimizada. Se o otimizador detectar que a imagem já está suficientemente otimizada, a imagem original é exibida.
- Em alguns casos de configurações de qualidade alta ou original, a imagem otimizada possui baixa variação de distinção em relação a imagem original e neste caso a imagem original é exibida.
Formato e extensões de imagens
A otimização de imagens atua em imagens no formato JPEG, PNG e GIF. Para que uma imagem seja otimizada, a url da imagens deve (antes da query string) terminar com uma das seguintes extensões de arquivo:
- .jpg
- .jpeg
- .png
- .gif
Imagens em urls sem extensão ou com extensão diferente das definidas acima podem ser otimizadas através de Smartrules.
Identificação de imagens otimizadas
Todas as imagens que passam pelo Lithio são servidas com o cabeçalho "X-GoCache-Image". O valor do cabeçalho indica se o estado da otimização e pode ter os seguintes valores:
| Valor | Descrição |
|---|---|
optimized | A imagem foi otimizada com sucesso |
unmodified | A imagem não foi otimizada e esta imagem é a imagem original |
Configurações
A configuração geral do Lithio está disponível no painel GoCache, na página de Configurações, dentro da aba Performance.
As opções da configuração geral são aplicadas somente ao domínio atual e obedecem os Critérios gerais de otimização de imagens.
Ativar a otimização de imagens
Permite ativar a otimização para imagens JPEG, PNG e GIF para o domínio atual.
As imagens são otimizadas baseadas na extensão do arquivo e é feita somente para imagens que possam ser cacheadas (imagens em áreas com cache desativado não serão otimizadas).
As imagens otimizadas são armazenadas em versão diferente das imagens originais, então ao ativar a otimização de imagens, as imagens serão otimizadas imediatamente. Na desativação, as imagens originais em cache serão servidas imediatamente.
Otimizar para WebP
Ativar o suporte para otimizar imagens para o formato WebP.
O formato WebP é um novo formato de imagens desenvolvido pela Google que é otimizado especificamente para a WEB e resulta em imagens menores.
Este formato é suportado por alguns navegadores. Caso o acesso seja feito por um navegador que não suporta WebP, a conversão não ocorre e a imagem é otimizada em seu formato original.
Otimizar para JPEG progressivo
Ativa o suporte para otimizar JPEGs para o formato progressivo.
No formato progressivo, a imagem é compactada em múltiplas linhas de varredura, permitindo que para conexões lentas a imagem seja carregada gradualmente a partir de uma resolução menor.
Remover metadados
Ativa a remoção de metadados de imagens, que diminui o tamanho da imagem otimizada.
Os metadados contém informações adicionais sobre as imagens que não são necessárias para a apresentação em websites.
Os metadados geralmente são gerados pelos dispositivos e programas nos quais as imagens foram criadas.
Nível de compressão
Define o nível geral da compressão efetuada pelo Lithio.
O nível identifica quão menor a imagem deverá ficar após a otimização. Com o nível configurado, imagens JPEG e GIF podem ter sua qualidade alterada.
Nível Alto
Imagens serão otimizadas com objetivo de obter uma imagem do menor tamanho possível. A qualidade de imagem pode ser diminuída.
Nível Médio
Imagens serão otimizadas com objetivos de obter uma imagem de tamanho menor porém sem perder muita qualidade. A qualidade de imagem pode ser diminuída.
Nível Baixo
Imagens serão otimizadas com objetivo de mantê-las próximas à qualidade original. A qualidade da imagem pode ser diminuída levemente.
Sem Compressão
Tenta otimizar as imagens sem alterar a qualidade.
Customização
Smartrules
As configurações de otimização de imagens estão disponíveis como ações de smartrules, permitindo a criação de exceções e configurações customizadas para áreas específicas de um site de acordo com os critérios definidos nas regras.
API
A API de otimização de imagens está disponível somente após a ativação através do painel GoCache.
A API para alteração e consulta de de otimização de imagens utiliza os seguintes endpoints:
- Configuração geral do domínio: endpoint da API de domínios
- Configuração através de smartrule: endpoint da API de Smartrules
Ambos endpoints utilizam os seguintes parâmetros de configuração:
| Parâmetro | Valores | Descrição |
|---|---|---|
image_optimize | true ou false | Determina se a otimização de imagens está ligada (true) ou desligada (false) |
image_optimize_webp | true ou false | Determina se a conversão de imagens para WebP está ligada (true) ou desligada (false) |
image_optimize_metadata | true ou false | Determina se a remoção de metadados está ligada (true) ou desligada (false) |
image_optimize_progressive | true ou false | Determina se a conversão de JPEG para o formato progressivo está ligada (true) ou desligada (false) |
image_optimize_level | Número na faixa 0-100 | Determina o nível de compressão, sendo 1 a maior compressão (menor qualidade) e 100 a menor compressão (maior qualidade). O valor zero (0) permite desligar a compressão (evita alterar a qualidade). Os valores pré-estabelecidos correspondem aos seguintes níveis:
|
Casos de Uso
Desativar otimização para um diretório
Para fazer exclusão (ou customizar os parâmetros) da otimização de imagens, você pode criar uma smartrule que desativa a otimização de imagens.
Para a criação das regras, siga os seguintes passos:
- Acesse o domínio em seu painel GoCache
- Acesse a página de Smart Rules
- Na aba Geral, crie uma nova SmartRule.
- No critério URL coloque a uri do diretório que deseja desativar a otimização.
- Nas ações, selecione a ação Otimização de imagens com o valor Desligado.
- Salve e ative a SmartRule
Aumentar o nível de compressão de imagens para dispositivos mobile
É possível utilizar uma SmartRule para aumentar o nível de compressão para dispositivos mobile.
Para a criação das regras, siga os seguintes passos:
- Acesse o domínio em seu painel GoCache
- Acesse a página de Smart Rules
- Na aba Geral, crie uma nova SmartRule.
- No critério Tipo de Dispositivo, selecione a opção Mobile.
- Nas ações, selecione a ação Nível de compressão com o valor Alto.
- Salve e ative a SmartRule
Resolução de Problemas
Por que uma imagem não foi otimizada?
A otimização de imagens depende de algumas condições para que seja efetuada, você pode consultar a lista de condições em Critérios gerais de otimização de imagens.