REQUIRED: Could not find wp_link_pages. See: wp_link_pages by Theme Checker

I have run my theme through WordPress theme checker to see if it can be submitted to WordPress.org. I encountered this error:

REQUIRED: Could not find wp_link_pages. See: wp_link_pages

Read More

But this is not true. I am using a custom function wp_my_own_link_pages() which is a replacement for wp_link_pages(). It generates pagination with a compatible HTML structure for the theme.

Did I miss something required? How can I make this work?

Related posts

Leave a Reply

2 comments

  1. First, this question should be asked on the Theme Reviewers mail-list, not at WPSE. If you want official answers, you should use the official communication channels.

    But to answer your question in brief: Themes that implement core features/functionality are required to support the core implementation of those features/functionality.

    Thus, the requirement to use wp_link_pages() is… a requirement. Note that if you need to modify the HTML markup of the generated pagination links, you can use the arguments passed to wp_link_pages().

    Functions that are filterable can have filters applied, but wholesale replacement of core functions does not conform to the Guidelines.

  2. It should be okay. The requirement exists to make sure page pagination works. If it does you are fine. Note the theme checker cannot test all requirements, even much simpler cases will fall through.

    That’s why there is a theme review team, where humans make the real tests. If your upload fails, ask on the mailing list theme-reviewers.

    Update: As Chip said it is a literal requirement. Unfortunately, wp_link_pages() has not enough filters to be really useful, so you have to submit a simplified version of your theme to wordpress.org. But you can offer an advanced version on the page for your theme.