Trusted WordPress tutorials, when you need them most.
Beginner’s Guide to WordPress
Copa WPB
25 Million+
Websites using our plugins
16+
Years of WordPress experience
3000+
WordPress tutorials
by experts

Como adicionar imagens de taxonomia (ícones de categoria) no WordPress

Nota editorial: Ganhamos uma comissão de links de parceiros no WPBeginner. As comissões não afetam as opiniões ou avaliações de nossos editores. Saiba mais sobre Processo editorial.

Deseja exibir imagens de taxonomia ou ícones de categoria no WordPress?

Por padrão, o WordPress não tem uma opção para carregar uma imagem de taxonomia ou um ícone de categoria. Ele simplesmente exibe um nome de categoria ou taxonomia nas páginas de arquivo.

Neste artigo, mostraremos como adicionar facilmente imagens de taxonomia ou ícones de categoria no WordPress. Também mostraremos como exibir imagens de taxonomia em suas páginas de arquivo.

Adding category icons or taxonomy images in WordPress

Por que adicionar imagens de taxonomia no WordPress?

Por padrão, seu site WordPress não vem com uma opção para adicionar imagens para suas taxonomias, como categorias e tags (ou qualquer outra taxonomia personalizada).

Ele simplesmente usa nomes de taxonomia em todos os lugares, inclusive nos arquivos de categoria ou nas páginas de arquivo de taxonomia.

Plain taxonomy archive page

Isso parece um pouco simples e sem graça.

Se você recebe muito tráfego de pesquisa para suas páginas de taxonomia, talvez queira torná-las mais atraentes.

A maneira mais fácil de tornar uma página mais interessante é adicionar imagens. Você pode adicionar imagens de taxonomia ou ícones de categoria para tornar essas páginas mais fáceis de usar e envolventes.

Um bom exemplo disso é um site como o NerdWallet, que usa ícones de categoria em seu cabeçalho:

Category Icons example Nerdwallet

Você também pode usá-lo para criar belas seções de navegação na sua página inicial, como o Bankrate:

Category Icon Navigation Blocks

Dito isso, vamos dar uma olhada em como adicionar facilmente imagens de taxonomia no WordPress.

Adicione facilmente imagens de taxonomia no WordPress

A primeira coisa que você precisa fazer é instalar e ativar o plug-in Categories Images. Para obter mais detalhes, consulte nosso guia passo a passo sobre como instalar um plug-in do WordPress.

Após a ativação, você pode simplesmente acessar a página Posts ” Categories. Você notará que o plug-in mostrará uma imagem de espaço reservado para as categorias existentes.

Default placeholder image

Para escolher seu próprio ícone de categoria, você precisa clicar no link Edit (Editar) abaixo de uma categoria.

Na página Editar categoria, role para baixo até a parte inferior e você encontrará um formulário para carregar sua própria imagem de taxonomia.

Upload new taxonomy image

Basta clicar no botão “Upload/Add New Image” (Carregar/Adicionar nova imagem) para carregar a imagem que você deseja usar para essa categoria específica.

Não se esqueça de clicar no botão Add Category (Adicionar categoria) ou Update (Atualizar) para salvar suas alterações.

Em seguida, você pode repetir o processo para carregar imagens para outras imagens de categoria. Você também pode carregar imagens para suas tags e quaisquer outras taxonomias.

Categories with thumbnail images

Agora, o problema é que, depois de adicionar as imagens, se você visitar uma página de categoria, não verá a imagem da categoria.

Para exibi-lo, você precisará editar seu tema ou tema filho do WordPress ou usar o plug-in WPCode para adicionar o código.

Mostraremos os dois métodos para que você possa escolher o que lhe parecer mais fácil.

Opção 1. Exibir ícones de imagem de categoria usando WPCode (recomendado)

Esse método é mais fácil porque você não precisa descobrir qual arquivo de tema deve ser modificado e pode adicionar o código com segurança sem danificar o site.

Também é recomendado para usuários que estejam usando um tema de bloco com suporte ao editor de sites.

Primeiro, você precisa instalar e ativar o plug-in WPCode. Para obter mais detalhes, consulte nosso tutorial sobre como instalar um plug-in do WordPress.

Após a ativação, vá para a página WPCode ” + Add Snippet e clique no botão Use Snippet na caixa ‘Add Your Custom Code (New Snippet)’.

WPCode Add new Snippet

Na próxima tela, dê ao snippet um título que o ajude a identificá-lo.

Depois disso, selecione o snippet PHP como seu tipo de código.

WPCode snippet type

Na caixa Code Preview (Visualização de código), copie e cole o seguinte trecho de código:

if( is_category() ) { ?> 
<div class="taxonomy-image">
<img class="taxonomy-img" src="<?php if (function_exists('z_taxonomy_image_url')) echo z_taxonomy_image_url(); ?>"  alt="" / >
</div>
<?php 
} else {  
//do nothing
} 

Em seguida, role para baixo até a seção Inserção e escolha Shortcode como o método de inserção.

Você perceberá que o WPCode mostrará automaticamente um shortcode. No entanto, para que seu shortcode seja fácil de lembrar, você também pode criar um shortcode personalizado.

