# 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… - Página: - Idioma: pt - Atualizado em: 2026-09-02 - Outros idiomas: [fr](https://www.datafirefly.com/documentation/webp-avif-pro/index.md), [en](https://www.datafirefly.com/en/documentation/webp-avif-pro/index.md), [es](https://www.datafirefly.com/es/documentation/webp-avif-pro/index.md), [de](https://www.datafirefly.com/de/documentation/webp-avif-pro/index.md), [it](https://www.datafirefly.com/it/documentation/webp-avif-pro/index.md), [pl](https://www.datafirefly.com/pl/documentation/webp-avif-pro/index.md), [nl](https://www.datafirefly.com/nl/documentation/webp-avif-pro/index.md) - Índice: 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). Em alojamento partilhado, o AVIF nem sempre está disponível. Ative o recuo automático para WebP (ver mais abaixo) para garantir uma conversão em todos os casos. ## 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. Faça uma cópia de segurança da base de dados e dos ficheiros antes de um primeiro processamento em massa. Verifique que a opção de cópia dos originais está ativa para poder voltar atrás. ### 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. O modo «conservar» é o mais seguro para o AVIF, para a multimédia externa (CDN/S3) e para os construtores de páginas, porque nunca altera o ficheiro de origem nem a base de dados. ## 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. O plugin não tem subscrição, mas cada chamada à IA é faturada pelo seu fornecedor consoante a sua chave de API. A geração em lote avança em pequenos pacotes para respeitar os limites de débito. ## 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. O plugin é compatível com WordPress 6.5+, WooCommerce (HPOS), Polylang, multisite e PHP 8.1 a 8.3.