O formul\u00e1rio est\u00e1 configurado para usar o m\u00e9todo GET, o que significa que quaisquer par\u00e2metros pesquisados \u200b\u200bser\u00e3o anexados \u00e0 p\u00e1gina na URL, na forma de ” Os par\u00e2metros de pesquisa s\u00e3o mutuamente inclusivos. Isso significa que combinar, por exemplo, o ano “2011” e o autor “Some guy” retornar\u00e1 apenas livros que correspondam a AMBOS. Se tamb\u00e9m especificarmos “engra\u00e7ado” na entrada de texto de pesquisa geral, obteremos apenas retornos que correspondam a todos os tr\u00eas. Dito em palavras diferentes; usaremos a l\u00f3gica AND. Este \u00e9 o m\u00e9todo mais comum para filtrar os resultados da pesquisa.<\/p>\n Este tutorial n\u00e3o incluir\u00e1 estilo, ent\u00e3o esta parte \u00e9 com voc\u00ea. Abaixo est\u00e1 um exemplo de como isso pode ficar com alguns estilos b\u00e1sicos.<\/p>\n Se voc\u00ea deseja pagina\u00e7\u00e3o em uma consulta personalizada em uma \u00fanica p\u00e1gina, h\u00e1 algumas coisas a serem observadas. A pagina\u00e7\u00e3o de uma consulta pode ser gerada com as fun\u00e7\u00f5es do WordPress Existem algumas solu\u00e7\u00f5es alternativas, como escrever voc\u00ea mesmo uma fun\u00e7\u00e3o de pagina\u00e7\u00e3o. Ou voc\u00ea pode usar a a\u00e7\u00e3o O que faremos neste guia \u00e9 uma esp\u00e9cie de m\u00e9todo “hackish”. Dentro do modelo de p\u00e1gina, substituiremos o Sem mais delongas, vamos come\u00e7ar a codificar!<\/p>\n A primeira etapa \u00e9 definir o tipo de postagem personalizado para o qual queremos criar um modelo de pesquisa avan\u00e7ada. Se voc\u00ea j\u00e1 configurou um tipo de postagem personalizado ou deseja implement\u00e1-lo para postagens ou p\u00e1ginas, pode pular para a pr\u00f3xima parte.<\/p>\n Estamos definindo um tipo de postagem personalizado Coloque este c\u00f3digo em qualquer lugar no c\u00f3digo do seu tema Isso resultar\u00e1 em um tipo de postagem personalizado com uma taxonomia anexada a ele em admin.<\/p>\n A configura\u00e7\u00e3o da meta de postagem personalizada depende um pouco de voc\u00ea – manuseie-a manualmente \u00c9 claro que voc\u00ea pode configurar os campos do ACF usando a GUI de administra\u00e7\u00e3o do ACF. Mas h\u00e1 v\u00e1rios benef\u00edcios de adicion\u00e1-los por c\u00f3digo. Por exemplo, garantindo que voc\u00ea mantenha os mesmos campos onde quer que voc\u00ea ative seu tema ou plugin. Se voc\u00ea configurar os campos no admin, lembre-se de export\u00e1-los e import\u00e1-los se mudar de site WordPress.<\/p>\n Observe os meta-nomes; por exemplo Com o plugin ACF e o c\u00f3digo acima, editar um \u00fanico livro ficaria assim:<\/p>\n Com isso estamos todos bem para criar quantos posts de livros quisermos. A pr\u00f3xima etapa \u00e9 criar o modelo de p\u00e1gina para nossa pesquisa.<\/p>\n Vamos criar o modelo de p\u00e1gina onde colocaremos nosso modelo de pesquisa avan\u00e7ada. Fa\u00e7a uma c\u00f3pia do seu tema No topo do modelo de p\u00e1gina, indicamos que este \u00e9 um modelo de p\u00e1gina escrevendo "Nome do modelo" e seu nome no bloco de coment\u00e1rios. Fazer isso garantir\u00e1 que possamos selecionar o modelo de p\u00e1gina quando editarmos uma p\u00e1gina.<\/p>\n As se\u00e7\u00f5es que precisamos codificar em nosso modelo s\u00e3o as seguintes, nesta ordem:<\/p>\n A raz\u00e3o pela qual precisamos armazenar todas as vari\u00e1veis \u200b\u200bpesquisadas e a p\u00e1gina atual antecipadamente \u00e9 porque essas vari\u00e1veis \u200b\u200bser\u00e3o perdidas assim que redefinirmos o Em seu modelo, decida o local em que deseja gerar sua pesquisa personalizada e vamos come\u00e7ar do in\u00edcio:<\/p>\n Obtemos os par\u00e2metros GET (da URL) com Mas esses s\u00e3o todos os par\u00e2metros personalizados que n\u00e3o fazem parte dos par\u00e2metros GET padr\u00e3o do WordPress. O WordPress ir\u00e1 ignorar quaisquer par\u00e2metros GET que ele n\u00e3o conhe\u00e7a, ent\u00e3o cham\u00e1-los sempre retornar\u00e1 uma string vazia. Precisamos dizer ao WordPress para permitir cada um desses par\u00e2metros GET. Fazemos isso filtrando Agora nossos Tamb\u00e9m precisamos buscar a p\u00e1gina atual antes de estragar o Nota: Como O formul\u00e1rio de pesquisa ser\u00e1 simplesmente um Nota: Para encurtar e modularizar o modelo de pesquisa avan\u00e7ada, voc\u00ea pode separar a parte do formul\u00e1rio de pesquisa em um arquivo de modelo separado e inclu\u00ed-lo com O formul\u00e1rio em si precisa ser do m\u00e9todo GET, e a a\u00e7\u00e3o precisa apontar para a p\u00e1gina em que estamos. Para fazer isso, acessamos o Dentro da lista n\u00e3o ordenada, adicionaremos uma entrada adequada para cada um de nossos poss\u00edveis par\u00e2metros de pesquisa. Ajuste o HTML e os par\u00e2metros de pesquisa para atender \u00e0s suas necessidades:<\/p>\n Observe os O c\u00f3digo acima come\u00e7a renderizando uma entrada de texto para a pesquisa de texto geral. Definimos o O pr\u00f3ximo par\u00e2metro \u00e9 uma lista suspensa de g\u00eanero de nossa taxonomia personalizada. Para renderizar isso, utilizamos a fun\u00e7\u00e3o Em seguida, renderizamos outra entrada de texto para pesquisar o autor, uma entrada de n\u00famero para o ano de publica\u00e7\u00e3o, uma entrada de texto para o n\u00famero ISBN e, finalmente, uma caixa de sele\u00e7\u00e3o que, por padr\u00e3o, est\u00e1 desmarcada para incluir livros esgotados.<\/p>\n O pr\u00f3ximo passo \u00e9 um pequeno hack para garantir que a pagina\u00e7\u00e3o funcione para nossa consulta personalizada. N\u00f3s simplesmente armazenamos a corrente Esta parte trata da realiza\u00e7\u00e3o de uma nova consulta. Come\u00e7amos configurando os argumentos mais b\u00e1sicos e, em seguida, adicionamos par\u00e2metros condicionalmente dependendo do que foi encontrado nas vari\u00e1veis \u200b\u200bpesquisadas anteriormente (de nossos ?book-search=world&year-published=2016&book-author=mark<\/code>“. A outra op\u00e7\u00e3o se voc\u00ea quiser evitar ter “URLs feias” \u00e9 usar Javascript e AJAX. Mas h\u00e1 algumas desvantagens com isso. Em primeiro lugar, n\u00e3o ser\u00e1 poss\u00edvel marcar uma pesquisa com par\u00e2metros de pesquisa espec\u00edficos "pr\u00e9-preenchidos". Imagine que voc\u00ea em outro lugar do seu site deseja vincular diretamente \u00e0 sua p\u00e1gina de pesquisa personalizada por um autor espec\u00edfico. Voc\u00ea pode ent\u00e3o fazer o link ir para sua p\u00e1gina de pesquisa, anexar ” ?author=mark<\/code>“, e assim clicar no link levar\u00e1 diretamente aos resultados para esse autor. Isso n\u00e3o \u00e9 poss\u00edvel com AJAX.<\/p>\n![\"Como](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151388-61e4caf8ea62c.png\")
<\/a><\/p>\nUma observa\u00e7\u00e3o sobre pagina\u00e7\u00e3o com uma consulta personalizada<\/h2>\n
[the_posts_pagination](https:\/\/developer.wordpress.org\/reference\/functions\/the_posts_pagination\/)()<\/code>, [paginate_links](https:\/\/developer.wordpress.org\/reference\/functions\/paginate_links\/)()<\/code>, ou os dois [next_post_link](https:\/\/developer.wordpress.org\/reference\/functions\/next_post_link\/)()<\/code>e [previous_post_link](https:\/\/developer.wordpress.org\/reference\/functions\/previous_post_link\/)()<\/code>. No entanto, eles s\u00e3o codificados para funcionar com o wp_query<\/code>objeto global (que para um modelo de p\u00e1gina \u00e9 a pr\u00f3pria p\u00e1gina) e n\u00e3o com uma consulta personalizada.<\/p>\npre_get_posts<\/code>e manipular o wp_query<\/code>objeto. Infelizmente, este m\u00e9todo \u00e9 muito tarde para afetar as fun\u00e7\u00f5es de pagina\u00e7\u00e3o. Outra alternativa \u00e9 pular a pagina\u00e7\u00e3o e simplesmente mostrar todos os posts. Essa pode ser uma op\u00e7\u00e3o se voc\u00ea n\u00e3o tiver muitas postagens, mas se estiver criando um modelo de pesquisa personalizado avan\u00e7ado \u2013 suponho que voc\u00ea tenha algumas postagens.<\/p>\nwp_query<\/code>objeto com nossa consulta personalizada para que as fun\u00e7\u00f5es de loop e pagina\u00e7\u00e3o funcionem conforme o esperado. Este m\u00e9todo \u00e9 o que eu tive mais sucesso.<\/p>\nConfigurando o tipo de postagem personalizado, taxonomia e meta campos<\/h2>\n
book<\/code>com uma taxonomia personalizada hier\u00e1rquica book_category<\/code>. N\u00e3o entrarei em detalhes explicando como criar tipos de postagem personalizados e taxonomias aqui. Se voc\u00ea estiver interessado em saber mais, tenho um post que entra em detalhes sobre isso.<\/p>\nfunctions.php<\/code>ou plugin:<\/p>\nadd_action('init', function() {\n register_post_type('book', [\n 'label' => __('Books', 'txtdomain'),\n 'public' => true,\n 'menu_position' => 5,\n 'menu_icon' => 'dashicons-book',\n 'supports' => ['title', 'editor', 'thumbnail', 'author', 'revisions', 'comments'],\n 'show_in_rest' => true,\n 'rewrite' => ['slug' => 'book'],\n 'taxonomies' => ['book_category'],\n 'labels' => [\n 'singular_name' => __('Book', 'txtdomain'),\n 'add_new_item' => __('Add new book', 'txtdomain'),\n 'new_item' => __('New book', 'txtdomain'),\n 'view_item' => __('View book', 'txtdomain'),\n 'not_found' => __('No books found', 'txtdomain'),\n 'not_found_in_trash' => __('No books found in trash', 'txtdomain'),\n 'all_items' => __('All books', 'txtdomain'),\n 'insert_into_item' => __('Insert into book', 'txtdomain')\n ],\n ]);\n\u00a0\n register_taxonomy('book_category', ['book'], [\n 'label' => __('Book Category', 'txtdomain'),\n 'hierarchical' => true,\n 'rewrite' => ['slug' => 'book-category'],\n 'show_admin_column' => true,\n 'show_in_rest' => true,\n 'labels' => [\n 'singular_name' => __('Book Category', 'txtdomain'),\n 'all_items' => __('All Book Categories', 'txtdomain'),\n 'edit_item' => __('Edit Book Category', 'txtdomain'),\n 'view_item' => __('View Book Category', 'txtdomain'),\n 'update_item' => __('Update Book Category', 'txtdomain'),\n 'add_new_item' => __('Add New Book Category', 'txtdomain'),\n 'new_item_name' => __('New Book Category Name', 'txtdomain'),\n 'search_items' => __('Search Book Categories', 'txtdomain'),\n 'parent_item' => __('Parent Book Category', 'txtdomain'),\n 'parent_item_colon' => __('Parent Book Category:', 'txtdomain'),\n 'not_found' => __('No Book Categories found', 'txtdomain'),\n ]\n ]);\n});<\/code><\/pre>\n[add_meta_box](https:\/\/developer.wordpress.org\/reference\/functions\/add_meta_box\/)()<\/code>ou use o plug-in Advanced Custom Fields<\/a> (ACF), que \u00e9 perfeito para esse tipo de trabalho. Vou usar o ACF para configurar os campos programaticamente, assim:<\/p>\nif (function_exists('acf_add_local_field_group')) {\n add_action('acf\/init', function() {\n $fields = [\n [\n 'key' => 'field_author',\n 'label' => __('Author(s)', 'txtdomain'),\n 'name' => 'book_author',\n 'type' => 'textarea',\n 'rows' => 3,\n 'new_lines' => 'wpautop',\n ],\n [\n 'key' => 'field_year_published',\n 'label' => __('Year published', 'txtdomain'),\n 'name' => 'year_published',\n 'type' => 'number',\n ],\n [\n 'key' => 'field_isbn',\n 'label' => __('ISBN', 'txtdomain'),\n 'name' => 'isbn',\n 'type' => 'text',\n ],\n [\n 'key' => 'field_in_stock',\n 'label' => __('Stock status', 'txtdomain'),\n 'name' => 'in_stock',\n 'type' => 'true_false',\n 'message' => __('In stock', 'txtdomain'),\n 'default_value' => 1,\n ],\n ];\n\u00a0\n acf_add_local_field_group([\n 'key' => 'group_book_fields',\n 'title' => __('Book Details', 'txtdomain'),\n 'fields' => $fields,\n 'label_placement' => 'top',\n 'menu_order' => 0,\n 'style' => 'default',\n 'position' => 'normal',\n 'location' => [\n [\n [\n 'param' => 'post_type',\n 'operator' => '==',\n 'value' => 'book'\n ]\n ]\n ],\n ]);\n });\n}<\/code><\/pre>\nbook_author<\/code>, year_published<\/code>, e assim por diante. Voc\u00ea far\u00e1 refer\u00eancia a eles quando criarmos a consulta personalizada no modelo de pesquisa avan\u00e7ada.<\/p>\n![\"Como](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151388-61e4cafa3c2c8.png\")
<\/a><\/p>\nCriando o modelo de p\u00e1gina<\/h2>\n
single.php<\/code>ou page.php<\/code>e renomeie-o para, por exemplo, template-booksearch.php<\/code>. O HTML \u00e9 com voc\u00ea, mas a raz\u00e3o pela qual fazemos uma c\u00f3pia de single ou page \u00e9 porque eles s\u00e3o provavelmente o modelo mais pr\u00f3ximo em termos de layout.<\/p>\n<?php \/* Template Name: Advanced Book Search *\/\nget_header(); ?>\n...<\/code><\/pre>\n\n
get_query_var()<\/code>. Tamb\u00e9m precisa armazenar a p\u00e1gina atual<\/li>\nwp_query<\/code>objeto<\/li>\nWP_Query()<\/code>dependendo dos par\u00e2metros pesquisados \u200b\u200be execute a consulta. Atribuir a consulta personalizada ao wp_query<\/code>objeto<\/li>\nwp_query<\/code>objeto de volta ao que era<\/li>\n<\/ol>\nwp_query<\/code>objeto na etapa 3. Tamb\u00e9m precisamos das vari\u00e1veis \u200b\u200bpara nosso formul\u00e1rio de pesquisa, para preencher os campos.<\/p>\n1 Obtenha todas as vari\u00e1veis \u200b\u200bpesquisadas<\/h3>\n
[get_query_var](https:\/\/developer.wordpress.org\/reference\/functions\/get_query_var\/)()<\/code>. Por exemplo; se tivermos um par\u00e2metro ?book-author=benjamin<\/code>na URL, using get_query_var('book-author')<\/code>retornaria a string ‘ benjamin<\/code>‘. A busca de todas as vari\u00e1veis \u200b\u200bpode ser feita assim:<\/p>\n$search_string = get_query_var('book-search');\n$author = get_query_var('book-author');\n$category = get_query_var('book-category');\n$year = get_query_var('year-published');\n$isbn = get_query_var('isbn');\n$out_of_stock = get_query_var('out-of-stock');<\/code><\/pre>\nquery_vars<\/code>. No seu functions.php<\/code>, adicione isso tamb\u00e9m:<\/p>\nadd_filter('query_vars', function($vars) {\n $vars[] = 'book-search';\n $vars[] = 'book-author';\n $vars[] = 'book-category';\n $vars[] = 'year-published';\n $vars[] = 'isbn';\n $vars[] = 'out-of-stock';\n return $vars;\n});<\/code><\/pre>\nget_query_var()<\/code>‘s devem ser capazes de buscar os par\u00e2metros GET. Se eles n\u00e3o estiverem definidos, ele retornar\u00e1 uma string vazia.<\/p>\nwp_query<\/code>objeto. A p\u00e1gina atual \u00e9 um par\u00e2metro GET oculto chamado paged<\/code>. Vamos busc\u00e1-lo da mesma forma que nossos outros par\u00e2metros GET, mas vamos defini-lo como padr\u00e3o para 1 se estiver vazio.<\/p>\n$paged = (get_query_var('paged'))? get_query_var('paged'): 1;<\/code><\/pre>\npaged<\/code>\u00e9 um par\u00e2metro padr\u00e3o do WordPress, n\u00e3o precisamos adicionar paged<\/code>ao query_vars<\/code>filtro.<\/p>\n2 Renderize o formul\u00e1rio de pesquisa<\/h3>\n
<form><\/code>com as entradas necess\u00e1rias e um bot\u00e3o de envio de formul\u00e1rio. O HTML fica totalmente a seu crit\u00e9rio, no exemplo abaixo estou adicionando as entradas em uma lista simples. N\u00e3o incluirei nenhum estilo neste tutorial, isso \u00e9 com voc\u00ea. Voc\u00ea pode optar por estilizar o formul\u00e1rio de pesquisa para ficar na parte superior dos resultados ou na lateral – verticalmente para baixo junto com os resultados da pesquisa.<\/p>\n[get_template_part](https:\/\/developer.wordpress.org\/reference\/functions\/get_template_part\/)()<\/code>. Mas para simplificar este tutorial, incluirei tudo dentro do pr\u00f3prio arquivo de modelo.<\/p>\n$post<\/code>objeto global e obtemos o permalink dele. No final, adicionamos um bot\u00e3o de envio que enviar\u00e1 o formul\u00e1rio.<\/p>\nglobal $post;\n?>\n<form method=\"GET\" action=\"<?php echo get_permalink($post->ID); ?>\">\n <ul class=\"book-search-form\">\n\u00a0\n <\/ul>\n <input type=\"submit\" value=\"<?php _e('Search', 'txtdomain'); ?>\" \/>\n<\/form>\n<?php<\/code><\/pre>\nglobal $post;\n?>\n<form method=\"GET\" action=\"<?php echo get_permalink($post->ID); ?>\">\n <ul class=\"book-search-form\">\n <li>\n <label for=\"book-search\"><?php _e('Search...', 'txtdomain'); ?><\/label>\n <input type=\"text\" id=\"book-search\" name=\"book-search\" value=\"<?php echo $search_string; ?>\" \/>\n <\/li>\n <li>\n <label for=\"book-category\"><?php _e('Genre', 'txtdomain'); ?><\/label>\n <?php \n wp_dropdown_categories([\n 'taxonomy' => 'book_category',\n 'name' => 'book-category',\n 'id' => 'book-category',\n 'value_field' => 'slug',\n 'selected' => $category,\n 'show_option_none' => __('Any genre', 'txtdomain'),\n 'option_none_value' => '',\n 'hierarchical' => true,\n 'hide_if_empty' => false,\n ]);\n ?>\n <\/li>\n <li>\n <label for=\"book-author\"><?php _e('Author', 'txtdomain'); ?><\/label>\n <input type=\"text\" id=\"book-author\" name=\"book-author\" value=\"<?php echo $author; ?>\" \/>\n <\/li>\n <li>\n <label for=\"year-published\"><?php _e('Year published', 'txtdomain'); ?><\/label>\n <input type=\"number\" id=\"year-published\" name=\"year-published\" value=\"<?php echo $year; ?>\" \/>\n <\/li>\n <li>\n <label for=\"isbn\"><?php _e('ISBN', 'txtdomain'); ?><\/label>\n <input type=\"text\" id=\"isbn\" name=\"isbn\" value=\"<?php echo $isbn; ?>\" \/>\n <\/li>\n <li>\n <input type=\"checkbox\" id=\"out-of-stock\" name=\"out-of-stock\" value=\"out-of-stock\" <?php checked($out_of_stock, 'out-of-stock'); ?> \/><label for=\"out-of-stock\"><?php _e('Include out of stock', 'txtdomain'); ?><\/label>\n <\/li>\n <\/ul>\n <input type=\"submit\" value=\"<?php _e('Search', 'txtdomain'); ?>\" \/>\n<\/form>\n<?php<\/code><\/pre>\nname<\/code>atributos; eles s\u00e3o o que aparecer\u00e1 na URL quando o formul\u00e1rio for enviado. Eles devem corresponder ao query_vars<\/code>e get_query_var()<\/code>definimos anteriormente!<\/p>\nvalue<\/code>para a vari\u00e1vel pesquisada anteriormente que buscamos usando get_query_var()<\/code>. Isso garante que a entrada n\u00e3o seja limpa depois de fazermos uma pesquisa.<\/p>\n[wp_dropdown_categories](https:\/\/developer.wordpress.org\/reference\/functions\/wp_dropdown_categories\/)()<\/code>. D\u00ea uma olhada na p\u00e1gina de documenta\u00e7\u00e3o para ver por que adicionamos todos esses par\u00e2metros para ajustar a lista suspensa \u00e0s nossas necessidades. \u00c9 importante que taxonomy<\/code>esteja definido para nossa taxonomia personalizada, name<\/code>o atributo esteja correto e selected<\/code>definido para o valor da vari\u00e1vel pesquisada anteriormente. Tamb\u00e9m definimos os valores de termo como seus slugs em vez de IDs de termo. Parece melhor com ?book-category=fiction<\/code>em vez de ?book-category=42<\/code>. Tamb\u00e9m ativamos uma op\u00e7\u00e3o “nenhum” para adicionar uma op\u00e7\u00e3o “Qualquer g\u00eanero”.<\/p>\n3 Redefina o wp_query<\/h3>\n
$wp_query<\/code>em alguma vari\u00e1vel e ent\u00e3o a configuramos para null<\/code>. Mais tarde, na etapa 6, vamos redefini-lo a partir da $tmp_wpquery<\/code>vari\u00e1vel.<\/p>\n$tmp_wpquery = $wp_query;\n$wp_query = null;<\/code><\/pre>\n4 Configure argumentos e execute a consulta personalizada<\/h3>\n
get_query_var()<\/code>s).<\/p>\n$args = [\n 'post_type' => 'book',\n 'posts_per_page' => 20,\n 'paged' => $paged\n];\n\u00a0\n$meta_query = [];\n$tax_query = [];\n\u00a0\nif (!empty($search_string)) {\n $args['s'] = $search_string;\n}\n\u00a0\nif (!empty($category)) {\n $tax_query[] = [\n 'taxonomy' => 'book_category',\n 'field' => 'slug',\n 'terms' => $category\n ];\n}\n\u00a0\nif (!empty($author)) {\n $meta_query[] = [\n 'key' => 'book_author',\n 'value' => $author,\n 'compare' => 'LIKE'\n ];\n}\n\u00a0\nif (!empty($year)) {\n $year = (int) $year;\n $meta_query[] = [\n 'key' => 'year_published',\n 'value' => $year,\n 'compare' => 'LIKE'\n ];\n}\n\u00a0\nif (!empty($isbn)) {\n $meta_query[] = [\n 'key' => 'isbn',\n 'value' => $isbn,\n ];\n}\n\u00a0\nif (empty($out_of_stock)) {\n $meta_query[] = [\n 'key' => 'in_stock',\n 'value' => true,\n ];\n}\n\u00a0\nif (!empty($meta_query)) {\n $args['meta_query'] = $meta_query;\n}\nif (!empty($tax_query)) {\n $args['tax_query'] = $tax_query;\n}\n\u00a0\n\/\/ Perform query and assign it to wp_query\n$books = new WP_Query($args);\n$wp_query = $books;<\/code><\/pre>\n