Additional args for get_the_post_navigation()

[ChaseWiseman]

It would be awesome if get_the_post_navigation() accepted and passed along all of the parameters available to the get_next_post_link() and get_previous_post_link() functions that are used within. This would allow developers to still use the function in cases where limiting navigation by taxonomy/term is desired. Namely $in_same_term, $excluded_terms, and $taxonomy.

This was first mentioned in ​https://github.com/Automattic/_s/issues/759

[obenland]

Let's tackle the completion of that API in 4.4.

[wonderboymusic]

check out the docs

[DrewAPicture]

Docs fixes + spacing

[DrewAPicture]

In 34715:

Themes: Introduce three new arguments for get_the_post_navigation(), in_same_term, excluded_terms, and taxonomy.

The addition of these new arguments brings get_the_post_navigation() into argument parity with get_previous_post_link() and get_next_post_link(), both of which it wraps, and will allow for more flexibility in configuring the next and previous post links for simultaneous display in themes.

Props ChaseWiseman.
Fixes #32618.