Why do you need an unlikely integer in paginating?

Note the get_pagenum_link( $big ): This will create an URL (not a link) based on the number provided in the first parameter.

That function is used to get the basic pattern for the URL, and the high integer is used here, because:

  1. You must provide an integer as argument.
  2. The resulting URL is filtered with apply_filters('get_pagenum_link', $result) and might be changed by plugins. This risk is slightly higher for numbers matching existing pages, for example when a plugin implements separate titles for sub-pages.

So this is just a … dirty convention, a signal to other plugins: Don’t change that please! I think PHP_INT_MAX would have been better, but still ugly. And I wonder how many plugin developers know that.

The number is then replaced with the placeholder needed in paginate_links().

What you see here is an incomplete API. Try to learn something from this example – do not release incomplete APIs, or your docs will look embarrassing. 🙂

Related Posts:

  1. Is it possible to paginate posts correctly that are random ordered?
  2. How to determine if I’m on the first page of pagination?
  3. Changing pagination list class
  4. How to determine if theres a next page
  5. WordPress /page/2 404 pagination problem – what to do?
  6. Paged posts – how to use numbers and next/previous links?
  7. How to display pagination links for WP_User_Query?
  8. How to show a single post on the front page but have normal paging?
  9. How to add CSS Class to previous_post_link or get previous/next post link URL
  10. Pagination resolving to first page only
  11. how to get pagination link url?
  12. add_rewrite_rule – working fine but broken for pagination
  13. How to get the number of Pages in a single Post Pagination?
  14. Aggregate comments, with pagination
  15. post pagination names, not numbers
  16. How to fix pagination after rewriting url? ie. www.site.com/players/type/pro/page/3/
  17. Display “Page 3 of 5” for a paginated post
  18. Implementing a general Table of Content across single paginated post pages
  19. Paginate links with “ugly” and “pretty” permalinks?
  20. Pagination of RSS2 feed
  21. Strange paginate_links behavior. First page link is always whatever page I’m on, all other links are correct
  22. Custom WP_Comment_Query with pagination and orderby?
  23. Pagination: How do I always show ‘previous’?
  24. Next/Previous Links in same category
  25. How To create ajaxed wp-pagenavi?
  26. Single Page View for Paginated Posts
  27. How can I see all of a post’s comments on a single page as a reader, if pagination is enabled?
  28. Using paginate_links() to generate “1, 2, 3 … 10, 20, 30, 40… 55” paginations
  29. Change class=”page-numbers” in pagination
  30. Check if on last page of paginated post using wp_link_pages
  31. Varying the number of posts per page from the first one
  32. Using pagination with get_posts on page type
  33. List posts based on first letter of posts
  34. Pagination for sub-pages
  35. Modifying WP_LIST_AUTHOR Functions to output all users in a grid (and Paginate)
  36. How to get post pagination like this
  37. How to paginate a list of tags
  38. Pagination Not Displaying on Custom Term Archive
  39. Non existing blog pages are not redirected to 404
  40. posts_per_page & pagination conflict
  41. How to implement pagination eg. newer – 3 – 4 – 5 – 6 – 7 – older
  42. How do I sort multiples pages?
  43. Problem: ( kriesi ) pagination doesn’t work in homepage [duplicate]
  44. Custom loop pagination issue ( pagination not showing up )
  45. WordPress pagination on custom script
  46. Combining WordPress pagination functions for archives and search results
  47. Pagination is not working wp_query custom fields values
  48. Broken pagination
  49. Passing custom args in paginate_links
  50. Limit number of pages in pagination
  51. wordpress Static Page pagination
  52. Static front page with recent posts pagination
  53. How to ignore or disable nextpage tag?
  54. Paginate tags page
  55. pagenavigation not showing the next page just linking back to the main page [closed]
  56. Category pagination shows same posts
  57. How to display next and prev pagination links with WP_User_Query?
  58. Custom taxonomy list and sortby letter pagination problem
  59. Paginate a list of users?
  60. Move pagination numbers above plug-ins
  61. Custom Page Template for “Older Posts” Pages
  62. Allow Users to Choose Pagination or Next/Previous (Combine)
  63. WordPress Pagination not displaying posts after certain page
  64. wp_link_page – wrap current page element
  65. category/category_name pagination 404 error
  66. How to create pagination on archive.php template
  67. Paginate get related post by author function
  68. Pagination that includes “view all on one page”
  69. How to use pre_get_posts?
  70. Custom page-links for paginated posts | wp_link_pages quicktag
  71. Custom paging function
  72. How to change title tags on paginated posts?
  73. Broken pagination, need help figuring out why!
  74. How to grab a specific page of content from paginated post?
  75. Jetpack plugin – ‘posts_per_page’ not overriding ‘Blog pages show at most’ option, also different values for different post types?
  76. Pagination with get_posts seems to work but links not showing
  77. get_query_var(‘paged’) giving same result
  78. Possible to paginate on single.php?
  79. Keep Pagination in Tabs
  80. Show content only on front page?
  81. paginate_links() outputs extra empty pages on custom loop
  82. Need help understanding pagination parameters
  83. Jetpack Infinite scroll conflicting with theme’s pre_get_posts custom posts_per_page
  84. When to check for max_num_pages using WordPress REST API?
  85. Adding pagination to a custom archive template
  86. How to make my pagination loop continuously?
  87. redirect pages with no content, instead of 404 error, using max_num_posts?
  88. add spans and characters into paginate_links
  89. I want to change the media list with additionally query
  90. Content only on last page, if the page has pagination
  91. paginate_links WP function
  92. Show next / previous text (button) all the time
  93. Using pre_get_posts to filter out posts, pagination problem
  94. How to let crawlers search paginated comments?
  95. Getting 404 on taxonomy page
  96. Having issues with wordpress pagination with multiple categories
  97. In pagination, change link for page 1 to homepage
  98. wordpress Next/Previous post in same category not working
  99. Why am I getting a 404 on anything past page 1 of my query?
  100. Getting pagination for second loop to work on single.php

Leave a Comment