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 metadados do Facebook Open Graph em temas do 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 adicionar metadados do Facebook Open Graph aos seus temas do WordPress?

Os metadados do Open Graph ajudam o Facebook e outros sites de mídia social a obter informações sobre suas publicações e páginas do WordPress. Eles também permitem que você controle como seu conteúdo é exibido quando compartilhado no Facebook.

Neste artigo, mostraremos a você como adicionar facilmente metadados do Facebook Open Graph em temas do WordPress.

Add Facebook open graph meta data in any WordPress theme

Compartilharemos três métodos diferentes para que você possa escolher o que funciona melhor para o seu site WordPress:

Método 1: Adicionar metadados do Facebook Open Graph com o AIOSEO

OAll in One SEO é um popular plugin de SEO para WordPress usado por mais de 3 milhões de sites. Ele permite que você otimize facilmente seu site para mecanismos de pesquisa, bem como para plataformas sociais como Facebook e Twitter.

Primeiro, você precisa instalar e ativar o plug-in gratuito All in One SEO. Para obter mais detalhes, consulte nosso guia passo a passo sobre como instalar um plug-in do WordPress.

Após a ativação, você precisa visitar a página All in One SEO ” Social Networks (Redes sociais ). Aqui, você pode inserir o URL da sua página do Facebook e de todas as suas outras redes sociais.

AIOSEO social network settings

Em seguida, clique na guia Facebook, na parte superior da página, e você verá que a marcação do Open Graph está ativada por padrão.

Você pode clicar no botão “Carregar ou selecionar imagem” para escolher uma imagem padrão do Facebook OG se um artigo não tiver uma imagem do Open Graph.

Set default Open Graph image

Se você rolar a tela para baixo, poderá personalizar o nome do site, a descrição e outras configurações. Não se esqueça de clicar no botão azul “Salvar alterações” quando terminar.

Agora que você definiu metatags do Open Graph em todo o site, a próxima etapa é adicionar metadados do Open Graph para posts e páginas individuais.

Por padrão, o AIOSEO usará o título e a descrição de sua postagem para o título e a descrição do Open Graph. Você também pode definir manualmente a miniatura do Facebook para cada página e publicação.

Basta editar o post ou a página e rolar para baixo até a seção “Configurações do AIOSEO”, abaixo do editor. A partir daí, alterne para a guia Social e você verá uma visualização da miniatura.

AIOSEO Facebook preview

Você pode definir a imagem da mídia social aqui, bem como o título e a descrição.

Basta rolar a tela para baixo até o campo “Image Source”. Você pode optar por usar a imagem em destaque, carregar uma imagem personalizada ou outras opções.

Choose which WordPress image to use as your Facebook thumbnail

Método 2: Definir metadados do Facebook Open Graph usando o Yoast SEO

OYoast SEO é outro plug-in de SEO para WordPress que você pode usar para adicionar metadados do Facebook Open Graph a qualquer site do WordPress.

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

Depois de ativado, você precisa ir para SEO ” Social e selecionar a opção “Enabled” (Ativado) em “Add Open Graph meta data” (Adicionar metadados do Open Graph).

Enable Facebook Open Graph

Você pode salvar suas configurações ou continuar e configurar outras opções sociais do Facebook.

Você pode fornecer um ID de aplicativo do Facebook se usar um para sua página do Facebook e insights. Você também pode alterar o título, a descrição e a imagem da meta-página inicial do Open Graph.

Por fim, você pode definir uma imagem padrão a ser usada quando nenhuma imagem for definida para um post ou uma página.

O Yoast SEO também permite que você defina metadados do Open Graph para posts e páginas individuais. Basta editar um post ou uma página e rolar para baixo até a seção “Yoast SEO”, abaixo do editor.

Set open graph meta data for post and pages

A partir daí, você pode definir uma miniatura do Facebook para essa postagem ou página específica. Se você não definir um título ou uma descrição do post, o plug-in usará seu metatítulo e sua descrição de SEO.

Agora você pode salvar seu post ou página, e o plug-in armazenará os metadados do Facebook Open Graph.

