Inizier\u00f2 con un TL; DR prima, per\u00f2. In questo modo, puoi farti un’idea prima di leggere tutto.<\/p>\n
Modelli di archivio personalizzati<\/h2>\n
Quindi il TL; DR dietro l’intera cosa \u00e8 questo:<\/p>\n
- \n
- le informazioni sulla data fornite dall’API di terze parti sono conservate nella tabella dei metadati post,<\/li>\n
- la chiave \u00e8 la data di inizio e il valore \u00e8 la data effettiva,<\/li>\n
- Ordino il contenuto in ordine decrescente e in base al meta valore.<\/li>\n<\/ul>\n
L’impaginazione pu\u00f2 essere un po’ un problema e se usi un tipo di post personalizzato, avrai bisogno di alcuni parametri extra, ma c’\u00e8 l’idea generale.<\/p>\n
Ora per l’intera configurazione.<\/p>\n
Tipi di post personalizzati<\/h3>\n
Quando si tratta di interfacciarsi con API di terze parti, sono un grande fan dei tipi di post personalizzati perch\u00e9 tendo a pensarli come un ibrido tra modelli e viste.<\/p>\n
- \n
- Il componente del modello include tutto ci\u00f2 che \u00e8 tangenzialmente correlato e pu\u00f2 essere scritto nel database. Ci\u00f2 significa qualsiasi informazione sulla tassonomia o metadati dei post.<\/li>\n
- Il componente di visualizzazione \u00e8 generalmente tutto ci\u00f2 che entra nel modello in grado di sfruttare eventuali tag di modello preesistenti, ovvero tutto ci\u00f2 che potrebbe essere necessario creare che legga anche le informazioni dal database.<\/li>\n<\/ul>\n
Per questo post, user\u00f2 acme-event<\/strong> come tipo di post personalizzato.<\/p>\n
Pubblica metadati<\/h3>\n
Ho impostato le date nei metadati del post piuttosto che nel post stesso perch\u00e9 se succede qualcosa in futuro e i dati sono impostati sul record del post stesso, WordPress lo tratter\u00e0 come un post programmato<\/strong> che non \u00e8 pubblicato .<\/p>\n<\/p>\n
Invece, preferirei pubblicare il post e quindi modificare il modo in cui i metadati vengono visualizzati nel modello.<\/p>\n
Impaginazione<\/h3>\n
WordPress fa una sottile distinzione con l’impaginazione nella sua base di codice. Ovvero, la variabile di query per i siti senza una home page statica utilizza paged<\/strong> e il caso opposto utilizza page<\/strong>.<\/p>\n
![\"Modelli](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161511-61e724257d2b2.png\")
<\/a><\/p>\nQuesto \u00e8 importante quando stai costruendo gli argomenti per la query a cui arriver\u00f2 momentaneamente.<\/p>\n
Solo pagine di archivio<\/h3>\n
Ricorda che ogni volta che stai introducendo l’impaginazione, vuoi cambiare la query solo ogni volta che ti trovi nella pagina di archivio effettiva.<\/p>\n
Ci\u00f2 significa che non ti interessano i casi quando sei nell’area amministrativa di WordPress e non vuoi modificare la query per archivi di tipo post non personalizzato. A tal fine, assicurati di impostare correttamente la variabile di query nel callback pre_get_posts.<\/p>\n
Nota che posso mostrare una funzione su come farlo, ma a causa del modo in cui scriviamo il codice in WordPress, ovvero alcuni scrivono codice procedurale, altri scrivono codice orientato agli oggetti, lo visualizzer\u00f2 semplicemente nel codice procedurale.<\/p>\n
Unendo tutto<\/h3>\n
Per prima cosa, costruir\u00f2 la query:<\/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>\nNota che nel codice sopra c’\u00e8 un argomento per paged<\/strong>. Parler\u00f2 del codice per questo momentaneamente.<\/p>\n
Quindi il modello includer\u00e0 tutte le informazioni che scegli di visualizzare. Ho scelto di non condividere il codice per il mio modello in questo post perch\u00e9 \u00e8 irrilevante per l’idea pi\u00f9 ampia a portata di mano.<\/p>\n
Inoltre, hai tutto il necessario per visualizzare il contenuto.<\/p>\n
Successivamente, imposter\u00f2 l’impaginazione. Innanzitutto, devo farlo usando l’hook pre_get_posts per assicurarmi che sia impostata la variabile di query corretta<\/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>\nQuindi implementer\u00f2 l’impaginazione<\/a> utilizzando la query personalizzata:<\/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 dopo, ripristiner\u00f2 la variabile $post globale<\/a> usando wp_reset_postdata() nel caso in cui sia necessario utilizzare qualsiasi cosa del post originale.<\/p>\n
<?php wp_reset_postdata(); ?><\/code><\/pre>\nQuesto \u00e8 generalmente considerato una buona pulizia ogni volta che si utilizza una query personalizzata, comunque.<\/p>\n
link utili<\/h3>\n
Di seguito \u00e8 riportato un elenco di funzioni, pagine e riferimenti che potresti trovare utili in relazione al codice sopra o a qualsiasi lavoro futuro che potresti svolgere.<\/p>\n
- \n
- WP_Query<\/a><\/li>\n
- Impaginazione<\/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
- Il codice completo<\/a> in questo post.<\/li>\n<\/ul>\n
Se lavori con WordPress da molto tempo, alcuni di questi potrebbero sembrare ridondanti. In altri casi, potrebbe sembrare nuovo o potrebbe far luce su aree delle API di WordPress che non sapevi esistessero (almeno per me era cos\u00ec).<\/p>\n
Perch\u00e9 preoccuparsi di tutto questo?<\/h2>\n
Questo pu\u00f2 sembrare un post lungo per un compito apparentemente semplice, ma le informazioni sono un po’ sparse in tutto il Web in quanto si riferiscono a fare qualcosa del genere.<\/p>\n
Quindi ho voluto provare a riunire il tutto con spiegazioni, codice di esempio e collegamenti a pagine che potrebbero essere di interesse a seconda di come viene eseguita l’implementazione.<\/p>\n
Dopotutto, molti di noi stanno utilizzando WordPress al di l\u00e0 della gestione dei contenuti di base a questo punto, ma ci\u00f2 non significa che non dovremmo sfruttare le sue funzioni e API integrate quando possibile.<\/p>\n
- Impaginazione<\/a><\/li>\n
- WP_Query<\/a><\/li>\n