Sin embargo, comenzar\u00e9 con un TL; DR primero. De esa manera, puedes hacerte una idea antes de leer todo.<\/p>\n
Plantillas de archivo personalizadas<\/h2>\n
Entonces, el TL; DR detr\u00e1s de todo esto es este:<\/p>\n
- \n
- la informaci\u00f3n de fecha proporcionada por la API de terceros se mantiene en la tabla de metadatos de la publicaci\u00f3n,<\/li>\n
- la clave es la fecha de inicio y el valor es la fecha real,<\/li>\n
- Ordeno el contenido en orden descendente y por el valor meta.<\/li>\n<\/ul>\n
La paginaci\u00f3n puede ser un problema, y \u200b\u200bsi usa un tipo de publicaci\u00f3n personalizada, necesitar\u00e1 algunos par\u00e1metros adicionales, pero esa es la idea general.<\/p>\n
Ahora para toda la configuraci\u00f3n.<\/p>\n
Tipos de publicaciones personalizadas<\/h3>\n
Cuando se trata de interactuar con API de terceros, soy un gran admirador de los tipos de publicaciones personalizadas porque tiendo a pensar en ellos como un h\u00edbrido entre modelos y vistas.<\/p>\n
- \n
- El componente del modelo incluye todo lo que est\u00e1 relacionado tangencialmente y se puede escribir en la base de datos. Esto significa cualquier informaci\u00f3n de taxonom\u00eda o metadatos de publicaciones.<\/li>\n
- El componente de vista generalmente es cualquier cosa que se incluye en la plantilla que puede aprovechar cualquier etiqueta de plantilla preexistente, es cualquier cosa que deba crearse y que tambi\u00e9n lea informaci\u00f3n de la base de datos.<\/li>\n<\/ul>\n
Para esta publicaci\u00f3n, usar\u00e9 acme-event<\/strong> como el tipo de publicaci\u00f3n personalizada.<\/p>\n
Publicar metadatos<\/h3>\n
Establec\u00ed las fechas en los metadatos de la publicaci\u00f3n en lugar de en la publicaci\u00f3n en s\u00ed porque si algo va a suceder en el futuro y los datos se establecen en el registro de la publicaci\u00f3n en s\u00ed, WordPress lo tratar\u00e1 como una publicaci\u00f3n programada<\/strong> que no est\u00e1 publicada. .<\/p>\n<\/p>\n
En cambio, prefiero publicar la publicaci\u00f3n y luego cambiar la forma en que se muestran los metadatos en la plantilla.<\/p>\n
Paginaci\u00f3n<\/h3>\n
WordPress hace una distinci\u00f3n sutil con la paginaci\u00f3n en su base de c\u00f3digo. Es decir, la variable de consulta para sitios sin una p\u00e1gina de inicio est\u00e1tica usa paged<\/strong> y el caso contrario usa page<\/strong>.<\/p>\n
![\"Plantillas](\"https:\/\/wordpress.mediadoma.com\/wp-content\/uploads\/2022\/01\/post-161511-61e724257d2b2.png\")
<\/a><\/p>\nEsto importa cuando est\u00e1s construyendo los argumentos para la consulta a la que llegar\u00e9 en un momento.<\/p>\n
Solo p\u00e1ginas de archivo<\/h3>\n
Recuerde que siempre que est\u00e9 introduciendo la paginaci\u00f3n, solo querr\u00e1 cambiar la consulta siempre que est\u00e9 en la p\u00e1gina de archivo real.<\/p>\n
Esto significa que no le importan los casos cuando se encuentra en el \u00e1rea administrativa de WordPress y no desea modificar la consulta de archivos de tipo de publicaci\u00f3n no personalizados. Con ese fin, querr\u00e1 asegurarse de que est\u00e1 configurando la variable de consulta correctamente en la devoluci\u00f3n de llamada pre_get_posts.<\/p>\n
Tenga en cuenta que puedo mostrar una funci\u00f3n sobre c\u00f3mo hacer esto, pero debido a c\u00f3mo escribimos c\u00f3digo en WordPress, es decir, algunos escriben c\u00f3digo de procedimiento, otros escriben c\u00f3digo orientado a objetos, simplemente lo mostrar\u00e9 en c\u00f3digo de procedimiento.<\/p>\n
Reuni\u00e9ndolo todo<\/h3>\n
Primero, construir\u00e9 la consulta:<\/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>\nTenga en cuenta que en el c\u00f3digo anterior hay un argumento para paginado<\/strong>. Hablar\u00e9 sobre el c\u00f3digo para esto moment\u00e1neamente.<\/p>\n
Luego, la plantilla incluir\u00e1 cualquier informaci\u00f3n que elija mostrar. Elijo no compartir el c\u00f3digo de mi plantilla en esta publicaci\u00f3n porque es irrelevante para la gran idea que tenemos entre manos.<\/p>\n
Adem\u00e1s, tienes todo lo que necesitas para mostrar el contenido.<\/p>\n
A continuaci\u00f3n, configurar\u00e9 la paginaci\u00f3n. Primero, necesito hacer esto usando el gancho pre_get_posts para asegurarme de que se establece la variable de consulta adecuada<\/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>\nLuego implementar\u00e9 la paginaci\u00f3n<\/a> usando la consulta personalizada:<\/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>\nY despu\u00e9s de eso, restablecer\u00e9 la variable global $post<\/a> usando wp_reset_postdata() en caso de que se necesite usar algo de la publicaci\u00f3n original.<\/p>\n
<?php wp_reset_postdata(); ?><\/code><\/pre>\nDe todos modos, esto generalmente se considera una buena limpieza cada vez que utiliza una consulta personalizada.<\/p>\n
Enlaces \u00fatiles<\/h3>\n
A continuaci\u00f3n hay una lista de funciones, p\u00e1ginas y referencias que pueden resultarle \u00fatiles en relaci\u00f3n con el c\u00f3digo anterior o cualquier trabajo futuro que pueda realizar.<\/p>\n
- \n
- WP_Query<\/a><\/li>\n
- Paginaci\u00f3n<\/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
- actualizaci\u00f3n_post_meta<\/a><\/li>\n
- wp_reset_postdata<\/a><\/li>\n
- El c\u00f3digo completo<\/a> en este post.<\/li>\n<\/ul>\n
Si ha estado trabajando con WordPress durante mucho tiempo, algunos de estos pueden parecer redundantes. En otros casos, puede parecer nuevo, o puede arrojar luz sobre \u00e1reas de las API de WordPress que no sab\u00edas que existen (al menos ese fue mi caso).<\/p>\n
\u00bfPor qu\u00e9 molestarse con todo esto?<\/h2>\n
Esto puede parecer una publicaci\u00f3n larga para una tarea aparentemente simple, pero la informaci\u00f3n est\u00e1 un poco dispersa por toda la web en lo que respecta a hacer algo como esto.<\/p>\n
As\u00ed que quer\u00eda intentar reunirlo todo con explicaciones, c\u00f3digo de ejemplo y enlaces a p\u00e1ginas que pueden ser de inter\u00e9s dependiendo de c\u00f3mo se realice la implementaci\u00f3n.<\/p>\n
Despu\u00e9s de todo, muchos de nosotros estamos usando WordPress m\u00e1s all\u00e1 de la gesti\u00f3n b\u00e1sica de contenido en este momento, pero eso no significa que no debamos aprovechar sus funciones y API integradas cuando sea posible.<\/p>\n
- Paginaci\u00f3n<\/a><\/li>\n
- WP_Query<\/a><\/li>\n