Método 3: Adicionar metadados do Facebook Open Graph usando código

Esse método requer a edição dos arquivos do tema, portanto, certifique-se de fazer backup dos arquivos do tema antes de fazer qualquer alteração.

Depois disso, basta copiar e colar esse código no arquivo functions.php do seu tema ou adicionar o trecho de código usando o plug-in WPCode (recomendado).

Primeiro, instale e ative o plug-in gratuito WPCode. Para obter mais detalhes, consulte nosso guia sobre como instalar um plug-in do WordPress.

Após a ativação, você pode ir para Code Snippets ” + Add Snippet no painel do WordPress. Você precisa passar o mouse sobre o primeiro snippet denominado “Add Your Custom Code (New Snippet)” e clicar no botão “Use snippet”.

Adding Your Custom Code in WPCode

Isso criará um novo snippet no qual você precisará digitar um título e selecionar o tipo de código “PHP Snippet”. Depois disso, você precisa postar o seguinte código na seção “Code Preview” (Visualização de código):

//Adding the Open Graph in the Language Attributes
function add_opengraph_doctype( $output ) {
        return $output . ' xmlns:og="http://opengraphprotocol.org/schema/" xmlns:fb="http://www.facebook.com/2008/fbml"';
    }
add_filter('language_attributes', 'add_opengraph_doctype');
 
//Lets add Open Graph Meta Info
 
function insert_fb_in_head() {
    global $post;
    if ( !is_singular()) //if it is not a post or a page
        return;
        echo '<meta property="fb:app_id" content="Your Facebook App ID" />';
        echo '<meta property="og:title" content="' . get_the_title() . '"/>';
        echo '<meta property="og:type" content="article"/>';
        echo '<meta property="og:url" content="' . get_permalink() . '"/>';
        echo '<meta property="og:site_name" content="Your Site Name Goes Here"/>';
    if(!has_post_thumbnail( $post->ID )) { //the post does not have featured image, use a default image
        $default_image="http://example.com/image.jpg"; //replace this with a default image on your server or an image in your media library
        echo '<meta property="og:image" content="' . $default_image . '"/>';
    }
    else{
        $thumbnail_src = wp_get_attachment_image_src( get_post_thumbnail_id( $post->ID ), 'medium' );
        echo '<meta property="og:image" content="' . esc_attr( $thumbnail_src[0] ) . '"/>';
    }
    echo "
";
}
add_action( 'wp_head', 'insert_fb_in_head', 5 );

Lembre-se de adicionar o nome do seu site na Linha 17, onde está escrito “Your Site Name Goes Here”. Depois disso, altere o URL padrão da imagem na linha 19 com um de seus próprios URLs de imagem.

Recomendamos que você coloque uma imagem com seu logotipo ali, de modo que, se a postagem não tiver uma miniatura, ela puxará o logotipo do seu site.

Você também precisa adicionar seu próprio Facebook App ID na Linha 13. Se você não tiver um aplicativo do Facebook, poderá remover a Linha 13 do código.

The New Code Snippet in WPCode

Quando terminar de atualizar o código, você precisará alternar o snippet para “Ativo” e clicar no botão “Salvar snippet”. Seu tema agora começará a exibir os metadados do Facebook Open Graph no cabeçalho do WordPress.

Guias especializados sobre Facebook e WordPress

Agora que você sabe como adicionar metadados do Facebook Open Graph, talvez queira ver outros guias relacionados a como usar o Facebook no WordPress:

Esperamos que este artigo tenha ajudado você a adicionar metadados do Facebook Open Graph no WordPress. Talvez você também queira ver nosso guia sobre como realizar um sorteio ou concurso no WordPress ou nossas escolhas de especialistas sobre os melhores plug-ins do Facebook para expandir seu blog.

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

