WordPress.org

Plugin Directory

Converter for Media – Otimização de imagens | Conversão para WebP e AVIF

Converter for Media – Otimização de imagens | Conversão para WebP e AVIF

Descrição

Acelere seu site usando nosso otimizador de imagem fácil, exibindo imagens WebP e AVIF. Ao substituir arquivos nos formatos JPEG, PNG e GIF padrão pelos formatos WebP e AVIF, você pode economizar mais da metade do peso da página sem perder a qualidade.

After installing the plugin, you can optimize your entire Media Library with a single click — no further action required. When image optimization finishes, every visitor will automatically receive new images with significantly reduced file sizes.

As of today, over 95% of users use browsers that support the WebP format. The loading time of your website depends to a large extent on its weight and the level of image optimization. Using our WebP Converter, now you can and speed up it in a few seconds without much effort!

Isso será um lucro tanto para seus usuários que não terão que baixar tantos dados, mas também para um servidor que ficará menos carregado. Lembre-se de que um site melhor otimizado também afeta sua classificação no Google. A otimização da imagem é muito importante.

Suporte AVIF

Now in the PRO version you can use AVIF as the output format for your images. The AVIF format is a new extension — is the successor to WebP. Images converted to the AVIF format weigh about 50% less than images converted only to the WebP format, while maintaining better image quality.

Enjoy peace of mind knowing that AVIF is supported by over 90% of browsers. And if any visitor has an older browser, our plugin will automatically fall back to WebP — so every user gets fast, high-quality images without a hitch.

Unlock the magic of AVIF in our PRO version — upgrade today for unparalleled image performance.

Como é que isso funciona?

Quando um navegador tenta carregar um arquivo de imagem, o plugin verifica se ele é compatível com o formato AVIF (se ativado nas configurações do plugin). Em caso afirmativo, o navegador irá receber o equivalente da imagem original no formato AVIF. Se não for compatível com AVIF, mas for compatível com o formato WebP, o navegador irá receber o equivalente à imagem original no formato WebP. Caso o navegador não seja compatível com WebP ou AVIF, a imagem original será carregada. Isso significa que há compatibilidade total com todos os navegadores.

Um guia sobre como testar se o plugin está funcionando corretamente pode ser encontrado aqui.

Informações adicionais

  • Se você acabou de instalar o plugin, poderá otimizar as imagens com um clique. O tamanho da imagem será menor após a geração de AVIF e WebP!
  • Novas imagens que serão adicionadas à biblioteca de mídia serão convertidas automaticamente.
  • Nosso otimizador de imagens não modifica suas imagens originais de forma alguma. Isso significa segurança para você e seus arquivos. Os arquivos convertidos para o formato AVIF e WebP são salvos em um diretório separado: /wp-content/uploads-webpc/.
  • Você não perde nada – se você tiver que remover o plugin, ele irá remover tudo depois. Não deixa nenhum rastro, portanto, você pode verificá-lo com facilidade.

Converta WebP e AVIF – este é o futuro da otimização de imagens!

Otimize imagens e eleve seu site a um novo nível agora! Instale o plugin e desfrute de um site que carrega mais rápido pela otimização de imagem. Certamente você e seus usuários vão gostar.

Converting images to WebP and AVIF simultaneously guarantees the lowest weight of your images and compatibility with all browsers. By using the AVIF format you will reduce the weight of your images even more compared to WebP.

Suporte para diretórios adicionais

Você pode converter WebP e AVIF e otimizar imagens não apenas do diretório /uploads, mas também dos diretórios /plugins e /themes. Isso permite a total integração com os formatos WebP e AVIF!

Development of the plugin

If you love our plugin, leave a ★★★★★ review on WordPress.org — it really makes our day and helps others discover it!

Leia também as Perguntas frequentes abaixo. Obrigado por estar conosco!

Capturas de tela

  • Aba Geral das configurações do plugin
  • Aba Avançado das configurações do plugin
  • Otimização em massa de imagens
  • Estatísticas de otimização da Biblioteca de mídia
  • Capacidade de desfazer manualmente a otimização da imagem selecionada

