Vou come\u00e7ar com um TL;DR primeiro, no entanto. Dessa forma, voc\u00ea pode ter a ideia antes de ler a coisa toda.<\/p>\n
Modelos de arquivo personalizados<\/h2>\n
Ent\u00e3o o TL;DR por tr\u00e1s da coisa toda \u00e9 isso:<\/p>\n
- \n
- as informa\u00e7\u00f5es de data fornecidas pela API de terceiros s\u00e3o mantidas na tabela de metadados post,<\/li>\n
- a chave \u00e9 a data de in\u00edcio e o valor \u00e9 a data real,<\/li>\n
- Ordeno o conte\u00fado em ordem decrescente e pelo valor meta.<\/li>\n<\/ul>\n
A pagina\u00e7\u00e3o pode ser um problema e, se voc\u00ea usar um tipo de postagem personalizado, precisar\u00e1 de alguns par\u00e2metros extras, mas essa \u00e9 a ideia geral.<\/p>\n
Agora para toda a configura\u00e7\u00e3o.<\/p>\n
Tipos de postagem personalizados<\/h3>\n
Quando se trata de interface com APIs de terceiros, sou um grande f\u00e3 de tipos de postagem personalizados porque costumo pensar neles como um h\u00edbrido entre modelos e visualiza\u00e7\u00f5es.<\/p>\n
- \n
- O componente de modelo inclui qualquer coisa que seja tangencialmente relacionada e possa ser gravada no banco de dados. Isso significa qualquer informa\u00e7\u00e3o de taxonomia ou meta-dados de postagem.<\/li>\n
- O componente de visualiza\u00e7\u00e3o geralmente \u00e9 qualquer coisa que v\u00e1 para o modelo que possa alavancar quaisquer tags de modelo pr\u00e9-existentes, ou qualquer coisa que precise ser criada e que tamb\u00e9m leia informa\u00e7\u00f5es do banco de dados.<\/li>\n<\/ul>\n
Para este post, vou usar acme-event<\/strong> como o tipo de post personalizado.<\/p>\n
Postar metadados<\/h3>\n
Eu defino as datas nos metadados do post e n\u00e3o no post em si, porque se algo acontecer no futuro e os dados forem definidos no pr\u00f3prio registro do post, o WordPress o tratar\u00e1 como um post agendado<\/strong> que n\u00e3o foi publicado .<\/p>\n<\/p>\n
Em vez disso, prefiro publicar a postagem e alterar a maneira como os metadados s\u00e3o exibidos no modelo.<\/p>\n
Pagina\u00e7\u00e3o<\/h3>\n
O WordPress faz uma distin\u00e7\u00e3o sutil com a pagina\u00e7\u00e3o em sua base de c\u00f3digo. Ou seja, a vari\u00e1vel de consulta para sites sem uma p\u00e1gina inicial est\u00e1tica usa paged<\/strong> e o caso oposto usa page<\/strong>.<\/p>\n
![\"Modelos](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161511-61e724257d2b2.png\")
<\/a><\/p>\nIsso \u00e9 importante quando voc\u00ea est\u00e1 construindo os argumentos para a consulta que vou abordar momentaneamente.<\/p>\n
Arquivar apenas p\u00e1ginas<\/h3>\n
Lembre-se de que sempre que estiver introduzindo a pagina\u00e7\u00e3o, voc\u00ea s\u00f3 deseja alterar a consulta sempre que estiver na p\u00e1gina de arquivo real.<\/p>\n
Isso significa que voc\u00ea n\u00e3o se importa com casos em que est\u00e1 na \u00e1rea administrativa do WordPress e n\u00e3o deseja alterar a consulta para arquivos n\u00e3o personalizados do tipo post. Para esse fim, voc\u00ea deve certificar-se de que est\u00e1 configurando a vari\u00e1vel de consulta corretamente no retorno de chamada pre_get_posts.<\/p>\n
Observe que posso mostrar uma fun\u00e7\u00e3o de como fazer isso, mas por causa de como escrevemos c\u00f3digo no WordPress \u2013 ou seja, alguns escrevem c\u00f3digo procedural, outros escrevem c\u00f3digo orientado a objetos \u2013 vou simplesmente exibi-lo em c\u00f3digo procedural.<\/p>\n
Juntando tudo<\/h3>\n
Primeiro, vou construir a consulta:<\/a><\/p>\n
<?php\n\n$eventQuery = new WP_Query([\n 'post_type' => 'acme-events',\n 'post_status' => 'publish',\n 'orderby' => 'meta_value',\n 'order' => 'desc',\n 'meta_key' => 'acme-event-start-date-time',\n 'posts_per_archive_page' => 5,\n 'paged' => get_query_var('paged')? get_query_var('paged'): 1\n]);<\/code><\/pre>\nObserve que no c\u00f3digo acima h\u00e1 um argumento para paged<\/strong>. Vou falar sobre o c\u00f3digo para isso momentaneamente.<\/p>\n
Em seguida, o modelo incluir\u00e1 todas as informa\u00e7\u00f5es que voc\u00ea optar por exibir. Estou optando por n\u00e3o compartilhar o c\u00f3digo do meu modelo neste post porque \u00e9 irrelevante para a ideia maior em quest\u00e3o.<\/p>\n
Al\u00e9m disso, voc\u00ea tem tudo o que precisa para exibir o conte\u00fado.<\/p>\n
Em seguida, definirei a pagina\u00e7\u00e3o. Primeiro, preciso fazer isso usando o gancho pre_get_posts para garantir que a vari\u00e1vel de consulta adequada esteja definida<\/a> :<\/p>\n
<?php\n\nadd_action('pre_get_posts', 'setCustomQueryVariable');\npublic function setCustomQueryVariable($query)\n{\n if (is_admin() || !is_archive()) {\n return;\n }\n\n if ($query->is_archive('acme-events')) {\n set_query_var('posts_per_page', 5);\n }\n}<\/code><\/pre>\nEm seguida, implementarei a pagina\u00e7\u00e3o<\/a> usando a consulta personalizada:<\/p>\n
<?php\n\n<a class=\"next page-numbers\" href=\"<?php echo esc_attr(get_next_posts_page_link($eventQuery->max_num_pages)); ?>\">\n Next Page\n<\/a>\n\n<a class=\"prev page-numbers\" href=\"<?php echo esc_attr(get_previous_posts_page_link()); ?>\">\n Previous Page\n<\/a><\/code><\/pre>\nE depois disso, vou redefinir a vari\u00e1vel global $post<\/a> usando wp_reset_postdata() caso alguma coisa da postagem original precise ser usada.<\/p>\n
<?php wp_reset_postdata(); ?><\/code><\/pre>\nIsso geralmente \u00e9 considerado uma boa limpeza sempre que voc\u00ea usa uma consulta personalizada.<\/p>\n
Links \u00dateis<\/h3>\n
Abaixo est\u00e1 uma lista de fun\u00e7\u00f5es, p\u00e1ginas e refer\u00eancias que voc\u00ea pode achar \u00fateis no que se refere ao c\u00f3digo acima ou a qualquer trabalho futuro que voc\u00ea possa fazer.<\/p>\n
- \n
- WP_Query<\/a><\/li>\n
- Pagina\u00e7\u00e3o<\/a><\/li>\n
- pre_get_posts<\/a><\/li>\n
- get_query_var<\/a><\/li>\n
- set_query_var<\/a><\/li>\n
- get_next_posts_page_link<\/a><\/li>\n
- get_previous_posts_page_link<\/a><\/li>\n
- update_post_meta<\/a><\/li>\n
- wp_reset_postdata<\/a><\/li>\n
- O c\u00f3digo completo<\/a> neste post.<\/li>\n<\/ul>\n
Se voc\u00ea trabalha com o WordPress h\u00e1 muito tempo, alguns deles podem parecer redundantes. Em outros casos, pode parecer novo ou pode esclarecer \u00e1reas das APIs do WordPress que voc\u00ea n\u00e3o sabia que existiam (pelo menos foi o meu caso).<\/p>\n
Por que se incomodar com tudo isso?<\/h2>\n
Isso pode parecer um post longo para uma tarefa aparentemente simples, mas as informa\u00e7\u00f5es est\u00e3o um pouco espalhadas por toda a web no que se refere a fazer algo assim.<\/p>\n
Ent\u00e3o eu queria tentar juntar tudo isso com explica\u00e7\u00f5es, c\u00f3digo de exemplo e links para p\u00e1ginas que podem ser de interesse dependendo de como a implementa\u00e7\u00e3o \u00e9 feita.<\/p>\n
Afinal, muitos de n\u00f3s est\u00e3o usando o WordPress al\u00e9m do gerenciamento b\u00e1sico de conte\u00fado neste momento, mas isso n\u00e3o significa que n\u00e3o devemos aproveitar suas fun\u00e7\u00f5es e APIs integradas quando poss\u00edvel.<\/p>\n
- Pagina\u00e7\u00e3o<\/a><\/li>\n
- WP_Query<\/a><\/li>\n