Shortcode insertion method

Em seguida, clique no botão Copy (Copiar) no shortcode personalizado.

Agora você pode usar esse shortcode para exibir a imagem da categoria em suas páginas de arquivo.

Adição de código curto no Site Editor

Se estiver usando um tema de bloco com suporte ao editor de sites, vá para a página Appearance ” Editor para abrir o Site Editor.

Edit Archive template in Site Editor

Aqui, você pode adicionar um bloco de shortcode logo antes do bloco Archive Title.

Agora, cole o shortcode que você copiou anteriormente no bloco de shortcode.

Adding shortcode in site editor

Não se esqueça de salvar suas alterações para aplicá-las. Agora você pode visitar a página de arquivo da categoria para ver o shortcode em ação.

Não se preocupe se a imagem não estiver correta. Mais tarde, mostraremos como corrigi-la usando CSS personalizado.

Category icon shortcode preview

Opção 1. Exibir ícones de imagem de categoria manualmente

Para esse método, você precisará adicionar o código personalizado aos arquivos do tema do WordPress.

Se esta é a primeira vez que você edita arquivos do WordPress, consulte nosso guia sobre como copiar e colar código no WordPress.

Primeiro, você precisará se conectar ao seu site WordPress usando um cliente FTP ou o gerenciador de arquivos da sua hospedagem WordPress.

Depois de conectado, você precisará localizar o modelo responsável pela exibição dos arquivos de taxonomia. Pode ser os arquivos archives.php, category.php, tag.php ou taxonomy.php.

Para obter mais detalhes, consulte nosso guia sobre como encontrar os arquivos a serem editados em um tema do WordPress.

Depois de encontrar o arquivo, será necessário baixá-lo para o computador e abri-lo em um editor de texto como o Notepad ou o TextEdit.

Agora cole o código a seguir onde deseja exibir a imagem da taxonomia. Normalmente, você deve adicioná-lo antes do título da taxonomia ou da tag the_archive_title().

<?php if( is_category() ) { ?> 
<div class="taxonomy-image">
<img class="taxonomy-img" src="<?php if (function_exists('z_taxonomy_image_url')) echo z_taxonomy_image_url(); ?>"  alt="" / >
</div>
<?php 
} else {  
//do nothing
} 
?>

Depois de adicionar o código, você precisa salvar esse arquivo e carregá-lo de volta ao seu site usando o FTP.

Agora você pode visitar a página de arquivo da taxonomia para vê-la exibir a imagem da taxonomia. Veja como ficou em nossa página de arquivo de demonstração.

Category with image

Agora, ele ainda pode parecer um pouco estranho, mas não se preocupe. Você pode estilizar isso usando um pouco de CSS personalizado.

Estilização de ícones de categoria com CSS personalizado

Depois de adicionar o ícone de categoria ou as imagens de taxonomia ao seu tema do WordPress, a imagem pode não ficar muito boa.

Para corrigir isso, você precisará adicionar código CSS para alinhá-lo corretamente.

Se esta é a primeira vez que você adiciona código CSS no WordPress, dê uma olhada no nosso guia para iniciantes sobre como adicionar CSS personalizado no WordPress.

Aqui está o CSS personalizado que usamos para a imagem da taxonomia.

img.taxonomy-img {
    float: left;
    max-height: 100px;
    max-width: 100px;
    display: inline-block;
    padding: 20px;
}

Dependendo do tema, talvez também seja necessário estilizar os elementos adjacentes, como título do arquivo, título da taxonomia e descrição.

Simplesmente envolvemos o título e a descrição do nosso arquivo de taxonomia em um elemento <div> e adicionamos uma classe CSS personalizada. Em seguida, usamos o seguinte código CSS para ajustar o título e a descrição.

.taxonomy-title-description {
    display: inline-block;
    padding: 18px;
}

Veja como ficou depois em nosso site de teste.

After adding custom CSS

Excluir taxonomias da exibição de imagens de taxonomia

Agora, alguns usuários podem querer usar imagens de taxonomia somente para taxonomias específicas.

Por exemplo, se você administra uma loja on-line usando o WooCommerce, talvez queira excluir as categorias de produtos.

Basta voltar à página Categories Images (Imagens de categorias) na área de administração do WordPress e verificar as taxonomias que deseja excluir.

Exclude categories

Não se esqueça de clicar no botão Save Changes (Salvar alterações) para armazenar suas configurações.

Esperamos que este artigo tenha ajudado você a aprender como adicionar facilmente imagens de taxonomia no WordPress. Talvez você também queira ver esses hacks e plugins de categoria úteis para o WordPress ou ver nossas dicas sobre como obter mais tráfego dos mecanismos de pesquisa.

Se você gostou deste artigo, inscreva-se em nosso canal do YouTube para receber tutoriais em vídeo sobre o WordPress. Você também pode nos encontrar no Twitter e no Facebook.

Divulgação: Nosso conteúdo é apoiado pelo leitor. Isso significa que, se você clicar em alguns de nossos links, poderemos receber uma comissão. Veja como o WPBeginner é financiado, por que isso é importante e como você pode nos apoiar. Aqui está nosso processo editorial.

