{"id":228846,"date":"2022-10-18T18:23:00","date_gmt":"2022-10-18T15:23:00","guid":{"rendered":"https:\/\/wordpress.mediadoma.com\/?p=228846"},"modified":"2022-11-09T04:30:20","modified_gmt":"2022-11-09T01:30:20","slug":"wp_query-wordpress-block-editor-gutenberg-equivalente-e-getentityrecords","status":"publish","type":"post","link":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp_query-wordpress-block-editor-gutenberg-equivalente-e-getentityrecords\/","title":{"rendered":"WP_Query WordPress Block Editor (Gutenberg) Equivalente \u00e9 getEntityRecords"},"content":{"rendered":"\n<p>Se voc\u00ea \u00e9 novo em escrever plugins para o WordPress Block Editor (Gutenberg), pode estar um pouco confuso sobre como fazer todas as coisas que fazia regularmente, como pegar postagens com WP_Query.<\/p>\n<p>Voc\u00ea ficar\u00e1 muito satisfeito em saber que ainda pode fazer tudo o que costumava fazer com WP_Query usando <code>getEntityRecords<\/code>.<\/p>\n<p>Por exemplo, podemos pegar as postagens mais recentes usando o seguinte trecho de c\u00f3digo:<\/p>\n<p>wp.data.select( &#8216;core&#8217; ).getEntityRecords( &#8216;postType&#8217;, &#8216;posts&#8217; );<\/p>\n<p>Voc\u00ea tamb\u00e9m pode consultar tipos de postagem personalizados (CPT) da mesma maneira, desde que tenha <a href=\"https:\/\/developer.wordpress.org\/rest-api\/extending-the-rest-api\/adding-rest-api-support-for-custom-content-types\/#registering-a-custom-post-type-with-rest-api-support\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">tornado seu CPT acess\u00edvel por meio da API REST<\/a>.<\/p>\n<p>wp.data.select( &#8216;core&#8217; ).getEntityRecords( &#8216;postType&#8217;, &#8216;my_custom_post_type&#8217; );<\/p>\n<p>Podemos at\u00e9 passar alguns argumentos que podem parecer familiares:<\/p>\n<pre><code>wp.data.select( 'core' ).getEntityRecords(\n    'postType', \n    'post', \n    {\n        'status': 'draft', \n        'per_page': 2, \n    } \n);\n`\n<\/code><\/pre>\n<p>Voc\u00ea pode encontrar a lista definitiva dos argumentos que voc\u00ea pode passar para a fun\u00e7\u00e3o aqui no <a href=\"https:\/\/developer.wordpress.org\/rest-api\/reference\/posts\/#arguments\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">guia do desenvolvedor do Gutenberg<\/a>.<\/p>\n<h2>Experimente no console<\/h2>\n<p>Se voc\u00ea estiver logado em um site e estiver visualizando o front-end, poder\u00e1 testar praticamente qualquer comando do Gutenberg. O WordPress armazena todos eles no <code>wp<\/code>objeto acess\u00edvel.<\/p>\n<p>Digitando o comando acima no console em um dos meus sites de desenvolvimento, recebo o seguinte:<\/p>\n<p>Usando getEntityRecords para pegar postagens no Console<\/p>\n<p>A captura de tela acima mostra o console retornando dois objetos de postagem do WordPress no JavaScript, que s\u00e3o postagens de rascunho (de acordo com os par\u00e2metros que passei para <code>getEntityRecords<\/code>).<\/p>\n<h2>O objeto de postagem JavaScript<\/h2>\n<p>Explorando ainda mais o objeto post no console, voc\u00ea pode ver que h\u00e1 muitas propriedades retornadas para voc\u00ea acessar.<\/p>\n<pre><code>    id: 42\n    date: \"2020-03-21T14:02:00\"\n    date_gmt: \"2020-03-21T14:02:00\"\n    guid: {\n        rendered: \"https:\/\/wholesomecode.ltd\/?p=42\"\n        raw: \"https:\/\/wholesomecode.ltd\/?p=42\"\n    }\n    modified: \"2020-03-21T14:02:00\"\n    modified_gmt: \"2020-03-21T14:02:00\"\n    password: \"\"\n    slug: \"wp-query-and-the-wordpress-block-editor-gutenberg\"\n    status: \"draft\"\n    type: \"post\"\n    link: \"https:\/\/wholesomecode.ltd\/?p=42\"\n    title: {\n        raw: \"WP_Query and the WordPress Block Editor (Gutenberg)\"\n        rendered: \"WP_Query and the WordPress Block Editor (Gutenberg)\"\n    }\n    content: {\n        raw: \"Content goes here.\"    \n        rendered: \"&lt;p&gt;Content goes here.&lt;\/p&gt;\u21b5\"\n        protected: false\n        block_version: 0\n    }\n    excerpt: {\n        raw: \"\"\n        rendered: \"&lt;p&gt;Content goes here.&lt;\/p&gt;\u21b5\"\n        protected: false\n    }\n    author: 1\n    featured_media: 101\n    comment_status: \"open\"\n    ping_status: \"open\"\n    sticky: false\n    template: \"\"\n    format: \"standard\"\n    meta: {\n        _wcltd_meta_example_1: \"1\"         \n        _wcltd_meta_example_2: \"Hello\"\n    }\n    categories: [1]\n    tags: []\n    country: []\n    region: []\n    city: []\n    permalink_template: \"https:\/\/wholesomecode.ltd\/%postname%\/\"\n    generated_slug: \"wp-query-and-the-wordpress-block-editor-gutenberg\"\n<\/code><\/pre>\n<h2>Post Meta em Gutenberg<\/h2>\n<p>Uma coisa que voc\u00ea notar\u00e1 no objeto post que exploramos acima \u00e9 que todo o meta do post est\u00e1 contido no objeto na <code>meta<\/code>propriedade. Isso nos poupa de fazer o equivalente a <code>get_post_meta()<\/code>para este objeto em Gutenberg.<\/p>\n<p>No entanto, se voc\u00ea quiser obter a meta do post para um \u00fanico objeto post, <a href=\"https:\/\/wholesomecode.ltd\/blog\/get_post_meta-wordpress-block-editor-gutenberg-equivalent-is-geteditedpostattributemeta\/?preview_id=3880&#038;preview_nonce=46ba9ffabf&#038;preview=true\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">veja o <code>get_post_meta<\/code>equivalente no artigo do Gutenberg<\/a>.<\/p>\n<h2>Obtendo os detalhes da imagem em Gutemberg<\/h2>\n<p>O objeto de postagem voc\u00ea pode obter o ID da m\u00eddia em destaque, que \u00e9 armazenado na <code>featured_media<\/code>propriedade.<\/p>\n<p>Voc\u00ea pode usar <code>getMedia<\/code>(o <a href=\"https:\/\/wholesomecode.ltd\/blog\/wp_get_attachment_image-gutenberg-equivalent-getmeta\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">equivalente do WordPress Gutenberg de<code>wp_get_attachment_image<\/code><\/a>) para obter as propriedades deste anexo.<\/p>\n<h2>O Loop Post de Gutenberg<\/h2>\n<p>Vamos expandir o <a href=\"https:\/\/wholesomecode.ltd\/articles\/an-overview-of-the-wordpress-create-block-script\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">bloco criado pelo <code>@wordpress\/create-block<\/code>script, sobre o qual escrevi anteriormente<\/a>, para incluir um exemplo de como fazer o equivalente a um loop WP_Query no Gutenberg.<\/p>\n<p>Primeiro, precisamos importar a <code>select()<\/code>fun\u00e7\u00e3o de wp-data. Podemos fazer isso referenciando o m\u00f3dulo NPM:<\/p>\n<p><code>import { select } from '@wordpress\/data;<\/code><\/p>\n<p>Ou usando o <code>wp<\/code>objeto:<\/p>\n<p><code>const { select } = wp.data;<\/code><\/p>\n<p>Vamos ficar com as pr\u00e1ticas usadas no bloco criado e usar o m\u00f3dulo NPM, e usar o <code>@wordpress\/data<\/code>m\u00e9todo.<\/p>\n<p>Aqui est\u00e1 uma implementa\u00e7\u00e3o b\u00e1sica do equivalente a um loop WP_Query em Gutenberg.<\/p>\n<p><strong>Imagens em destaque<\/strong><\/p>\n<p>Observe que as imagens em destaque devem ser definidas para as duas \u00faltimas postagens para que este exemplo funcione corretamente.<\/p>\n<pre><code>import { registerBlockType } from '@wordpress\/blocks';\nimport { select, withSelect } from '@wordpress\/data';\nimport { __ } from '@wordpress\/i18n';\n\nregisterBlockType( 'wholesomecode\/wholesome-plugin', {\n    title: __( 'Wholesome Plugin', 'wholesomecode' ),\n    description: __( 'Just an Example Plugin', 'wholesomecode' ),\n    category: 'common',\n    icon: 'smiley',\n\n    edit: withSelect( (select) =&gt; {\n        const posts = select( 'core' ).getEntityRecords( 'postType', 'post', { 'per_page': 2 } );\n        let media = {};\n        posts.forEach( post =&gt; {\n            media[ post.id ] = select('core').getMedia( post.featured_media );\n        });\n        return {\n            posts,\n            media\n        };\n    } )( props =&gt; {\n\n        const { media, posts } = props;\n\n        if (! posts ||! media) {\n            return (&lt;p&gt;{ __( 'Loading...', 'wholesomecode') }&lt;\/p&gt;\n            );\n        }\n\n        return (&lt;ul&gt;\n            { posts.map( (post) =&gt; {\n                    if (media[ post.id ]) {\n                        const imageThumbnailSrc = media[ post.id ].media_details.sizes.thumbnail.source_url;\n                    return (&lt;li&gt;\n                            &lt;img src={ imageThumbnailSrc } \/&gt;\n                            &lt;a href={ post.link }&gt;\n                                { post.title.raw }\n                            &lt;\/a&gt;\n                        &lt;\/li&gt;) }\n                }) }\n            &lt;\/ul&gt;\n        );\n    } ),\n\n    save() {\n        return (&lt;p&gt;\n                { __( 'Wholesome Plugin \u2013 Nothing to see here.', 'wholesomecode') }\n            &lt;\/p&gt;\n        );\n    },\n} );\n<\/code><\/pre>\n<p>Observe o uso de <code>withSelect<\/code>para pr\u00e9-carregar os dados antes que o bloco seja carregado. Voc\u00ea pode <a href=\"https:\/\/developer.wordpress.org\/block-editor\/packages\/packages-data\/#withSelect\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">descobrir mais sobre withSelect lendo a documenta\u00e7\u00e3o do Gutenberg<\/a>.<\/p>\n<p>O c\u00f3digo acima gera o seguinte exemplo (muito b\u00e1sico) de uma lista de artigos e suas miniaturas associadas no editor:<\/p>\n<p><img decoding=\"async\" src=\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-168779-61e7f3032376a.png\" alt=\"WP_Query WordPress Block Editor (Gutenberg) Equivalente \u00e9 getEntityRecords\" \/>Exemplo de Post Loop em Gutenberg.<\/p>\n<h2>Usando a API REST<\/h2>\n<p>Se voc\u00ea deseja obter dados personalizados por meio da API REST, confira meu post sobre <a href=\"https:\/\/wholesomecode.ltd\/articles\/using-the-wordpress-block-editor-gutenberg-with-the-rest-api\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">como usar a API REST com o WordPress Block Editor (Gutenberg)<\/a>.<\/p>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Fonte de grava\u00e7\u00e3o:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/wholesomecode.ltd\" class=\"external external_icon\">wholesomecode.ltd<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Se voc\u00ea \u00e9 novo em escrever plugins para o WordPress Block Editor (Gutenberg), pode estar um pouco confuso sobre como fazer todas as coisas que fazia regularmente, como pegar postagens com WP_Q&#8230;<\/p>\n","protected":false},"author":1,"featured_media":223674,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[898,722,941,920,846,867],"tags":[1170],"class_list":["post-228846","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-codigo-2","category-desenvolvedor","category-gutenberg-8","category-outro","category-tutoriais","category-wordpress-8","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228846","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/comments?post=228846"}],"version-history":[{"count":0,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/posts\/228846\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media\/223674"}],"wp:attachment":[{"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/media?parent=228846"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/categories?post=228846"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/wordpress.mediadoma.com\/pt-pt\/wp-json\/wp\/v2\/tags?post=228846"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}