Instalação

  1. Envie os arquivos do plugin para o diretório /wp-content/plugins/webp-converter-for-media ou instale o plugin diretamente pela tela de plugins do WordPress.
  2. Ative o plugin através da tela Plugins no painel de administração do WordPress.
  3. Use a tela Configurações -> Configurações -> Converter for Media para configurar o plugin.
  4. Clique no botão Iniciar otimização em massa e aguarde.
  5. Verifique se tudo funciona bem usando este tutorial.

Isso é tudo! Seu site já está carregando mais rápido!

Perguntas frequentes

Como posso relatar erros de segurança?

Você pode relatar erros de segurança através do Programa de Divulgação de Vulnerabilidades da Patchstack. A equipe do Patchstack ajuda a validar, fazer a triagem e lidar com todas as vulnerabilidades de segurança.

Report a security vulnerability

Como obter suporte técnico? (antes de pedir ajuda)

Antes de adicionar um novo tópico, leia todas as outras perguntas nas Perguntas frequentes e outros tópicos no fórum de suporte primeiro. Talvez alguém tenha tido um problema semelhante e tenha sido resolvido.

Ao adicionar um tópico, siga estes passos e responda a cada um deles:

1. Você tem algum erro na página de configurações do plugin? Leia este tópico se tiver algum erro.

2. URL do seu site.

3. Captura de tela da aba Central de ajuda na tela de configurações do plugin – faça uma captura de tela de TODA a página.

4. Por favor, faça o teste, que está descrito nas Perguntas frequentes, na pergunta “Como verificar se o plugin funciona?”. Envie uma captura de tela do Devtools com os resultados do teste.

Lembre-se de incluir as respostas para todas as perguntas adicionando um tópico. É muito mais fácil e agiliza a solução do seu problema.

Configuração para Nginx

Se você estiver usando um servidor Nginx que não suporta regras .htaccess, é necessária configuração adicional no servidor Nginx para que o plugin funcione corretamente.

Leia este tutorial para obter mais informações.

Configuração do Proxy Nginx

Se você estiver usando um servidor Nginx que suporta regras .htaccess, mas ainda assim está enfrentando um erro de configuração do servidor na página de configurações do plugin, é necessária configuração adicional no servidor Nginx para que o plugin funcione corretamente.

Leia este tutorial para obter mais informações.

Erro na tela de configurações do plugin?

Se você tiver um erro na tela de configurações do plugin, antes de tudo, leia-o com atenção. Eles são exibidos quando há um problema com a configuração do seu servidor ou site.

As mensagens são projetadas para reduzir o número de solicitações de suporte repetidas. Economiza o seu e o nosso tempo. Leia este tópico para obter mais informações.

Erro ao converter?

Você pode obter vários tipos de erros durante a conversão. Em primeiro lugar, leia atentamente o seu conteúdo. Na maioria das vezes, você pode resolver esse problema sozinho. Tente fazer isso ou entre em contato com o administrador do servidor.

Se você receber um erro: Arquivo "%s" não existe. Verifique o caminho do arquivo. significa que a função file_exists() em PHP retornou false usando o caminho de arquivo fornecido na mensagem de erro. Verifique este caminho e certifique-se de que está correto.

Se você receber um erro: O arquivo "%s" está ilegível. Verifique as permissões do arquivo. significa que a função is_readable() em PHP retornou false usando o caminho de arquivo fornecido na mensagem de erro. Verifique as permissões do arquivo e o diretório no qual o arquivo está localizado.

Se você receber um erro: "%s" não é um arquivo de imagem válido. significa que o arquivo está danificado de alguma forma. Baixe o arquivo para o disco, salve-o novamente usando qualquer programa gráfico e adicione-o novamente à página. Se o erro se aplicar a imagens individuais, então ignore – apenas as imagens originais serão carregadas, não o WebP.