222 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. wpbeginner says

    @SteveJoseph@joshuatj Josh not sure when you last checked the plugin, but our plugin has full support for the og:description. It has been there since version 0.1.2. Here is the changelog:http://wordpress.org/extend/plugins/facebook-open-graph-meta-in-wordpress/changelog/In version 0.1.3, we improved the description code to actually look for Yoast’s plugin’s description code, and if that doesn’t exist then it pulls the post excerpt if that exists.

  3. SteveJoseph says

    @joshuatj Good point and thanks again for the links and your help. It’s much appreciated. Between Linter and the Yoast plugin I should be ok. All the best.

  4. SteveJoseph says

    @joshuatj I tried linter before but that only fixed the 1st post. The rest still display the old copy. I just realized however that if I lint each unique page then it shows the correct information which is what you’ve posted above. Annoying but I guess this is what I’ll need to use for now or check out the link you provided and see if that plugin works for me. Much thanks mate! Cheers.

  5. joshuatj says

    @SteveJoseph Oops, you’re right, I did make a typo mistake there. I meant “Yoast”. http://yoast.com/wordpress/seo/But in actual fact, Yoast does more than just solving the og-description issue, so it might not be what you want. I just used URL Linter (http://developers.facebook.com/tools/lint/) for your site. It seem to be displaying this description “Future Tomorrow is the collective online moniker, portfolio site and blog of Steve Joseph. With over 14yrs creative experience across several disciplines and knowledge that far extends beyond “just being a creative”, there is much to share but still more to learn.”. Is that what you want in the description field? Try “sharing on Facebook” again?

  6. SteveJoseph says

    @joshuatj Thanks for the response joshuatj. Unfortunately a search of “Yeost Facebook Plugin” or “Yeost Plugin” didn’t return any helpful results in guiding me to this possible solution. Do you have a direct link?

    I also tried searching “Yoast” thinking there may have been a typo in your response and that still didn’t lead me to a solution. Any further help would be greatly appreciated. Thanks for your time.

  7. SteveJoseph says

    Hi,

    I tried both your plug-in and code method and neither worked. When clicking “share this on Facebook” from my blog, my title is correct, URL is correct, image is correct but the description is old and incorrect. Is there an update to the code or plug-in where the “description” is properly displayed?Thanks in advance.

    Cheers,

    Steve

  8. joshuatj says

    The plugin is awesome! Thanks wpbeginner! However it’ll be awesome if we can also add the “description” content for the <meta property=”og:description” content=””> meta tag

  9. ExpandSM says

    Thanks for this plugin! I have a blog that is also a Buddypress site and I can’t get it to pull the post excerpt. Any suggestions?

  10. jaffa says

    @wpbeginner Thank you for your reply.

    I realise I’m turning into the biggest pain on this thread and this will be my last question:

    I use the catch that image and tim thumb function on my site and was wondering how or if I could implement that into this function to replace the code that looks for a featured image?

    Sometimes I don’t use the featured image so it would be handy if the script could just look for the first image in the post and if that is not there then use the default.

    Thanks in advance :)

  11. dbrabyn says

    @wpbeginner @dbrabyn Fair enough. I’ve just tried it and for a post with no featured image but a post image, FB Lint tells me “The image url is not compliant with RFC2396 and will not be displayed correctly.” The absence of a default image is a problem too. Thanks anyway.

  12. wpbeginner says

    @jaffa If you don’t have these meta tags, and the user LIKES a post using the like button on your blog (FB will pick a random image for them)….Now if they put the link on their Facebook profile (then they will get option)… Most of the time folks click on the like button then actually copying the link and pasting on their facebook status box. This plugin actually fixes that issue.

  13. wpbeginner says

    @dbrabyn The plugin that we have in the repository actually does that. It looks for the featured image and if no featured image is found it falls back to the first image of the post… The snippet in this post doesn’t do that. Just use the plugin.

  14. jaffa says

    Finally got this working with the help of wpbeginner!

    I have a question though, when I share a page that doesn’t have any images in the content the default image is used. Is it possible to specify more than one default image?

    Also, I noticed if I share the homepage of the website, I have a choice of all the images on the page to pick from but when sharing a normal page I am forced to use the default only. Is there a way to see all images on the page?

    Thanks

  15. dbrabyn says

    Any way to make this function grab the first image from the post, then the featured image, then the default image? Just like get_the_image does.

  16. wpbeginner says

    @jaffa If you send us an email using the contact form, we can definitely look into it and help you get this working.

  17. jaffa says

    @wpbeginner It is not that I am not satisfied with the article here, it’s just I can’t seem to get it working. I always visit this site as it has helped me greatly and allowed me to learn a lot about wp.

    I couldn’t get the opengraph to work and then started looking elsewhere online which lead me to other articles that just confused me really. I then came back here to try again. Maybe I have done something incorrect or there is something not right in my theme that is preventing it from working. That’s what I meant by ‘I’ll figure it out’

    I appreciate your replies and help.

    Thank you.

  18. wpbeginner says

    @jaffa You don’t need an app if you don’t want it. You can still retrieve analytics for your like buttons through your personal account. There is nothing to figure out because the article explains everything, but if you still are not satisfied then sure do further research.

  19. jaffa says

    @wpbeginner ok, thanks!

    Other articles suggested an app needed to be created which is why I was confused. Nevermind, I’ll figure it out.

    :)

  20. wpbeginner says

    @jaffa You DO NOT have to create a facebook application for this tutorial. It will work regardless. We have the app on our page for other reasons that does not relate to the tutorial mentioned in this article….

  21. jaffa says

    @wpbeginner thanks for your reply. I was getting very confused :s

    Do I need to create a facebook application for this open graph to work correctly? I just checked the source code for this page and you have an ‘fb:app_id’ field which isn’t included in the code above?

    I apologise for all the questions, if anyone can direct me to some documentation about open graph I will happily try to find some answers and come back and share any info I may find.

    Thanks

    :)

  22. wpbeginner says

    @jbjb3077 Look at our article about showing custom fields anywhere on the site. Custom Fields 101 article covers that on our site :)

  23. jaffa says

    this may seem like a very silly question but in order for this to work do you have to create a facebook application first? I just have a regular facebook page and nothing else and I have tried this code many times but still cannot get it to work. When I run it through the linter tool I get the error: invalid app ID.

    Is the example of the USER ID above the same as an app ID or not?

  24. mark.bravura says

    Thanks again for your quick response. And that is the heart of my question… the Facebook Open Graph Meta For WordPress plugin is pulling in all of the meta data correctly, except for no excerpt/description data. Hence why I am wondering how to manually tweak it. Any suggestions?

  25. wpbeginner says

    @mark.bravura Your post title is being pulled as the title. Your excerpt is being pulled as the description. Your featured image (thumbnail) is being pulled as the thumbnail. Modify any of those, and you can modify the og data.

  26. mark.bravura says

    Thanks for the quick reply. So is there a reasonably easy way to manually fine tune (access/modify) the OG data?

  27. Liverpoolfcblog says

    Hey there wpbeginner @wpbeginner , the code is working fine. Thanks for that.

    Just have a question. I ran individual articles through facebook’s linter and all appeared fine. However, when I ran my home page through it says this:

    Required Property Missing og:title is required

    Required Property Missing og:type is required

    Required Property Missing og:url is required

    Required Property Missing og:image is required

    I noticed this in the code: if ( !is_singular()) //if it is not a post or a page return;

    Does adding the above four affect how facebook sees my site? For instance, will it categorize as a website and show the Title?

    Cheers.

    • Editorial Staff says

      You can remove the is_singular item and show this on the homepage… Most if not all WordPress blogs are only shared from the single post page. That is also the page where the Like button is prominent.

      Administrador

  28. jbjb3077 says

    hello my post images are in custom field (thumb) i had a hack with previous version but now cant figure it out how to add that. please help me. this is the code i have replaced

    if ( get_post_meta($post->ID, ‘thumb’, true) ) { //the post does have featured image $thumbnail_src = get_post_meta($post->ID, “thumb”, true); echo ‘<meta property=”og:image” content=”‘ . esc_attr( $thumbnail_src[0] ) . ‘”/>’; } else{ echo ‘<meta property=”og:image” content=”mysite image in a path.jpg”/>’; } echo “n”;

  29. jaffa says

    Thanks Daniel, adding that did help remove the errors I was receiving before but now it’s telling me the title, url, image and type are missing even though they are there.

    It is also showing the wrong image, it doesn’t seem to be picking up the image from the article rather a random image from the page.

    I have no idea why I can’t get this to work, I wanted to avoid using the plugin but maybe that’s the way I need to go.

    :(

    Thanks guys for your help.

  30. jaffa says

    I added the code to my functions file and then followed your article on how to add the Like and Send button and all seemed to be fine but today as my client posted a link on the FB wall to the latest article there was no option to select an image to go with the article.

    I can’t understand what went wrong or how to go about fixing it. I am assuming it is the FB code I added that has caused this as I have made no other changes.

    Any idea’s what could be the problem?

      • jaffa says

        Thank you for your reply.

        I didn’t realise it took that option away. But I still don’t understand why it didn’t display the thumbnail when I have included a thumbnail image. There just wasn’t an image there at all.

        When I view the source I can see a link to the image in the og:image field.

        I wish I could get it to work, might have to try the plugin.

        Just one other thing, I have defined a number of different thumbnail sizes in my theme to use in various places, so instead of it calling the ‘medium’ sized image do I need to set it so it calls one of my defined thumbnails??

        Sorry for the long and confusing comment, newbie here!

        :-)

        • Elliott the web design guy says

          Facebook will scrape your site every 24hrs or so… so if you’ve made any changes on your site facebook will need to catch up – 24hrs or so later. But, you can force facebook to re-scrape your site by using the linter tool. Before testing the Send button again run anyone of your url’s through http://developers.facebook.com/tools/lint/ to force Facebook to refresh the details, hopefully this should resolve the image issue ;-)

        • jaffa says

          Thanks Elliott, the Linter tool you provided a link to was quite helpful.

          After passing a url through it, the error message I got was:

          fb:admins field contained some invalid ids, I noticed that my page ID is 15 characters long but the one used in the example above is only 10.

          The other message I got was:
          You put App ID in the fb:admins field. It should be in fb:app_id

          Should there be an extra field for app_id in the code above?

          I’m slightly confused now…

        • Daniel Chenery says

          Sorry, I thought the code tag might keep the tags, turns out not. Let me try and post that again
          <meta property=”fb:app_id” content=”Your_App_ID”/>
          <meta property=”fb:admins” content=”Your_Profile_ID”/>

    • Editorial Staff says

      We updated the plugin to fix a bug with the default image issue. Now, it is checking if your post has a thumbnail… If it doesn’t, then it picks the first image from your post. We do have plans on bringing the default image feature back soon.

      Administrador

  31. Ovidiu says

    I am curios about this part of the code: add_opengraph_doctype the problem is that that function doesn’t seem to do anything on my install :-( the rest is working fine but this add_opengraph_doctype doesn’t.

    is it necessary and why do you think my themes doesn’t trigger that?

  32. Sheryl says

    I installed the open graph plug-in to wordpress. I configured the settings swapping my business name out for the name on the URL you posted.

    Now what?? What do I do next to get the send button under my like button?

  33. Preston says

    This is great. Any guidance on how to modify this so that Facebook draws an excerpt from the written content? The plug-in doesn’t go to content but takes author name, categories, and date. Thoughts?

  34. Chris Bracco says

    This code only adds the OG tags to single posts and pages. I’d like to have the tags appear on all of my pages, and I can’t figure out a simple way to accomplish this. Any ideas?

    • Editorial Staff says

      You have individual like / send buttons on your archive, category, tags pages??? Like buttons are only good on single posts / pages which is why the code adds that. The only other like button added on the site is the (Like Box) for the Facebook page of the site. Which doesn’t require this information.

      But if you must, then remove the !is_singular conditional statement.

      Administrador

    • Editorial Staff says

      You can hard code it into the header.php but that is a multiple step process as you have to edit doctype, then add the other meta tags… This is a one step process. Paste, and Done. Or install the plugin, and done. If you use the plugin, then you are even better of because the tags stay even when you change the themes.

      Administrador

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.