Avatar

Editorial Staff at WPBeginner is a team of WordPress experts led by Syed Balkhi with over 16 years of experience in WordPress, Web Hosting, eCommerce, SEO, and Marketing. Started in 2009, WPBeginner is now the largest free WordPress resource site in the industry and is often referred to as the Wikipedia for WordPress.

O kit de ferramentas definitivo WordPress

Obtenha acesso GRATUITO ao nosso kit de ferramentas - uma coleção de produtos e recursos relacionados ao WordPress que todo profissional deve ter!

Reader Interactions

27 ComentáriosDeixe uma resposta

  1. Syed Balkhi says

    Hey WPBeginner readers,
    Did you know you can win exciting prizes by commenting on WPBeginner?
    Every month, our top blog commenters will win HUGE rewards, including premium WordPress plugin licenses and cash prizes.
    You can get more details about the contest from here.
    Start sharing your thoughts below to stand a chance to win!

  2. Ivan says

    Any suggestions for any other up to date plugin. Looks like the one suggested here hasn’t been updated recently.

  3. Gabrielle says

    Hi,i’m currently using this plugin on localhost.
    I find a strange/interesting usage for this plugin:
    Extending default WP menu, for categories links,
    to show links with background images.
    Anyone knows how to integrate this plugin filter,
    into wp menu to return
    for each menu?
    The case is complicated, do i need to use Walker class?

  4. Jess says

    How do I display the images used in the front end? I have a listing page and want to display the taxonomy image when ever that page has that taxonomy outputted on the page. I can’t find anything that actually shows me how to display the image on the front end. All I see is the Taxonomy label outputted by not the image.

    Thanks for your help,

    Jess

  5. Harsha says

    Hi,
    The reason I ended in this post is I googled – featured content in wordpress

    I am actually looking at way, i can improve the related content in the wordpress.

    Because of selecting multiple categories and mutiple tags to posts, I see WordPress gets confused and does not show related content as I presume.

    So, Is taxonomies a way to improve how we show related posts, to the readers.

    And this plugin Taxonomy Images is not updated for 2 years

  6. JW says

    Great tutorial! Thank!

    Unfortunately it looks like this plugin isn’t supported anymore, do you know if there is an alternative?

    Or is the code still valid?

  7. Gonzalo says

    How to display pictures of taxonomies in the theme?

    I used the code but does not work
    print apply_filters( ‘taxonomy-images-queried-term-image’, ” );

    Please Help?

  8. Nicholas Worth says

    Would make more sense if title was, “Best Plugin for Adding Images to Taxonomy in WordPress”, cause this isn’t really a tutorial about how to add images to taxonomy. Don’t mean to be a downer but I hate coming to articles that claim information but in reality they are saying this other guy knows you were hoping to here.

      • Jacob Perl says

        I’m guessing what Nicholas thought was the same thing I thought when I found this article: that it would be a tutorial on how to add a custom image field to taxonomies manually via coding rather than with a plugin. Still the plugin looks cool…I might check it out.

        • Luís Felipe says

          The same thing i thought, i was searching for an article that shows how to code this instead using a plugin
          But this is a good article anyway.

  9. lemonthirst says

    I am delighted that i have found this great plugin, it works like a charm, i ran across some minor issues on my custom posts/taxonmy but all is well now.
    Thank you guys!

  10. Mattia says

    Hi, have a related question about custom taxonomies: how do you create a custom taxonomy that exists only inside a particular custom post type (like your “work” custom post type), without a plugin?
    My problem is that when I create a custom taxonomy, it appears to be also under the normal articles or the other custom post types…

  11. Banna says

    Hi,
    We are using this,
    But we cant get it work with cate ID.
    We have a Cat id we want display its thumbnail please help me to do this.

    how get thumbnail image using tax id

    Please let me know.

    Thank You
    Banna Daxxip

  12. Ruben Boehler says

    Sorry but i can get this plugin to work…no output. Maybe i do somehing wrong?!

    i use the plugin + this code and hooked it in:

    print apply_filters( ‘taxonomy-images-list-the-terms’, ”, array( ‘image_size’ => ‘detail’, ‘taxonomy’ => ‘company’, ‘after’ => ”, ‘after_image’ => ”, ‘before’ => ”, ‘before_image’ => ”, ) );

    iam getting absolutly no output … could you help me to figure it out?

  13. DanielPeiser says

    Sounds interesting! What if I have a few blog posts that don’t have a thumbnail image (or image in post), and there is always the same default image loaded as thumbnail in archive pages: Would the plugin load one associated to the category/tag?

    • wpbeginner says

      @DanielPeiser You can certainly set it so it does that. Basically the steps would be like: First check if post thumbnail exist… If it doesn’t exist, then check for taxonomy image… if that doesn’t exist either, then return default thumbnail.

Deixe uma resposta

Obrigado por deixar um comentário. Lembre-se de que todos os comentários são moderados de acordo com nossos política de comentários, e seu endereço de e-mail NÃO será publicado. NÃO use palavras-chave no campo do nome. Vamos ter uma conversa pessoal e significativa.