Jag b\u00f6rjar dock med en TL;DR f\u00f6rst. P\u00e5 s\u00e5 s\u00e4tt kan du f\u00e5 id\u00e9n innan du l\u00e4ser det hela.<\/p>\n
Anpassade arkivmallar<\/h2>\n
S\u00e5 TL;DR bakom det hela \u00e4r detta:<\/p>\n
- \n
- datuminformationen som tillhandah\u00e5lls av tredje parts API sparas i post-metadatatabellen,<\/li>\n
- nyckeln \u00e4r startdatumet och v\u00e4rdet \u00e4r det faktiska datumet,<\/li>\n
- Jag best\u00e4ller inneh\u00e5llet i fallande ordning och efter metav\u00e4rdet.<\/li>\n<\/ul>\n
Paginering kan vara lite av ett problem, och om du anv\u00e4nder en anpassad inl\u00e4ggstyp beh\u00f6ver du n\u00e5gra extra parametrar, men det finns den allm\u00e4nna id\u00e9n.<\/p>\n
Nu till hela uppl\u00e4gget.<\/p>\n
Anpassade inl\u00e4ggstyper<\/h3>\n
N\u00e4r det kommer till gr\u00e4nssnitt med tredje parts API:er \u00e4r jag ett stort fan av anpassade inl\u00e4ggstyper eftersom jag tenderar att t\u00e4nka p\u00e5 dem som en hybrid mellan modeller och vyer.<\/p>\n
- \n
- Modellkomponenten inkluderar allt som \u00e4r tangentiellt relaterat och kan skrivas till databasen. Detta inneb\u00e4r all taxonomiinformation eller postmetadata.<\/li>\n
- View-komponenten \u00e4r i allm\u00e4nhet allt som g\u00e5r in i mallen som kan utnyttja alla redan existerande malltaggar \u00e4r allt som kan beh\u00f6va skapas som ocks\u00e5 l\u00e4ser information fr\u00e5n databasen.<\/li>\n<\/ul>\n
F\u00f6r det h\u00e4r inl\u00e4gget kommer jag att anv\u00e4nda acme-event<\/strong> som den anpassade posttypen.<\/p>\n
L\u00e4gg upp metadata<\/h3>\n
Jag st\u00e4ller in datumen i inl\u00e4ggets metadata snarare \u00e4n i sj\u00e4lva inl\u00e4gget, f\u00f6r om n\u00e5got kommer att h\u00e4nda i framtiden och data st\u00e4lls in p\u00e5 sj\u00e4lva postposten, kommer WordPress att behandla det som ett schemalagt<\/strong> inl\u00e4gg som \u00e4r opublicerat .<\/p>\n<\/p>\n
Ist\u00e4llet vill jag hellre ha inl\u00e4gget publicerat och sedan \u00e4ndra hur metadata visas i mallen.<\/p>\n
Paginering<\/h3>\n
WordPress g\u00f6r en subtil skillnad med paginering i sin kodbas. Det vill s\u00e4ga att fr\u00e5gevariabeln f\u00f6r webbplatser utan en statisk hemsida anv\u00e4nder paged<\/strong> och det motsatta fallet anv\u00e4nder page<\/strong>.<\/p>\n
![\"Anpassade](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161511-61e724257d2b2.png\")
<\/a><\/p>\nDet h\u00e4r spelar roll n\u00e4r du konstruerar argumenten f\u00f6r fr\u00e5gan som jag kommer till ett \u00f6gonblick.<\/p>\n
Endast arkivsidor<\/h3>\n
Kom ih\u00e5g att n\u00e4r du introducerar sidnumrering vill du bara \u00e4ndra fr\u00e5gan n\u00e4r du \u00e4r p\u00e5 den faktiska arkivsidan.<\/p>\n
Det betyder att du inte bryr dig om fall n\u00e4r du \u00e4r i det administrativa omr\u00e5det f\u00f6r WordPress och du inte vill \u00e4ndra fr\u00e5gan f\u00f6r arkiv av icke-anpassad posttyp. F\u00f6r det \u00e4ndam\u00e5let vill du se till att du st\u00e4ller in fr\u00e5gevariabeln korrekt i pre_get_posts-\u00e5teruppringningen.<\/p>\n
Observera att jag kan visa en funktion f\u00f6r hur man g\u00f6r detta, men p\u00e5 grund av hur vi skriver kod i WordPress \u2013 det vill s\u00e4ga vissa skriver procedurkod, andra skriver objektorienterad kod \u2013 s\u00e5 visar jag det helt enkelt i procedurkod.<\/p>\n
Att f\u00f6ra ihop allt<\/h3>\n
F\u00f6rst ska jag bygga fr\u00e5gan:<\/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>\nObservera att i koden ovan finns ett argument f\u00f6r paged<\/strong>. Jag ska prata om koden f\u00f6r detta ett \u00f6gonblick.<\/p>\n
D\u00e5 kommer mallen att inneh\u00e5lla all information du v\u00e4ljer att visa. Jag v\u00e4ljer att inte dela koden f\u00f6r min mall i det h\u00e4r inl\u00e4gget eftersom det \u00e4r irrelevant f\u00f6r den st\u00f6rre id\u00e9n som finns.<\/p>\n
Dessutom har du allt du beh\u00f6ver f\u00f6r att visa inneh\u00e5llet.<\/p>\n
D\u00e4refter ska jag st\u00e4lla in paginering. F\u00f6rst m\u00e5ste jag g\u00f6ra detta med pre_get_posts-kroken f\u00f6r att se till att r\u00e4tt fr\u00e5gevariabel \u00e4r inst\u00e4lld<\/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>\nSedan implementerar jag pagineringen<\/a> med hj\u00e4lp av den anpassade fr\u00e5gan:<\/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>\nOch efter det kommer jag att \u00e5terst\u00e4lla den globala $post-variabeln<\/a> med wp_reset_postdata() ifall n\u00e5gonting fr\u00e5n det ursprungliga inl\u00e4gget beh\u00f6ver anv\u00e4ndas.<\/p>\n
<?php wp_reset_postdata(); ?><\/code><\/pre>\nDetta anses generellt sett vara bra hush\u00e5llning n\u00e4r du anv\u00e4nder en anpassad fr\u00e5ga i alla fall.<\/p>\n
Anv\u00e4ndbara l\u00e4nkar<\/h3>\n
Nedan finns en lista \u00f6ver funktioner, sidor och referenser som du kan ha nytta av n\u00e4r det g\u00e4ller koden ovan eller eventuellt framtida arbete du kan g\u00f6ra.<\/p>\n
- \n
- WP_Query<\/a><\/li>\n
- Paginering<\/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
- Hela koden<\/a> i detta inl\u00e4gg.<\/li>\n<\/ul>\n
Om du har arbetat med WordPress l\u00e4nge kan vissa av dessa verka \u00f6verfl\u00f6diga. I andra fall kan det verka nytt, eller s\u00e5 kan det kasta ljus \u00f6ver delar av WordPress API:er som du inte visste fanns (\u00e5tminstone var det fallet f\u00f6r mig).<\/p>\n
Varf\u00f6r bry sig om allt detta?<\/h2>\n
Det h\u00e4r kan se ut som ett l\u00e5ngt inl\u00e4gg f\u00f6r en till synes enkel uppgift, men informationen \u00e4r lite spridd \u00f6ver hela webben n\u00e4r det g\u00e4ller att g\u00f6ra n\u00e5got s\u00e5dant h\u00e4r.<\/p>\n
S\u00e5 jag ville f\u00f6rs\u00f6ka f\u00e5 ihop det hela med f\u00f6rklaringar, exempelkod och l\u00e4nkar till sidor som kan vara av intresse beroende p\u00e5 hur implementeringen g\u00e5r till.<\/p>\n
N\u00e4r allt kommer omkring anv\u00e4nder m\u00e5nga av oss WordPress ut\u00f6ver grundl\u00e4ggande inneh\u00e5llshantering vid det h\u00e4r laget, men det betyder inte att vi inte b\u00f6r utnyttja dess inbyggda funktioner och API:er n\u00e4r det \u00e4r m\u00f6jligt.<\/p>\n
- Paginering<\/a><\/li>\n
- WP_Query<\/a><\/li>\n