Option to customize a different pagination limit specifically for the archive pages

[shenweiyan]

Context

No response

Description

I've found that the pagination_per_page parameter in the blog plugin affects both the blog's main page and the archive pages.

Now, I wish there was an option to customize a different pagination limit specifically for the archive pages, for example, setting pagination_per_page=20 for the archives page while keeping pagination_per_page=5 for the main blog page.

Related links

• How to set pagination_per_page for archive page? #6376

Use Cases

Separately setting different pagination_per_page for the blog's main page and the archive pages can provide more flexibility for the customization of the blog plugin.

Visuals

No response

Before submitting

• I have read and followed the change request guidelines.
• I have verified that my idea is a change request and not a bug report.
• I have ensured that, to the best of my knowledge, my idea will benefit the entire community.
• I have included relevant links to the documentation, related issues, and discussions to underline the need for my idea.

[squidfunk]

Thanks for suggesting! Added in 8ecee7b (Insiders). This commit introduces several new configuration flags, and fixes some issues when pagination is disabled. New advanced settings are:

• archive_pagination
• archive_pagination_per_page
• categories_pagination
• categories_pagination_per_page

All of those are optional settings (similar to archive_toc and categories_toc), and will inherit their values from pagination and pagination_per_page unless they're explicitly specified.

Note that these options will at first be only available to sponsors. We're happy to offer more advanced configuration settings for the blog plugin that don't cater to everyday use cases to our sponsors as part of Insiders.

I'll backport the pagination fixes in a minute to the community edition. Adding this functionality was a great opportunity to refactor inheritance of settings a little, and to allow us to add more fine-grained controls in the future.

[squidfunk]

Documentation added in a6772cf.

[squidfunk]

Fixes for pagination have been backported in ae05629.

[squidfunk]

Released as part of 9.4.11+insiders-4.44.0.