Se você receber um erro: A imagem "%s" convertida em .webp é maior que o original e o arquivo .webp convertido foi excluído. significa que a imagem original pesava menos que WebP. Isso acontece quando as imagens foram compactadas antes. Desative a opção “Remoção automática de arquivos em formatos de saída maiores que o original” nas configurações do plugin para forçar sempre o uso do WebP.

Quais são os requisitos do plugin?

Praticamente todas as hospedagens atendem a esses requisitos. Você deve usar PHP no mínimo 7.0 e ter a extensão GD ou Imagick instalada. A extensão deve suportar formato WebP. Se você tiver um erro dizendo que a biblioteca GD ou Imagick não está instalada, mas você a instalou, provavelmente eles estão configurados incorretamente e não tem suporte WebP.

São extensões nativas do PHP necessárias, usadas entre outros pelo WordPress para gerar miniaturas. Seu servidor também deve ter os módulos mod_mime, mod_rewrite e mod_expires ativados.

Um exemplo da configuração correta do servidor pode ser encontrado aqui. O link para sua configuração atual pode ser encontrado na aba Central de ajuda na tela de configurações do plugin.

Observe os itens marcados em vermelho. Se os valores marcados em vermelho não aparecerem no seu caso, significa que seu servidor não atende aos requisitos técnicos. Preste atenção ao valor WebP Support para a biblioteca GD e WEBP na lista de extensões suportadas para a biblioteca Imagick.

Em uma situação em que seu servidor não atenda aos requisitos técnicos, entre em contato com o administrador do servidor. Não podemos ajudá-lo. Não nos contate sobre este assunto, porque este é um problema de configuração do servidor, não do plugin.

Além disso, a API REST deve estar habilitada e funcionar sem restrições adicionais. Se você tiver algum problema com ele, entre em contato com o desenvolvedor que criou seu site. Ele deve encontrar facilmente o problema com a API REST não funcionando.

Como verificar se o plugin funciona?

Você pode encontrar mais informações sobre como o plugin funciona em nosso manual.

Como alterar o caminho para uploads?

Isso é possível usando os seguintes tipos de filtros para alterar os caminhos padrão. É uma solução para usuários avançados. Se não for, pule esta pergunta.

Caminho para o diretório de instalação raiz do WordPress (ABSPATH por padrão):

add_filter( 'webpc_site_root', function( $path ) {
    return ABSPATH;
} );

Caminhos para diretórios (relativo ao diretório raiz):

add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'wp-content/uploads';
        case 'webp':
            return 'wp-content/uploads-webpc';
        case 'plugins':
            return 'wp-content/plugins';
        case 'themes':
            return 'wp-content/themes';
    }
    return $path;
}, 10, 2 );

Observe que o diretório /uploads-webpc deve estar no mesmo nível de aninhamento que /uploads, /plugins e /temas diretórios.

Prefixo na URL do diretório /wp-content/ ou equivalente (usado em .htaccess):

add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );

Para o seguinte exemplo de estrutura personalizada do WordPress:

...
├── web
    ...
    ├── app
    │   ├── mu-plugins
    │   ├── plugins
    │   ├── themes
    │   └── uploads
    ├── wp-config.php
    ...

Use os seguintes filtros:

add_filter( 'webpc_site_root', function( $path ) {
    return 'C:/WAMP/www/project/web'; // your valid path to root
} );
add_filter( 'webpc_htaccess_rewrite_path', function( $prefix ) {
    return '/';
} );
add_filter( 'webpc_dir_name', function( $path, $directory ) {
    switch ( $directory ) {
        case 'uploads':
            return 'app/uploads';
        case 'webp':
            return 'app/uploads-webpc';
        case 'plugins':
            return 'app/plugins';
        case 'themes':
            return 'app/themes';
    }
    return $path;
}, 10, 2 );

Depois de definir os filtros, vá para Configurações -> Converter for Media no painel de administração e clique no botão Salvar alterações. Arquivos .htaccess com regras apropriadas devem ser criados nos diretórios /uploads e /uploads-webpc.

Como excluir caminhos da conversão?

