Je vais commencer par un TL; DR d’abord, cependant. De cette fa\u00e7on, vous pouvez vous faire une id\u00e9e avant de tout lire.<\/p>\n
Mod\u00e8les d’archives personnalis\u00e9s<\/h2>\n
Donc, le TL; DR derri\u00e8re tout cela est ceci\u00a0:<\/p>\n
- \n
- les informations de date fournies par l’API tierce sont conserv\u00e9es dans la table de m\u00e9tadonn\u00e9es post,<\/li>\n
- la cl\u00e9 est la date de d\u00e9but et la valeur est la date r\u00e9elle,<\/li>\n
- Je commande le contenu par ordre d\u00e9croissant et par la m\u00e9ta-valeur.<\/li>\n<\/ul>\n
La pagination peut \u00eatre un peu probl\u00e9matique, et si vous utilisez un type de publication personnalis\u00e9, vous aurez besoin de param\u00e8tres suppl\u00e9mentaires, mais il y a l’id\u00e9e g\u00e9n\u00e9rale.<\/p>\n
Passons maintenant \u00e0 l’ensemble du montage.<\/p>\n
Types de publication personnalis\u00e9s<\/h3>\n
En ce qui concerne l’interface avec des API tierces, je suis un grand fan des types de publication personnalis\u00e9s, car j’ai tendance \u00e0 les consid\u00e9rer comme un hybride entre les mod\u00e8les et les vues.<\/p>\n
- \n
- Le composant de mod\u00e8le inclut tout ce qui est tangentiellement li\u00e9 et peut \u00eatre \u00e9crit dans la base de donn\u00e9es. Cela signifie toute information de taxonomie ou publication de m\u00e9tadonn\u00e9es.<\/li>\n
- Le composant de vue est g\u00e9n\u00e9ralement tout ce qui entre dans le mod\u00e8le et qui peut exploiter les balises de mod\u00e8le pr\u00e9existantes, c’est-\u00e0-dire tout ce qui peut devoir \u00eatre cr\u00e9\u00e9 et qui lit \u00e9galement les informations de la base de donn\u00e9es.<\/li>\n<\/ul>\n
Pour ce post, je vais utiliser acme-event<\/strong> comme type de post personnalis\u00e9.<\/p>\n
Publier les m\u00e9tadonn\u00e9es<\/h3>\n
J’ai d\u00e9fini les dates dans les m\u00e9tadonn\u00e9es de la publication plut\u00f4t que sur la publication elle-m\u00eame, car si quelque chose doit se produire dans le futur et que les donn\u00e9es sont d\u00e9finies sur l’enregistrement de la publication elle-m\u00eame, WordPress la traitera comme une publication planifi\u00e9e<\/strong> non publi\u00e9e. .<\/p>\n<\/p>\n
Au lieu de cela, je pr\u00e9f\u00e9rerais que le message soit publi\u00e9, puis modifier la fa\u00e7on dont les m\u00e9tadonn\u00e9es sont affich\u00e9es dans le mod\u00e8le.<\/p>\n
Pagination<\/h3>\n
WordPress fait une distinction subtile avec la pagination dans sa base de code. Autrement dit, la variable de requ\u00eate pour les sites sans page d’accueil statique utilise paged<\/strong> et le cas contraire utilise page<\/strong>.<\/p>\n
![\"Mod\u00e8les](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161511-61e724257d2b2.png\")
<\/a><\/p>\nC’est important lorsque vous construisez les arguments de la requ\u00eate que j’aborderai dans un instant.<\/p>\n
Archiver uniquement les pages<\/h3>\n
N’oubliez pas que chaque fois que vous introduisez la pagination, vous ne souhaitez modifier la requ\u00eate que lorsque vous \u00eates sur la page d’archives r\u00e9elle.<\/p>\n
Cela signifie que vous ne vous souciez pas des cas o\u00f9 vous vous trouvez dans la zone administrative de WordPress et que vous ne souhaitez pas modifier la requ\u00eate pour les archives de type publication non personnalis\u00e9es. \u00c0 cette fin, vous devez vous assurer que vous d\u00e9finissez correctement la variable de requ\u00eate dans le rappel pre_get_posts.<\/p>\n
Notez que je peux montrer une fonction pour savoir comment faire cela, mais en raison de la fa\u00e7on dont nous \u00e9crivons du code dans WordPress – c’est-\u00e0-dire que certains \u00e9crivent du code proc\u00e9dural, d’autres \u00e9crivent du code orient\u00e9 objet – je l’afficherai simplement dans le code proc\u00e9dural.<\/p>\n
Rassembler le tout<\/h3>\n
Tout d’abord, je vais cr\u00e9er la requ\u00eate\u00a0:<\/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>\nNotez que dans le code ci-dessus, il y a un argument pour paged<\/strong>. Je vais parler du code pour cela momentan\u00e9ment.<\/p>\n
Ensuite, le mod\u00e8le inclura toutes les informations que vous choisissez d’afficher. Je choisis de ne pas partager le code de mon mod\u00e8le dans cet article car il n’est pas pertinent pour l’id\u00e9e plus large \u00e0 port\u00e9e de main.<\/p>\n
De plus, vous avez tout ce dont vous avez besoin pour afficher le contenu.<\/p>\n
Ensuite, je vais d\u00e9finir la pagination. Tout d’abord, je dois le faire en utilisant le crochet pre_get_posts pour m’assurer que la variable de requ\u00eate appropri\u00e9e est d\u00e9finie<\/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>\nEnsuite, je vais impl\u00e9menter la pagination<\/a> \u00e0 l’aide de la requ\u00eate personnalis\u00e9e\u00a0:<\/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>\nEt apr\u00e8s cela, je r\u00e9initialiserai la variable globale $ post<\/a> en utilisant wp_reset_postdata() juste au cas o\u00f9 quelque chose de la publication d’origine devrait \u00eatre utilis\u00e9.<\/p>\n
<?php wp_reset_postdata(); ?><\/code><\/pre>\nCeci est g\u00e9n\u00e9ralement consid\u00e9r\u00e9 comme un bon entretien chaque fois que vous utilisez une requ\u00eate personnalis\u00e9e, de toute fa\u00e7on.<\/p>\n
Liens utiles<\/h3>\n
Vous trouverez ci-dessous une liste de fonctions, de pages et de r\u00e9f\u00e9rences qui pourraient vous \u00eatre utiles en ce qui concerne le code ci-dessus ou tout travail futur que vous pourriez effectuer.<\/p>\n
- \n
- WP_Query<\/a><\/li>\n
- Pagination<\/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
- Le code complet<\/a> dans ce post.<\/li>\n<\/ul>\n
Si vous travaillez avec WordPress depuis longtemps, certains d’entre eux peuvent sembler redondants. Dans d’autres cas, cela peut sembler nouveau, ou cela peut \u00e9clairer des domaines des API WordPress dont vous ne saviez pas qu’ils existaient (du moins c’\u00e9tait le cas pour moi).<\/p>\n
Pourquoi s’emb\u00eater avec tout \u00e7a ?<\/h2>\n
Cela peut sembler \u00eatre un long message pour une t\u00e2che apparemment simple, mais les informations sont un peu dispers\u00e9es sur le Web en ce qui concerne la r\u00e9alisation de quelque chose comme \u00e7a.<\/p>\n
J’ai donc voulu essayer de rassembler le tout avec des explications, des exemples de code et des liens vers des pages qui peuvent \u00eatre int\u00e9ressantes en fonction de la mani\u00e8re dont la mise en \u0153uvre est effectu\u00e9e.<\/p>\n
Apr\u00e8s tout, beaucoup d’entre nous utilisent WordPress au-del\u00e0 de la gestion de contenu de base \u00e0 ce stade, mais cela ne signifie pas que nous ne devrions pas tirer parti de ses fonctions et API int\u00e9gr\u00e9es lorsque cela est possible.<\/p>\n
- Pagination<\/a><\/li>\n
- WP_Query<\/a><\/li>\n