{"id":1250,"date":"2019-06-29T11:37:07","date_gmt":"2019-06-29T14:37:07","guid":{"rendered":"https:\/\/felipeelia.com.br\/?p=1250"},"modified":"2022-08-27T19:05:08","modified_gmt":"2022-08-27T22:05:08","slug":"ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest","status":"publish","type":"post","link":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/","title":{"rendered":"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST"},"content":{"rendered":"\n<p>H\u00e1 algum tempo, depois de anunciar a chegada do primeiro beta do WordPress 5.1 no grupo WordPress Brasil no Facebook, um usu\u00e1rio perguntou quando viria a op\u00e7\u00e3o de ordenar aleatoriamente os posts na <a href=\"https:\/\/felipeelia.com.br\/a-api-rest-do-wordpress\/\">API REST do WordPress<\/a>. Expliquei que n\u00e3o era preciso ter isso no <em>core<\/em> e criei um c\u00f3digo para habilitar esta funcionalidade.<\/p>\n\n\n\n<p>O c\u00f3digo abaixo usa o <a href=\"https:\/\/felipeelia.com.br\/hooks-no-wordpress-actions-e-filters\/\">filtro<\/a> <code>rest_{$this-&gt;post_type}_collection_params<\/code> para incluir <code>rand<\/code> como uma entrada no array que enumera os valores poss\u00edveis para a ordena\u00e7\u00e3o. Este filtro \u00e9 usado no final do m\u00e9todo <code>get_collection_params<\/code> da classe <code>WP_REST_Posts_Controller<\/code>, como voc\u00ea pode ver <a rel=\"noreferrer noopener\" aria-label=\"aqui (abre numa nova aba)\" href=\"https:\/\/github.com\/WordPress\/WordPress\/tree\/master\/wp-includes\/rest-api\/endpoints\/class-wp-rest-posts-controller.php#L2545\" target=\"_blank\">aqui<\/a>. A parte <code>{$this-&gt;post_type}<\/code> do filtro \u00e9 vari\u00e1vel e no c\u00f3digo eu uso para alterar a lista de posts.<\/p>\n\n\n\n<p>Para usar basta chamar <code>\/wp-json\/wp\/v2\/posts?orderby=rand<\/code>. Se voc\u00ea estiver usando alguma solu\u00e7\u00e3o para cache, o funcionamento pode ser afetado.<\/p>\n\n\n\n<pre class=\"wp-block-code php\"><code>&lt;?php\n\/**\n * Plugin Name: REST API - Post list randomize\n * Description: Randomize the content list in REST API passing `orderby=rand` as parameter.\n * Version:     1.0.0\n * Author:      Felipe Elia | Codeable\n * Author URI:  https:\/\/codeable.io\/developers\/felipe-elia?ref=qGTOJ\n *\/\n\n\/**\n * Add `rand` as an option for orderby param in REST API.\n * Hook to `rest_{$this-&gt;post_type}_collection_params` filter.\n *\n * @param array $query_params Accepted parameters.\n * @return array\n *\/\nfunction add_rand_orderby_rest_post_collection_params( $query_params ) {\n\t$query_params&#91;'orderby']&#91;'enum']&#91;] = 'rand';\n\treturn $query_params;\n}\nadd_filter( 'rest_post_collection_params', 'add_rand_orderby_rest_post_collection_params' );<\/code><\/pre>\n\n\n\n<p>\u00c9 s\u00f3 salvar o c\u00f3digo como um arquivo php e colocar o arquivo na pasta plugins. O c\u00f3digo tamb\u00e9m est\u00e1 dispon\u00edvel no <a href=\"https:\/\/gist.github.com\/felipeelia\/db5ecc36885bb3cbde5334b06861ea78\">gist<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_uag_custom_page_level_css":"","footnotes":""},"categories":[30],"tags":[104],"yoast_head":"<!-- This site is optimized with the Yoast SEO plugin v21.9.1 - https:\/\/yoast.com\/wordpress\/plugins\/seo\/ -->\n<title>Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST | Felipe Elia<\/title>\n<meta name=\"description\" content=\"Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.\" \/>\n<meta name=\"robots\" content=\"index, follow, max-snippet:-1, max-image-preview:large, max-video-preview:-1\" \/>\n<link rel=\"canonical\" href=\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/\" \/>\n<meta property=\"og:locale\" content=\"pt_BR\" \/>\n<meta property=\"og:type\" content=\"article\" \/>\n<meta property=\"og:title\" content=\"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST | Felipe Elia\" \/>\n<meta property=\"og:description\" content=\"Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.\" \/>\n<meta property=\"og:url\" content=\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/\" \/>\n<meta property=\"og:site_name\" content=\"Felipe Elia\" \/>\n<meta property=\"article:publisher\" content=\"https:\/\/www.facebook.com\/felipe.elia\" \/>\n<meta property=\"article:author\" content=\"https:\/\/www.facebook.com\/felipe.elia\" \/>\n<meta property=\"article:published_time\" content=\"2019-06-29T14:37:07+00:00\" \/>\n<meta property=\"article:modified_time\" content=\"2022-08-27T22:05:08+00:00\" \/>\n<meta property=\"og:image\" content=\"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2017\/09\/query-posts.jpg\" \/>\n\t<meta property=\"og:image:width\" content=\"1200\" \/>\n\t<meta property=\"og:image:height\" content=\"630\" \/>\n\t<meta property=\"og:image:type\" content=\"image\/jpeg\" \/>\n<meta name=\"author\" content=\"Felipe Elia\" \/>\n<meta name=\"twitter:card\" content=\"summary_large_image\" \/>\n<meta name=\"twitter:creator\" content=\"@https:\/\/twitter.com\/felipe_elia\" \/>\n<meta name=\"twitter:site\" content=\"@felipe_elia\" \/>\n<meta name=\"twitter:label1\" content=\"Escrito por\" \/>\n\t<meta name=\"twitter:data1\" content=\"Felipe Elia\" \/>\n\t<meta name=\"twitter:label2\" content=\"Est. tempo de leitura\" \/>\n\t<meta name=\"twitter:data2\" content=\"2 minutos\" \/>\n<script type=\"application\/ld+json\" class=\"yoast-schema-graph\">{\"@context\":\"https:\/\/schema.org\",\"@graph\":[{\"@type\":\"Article\",\"@id\":\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#article\",\"isPartOf\":{\"@id\":\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/\"},\"author\":{\"name\":\"Felipe Elia\",\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"headline\":\"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST\",\"datePublished\":\"2019-06-29T14:37:07+00:00\",\"dateModified\":\"2022-08-27T22:05:08+00:00\",\"mainEntityOfPage\":{\"@id\":\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/\"},\"wordCount\":171,\"commentCount\":0,\"publisher\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"keywords\":[\"API REST\"],\"articleSection\":[\"WordPress\"],\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"CommentAction\",\"name\":\"Comment\",\"target\":[\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#respond\"]}]},{\"@type\":\"WebPage\",\"@id\":\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/\",\"url\":\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/\",\"name\":\"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST | Felipe Elia\",\"isPartOf\":{\"@id\":\"https:\/\/felipeelia.com.br\/#website\"},\"datePublished\":\"2019-06-29T14:37:07+00:00\",\"dateModified\":\"2022-08-27T22:05:08+00:00\",\"description\":\"Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.\",\"breadcrumb\":{\"@id\":\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#breadcrumb\"},\"inLanguage\":\"pt-BR\",\"potentialAction\":[{\"@type\":\"ReadAction\",\"target\":[\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/\"]}]},{\"@type\":\"BreadcrumbList\",\"@id\":\"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"In\u00edcio\",\"item\":\"https:\/\/felipeelia.dev\/\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST\"}]},{\"@type\":\"WebSite\",\"@id\":\"https:\/\/felipeelia.com.br\/#website\",\"url\":\"https:\/\/felipeelia.com.br\/\",\"name\":\"Felipe Elia\",\"description\":\"Programa\u00e7\u00e3o com WordPress de um jeito f\u00e1cil, do b\u00e1sico ao avan\u00e7ado\",\"publisher\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\"},\"potentialAction\":[{\"@type\":\"SearchAction\",\"target\":{\"@type\":\"EntryPoint\",\"urlTemplate\":\"https:\/\/felipeelia.com.br\/?s={search_term_string}\"},\"query-input\":\"required name=search_term_string\"}],\"inLanguage\":\"pt-BR\"},{\"@type\":[\"Person\",\"Organization\"],\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292\",\"name\":\"Felipe Elia\",\"image\":{\"@type\":\"ImageObject\",\"inLanguage\":\"pt-BR\",\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/\",\"url\":\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg\",\"contentUrl\":\"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg\",\"width\":400,\"height\":400,\"caption\":\"Felipe Elia\"},\"logo\":{\"@id\":\"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/\"},\"description\":\"Associate Director of Platform Engineering na 10up, WordPress Core Contributor, Global Polyglots Mentor na comunidade internacional do WordPress e Locale Manager na comunidade WordPress Brasil.\",\"sameAs\":[\"https:\/\/www.facebook.com\/felipe.elia\",\"https:\/\/www.instagram.com\/felipe.elia\/\",\"https:\/\/www.linkedin.com\/in\/felipeelia\/\",\"https:\/\/twitter.com\/https:\/\/twitter.com\/felipe_elia\",\"https:\/\/www.youtube.com\/channel\/UCD_26rOE3ClALcZreTkyIoQ\"],\"url\":\"https:\/\/felipeelia.com.br\/author\/admin\/\"}]}<\/script>\n<!-- \/ Yoast SEO plugin. -->","yoast_head_json":{"title":"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST | Felipe Elia","description":"Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.","robots":{"index":"index","follow":"follow","max-snippet":"max-snippet:-1","max-image-preview":"max-image-preview:large","max-video-preview":"max-video-preview:-1"},"canonical":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/","og_locale":"pt_BR","og_type":"article","og_title":"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST | Felipe Elia","og_description":"Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.","og_url":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/","og_site_name":"Felipe Elia","article_publisher":"https:\/\/www.facebook.com\/felipe.elia","article_author":"https:\/\/www.facebook.com\/felipe.elia","article_published_time":"2019-06-29T14:37:07+00:00","article_modified_time":"2022-08-27T22:05:08+00:00","og_image":[{"width":"1200","height":"630","url":"https:\/\/felipeelia.com.br\/wp-content\/uploads\/2017\/09\/query-posts.jpg","type":"image\/jpeg"}],"author":"Felipe Elia","twitter_card":"summary_large_image","twitter_creator":"@https:\/\/twitter.com\/felipe_elia","twitter_site":"@felipe_elia","twitter_misc":{"Escrito por":"Felipe Elia","Est. tempo de leitura":"2 minutos"},"schema":{"@context":"https:\/\/schema.org","@graph":[{"@type":"Article","@id":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#article","isPartOf":{"@id":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/"},"author":{"name":"Felipe Elia","@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"headline":"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST","datePublished":"2019-06-29T14:37:07+00:00","dateModified":"2022-08-27T22:05:08+00:00","mainEntityOfPage":{"@id":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/"},"wordCount":171,"commentCount":0,"publisher":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"keywords":["API REST"],"articleSection":["WordPress"],"inLanguage":"pt-BR","potentialAction":[{"@type":"CommentAction","name":"Comment","target":["https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#respond"]}]},{"@type":"WebPage","@id":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/","url":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/","name":"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST | Felipe Elia","isPartOf":{"@id":"https:\/\/felipeelia.com.br\/#website"},"datePublished":"2019-06-29T14:37:07+00:00","dateModified":"2022-08-27T22:05:08+00:00","description":"Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.","breadcrumb":{"@id":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#breadcrumb"},"inLanguage":"pt-BR","potentialAction":[{"@type":"ReadAction","target":["https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/"]}]},{"@type":"BreadcrumbList","@id":"https:\/\/felipeelia.com.br\/ordem-aleatoria-order-by-rand-na-lista-de-posts-da-api-rest\/#breadcrumb","itemListElement":[{"@type":"ListItem","position":1,"name":"In\u00edcio","item":"https:\/\/felipeelia.dev\/"},{"@type":"ListItem","position":2,"name":"Ordem aleat\u00f3ria (order by rand) na lista de posts da API REST"}]},{"@type":"WebSite","@id":"https:\/\/felipeelia.com.br\/#website","url":"https:\/\/felipeelia.com.br\/","name":"Felipe Elia","description":"Programa\u00e7\u00e3o com WordPress de um jeito f\u00e1cil, do b\u00e1sico ao avan\u00e7ado","publisher":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292"},"potentialAction":[{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https:\/\/felipeelia.com.br\/?s={search_term_string}"},"query-input":"required name=search_term_string"}],"inLanguage":"pt-BR"},{"@type":["Person","Organization"],"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/927a99b6e1cde7fcf9f4f79a1638b292","name":"Felipe Elia","image":{"@type":"ImageObject","inLanguage":"pt-BR","@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/","url":"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg","contentUrl":"https:\/\/felipeelia.dev\/wp-content\/uploads\/2023\/06\/avatar-400x400-1.jpg","width":400,"height":400,"caption":"Felipe Elia"},"logo":{"@id":"https:\/\/felipeelia.com.br\/#\/schema\/person\/image\/"},"description":"Associate Director of Platform Engineering na 10up, WordPress Core Contributor, Global Polyglots Mentor na comunidade internacional do WordPress e Locale Manager na comunidade WordPress Brasil.","sameAs":["https:\/\/www.facebook.com\/felipe.elia","https:\/\/www.instagram.com\/felipe.elia\/","https:\/\/www.linkedin.com\/in\/felipeelia\/","https:\/\/twitter.com\/https:\/\/twitter.com\/felipe_elia","https:\/\/www.youtube.com\/channel\/UCD_26rOE3ClALcZreTkyIoQ"],"url":"https:\/\/felipeelia.com.br\/author\/admin\/"}]}},"uagb_featured_image_src":{"full":false,"thumbnail":false,"medium":false,"medium_large":false,"large":false,"1536x1536":false,"2048x2048":false,"ocean-thumb-m":false,"ocean-thumb-ml":false,"ocean-thumb-l":false,"yarpp-thumbnail":false},"uagb_author_info":{"display_name":"Felipe Elia","author_link":"https:\/\/felipeelia.com.br\/author\/admin\/"},"uagb_comment_info":0,"uagb_excerpt":"Um plugin simples para habilitar a ordena\u00e7\u00e3o aleat\u00f3ria dos posts na API REST do WordPress.","_links":{"self":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/posts\/1250"}],"collection":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/comments?post=1250"}],"version-history":[{"count":0,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/posts\/1250\/revisions"}],"wp:attachment":[{"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/media?parent=1250"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/categories?post=1250"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/felipeelia.com.br\/wp-json\/wp\/v2\/tags?post=1250"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}