Para excluir diretórios selecionados, forneça-os no campo Diretórios excluídos na aba “Configurações avançadas” nas configurações do plugin.

Neste campo, você pode digitar um nome de diretório ou caminho. Aqui estão alguns exemplos:
2023
2024/01
2023,2024/01

Para excluir arquivos selecionados, use o seguinte filtro (neste caso, com o sufixo “-skipped” em um nome de arquivo, por exemplo, image-skipped.png):

add_filter( 'webpc_supported_source_file', function( bool $status, string $file_name, string $server_path ): bool {
    $excluded_suffix = '-skipped';
    if ( strpos( $file_name, $excluded_suffix . '.' ) !== false ) {
        return false;
    }
    return $status;
}, 10, 3 );

O argumento $server_path é o caminho absoluto do servidor para um diretório ou arquivo. Dentro dos filtros, você pode aplicar regras mais complicadas conforme necessário.

As alterações nos diretórios e arquivos excluídos entram em vigor antes da conversão das imagens – elas não afetam as imagens já convertidas. Estas imagens precisam ser removidas manualmente do diretório: /wp-content/uploads-webpc/.

Suporte para diretórios personalizados

O plugin suporta os seguintes diretórios por padrão:
/gallery
/plugins
/themes
/uploads

Se você deseja adicionar suporte para um diretório personalizado, adicione o seguinte código ao arquivo functions.php no diretório do seu tema (use um nome de diretório correto em vez de custom-directory):

add_filter( 'webpc_source_directories', function ( $directories ) {
    $directories[] = 'custom-directory';
    return $directories;
} );

Lembre-se que este diretório deve estar localizado no diretório /wp-content.

Como executar a conversão manualmente?

Por padrão, todas as imagens são convertidas quando você clica no botão Iniciar otimização em massa. Além disso, a conversão é automática quando você adiciona novos arquivos à sua Biblioteca de mídia.

Lembre-se que nosso plugin leva em consideração as imagens geradas pelo WordPress. Existem muitos plugins que geram, por exemplo, imagens de tamanho diferente ou em versão diferente.

Se você gostaria de integrar com seu plugin, que gera imagens por conta própria, você pode fazê-lo. Nosso plugin oferece a possibilidade desse tipo de integração. Isso funciona para todas as imagens no diretório /wp-content.

É uma solução para usuários avançados. Se você deseja integrar com outro plugin, é melhor entrar em contato com o autor desse plugin e fornecer a ele informações sobre as ações disponíveis em nosso plugin. Isso ajudará você a encontrar uma solução mais rapidamente.

Você pode executar manualmente a conversão dos arquivos selecionados, pode usar a ação para a qual passará um array com uma lista de caminhos (eles devem ser caminhos absolutos do servidor):

do_action( 'webpc_convert_paths', $paths, true );

Um método alternativo é iniciar manualmente a conversão do anexo selecionado, passando o ID do post da Biblioteca de mídia. Lembre-se de executar esta ação após registrar todos os tamanhos de imagem (ou seja, após executar a função add_image_size):

do_action( 'webpc_convert_attachment', $post_id, true );

Para excluir arquivos convertidos manualmente, use a seguinte ação, fornecendo como argumento uma matriz de caminhos de servidor absolutos para os arquivos (isso excluirá os arquivos convertidos manualmente):

do_action( 'webpc_delete_paths', $paths );

Suporte para WP-CLI

O plugin suporta WP-CLI, que permite uma conversão de imagem mais rápida no nível do servidor. Mais informações sobre como começar a usar o WP-CLI podem ser encontradas no Manual. Os comandos suportados são descritos abaixo.

Verificando quantas imagens máximas para conversão existem no site:

wp converter-for-media calculate

Convertendo todas as imagens:

wp converter-for-media regenerate

Convertendo todas as imagens (com a opção “Forçar a conversão de todas as imagens novamente”):

wp converter-for-media regenerate --force

O plugin suporta CDN?

