{"id":49232,"date":"2025-03-21T23:18:04","date_gmt":"2025-03-22T02:18:04","guid":{"rendered":"\/tutoriais\/?p=49232"},"modified":"2025-12-18T11:32:10","modified_gmt":"2025-12-18T14:32:10","slug":"get-post-meta","status":"publish","type":"post","link":"\/br\/tutoriais\/get-post-meta","title":{"rendered":"O que \u00e9 e como usar a fun\u00e7\u00e3o get_post_meta do WordPress"},"content":{"rendered":"<p>Um campo personalizado no WordPress armazena informa&ccedil;&otilde;es extras sobre um post no back-end. Para recuperar e exibir esses meta dados, adicione a fun&ccedil;&atilde;o <strong>get_post_meta<\/strong> ao c&oacute;digo do seu site.<\/p><p>Esses meta dados s&atilde;o exibidos pelos <strong>desenvolvedores do WordPress<\/strong> para tornar a navega&ccedil;&atilde;o mais intuitiva e o conte&uacute;do mais acess&iacute;vel. Por exemplo, &eacute; poss&iacute;vel real&ccedil;ar o pre&ccedil;o do produto, adicionar uma tag de categoria extra e incluir um cabe&ccedil;alho personalizado no seu post.<\/p><p>Neste tutorial, vamos explicar a fun&ccedil;&atilde;o <strong>get_post_meta<\/strong> do WordPress e suas configura&ccedil;&otilde;es. Voc&ecirc; tamb&eacute;m vai aprender dois m&eacute;todos bem conhecidos para adicionar essa fun&ccedil;&atilde;o ao seu site WordPress: pelo Editor de Tema ou via plugins.<\/p><p>\n\n\n\n\n\n<div class=\"protip\">\n                    <h4 class=\"title\">O que &eacute; a fun&ccedil;&atilde;o get_post_meta do WordPress?<\/h4>\n                    <p>A fun&ccedil;&atilde;o get_post_meta do WordPress permite acessar e mostrar os valores dos campos personalizados diretamente na interface. Voc&ecirc; pode adicionar essa fun&ccedil;&atilde;o diretamente ao arquivo de configura&ccedil;&atilde;o do seu tema WordPress ou usar plugins como o WPCode.<\/p>\n                <\/div>\n\n\n\n<\/p><h3 class=\"wp-block-heading\" id=\"h-parametros-da-funcao-get-post-meta\"><strong>Par&acirc;metros da fun&ccedil;&atilde;o get_post_meta<\/strong><\/h3><p>No WordPress, a sintaxe dessa fun&ccedil;&atilde;o possui tr&ecirc;s par&acirc;metros:<\/p><pre class=\"wp-block-code\"><code>get_post_meta( $post_id, $key, $single );<\/code><\/pre><p>Aqui est&aacute; o que cada par&acirc;metro significa:<\/p><ul class=\"wp-block-list\">\n<li><strong>$post_id<\/strong> &ndash; O post do qual as informa&ccedil;&otilde;es personalizadas ser&atilde;o retiradas. Para ver todos os IDs de post, use <strong>get_the_id()<\/strong>. Se voc&ecirc; usar um ID de post que n&atilde;o existe, a fun&ccedil;&atilde;o retornar&aacute; uma string vazia.<\/li>\n\n\n\n<li><strong>$key<\/strong> &ndash; A chave meta que representa o campo personalizado a ser acessado. Se deixada em branco, os dados ser&atilde;o retirados de todos os metacampos do post. Se o campo personalizado n&atilde;o existir ou faltar um valor meta, ele retorna um array vazio.<\/li>\n\n\n\n<li><strong>$single<\/strong> &ndash; Um par&acirc;metro que determina se a fun&ccedil;&atilde;o retorna um array de valores ou apenas um valor. O valor padr&atilde;o &eacute; <strong>TRUE<\/strong> (verdadeiro), que obt&eacute;m um &uacute;nico array. Definindo como <strong>FALSE <\/strong>(falso), a fun&ccedil;&atilde;o retorna um array com todos os valores da chave meta especificada.<\/li>\n<\/ul><p>\n\n\n<div><p class=\"important\"><strong>Importante!<\/strong> Se o par&acirc;metro $single for TRUE e os campos meta contiverem multiplos dados, apenas o primeiro valor do campo meta ser&aacute; recuperado. Se voc&ecirc; passar uma string vazia, a fun&ccedil;&atilde;o buscar&aacute; e retornar&aacute; todos os meta dados salvos com essa chave no post atual.<\/p><\/div>\n\n\n\n<\/p><p>Voc&ecirc; tamb&eacute;m pode usar essa fun&ccedil;&atilde;o para outras finalidades, como verificar se um campo meta espec&iacute;fico existe no post desejado:<\/p><pre class=\"wp-block-code\"><code>$custom_field = get_post_meta( get_the_id() );\nif (!empty($custom_field)){\n&nbsp;&nbsp;&nbsp;echo \"Meta field exists in this post\"\n}&nbsp;\nelse\n{\n&nbsp;&nbsp;&nbsp;echo \"This post doesn&rsquo;t contain a custom field\"\n}<\/code><\/pre><h2 class=\"wp-block-heading\" id=\"h-exibindo-campos-personalizados-com-a-funcao-get-post-meta-no-wordpress\"><strong>Exibindo campos personalizados com a fun&ccedil;&atilde;o get_post_meta no WordPress<\/strong><\/h2><p>Nesta se&ccedil;&atilde;o, vamos explicar dois m&eacute;todos para usar essa fun&ccedil;&atilde;o do WordPress. Os dois m&eacute;todos geram o mesmo resultado, ent&atilde;o escolha o que for melhor para voc&ecirc;.<\/p><h3 class=\"wp-block-heading\" id=\"h-como-adicionar-a-funcao-get-post-meta-manualmente-a-um-template-de-post\"><strong>Como adicionar a fun&ccedil;&atilde;o get_post_meta manualmente a um template de post<\/strong><\/h3><p>A primeira op&ccedil;&atilde;o &eacute; inserir a fun&ccedil;&atilde;o diretamente no arquivo de <a href=\"\/br\/pt\/tutoriais\/como-criar-uma-pagina-template-no-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>template da p&aacute;gina<\/strong><\/a> do WordPress. Sugerimos o <a href=\"\/br\/pt\/tutoriais\/child-theme-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>uso de um child theme<\/strong><\/a> para evitar erros e garantir que suas altera&ccedil;&otilde;es n&atilde;o sejam perdidas ap&oacute;s uma atualiza&ccedil;&atilde;o.<\/p><p>Para modificar o arquivo de template da p&aacute;gina, use o painel do WordPress ou o <a href=\"\/br\/tutoriais\/como-utilizar-o-gerenciador-de-arquivos-hostinger\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>Gerenciador de Arquivos<\/strong><\/a> da Hostinger. Veja como fazer isso usando a primeira op&ccedil;&atilde;o:<\/p><ol class=\"wp-block-list\">\n<li>Fa&ccedil;a login no seu painel de administrador do WordPress. Na barra lateral, navegue at&eacute; <strong>Apar&ecirc;ncia<\/strong> &rarr;<strong> Editor de Arquivo de Tema<\/strong>.<\/li>\n\n\n\n<li>No menu <strong>Arquivos do Tema<\/strong>, localize o arquivo <strong>single.php<\/strong>.<\/li>\n\n\n\n<li>Insira o seguinte c&oacute;digo no fim do arquivo, certificando-se de que fique antes da tag <strong>&lt;?php<\/strong>. Lembre-se de alterar os valores de acordo com as suas necessidades:<\/li>\n<\/ol><pre class=\"wp-block-code\"><code>echo get_post_meta(Post ID, 'key', true );<\/code><\/pre><ol start=\"4\" class=\"wp-block-list\">\n<li>Inclua o loop do WordPress ap&oacute;s a fun&ccedil;&atilde;o para garantir que os meta dados sejam carregados corretamente na p&aacute;gina. Veja um exemplo que exibe o valor meta do post no final do seu conte&uacute;do:<\/li>\n<\/ol><pre class=\"wp-block-code\"><code>&lt;?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?&gt;\n&lt;?php endwhile; else: ?&gt;\n&lt;?php endif; ?&gt;<\/code><\/pre><ol start=\"5\" class=\"wp-block-list\">\n<li>Clique em <strong>Atualizar Arquivo <\/strong>para salvar as altera&ccedil;&otilde;es.<\/li>\n<\/ol><div class=\"wp-block-image\">\n<figure data-wp-context='{\"imageId\":\"6a0041b64cb41\"}' data-wp-interactive=\"core\/image\" class=\"aligncenter size-full wp-lightbox-container\"><img decoding=\"async\" width=\"814\" height=\"173\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-on-async--load=\"callbacks.setButtonStyles\" data-wp-on-async-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/editor-de-tema-arquivo-wordpress.png\/public\" alt=\"editor de temas no wordpress\" class=\"wp-image-49233\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/editor-de-tema-arquivo-wordpress.png\/w=814,fit=scale-down 814w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/editor-de-tema-arquivo-wordpress.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/editor-de-tema-arquivo-wordpress.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/editor-de-tema-arquivo-wordpress.png\/w=768,fit=scale-down 768w\" sizes=\"(max-width: 814px) 100vw, 814px\" \/><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" aria-label=\"Enlarge\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-style--right=\"state.imageButtonRight\" data-wp-style--top=\"state.imageButtonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><p>Quando a fun&ccedil;&atilde;o retorna apenas um valor de uma chave meta, o loop do WordPress n&atilde;o &eacute; necess&aacute;rio. Mas se houver m&uacute;ltiplos valores ou um array de meta dados, ele ser&aacute; indispens&aacute;vel. Aqui est&aacute; como voc&ecirc; faz um loop em um array:<\/p><pre class=\"wp-block-code\"><code>\nforeach ($your_function_variable as $value){\n   \/\/command goes here\n}<\/code><\/pre><p>\n\n\n<div><p class=\"important\"><strong>Importante!<\/strong> Por causa do cache do WordPress, essa fun&ccedil;&atilde;o diferencia letras mai&uacute;sculas de min&uacute;sculas.<\/p><\/div>\n\n\n\n<\/p><p>Se o menu <strong>Editor de Arquivo de Tema<\/strong> n&atilde;o aparecer, isso significa que seu tema n&atilde;o permite a edi&ccedil;&atilde;o do arquivo de template da p&aacute;gina. Felizmente, quem usa a <a href=\"\/br\/hospedagem-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>Hospedagem Gerenciada para WordPress<\/strong><\/a> da Hostinger pode encontrar o arquivo pelo <strong>Gerenciador de Arquivos do hPanel.<\/strong><\/p><div class=\"wp-block-image\">\n<figure data-wp-context='{\"imageId\":\"6a0041b64d689\"}' data-wp-interactive=\"core\/image\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" width=\"1245\" height=\"538\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-on-async--load=\"callbacks.setButtonStyles\" data-wp-on-async-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/10\/gerenciador-de-arquivos-painel-hostinger.png\/public\" alt=\"acessando gerenciador de arquivos pelo hpanel\" class=\"wp-image-40836\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/10\/gerenciador-de-arquivos-painel-hostinger.png\/w=1245,fit=scale-down 1245w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/10\/gerenciador-de-arquivos-painel-hostinger.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/10\/gerenciador-de-arquivos-painel-hostinger.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/10\/gerenciador-de-arquivos-painel-hostinger.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2023\/10\/gerenciador-de-arquivos-painel-hostinger.png\/w=768,fit=scale-down 768w\" sizes=\"(max-width: 1245px) 100vw, 1245px\" \/><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" aria-label=\"Enlarge\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-style--right=\"state.imageButtonRight\" data-wp-style--top=\"state.imageButtonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><p>O arquivo <strong>single.php<\/strong> est&aacute; na pasta do seu tema ativo dentro de <strong>public_html<\/strong>\/<strong>wp-content<\/strong>\/<strong>themes<\/strong>. Para editar o arquivo, clique com o bot&atilde;o direito nele e selecione <strong>Editar<\/strong>.<\/p><div class=\"wp-block-image\">\n<figure class=\"aligncenter size-full\"><a href=\"\/br\/hospedagem-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><img decoding=\"async\" width=\"1024\" height=\"300\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2024\/06\/BR-New-WP_in-text-banner.png\/public\" alt=\"\" class=\"wp-image-44638\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2024\/06\/BR-New-WP_in-text-banner.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2024\/06\/BR-New-WP_in-text-banner.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2024\/06\/BR-New-WP_in-text-banner.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2024\/06\/BR-New-WP_in-text-banner.png\/w=768,fit=scale-down 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><\/a><\/figure><\/div><p>Outra op&ccedil;&atilde;o &eacute; inserir a fun&ccedil;&atilde;o no arquivo functions.php do seu tema e depois us&aacute;-la no template do post. Se voc&ecirc; tem tipos de post personalizados e deseja manter o arquivo do template principal sem c&oacute;digo extra, esse m&eacute;todo &eacute; o mais recomendado.<\/p><h3 class=\"wp-block-heading\" id=\"h-como-adicionar-a-funcao-get-post-meta-usando-um-plugin\"><strong>Como adicionar a fun&ccedil;&atilde;o get_post_meta usando um plugin<\/strong><\/h3><p>Se voc&ecirc; n&atilde;o consegue acessar o arquivo <strong>single.php<\/strong>, adicione a fun&ccedil;&atilde;o usando um plugin. Vamos mostrar como fazer isso usando a vers&atilde;o gr&aacute;tis do WPCode.<\/p><p>Depois de <a href=\"\/br\/tutoriais\/como-instalar-plugins-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>instalar e ativar o plugin<\/strong><\/a>, siga estes passos:<\/p><ol class=\"wp-block-list\">\n<li>Do painel de administra&ccedil;&atilde;o, navegue at&eacute; <strong>Snippets de C&oacute;digo &rarr; Adicionar Snippet<\/strong>.<\/li>\n\n\n\n<li>Passe o mouse sobre<strong> Adicionar Seu C&oacute;digo Personalizado e <\/strong>clique em<strong> Usar snippet<\/strong>.<\/li>\n<\/ol><div class=\"wp-block-image\">\n<figure data-wp-context='{\"imageId\":\"6a0041b64f048\"}' data-wp-interactive=\"core\/image\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" width=\"1024\" height=\"433\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-on-async--load=\"callbacks.setButtonStyles\" data-wp-on-async-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/adicionar-snippet-wpcode.png\/public\" alt=\"adicionando snippet no wp code\" class=\"wp-image-49234\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/adicionar-snippet-wpcode.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/adicionar-snippet-wpcode.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/adicionar-snippet-wpcode.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/adicionar-snippet-wpcode.png\/w=768,fit=scale-down 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" aria-label=\"Enlarge\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-style--right=\"state.imageButtonRight\" data-wp-style--top=\"state.imageButtonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><ol start=\"3\" class=\"wp-block-list\">\n<li>No menu suspenso do <strong>Tipo de C&oacute;digo<\/strong>, selecione <strong>Snippet de PHP<\/strong>.<\/li>\n\n\n\n<li>Insira seu c&oacute;digo no <strong>campo de pr&eacute;-visualiza&ccedil;&atilde;o <\/strong>de c&oacute;digo, incluindo a fun&ccedil;&atilde;o e o loop.<\/li>\n\n\n\n<li>Role para baixo at&eacute; a se&ccedil;&atilde;o de <strong>Inser&ccedil;&atilde;o<\/strong> e altere as configura&ccedil;&otilde;es de acordo com suas necessidades. Por exemplo, vamos selecionar <strong>Inserir Automaticamente <\/strong>e <strong>Inserir Ap&oacute;s o Conte&uacute;do<\/strong> como localiza&ccedil;&atilde;o.<\/li>\n<\/ol><div class=\"wp-block-image\">\n<figure data-wp-context='{\"imageId\":\"6a0041b64f9db\"}' data-wp-interactive=\"core\/image\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" width=\"1024\" height=\"279\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-on-async--load=\"callbacks.setButtonStyles\" data-wp-on-async-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/inserindo-snippet-wpcode.png\/public\" alt=\"inserindo snippet plugin wpcode\" class=\"wp-image-49235\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/inserindo-snippet-wpcode.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/inserindo-snippet-wpcode.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/inserindo-snippet-wpcode.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/inserindo-snippet-wpcode.png\/w=768,fit=scale-down 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" aria-label=\"Enlarge\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-style--right=\"state.imageButtonRight\" data-wp-style--top=\"state.imageButtonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><ol start=\"6\" class=\"wp-block-list\">\n<li>Clique em <strong>Salvar Snippet <\/strong>no canto superior direito.<\/li>\n\n\n\n<li>Pressione o <strong>bot&atilde;o de ativa&ccedil;&atilde;o<\/strong> para aplicar o c&oacute;digo.<\/li>\n<\/ol><div class=\"wp-block-image\">\n<figure data-wp-context='{\"imageId\":\"6a0041b65040f\"}' data-wp-interactive=\"core\/image\" class=\"aligncenter size-large wp-lightbox-container\"><img decoding=\"async\" width=\"1024\" height=\"93\" data-wp-class--hide=\"state.isContentHidden\" data-wp-class--show=\"state.isContentVisible\" data-wp-init=\"callbacks.setButtonStyles\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-on-async--load=\"callbacks.setButtonStyles\" data-wp-on-async-window--resize=\"callbacks.setButtonStyles\" src=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/salvar-snippet-wpcode.png\/public\" alt=\"salvar snippet plugin wpcode\" class=\"wp-image-49236\" srcset=\"https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/salvar-snippet-wpcode.png\/w=1024,fit=scale-down 1024w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/salvar-snippet-wpcode.png\/w=300,fit=scale-down 300w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/salvar-snippet-wpcode.png\/w=150,fit=scale-down 150w, https:\/\/imagedelivery.net\/LqiWLm-3MGbYHtFuUbcBtA\/wp-content\/uploads\/sites\/53\/2025\/03\/salvar-snippet-wpcode.png\/w=768,fit=scale-down 768w\" sizes=\"(max-width: 1024px) 100vw, 1024px\" \/><button class=\"lightbox-trigger\" type=\"button\" aria-haspopup=\"dialog\" aria-label=\"Enlarge\" data-wp-init=\"callbacks.initTriggerButton\" data-wp-on-async--click=\"actions.showLightbox\" data-wp-style--right=\"state.imageButtonRight\" data-wp-style--top=\"state.imageButtonTop\">\n\t\t\t<svg xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"12\" height=\"12\" fill=\"none\" viewbox=\"0 0 12 12\">\n\t\t\t\t<path fill=\"#fff\" d=\"M2 0a2 2 0 0 0-2 2v2h1.5V2a.5.5 0 0 1 .5-.5h2V0H2Zm2 10.5H2a.5.5 0 0 1-.5-.5V8H0v2a2 2 0 0 0 2 2h2v-1.5ZM8 12v-1.5h2a.5.5 0 0 0 .5-.5V8H12v2a2 2 0 0 1-2 2H8Zm2-12a2 2 0 0 1 2 2v2h-1.5V2a.5.5 0 0 0-.5-.5H8V0h2Z\"><\/path>\n\t\t\t<\/svg>\n\t\t<\/button><\/figure><\/div><h2 class=\"wp-block-heading\" id=\"h-exemplos-de-como-usar-a-funcao-get-post-meta-no-wordpress\"><strong>Exemplos de como usar a fun&ccedil;&atilde;o get_post_meta no WordPress<\/strong><\/h2><p>Nesta se&ccedil;&atilde;o, vamos mostrar v&aacute;rios exemplos de como usar a fun&ccedil;&atilde;o para inspirar voc&ecirc;.<\/p><p><strong>Acessando objetos de posts publicados e suas chaves meta.<\/strong><\/p><pre class=\"wp-block-code\"><code>$published_posts = get_posts(array('post_status' =&amp;gt; 'publish'));\nforeach ($published_posts as $post) {\n&nbsp;&nbsp;&nbsp;&nbsp;$post_id = $post-&gt;ID;\n&nbsp;&nbsp;&nbsp;&nbsp;$meta_keys = get_post_meta($post_id);}<\/code><\/pre><p>O c&oacute;digo de exemplo usa o <strong>get_posts<\/strong> para buscar todos os meta dados dos posts publicados e passa por cada um deles com o <strong>foreach<\/strong> para acessar as meta chaves.<\/p><p><strong>Buscando o elemento HTML img que corresponde a um anexo de imagem<\/strong><\/p><pre class=\"wp-block-code\"><code>$attachment_id = get_post_meta($post_id,'_thumbnail_id', true);\nif ($attachment_id) {\n&nbsp;&nbsp;&nbsp;$image_html = wp_get_attachment_image($attachment_id, 'large');\n&nbsp;&nbsp;&nbsp;echo $image_html;\n}\nelse { echo 'No images!'; }<\/code><\/pre><p>Esse c&oacute;digo busca o ID do anexo de imagem em um campo meta personalizado de um post e utiliza esse valor na fun&ccedil;&atilde;o <strong>wp_get_attachment_image<\/strong>. Com o ID, o c&oacute;digo localiza o elemento<strong> img<\/strong> da imagem.<\/p><p>Voc&ecirc; tamb&eacute;m pode usar esse c&oacute;digo para exibir a miniatura do post, s&oacute; precisa mudar o par&acirc;metro <strong>$size<\/strong> da fun&ccedil;&atilde;o <strong>wp_get_attachment_image<\/strong>.<\/p><p><strong>Buscando informa&ccedil;&otilde;es ligadas a um campo meta de um post de maneira din&acirc;mica<\/strong><\/p><pre class=\"wp-block-code\"><code>$dynamic_suffix = 'example';\n$custom_field_name = 'custom_field_' . $dynamic_suffix;\n$dynamic_data = get_post_meta(get_the_id(), $custom_field_name, true);\nif ($dynamic_data) {\n&nbsp;&nbsp;&nbsp;&nbsp;echo 'Dynamic Data: ' . esc_html($dynamic_data);\n} else {\n&nbsp;&nbsp;&nbsp;&nbsp;echo 'No dynamic data found.';\n}<\/code><\/pre><p>Voc&ecirc; pode adicionar campos personalizados din&acirc;micos usando um sufixo.&nbsp;Por exemplo, no c&oacute;digo usamos o sufixo <strong>&lsquo;example&rsquo;<\/strong> para criar o campo <strong>custom_field_example<\/strong>, que exibe os metadados no post atual. Se o valor existir, a fun&ccedil;&atilde;o marca os dados como din&acirc;micos.&nbsp; Se n&atilde;o, ela mostra uma mensagem de erro.<\/p><p><strong>Recuperando o status do post com base nos metadados.<\/strong><\/p><pre class=\"wp-block-code\"><code>$post_status = get_post_meta(post_ID, 'custom_field_post_status', true);\nif ($post_status) {\n&nbsp;&nbsp;&nbsp;&nbsp;echo 'Custom Status: ' . esc_html($post_status);\n} else {\n&nbsp;&nbsp;&nbsp;&nbsp;echo 'Custom status not found or unavailable.';\n}<\/code><\/pre><p>Ele verifica os campos de meta dados personalizados do post para encontrar o status.&nbsp; Se existir, o valor &eacute; exibido. Caso contr&aacute;rio, aparece uma mensagem de erro.<\/p><h2 class=\"wp-block-heading\" id=\"h-conclusao\"><strong>Conclus&atilde;o<\/strong><\/h2><p>A fun&ccedil;&atilde;o <strong>get_post_meta<\/strong> do WordPress permite que voc&ecirc; recupere os meta dados de um campo personalizado e mostre-os para os visitantes do seu site. Ela usa tr&ecirc;s par&acirc;metros: o ID do post, a chave do campo meta e uma op&ccedil;&atilde;o que indica se deve buscar apenas um valor ou v&aacute;rios.<\/p><p>Para usar essa fun&ccedil;&atilde;o, adicione o c&oacute;digo ao seu tema no arquivo <strong>single.php<\/strong> ou <strong>functions.php<\/strong>. Voc&ecirc; pode fazer isso usando o gerenciador de arquivos do seu painel de controle de hospedagem ou atrav&eacute;s do Editor de Arquivos de <strong>Tema do painel de administra&ccedil;&atilde;o do WordPress, <\/strong>que fica no menu <strong>Apar&ecirc;ncia<\/strong>.<\/p><p>Outra op&ccedil;&atilde;o &eacute; utilizar um plugin, como o <strong>WPCode<\/strong>. Depois de instalar e ativar, adicione seu c&oacute;digo como um novo snippet PHP e escolha onde ele deve aparecer no post, incluindo os meta dados. Clique no bot&atilde;o de ativar para come&ccedil;ar a usar.<\/p><p>Ficou com alguma d&uacute;vida? Voc&ecirc; pode explorar nosso <a target=\"_blank\" rel=\"noreferrer noopener\" href=\"https:\/\/www.hostinger.com\/tutorials\/wordpress\"><strong><u>tutorial do WordPress<\/u><\/strong><\/a> para saber mais!<\/p><h2 class=\"wp-block-heading\" id=\"h-perguntas-frequentes-faq-sobre-get-post-meta-no-wordpress\"><strong>Perguntas Frequentes (FAQ) sobre get_post_meta no WordPress<\/strong><\/h2><p>Nesta se&ccedil;&atilde;o, vamos responder as perguntas mais frequentes sobre a fun&ccedil;&atilde;o <strong>get_post_meta<\/strong> do WordPress.<\/p><div id=\"rank-math-faq\" class=\"rank-math-block\">\n<div class=\"rank-math-list \">\n<div id=\"faq-question-6944106aaf14f\" class=\"rank-math-list-item\">\n<h3 class=\"rank-math-question \"><strong>Como eu uso a fun&ccedil;&atilde;o get_post_meta?<\/strong><\/h3>\n<div class=\"rank-math-answer \">\n\n<p>Adicione a fun&ccedil;&atilde;o no arquivo <strong>single.php<\/strong> do seu tema ou no <strong>functions.php<\/strong> caso esteja usando um tipo de post personalizado. No c&oacute;digo, informe o ID do post, o nome do campo personalizado e se quer recuperar um &uacute;nico valor ou uma lista. Se tiver v&aacute;rios campos ou arrays, use um loop para exibir todos os meta dados.<\/p>\n\n<\/div>\n<\/div>\n<div id=\"faq-question-6944106aaf155\" class=\"rank-math-list-item\">\n<h3 class=\"rank-math-question \"><strong>Como a fun&ccedil;&atilde;o get_post_meta recupera os metadados dos campos personalizados no WordPress?<\/strong><\/h3>\n<div class=\"rank-math-answer \">\n\n<p>Os <a href=\"https:\/\/blog.hostinger.io\/br-tutoriais\/campos-personalizados-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><strong>campos personalizados do WordPress<\/strong><\/a> permitem adicionar informa&ccedil;&otilde;es extras a um post, que ficam salvas no banco de meta dados. Com a fun&ccedil;&atilde;o <strong>get_post_meta<\/strong>, voc&ecirc; consegue recuperar esses meta dados e mostrar na sua p&aacute;gina.<\/p>\n\n<\/div>\n<\/div>\n<div id=\"faq-question-6944106aaf156\" class=\"rank-math-list-item\">\n<h3 class=\"rank-math-question \"><strong>Posso usar a fun&ccedil;&atilde;o get_post_meta para exibir todos os campos personalizados?<\/strong><\/h3>\n<div class=\"rank-math-answer \">\n\n<p>Sim. O segundo par&acirc;metro da fun&ccedil;&atilde;o indica qual campo personalizado voc&ecirc; quer acessar. Se voc&ecirc; deixar como uma string vazia, ela vai buscar os valores de todos os campos personalizados do post. J&aacute; se colocar <strong>FALSE<\/strong>, ela retorna um array completo com todos os meta dados.<\/p>\n\n<\/div>\n<\/div>\n<div id=\"faq-question-6944106aaf157\" class=\"rank-math-list-item\">\n<h3 class=\"rank-math-question \"><strong>Como eu encontro o ID do post para usar na fun&ccedil;&atilde;o get_post_meta?<\/strong><\/h3>\n<div class=\"rank-math-answer \">\n\n<p>Existem v&aacute;rios m&eacute;todos para <a href=\"https:\/\/www.hostinger.com\/pt\/tutoriais\/post-id-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><strong><u>identificar o ID<\/u><\/strong><\/a> do post no WordPress. A forma mais f&aacute;cil &eacute; usar um plugin como o <a href=\"https:\/\/www.hostinger.com\/pt\/tutoriais\/post-id-wordpress\" target=\"_blank\" rel=\"noreferrer noopener\"><strong><u>Reveal IDs<\/u><\/strong><\/a>, que adiciona uma coluna com os IDs nos menus <strong>Todos os Posts<\/strong> e <strong>Todas as P&aacute;ginas<\/strong>. Outra op&ccedil;&atilde;o &eacute; usar <strong>echo get_the_ID<\/strong> para mostrar o ID direto no post.<\/p>\n\n<\/div>\n<\/div>\n<\/div>\n<\/div><p><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Um campo personalizado no WordPress armazena informa&ccedil;&otilde;es extras sobre um post no back-end. Para recuperar e exibir esses meta dados, adicione a fun&ccedil;&atilde;o get_post_meta ao c&oacute;digo do seu site. Esses meta dados s&atilde;o exibidos pelos desenvolvedores do WordPress para tornar a navega&ccedil;&atilde;o mais intuitiva e o conte&uacute;do mais acess&iacute;vel. Por exemplo, &eacute; poss&iacute;vel real&ccedil;ar o [&#8230;]<\/p>\n<p><a class=\"btn btn-secondary understrap-read-more-link\" href=\"\/br\/tutoriais\/get-post-meta\">Read More&#8230;<\/a><\/p>\n","protected":false},"author":473,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"rank_math_title":"","rank_math_description":"Descubra como usar a fun\u00e7\u00e3o get_post_meta do WordPress para exibir campos personalizados no seu site, tornando a navega\u00e7\u00e3o mais intuitiva.","rank_math_focus_keyword":"get_post_meta","footnotes":""},"categories":[4911],"tags":[],"class_list":["post-49232","post","type-post","status-publish","format-standard","hentry","category-wordpress"],"hreflangs":[{"locale":"en-US","link":"https:\/\/www.hostinger.com\/tutorials\/wordpress-get_post_meta","default":0},{"locale":"pt-BR","link":"https:\/\/www.hostinger.com\/br\/tutoriais\/get-post-meta","default":0},{"locale":"es-ES","link":"https:\/\/www.hostinger.com\/es\/tutoriales\/gestor-de-archivos-wordpress","default":0},{"locale":"en-UK","link":"https:\/\/www.hostinger.com\/uk\/tutorials\/wordpress-get_post_meta","default":0},{"locale":"en-MY","link":"https:\/\/www.hostinger.com\/my\/tutorials\/wordpress-get_post_meta","default":0},{"locale":"en-PH","link":"https:\/\/www.hostinger.com\/ph\/tutorials\/wordpress-get_post_meta","default":0},{"locale":"es-MX","link":"https:\/\/www.hostinger.com\/mx\/tutoriales\/gestor-de-archivos-wordpress","default":0},{"locale":"es-CO","link":"https:\/\/www.hostinger.com\/co\/tutoriales\/gestor-de-archivos-wordpress","default":0},{"locale":"es-AR","link":"https:\/\/www.hostinger.com\/ar\/tutoriales\/gestor-de-archivos-wordpress","default":0},{"locale":"en-IN","link":"https:\/\/www.hostinger.com\/in\/tutorials\/wordpress-get_post_meta","default":0},{"locale":"en-CA","link":"https:\/\/www.hostinger.com\/ca\/tutorials\/wordpress-get_post_meta","default":0},{"locale":"pt-PT","link":"https:\/\/www.hostinger.com\/pt\/tutoriais\/get-post-meta","default":0},{"locale":"en-AU","link":"https:\/\/www.hostinger.com\/au\/tutorials\/wordpress-get_post_meta","default":0},{"locale":"en-NG","link":"https:\/\/www.hostinger.com\/ng\/tutorials\/wordpress-get_post_meta","default":0}],"acf":[],"_links":{"self":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/49232","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/users\/473"}],"replies":[{"embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/comments?post=49232"}],"version-history":[{"count":12,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/49232\/revisions"}],"predecessor-version":[{"id":51521,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/posts\/49232\/revisions\/51521"}],"wp:attachment":[{"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/media?parent=49232"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/categories?post=49232"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.hostinger.com\/br\/tutoriais\/wp-json\/wp\/v2\/tags?post=49232"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}