Il modulo \u00e8 impostato per utilizzare il metodo GET, il che significa che tutti i parametri cercati verranno aggiunti alla pagina nell’URL, sotto forma di " I parametri di ricerca sono mutualmente inclusivi. Ci\u00f2 significa che la combinazione, ad esempio, dell’anno "2011" e dell’autore "Some guy" restituir\u00e0 solo libri che corrispondono a ENTRAMBI. Se specifichiamo anche "divertente" nell’input del testo di ricerca generale, otterremo solo ritorni che corrispondono a tutti e tre questi. Detto con parole diverse; useremo la logica AND. Questo \u00e8 il metodo pi\u00f9 comune per filtrare i risultati di ricerca.<\/p>\n Questo tutorial non includer\u00e0 lo stile, quindi questa parte dipende da te. Di seguito \u00e8 riportato un esempio di come potrebbe apparire con alcuni stili di base.<\/p>\n Se desideri l’impaginazione su una query personalizzata all’interno di una singola pagina, ci sono alcune cose da tenere a mente. L’impaginazione di una query pu\u00f2 essere generata con le funzioni di WordPress Ci sono alcune soluzioni alternative, come scrivere tu stesso una funzione di impaginazione. Oppure potresti usare l’azione Quello che faremo in questa guida \u00e8 una sorta di metodo "hackish". All’interno del modello di pagina sostituiremo l’ Senza ulteriori indugi, iniziamo a programmare!<\/p>\n Il primo passo \u00e8 definire il tipo di post personalizzato per il quale vogliamo creare un modello di ricerca avanzata. Se hai gi\u00e0 impostato un tipo di post personalizzato o desideri implementarlo per post o pagine, puoi passare direttamente alla parte successiva.<\/p>\n Stiamo definendo un tipo di post personalizzato Inserisci questo codice ovunque nel codice del tuo tema Ci\u00f2 risulter\u00e0 in un tipo di post personalizzato con una tassonomia allegata in admin.<\/p>\n L’impostazione del meta post personalizzato dipende un po’ da te: gestiscilo manualmente con Ovviamente sei libero di impostare i campi ACF usando la GUI di amministrazione di ACF. Ma ci sono diversi vantaggi nell’aggiungerli tramite codice. Ad esempio assicurandoti di mantenere gli stessi campi ovunque attivi il tuo tema o plug-in. Se imposti i campi in admin, devi ricordarti di esportarli e importarli se cambi sito WordPress.<\/p>\n Si prega di notare i meta nomi; ad esempio Con il plug-in ACF e il codice sopra la modifica di un singolo libro sarebbe simile a questo:<\/p>\n Con questo siamo tutti bravi a creare tutti i post di libri che vogliamo. Il prossimo passo \u00e8 creare il modello di pagina per la nostra ricerca.<\/p>\n Creiamo il modello di pagina in cui inseriremo il nostro modello di ricerca avanzata. Fai una copia del tuo tema Nella parte superiore del modello di pagina indichiamo che si tratta di un modello di pagina scrivendo "Nome modello" e il suo nome all’interno del blocco commenti. In questo modo ci assicureremo di poter selezionare il modello di pagina quando modifichiamo una pagina.<\/p>\n Le sezioni che dobbiamo codificare nel nostro modello sono le seguenti, in questo ordine:<\/p>\n Il motivo per cui abbiamo bisogno di memorizzare tutte le variabili cercate e la pagina corrente in anticipo \u00e8 perch\u00e9 queste variabili andranno perse una volta ripristinato l’ Nel tuo modello decidi il luogo in cui desideri generare la tua ricerca personalizzata e iniziamo dall’alto:<\/p>\n Otteniamo i parametri GET (dall’URL) con Ma questi sono tutti parametri personalizzati che non fanno parte dei parametri GET standard di WordPress. WordPress ignorer\u00e0 tutti i parametri GET che non conosce, quindi chiamarli restituir\u00e0 sempre una stringa vuota. Dobbiamo dire a WordPress di consentire ciascuno di questi parametri GET. Lo facciamo filtrando Ora i nostri Abbiamo anche bisogno di recuperare la pagina corrente prima di rovinare l’ Nota: poich\u00e9 Il modulo di ricerca sar\u00e0 semplicemente un Nota: per abbreviare e modulare il modello di ricerca avanzata \u00e8 possibile separare la parte del modulo di ricerca in un file modello separato e includerlo con Il modulo stesso deve essere del metodo GET e l’azione deve puntare alla pagina in cui ci troviamo. Per fare ci\u00f2 accediamo All’interno dell’elenco non ordinato aggiungeremo un input appropriato per ciascuno dei nostri possibili parametri di ricerca. Modifica l’HTML e i parametri di ricerca in base alle tue esigenze:<\/p>\n Si prega di prendere nota degli Il codice precedente inizia eseguendo il rendering di un input di testo per la ricerca di testo generale. Impostiamo la Il parametro successivo \u00e8 un menu a discesa del genere dalla nostra tassonomia personalizzata. Per rendere questo utilizziamo la funzione Successivamente eseguiamo un altro input di testo per la ricerca dell’autore, un input di numero per l’anno di pubblicazione, un input di testo per il numero ISBN e infine una casella di controllo che di default \u00e8 deselezionata per includere i libri esauriti.<\/p>\n Il passaggio successivo \u00e8 un piccolo trucco per garantire che l’impaginazione funzioni per la nostra query personalizzata. Memorizziamo semplicemente la corrente Questa parte riguarda l’esecuzione di una nuova query. Iniziamo impostando gli argomenti pi\u00f9 elementari, quindi aggiungiamo condizionalmente parametri a seconda di ci\u00f2 che \u00e8 stato trovato nelle variabili ricercate in precedenza (dal nostro ?book-search=world&year-published=2016&book-author=mark<\/code>". L’altra opzione se vuoi evitare di avere "URL brutti" sta usando Javascript e AJAX. Ma ci sono alcuni aspetti negativi di questo. Innanzitutto non sar\u00e0 possibile aggiungere ai preferiti una ricerca con specifici parametri di ricerca “precompilati". Immagina di voler collegare direttamente la tua pagina di ricerca personalizzata da un autore specifico in un altro punto del tuo sito. \u00c8 quindi possibile fare in modo che il collegamento vada alla pagina di ricerca, aggiungere " ?author=mark<\/code>", e quindi fare clic sul collegamento porter\u00e0 direttamente ai risultati per quell’autore. Questo non \u00e8 possibile con AJAX.<\/p>\n![\"Come](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151388-61e4caf8ea62c.png\")
<\/a><\/p>\nUna nota sull’impaginazione con una query personalizzata<\/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>o le due [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>. Tuttavia, questi sono codificati per funzionare con l’ wp_query<\/code>oggetto globale (che per un modello di pagina \u00e8 la pagina stessa) e non con una query personalizzata.<\/p>\npre_get_posts<\/code>e manipolare l’ wp_query<\/code>oggetto. Sfortunatamente questo metodo \u00e8 troppo tardi per influenzare le funzioni di impaginazione. Un’altra alternativa \u00e8 saltare del tutto l’impaginazione e mostrare semplicemente tutti i post. Questa potrebbe essere un’opzione se non hai molti post, ma se stai creando un modello di ricerca personalizzato avanzato, presumo che tu abbia un bel po’ di post.<\/p>\nwp_query<\/code>oggetto con la nostra query personalizzata in modo che le funzioni di loop e di impaginazione funzionino come previsto. Questo metodo \u00e8 quello con cui ho avuto pi\u00f9 successo.<\/p>\nImpostazione del tipo di post personalizzato, della tassonomia e dei meta campi<\/h2>\n
book<\/code>con una tassonomia personalizzata gerarchica book_category<\/code>. Non entrer\u00f2 nei dettagli spiegando come creare tipi di post personalizzati e tassonomie qui. Se sei interessato a saperne di pi\u00f9 ho un post che approfondisce questo argomento.<\/p>\nfunctions.php<\/code>o del 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>o utilizza il plug-in Advanced Custom Fields<\/a> (ACF), perfetto per questo tipo di lavoro. User\u00f2 ACF per impostare i campi in modo programmatico, in questo modo:<\/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 cos\u00ec via. Farai riferimento a questi quando creeremo la query personalizzata sul modello di ricerca avanzata.<\/p>\n![\"Come](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-151388-61e4cafa3c2c8.png\")
<\/a><\/p>\nCreazione del modello di pagina<\/h2>\n
single.php<\/code>o page.php<\/code>e rinominalo ad esempio in template-booksearch.php<\/code>. L’HTML dipende da te, ma il motivo per cui facciamo una copia di una singola o di una pagina \u00e8 perch\u00e9 sono probabilmente il modello pi\u00f9 vicino in termini di layout.<\/p>\n<?php \/* Template Name: Advanced Book Search *\/\nget_header(); ?>\n...<\/code><\/pre>\n\n
get_query_var()<\/code>. \u00c8 inoltre necessario memorizzare la pagina corrente<\/li>\nwp_query<\/code>oggetto<\/li>\nWP_Query()<\/code>in base ai parametri cercati ed eseguire la query. Assegna la query personalizzata wp_query<\/code>all’oggetto<\/li>\nwp_query<\/code>oggetto come era<\/li>\n<\/ol>\nwp_query<\/code>oggetto nel passaggio 3. Abbiamo anche bisogno delle variabili per il nostro modulo di ricerca, per popolare i campi.<\/p>\n1 Ottieni tutte le variabili cercate<\/h3>\n
[get_query_var](https:\/\/developer.wordpress.org\/reference\/functions\/get_query_var\/)()<\/code>. Per esempio; se abbiamo un parametro ?book-author=benjamin<\/code>nell’URL, using get_query_var('book-author')<\/code>restituirebbe la stringa ‘ benjamin<\/code>‘. Il recupero di tutte le variabili pu\u00f2 essere eseguito in questo modo:<\/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>. Nel tuo functions.php<\/code>, aggiungi anche questo:<\/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>dovrebbero essere in grado di recuperare i parametri GET. Se non sono impostati, restituisce una stringa vuota.<\/p>\nwp_query<\/code>oggetto. La pagina corrente \u00e8 un parametro GET nascosto chiamato paged<\/code>. Lo recupereremo allo stesso modo degli altri nostri parametri GET, ma lo imposteremo come predefinito su 1 se \u00e8 vuoto.<\/p>\n$paged = (get_query_var('paged'))? get_query_var('paged'): 1;<\/code><\/pre>\npaged<\/code>\u00e8 un parametro standard di WordPress, non \u00e8 necessario aggiungere paged<\/code>al query_vars<\/code>filtro.<\/p>\n2 Eseguire il rendering del modulo di ricerca<\/h3>\n
<form><\/code>con gli input necessari e un pulsante di invio del modulo. L’HTML dipende completamente da te, nell’esempio seguente aggiungo gli input in un semplice elenco. Non includer\u00f2 alcuno stile in questo tutorial, dipende da te. Puoi scegliere di impostare lo stile del modulo di ricerca in modo che risieda nella parte superiore dei risultati o di lato, verticalmente verso il basso insieme ai risultati della ricerca.<\/p>\n[get_template_part](https:\/\/developer.wordpress.org\/reference\/functions\/get_template_part\/)()<\/code>. Ma per semplicit\u00e0 di questo tutorial includer\u00f2 tutto all’interno del file modello stesso.<\/p>\n$post<\/code>all’oggetto globale e ne ricaviamo il permalink. Alla fine aggiungiamo un pulsante di invio che invier\u00e0 il modulo.<\/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>attributi; sono ci\u00f2 che apparir\u00e0 nell’URL quando il modulo viene inviato. Devono corrispondere a query_vars<\/code>e get_query_var()<\/code>abbiamo definito in precedenza!<\/p>\nvalue<\/code>variabile cercata in precedenza che abbiamo recuperato utilizzando get_query_var()<\/code>. Ci\u00f2 garantisce che l’input non venga cancellato dopo aver eseguito una ricerca.<\/p>\n[wp_dropdown_categories](https:\/\/developer.wordpress.org\/reference\/functions\/wp_dropdown_categories\/)()<\/code>. Dai un’occhiata alla pagina della documentazione per vedere perch\u00e9 aggiungiamo tutti questi parametri per adattare il menu a discesa alle nostre esigenze. \u00c8 importante che taxonomy<\/code>sia impostato sulla nostra tassonomia personalizzata, l’ name<\/code>attributo sia corretto e selected<\/code>impostato sul valore della variabile ricercata in precedenza. Inoltre, impostiamo i valori dei termini in modo che siano i loro slug anzich\u00e9 gli ID dei termini. Sembra meglio con ?book-category=fiction<\/code>invece di ?book-category=42<\/code>. Attiviamo anche un’opzione "nessuno" per aggiungere un’opzione "Qualsiasi genere".<\/p>\n3 Reimpostare wp_query<\/h3>\n
$wp_query<\/code>in una variabile e quindi la impostiamo su null<\/code>. Successivamente, nel passaggio 6, lo ripristineremo dalla $tmp_wpquery<\/code>variabile.<\/p>\n$tmp_wpquery = $wp_query;\n$wp_query = null;<\/code><\/pre>\n4 Impostare gli argomenti ed eseguire query personalizzate<\/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