Zaczn\u0119 jednak najpierw od TL;DR. W ten spos\u00f3b mo\u017cesz uzyska\u0107 pomys\u0142 przed przeczytaniem ca\u0142o\u015bci.<\/p>\n
Niestandardowe szablony archiwum<\/h2>\n
Wi\u0119c TL; DR za tym wszystkim jest tak:<\/p>\n
- \n
- informacje o dacie dostarczone przez zewn\u0119trzne API s\u0105 przechowywane w tabeli metadanych postu,<\/li>\n
- kluczem jest data rozpocz\u0119cia, a warto\u015b\u0107 rzeczywista data,<\/li>\n
- Uporz\u0105dkowa\u0142em zawarto\u015b\u0107 w porz\u0105dku malej\u0105cym i wed\u0142ug warto\u015bci meta.<\/li>\n<\/ul>\n
Podzia\u0142 na strony mo\u017ce stanowi\u0107 pewien problem, a je\u015bli u\u017cywasz niestandardowego typu postu, b\u0119dziesz potrzebowa\u0107 dodatkowych parametr\u00f3w, ale jest to og\u00f3lna idea.<\/p>\n
Teraz ca\u0142a konfiguracja.<\/p>\n
Niestandardowe typy post\u00f3w<\/h3>\n
Je\u015bli chodzi o interfejs z zewn\u0119trznymi interfejsami API, jestem wielkim fanem niestandardowych typ\u00f3w post\u00f3w, poniewa\u017c my\u015bl\u0119 o nich jako o hybrydzie mi\u0119dzy modelami i widokami.<\/p>\n
- \n
- Sk\u0142adnik modelu zawiera wszystko, co jest stycznie powi\u0105zane i mo\u017cna je zapisa\u0107 w bazie danych. Oznacza to wszelkie informacje o taksonomii lub post metadane.<\/li>\n
- Komponent widoku to na og\u00f3\u0142 wszystko, co wchodzi do szablonu, kt\u00f3re mo\u017ce wykorzystywa\u0107 wszelkie wcze\u015bniej istniej\u0105ce znaczniki szablonu, to wszystko, co mo\u017ce wymaga\u0107 utworzenia, a tak\u017ce odczytuje informacje z bazy danych.<\/li>\n<\/ul>\n
W tym po\u015bcie u\u017cyj\u0119 acme-event<\/strong> jako niestandardowego typu posta.<\/p>\n
Opublikuj metadane<\/h3>\n
Ustawiam daty w metadanych postu, a nie w samym po\u015bcie, poniewa\u017c je\u015bli co\u015b ma si\u0119 wydarzy\u0107 w przysz\u0142o\u015bci, a dane s\u0105 ustawione w samym rekordzie posta, WordPress potraktuje to jako zaplanowany<\/strong> post, kt\u00f3ry nie jest opublikowany .<\/p>\n<\/p>\n
Zamiast tego wola\u0142bym opublikowa\u0107 post, a nast\u0119pnie zmieni\u0107 spos\u00f3b wy\u015bwietlania metadanych w szablonie.<\/p>\n
Paginacja<\/h3>\n
WordPress wprowadza subtelne rozr\u00f3\u017cnienie z paginacj\u0105 w swoim kodzie. Oznacza to, \u017ce zmienna zapytania dla witryn bez statycznej strony g\u0142\u00f3wnej wykorzystuje paged<\/strong>, a w przeciwnym przypadku \u2014 page<\/strong>.<\/p>\n
![\"Niestandardowe](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161511-61e724257d2b2.png\")
<\/a><\/p>\nMa to znaczenie, gdy konstruujesz argumenty zapytania, do kt\u00f3rych za chwil\u0119 przejd\u0119.<\/p>\n
Tylko strony archiwum<\/h3>\n
Pami\u0119taj, \u017ce za ka\u017cdym razem, gdy wprowadzasz paginacj\u0119, chcesz zmieni\u0107 zapytanie tylko wtedy, gdy jeste\u015b na w\u0142a\u015bciwej stronie archiwum.<\/p>\n
Oznacza to, \u017ce nie przejmujesz si\u0119 przypadkami, gdy jeste\u015b w obszarze administracyjnym WordPressa i nie chcesz zmienia\u0107 zapytania dla archiw\u00f3w innych ni\u017c niestandardowe posty. W tym celu upewnij si\u0119, \u017ce poprawnie ustawiasz zmienn\u0105 zapytania w wywo\u0142aniu zwrotnym pre_get_posts.<\/p>\n
Zauwa\u017c, \u017ce mog\u0119 pokaza\u0107 funkcj\u0119, jak to zrobi\u0107, ale ze wzgl\u0119du na to, jak piszemy kod w WordPressie \u2013 to znaczy niekt\u00f3rzy pisz\u0105 kod proceduralny, inni pisz\u0105 kod obiektowy \u2013 po prostu wy\u015bwietl\u0119 to w kodzie proceduralnym.<\/p>\n
\u0141\u0105cz\u0105c to wszystko razem<\/h3>\n
Najpierw zbuduj\u0119 zapytanie:<\/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>\nZauwa\u017c, \u017ce w powy\u017cszym kodzie znajduje si\u0119 argument paged<\/strong>. Za chwil\u0119 powiem o kodzie.<\/p>\n
Nast\u0119pnie szablon b\u0119dzie zawiera\u0142 wszelkie informacje, kt\u00f3re zdecydujesz si\u0119 wy\u015bwietli\u0107. Zdecydowa\u0142em si\u0119 nie udost\u0119pnia\u0107 kodu do mojego szablonu w tym po\u015bcie, poniewa\u017c nie ma to znaczenia dla wi\u0119kszego pomys\u0142u.<\/p>\n
Dodatkowo masz wszystko, czego potrzebujesz do wy\u015bwietlania tre\u015bci.<\/p>\n
Nast\u0119pnie ustawi\u0119 paginacj\u0119. Najpierw musz\u0119 to zrobi\u0107 za pomoc\u0105 haka pre_get_posts, aby upewni\u0107 si\u0119, \u017ce ustawiona jest w\u0142a\u015bciwa zmienna zapytania<\/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>\nNast\u0119pnie zaimplementuj\u0119 paginacj\u0119<\/a> za pomoc\u0105 niestandardowego zapytania:<\/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>\nA potem zresetuj\u0119 globaln\u0105 zmienn\u0105 $post<\/a> za pomoc\u0105 wp_reset_postdata() na wypadek, gdyby trzeba by\u0142o u\u017cy\u0107 czegokolwiek z oryginalnego postu.<\/p>\n
<?php wp_reset_postdata(); ?><\/code><\/pre>\nJest to og\u00f3lnie uwa\u017cane za dobre porz\u0105dkowanie za ka\u017cdym razem, gdy u\u017cywasz niestandardowego zapytania.<\/p>\n
Przydatne linki<\/h3>\n
Poni\u017cej znajduje si\u0119 lista funkcji, stron i odniesie\u0144, kt\u00f3re mog\u0105 okaza\u0107 si\u0119 przydatne, poniewa\u017c odnosz\u0105 si\u0119 do powy\u017cszego kodu lub jakiejkolwiek przysz\u0142ej pracy, kt\u00f3r\u0105 mo\u017cesz wykona\u0107.<\/p>\n
- \n
- WP_Query<\/a><\/li>\n
- Paginacja<\/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
- Pe\u0142ny kod<\/a> w tym po\u015bcie.<\/li>\n<\/ul>\n
Je\u015bli pracujesz z WordPressem od d\u0142u\u017cszego czasu, niekt\u00f3re z nich mog\u0105 wydawa\u0107 si\u0119 zb\u0119dne. W innych przypadkach mo\u017ce wydawa\u0107 si\u0119 nowy lub mo\u017ce rzuci\u0107 \u015bwiat\u0142o na obszary API WordPressa, o kt\u00f3rych istnieniu nie wiedzia\u0142e\u015b (przynajmniej tak by\u0142o w moim przypadku).<\/p>\n
Po co zawraca\u0107 sobie g\u0142ow\u0119 tym wszystkim?<\/h2>\n
Mo\u017ce si\u0119 to wydawa\u0107 d\u0142ugim postem dla pozornie prostego zadania, ale informacje s\u0105 nieco rozproszone po ca\u0142ej sieci, poniewa\u017c odnosz\u0105 si\u0119 do robienia czego\u015b takiego.<\/p>\n
Chcia\u0142em wi\u0119c spr\u00f3bowa\u0107 zebra\u0107 to wszystko razem z obja\u015bnieniami, przyk\u0142adowym kodem i linkami do stron, kt\u00f3re mog\u0105 by\u0107 interesuj\u0105ce w zale\u017cno\u015bci od sposobu wdro\u017cenia.<\/p>\n
W ko\u0144cu wielu z nas korzysta obecnie z WordPressa poza podstawowym zarz\u0105dzaniem tre\u015bci\u0105, ale to nie znaczy, \u017ce nie powinni\u015bmy w miar\u0119 mo\u017cliwo\u015bci wykorzystywa\u0107 jego wbudowanych funkcji i interfejs\u00f3w API.<\/p>\n
- Paginacja<\/a><\/li>\n
- WP_Query<\/a><\/li>\n