Os arquivos do site (arquivos WordPress) e as imagens da Biblioteca de mídia devem estar no mesmo servidor. Se estiverem, tudo deve funcionar bem.

Se apenas suas imagens estiverem em outro servidor CDN, infelizmente a operação correta é impossível, porque essas imagens são gerenciadas por outro servidor.

Lista atual de servidores CDN suportados:
– BunnyCDN (consulte as instruções antes de usar)

Avaliações

13 junho, 2025
Worked Very Well – Beautiful User Interface! All Webp images are (free) Cloudflare Cache Status HIT! I did modify your output a bit in both .htaccess files and added my own cache control in the root… [ Header set Cache-Control “public, max-age=31536000, immutable” ] Really nice plugin! 6-Stars (if only allowed)
13 junho, 2025
Good plugin, I use the paid version on many websites on different servers, which often causes problems when files not converted correctly. With the paid version I can use a remote server set up for this job. Never had problems with that, saved a lot of time. Paid also offers AVIF and is affordable.
11 junho, 2025
Es un buen plugin, funciona bien y no muestra problemas de configuración como muchos otros. Gracias <font _mstmutation=”1″></font>
9 junho, 2025
Great plugin. Even the free version with only the WebP option works well and saves a lot of bytes on the page
30 maio, 2025
Had a minor issue (caused by me rather than the plugin). Emailed the team and had a response very quickly. They went above and beyond to solve this for me which they did quickly. Plugin has really helped the speed of the site.
Leia todas as 1.036 avaliações

Colaboradores e desenvolvedores

“Converter for Media – Otimização de imagens | Conversão para WebP e AVIF” é um programa de código aberto. As seguintes pessoas contribuíram para este plugin.

Colaboradores

Converter for Media – Otimização de imagens | Conversão para WebP e AVIF” foi traduzido para 21 localidades. Agradecemos aos tradutores por suas contribuições.

Traduzir o “Converter for Media – Otimização de imagens | Conversão para WebP e AVIF” para seu idioma.

Interessado no desenvolvimento?

Navegue pelo código, consulte o repositório SVN ou assine o registro de desenvolvimento por RSS.

Registro de alterações

6.2.2 (2025-04-29)

  • [Segurança] Atualização do cliente HTTP Axios

6.2.1 (2025-04-01)

  • [Corrigido] Tratamento dos diretórios excluídos ao enviar novas imagens
  • [Adicionado] Detecção de erro de funções necessárias na lista disable_functions na configuração do PHP
  • [Adicionado] Suporte para WordPress 6.8

6.2.0 (2024-12-18)

  • [Alterado] Versão mínima exigida do PHP de 7.0 para 7.1
  • [Adicionado] Compatibilidade com PHP 8.4

6.1.3 (2024-11-19)

  • [Corrigido] Traduções no cadastro de comandos para WP-CLI
  • [Adicionado] Suporte ao WordPress 6.7

6.1.2 (2024-10-26)

  • [Corrigido] Remoção de arquivos convertidos após a desinstalação do plugin

6.1.1 (2024-10-02)

  • [Alterado] Otimização em massa da seção de imagens

6.1.0 (2024-09-13)

  • [Removido] Filtro webpc_supported_source_directory
  • [Corrigido] Tratamento dos diretórios excluídos ao enviar novas imagens
  • [Corrigido] Tratamento dos nomes de arquivos excluídos ao enviar novas imagens
  • [Corrigido] Adicionado suporte para diretórios personalizados usando o filtro “webpc_source_directories”
  • [Corrigido] Verificação do erro de configuração do servidor “rewrites_not_working” quando o referenciador HTTP é necessário

6.0.0 (2024-08-28)

  • [Corrigido] Geração de estatísticas na página de configurações do plugin quando o formato WebP estava desmarcado
  • [Corrigido] Restauração das imagens originais na biblioteca de mídia
  • [Alterado] Estatísticas de otimização na biblioteca de mídia
  • [Adicionado] Alertas com explicações no campo de configurações do plugin: Modo de carregamento de imagem

Consulte changelog.txt para versões anteriores.