WebP AVIF Pro: guia completo

O WebP AVIF Pro converte e comprime as imagens da sua biblioteca de multimédia para WebP ou AVIF, localmente, sem subscrição nem quotas. Este guia cobre a instalação, os dois modos de entrega, a geração de texto ALT por IA, o SEO de imagens, o processamento por lotes, a execução em segundo plano com WP-Cron e WP-CLI, bem como a cópia de segurança e a resolução de problemas.

Requisitos do servidor

O plugin funciona com um dos dois motores de imagem do PHP:

• Imagick compilado com libheif (AVIF) e suporte de WebP, recomendado;
• GD com as funções imagewebp() e imageavif() (PHP 8.1 ou superior).

A página Definições do plugin mostra indicadores com os motores e formatos realmente disponíveis no seu alojamento (Imagick, GD, WebP, AVIF).

Instalação

1. Carregue a pasta df-webp-avif-pro para /wp-content/plugins/ (ou instale o ZIP a partir de Plugins e depois Adicionar).
2. Ative a extensão a partir do menu Plugins.
3. Vá a WebP AVIF Pro e depois Definições para configurar o formato, o modo de entrega, a mudança de nome e a IA.
4. Lance uma análise (simulação) e depois a otimização a partir da página Otimização.

Formato de saída e compressão

Escolha WebP (compatibilidade máxima) ou AVIF (compressão superior). Opções principais:

• Recuo automático para WebP: se for pedido AVIF mas este não estiver disponível, o plugin produz WebP em vez de falhar.
• Qualidade: de 1 a 100, recomendado entre 78 e 85.
• Redimensionamento: limita o lado maior a um valor em píxeis (0 = desativado). Apenas no modo «substituir».
• Remoção de EXIF/ICC: retira os metadados para aligeirar os ficheiros.
• Ignorar os GIF animados: evita estragar as animações.

Modos de entrega

O WebP AVIF Pro propõe duas estratégias, a escolher consoante o seu contexto.

Substituir

O ficheiro de origem é convertido, eventualmente renomeado, e todas as referências (conteúdo dos artigos, metadados) são reescritas para o novo ficheiro. Os originais ficam guardados para permitir um restauro.

Conservar o original (não destrutivo)

É gerado um ficheiro de nova geração ao lado do original (por exemplo foto.jpg e foto.jpg.webp). Na apresentação, o plugin serve a versão de nova geração apenas aos navegadores que a aceitam, graças ao cabeçalho Accept; os outros recebem o original. Não é necessária qualquer regra htaccess.

Mudança de nome para SEO

Estão disponíveis quatro modos de mudança de nome dos ficheiros: nenhum, nome do produto (WooCommerce), modelo personalizado, ou base64 (anonimização). O modo modelo aceita tokens:

• {product} {title} {sku} {cat} {alt} {id} {date} {n}

Exemplo: {product}-{cat}-{n} produz um nome de ficheiro do tipo tapete-personalizado-entrada-a1b2c3.webp. A mudança de nome não se aplica no modo «conservar o original».

Texto ALT por IA

O WebP AVIF Pro gera atributos ALT descritivos por IA, em vários idiomas, a partir do visual e do contexto do produto.

1. Ative a IA nas Definições, escolha um fornecedor (Anthropic, OpenAI, Gemini ou Mistral em análise visual, ou DeepSeek apenas por contexto) e indique a sua chave de API.
2. Selecione os idiomas pretendidos. O primeiro idioma assinalado alimenta o ALT principal; os outros são sincronizados com as traduções Polylang, se existirem.
3. Gere os ALT a partir da página ALT IA (em lote), automaticamente no carregamento, ou imagem a imagem através da ação «Gerar ALT (IA)» da biblioteca de multimédia.

SEO no front-end

• Dimensões anti-CLS: acrescenta os atributos width e height às imagens do conteúdo que não os têm, para limitar o desvio de esquema (Core Web Vitals).
• Schema ImageObject: emite um bloco JSON-LD nas páginas e fichas de produto (imagem de destaque e galeria do WooCommerce).

Otimização em lote

A partir da página Otimização:

• Analisar (simulação): estima o ganho numa amostra, sem alterar nada.
• Otimizar toda a biblioteca: trata as imagens por lotes, sem bloquear o servidor. Pode sair da página e voltar a lançar mais tarde; o processamento retoma onde ficou.

Os cartões de estatísticas mostram o número de imagens convertidas, o espaço poupado e um histórico mensal.

Segundo plano (WP-Cron) e WP-CLI

Nas bibliotecas grandes, ative o processamento em segundo plano: o plugin otimiza um lote a cada 5 minutos através do WP-Cron, sem manter um separador aberto. As agências também podem comandar o plugin na linha de comandos:

wp df-wap status
wp df-wap optimize --batch=20
wp df-wap optimize --dry-run
wp df-wap alt --batch=10
wp df-wap restore --yes

Cópia de segurança, limpeza e restauro

No modo «substituir», os originais são copiados para /wp-content/uploads/df-wap-backups/ (pasta protegida). Pode:

• Restaurar uma imagem (ação da biblioteca de multimédia) ou toda a biblioteca (botão «Restaurar tudo»).
• Limpar automaticamente as cópias de segurança depois de um número de dias definido, para recuperar espaço em disco.

No modo «conservar», o restauro elimina simplesmente os ficheiros de nova geração; os originais nunca foram alterados.

Diagnósticos

A página Otimização mostra avisos contextuais: presença de um módulo de externalização da multimédia (S3/CDN), construtores de páginas detetados, AVIF pedido mas indisponível, ou pouco espaço em disco. Siga estas recomendações antes de um processamento em massa.

Resolução de problemas

• AVIF indisponível: ative o recuo para WebP, ou mude o formato de saída para WebP. A página Definições indica os motores disponíveis.
• Imagens não substituídas num construtor de páginas: alguns URL guardados pelos builders escapam à reescrita. Prefira o modo «conservar o original».
• ALT não gerados: verifique que a IA está ativa, que a chave de API é válida e que ainda há crédito no fornecedor.
• O processamento em lote parece lento: reduza o número de imagens por lote (o AVIF é exigente), ou use o segundo plano / WP-CLI.