¿Pueden los enlaces Next/Prev Post ordenarse por orden de menú o por meta key?

La respuesta de Kaiser es increíble y detallada, sin embargo, simplemente cambiar la cláusula ORDER BY no es suficiente a menos que tu menu_order coincida con tu orden cronológico.

No puedo atribuirme el crédito por esto, pero encontré el siguiente código en este gist:

<?php
/**
 * Personalizar el orden de los enlaces de posts adyacentes
 */
function wpse73190_gist_adjacent_post_where($sql) {
  if ( !is_main_query() || !is_singular() )
    return $sql;

  $the_post = get_post( get_the_ID() );
  $patterns = array();
  $patterns[] = '/post_date/';
  $patterns[] = '/\'[0-9]{4}-[0-9]{2}-[0-9]{2} [0-9]{2}:[0-9]{2}:[0-9]{2}\'/';
  $replacements = array();
  $replacements[] = 'menu_order';
  $replacements[] = $the_post->menu_order;
  return preg_replace( $patterns, $replacements, $sql );
}
add_filter( 'get_next_post_where', 'wpse73190_gist_adjacent_post_where' );
add_filter( 'get_previous_post_where', 'wpse73190_gist_adjacent_post_where' );

function wpse73190_gist_adjacent_post_sort($sql) {
  if ( !is_main_query() || !is_singular() )
    return $sql;

  $pattern = '/post_date/';
  $replacement = 'menu_order';
  return preg_replace( $pattern, $replacement, $sql );
}
add_filter( 'get_next_post_sort', 'wpse73190_gist_adjacent_post_sort' );
add_filter( 'get_previous_post_sort', 'wpse73190_gist_adjacent_post_sort' );

He modificado los nombres de las funciones para WP.SE.

Si solo cambias la cláusula ORDER BY, la consulta sigue buscando posts mayores o menores que la fecha actual del post. Si tus posts no están en orden cronológico, no obtendrás el post correcto.

Esto cambia la cláusula WHERE para buscar posts donde el menu_order sea mayor o menor que el menu_order del post actual, además de modificar la cláusula ORDER BY.

La cláusula ORDER BY tampoco debería estar codificada para usar DESC, ya que necesitará cambiar según si estás obteniendo el enlace del siguiente o del anterior post.

Intenté engancharlo sin éxito. Puede que sea solo un problema de mi configuración, pero para aquellos que no pueden hacer que el hook funcione, aquí está la solución más simple:

<?php
    $all_posts = new WP_Query(array(
        'orderby' => 'menu_order',
        'order' => 'ASC',
        'posts_per_page' => -1
    ));

    foreach($all_posts->posts as $key => $value) {
        if($value->ID == $post->ID){
            $nextID = $all_posts->posts[$key + 1]->ID;
            $prevID = $all_posts->posts[$key - 1]->ID;
            break;
        }
    }
?>
<?php if($prevID): ?>
    <span class="prev">
        <a href="<?= get_the_permalink($prevID) ?>" rel="prev"><?= get_the_title($prevID) ?></a>
    </span>
<?php endif; ?>
<?php if($nextID): ?>
    <span class="next">
        <a href="<?= get_the_permalink($nextID) ?>" rel="next"><?= get_the_title($nextID) ?></a>
    </span>
<?php endif; ?>

/**
 * Modifica la consulta SQL para ordenar posts adyacentes por menu_order en lugar de post_date
 * 
 * @param string $sql La consulta SQL original
 * @return string La consulta SQL modificada
 */
function wpse73190_gist_adjacent_post_sort( $sql ) {
    $pattern = '/post_date/';
    $replacement = 'menu_order';

    return preg_replace( $pattern, $replacement, $sql );
}

// Aplicar el filtro tanto para el post siguiente como para el anterior
add_filter( 'get_next_post_sort', 'wpse73190_gist_adjacent_post_sort' );
add_filter( 'get_previous_post_sort', 'wpse73190_gist_adjacent_post_sort' );

Por si sirve de ayuda, aquí está cómo puedes ordenar por menu_order para un tipo de entrada personalizado específico:

/**
 * Personalizar el orden de las entradas adyacentes
 */
add_filter('get_next_post_sort', function($order) {
    if (is_singular('my_custom_post_type')) {
        return 'ORDER BY p.menu_order ASC LIMIT 1';
    }

    return $order;
}, 10);

add_filter('get_previous_post_sort', function($order) {
    if (is_singular('my_custom_post_type')) {
        return 'ORDER BY p.menu_order DESC LIMIT 1';
    }

    return $order;
}, 10);

add_filter('get_next_post_where', function() {
    if (is_singular('my_custom_post_type')) {
        global $post, $wpdb;
        return $wpdb->prepare("WHERE p.menu_order > %s AND p.post_type = %s AND p.post_status = 'publish'", $post->menu_order, $post->post_type);
    }
}, 10);

add_filter('get_previous_post_where', function() {
    if (is_singular('my_custom_post_type')) {
        global $post, $wpdb;
        return $wpdb->prepare("WHERE p.menu_order < %s AND p.post_type = %s AND p.post_status = 'publish'", $post->menu_order, $post->post_type);
    }
}, 10);

¡Espero que esto le sea útil a alguien más!

Basado en la respuesta de @Szabolcs Páll, he creado esta clase de utilidad con métodos auxiliares para poder obtener publicaciones de un tipo por orden de menú y también obtener la publicación siguiente y anterior por orden de menú. Además, he añadido condiciones para verificar si la publicación actual es la primera o la última, para así obtener la última o primera publicación respectivamente.

Por ejemplo:

// $currentPost es la primera por orden de menú
getPreviousPostByMenuOrder($postType, $$currentPost->ID)
// devuelve => última publicación por orden de menú

// $currentPost es la última por orden de menú
getPreviousPostByMenuOrder($postType, $$currentPost->ID)
// devuelve => primera publicación por orden de menú

La clase completa:

class PostMenuOrderUtils {

    public static function getPostsByMenuOrder($postType){
        $args =[
            'post_type' => $postType,
            'orderby' => 'menu_order',
            'order' => 'ASC',
            'posts_per_page' => -1
        ];

        $posts = get_posts($args);

        return $posts;
    }

    public static function getNextPostByMenuOrder($postType, $postID){
        $posts = self::getPostsByMenuOrder($postType);

        $nextPost = null;

        foreach($posts as $key => $value) {
            if($value->ID == $postID){
                $nextPost = $posts[$key] !== end($posts) ? $posts[$key + 1] : $posts[0];

                break;
            }
        }

        return $nextPost;
    }

    public static function getPreviousPostByMenuOrder($postType, $postID){
        $posts = self::getPostsByMenuOrder($postType);


        $prevPost = null;

        foreach($posts as $key => $value) {
            if($value->ID == $postID){
                $prevPost = $key !== 0 ? $posts[$key - 1] : end($posts);
                break;
            }
        }

        return $prevPost;
    }

}

Basado en la respuesta de @Szabolcs Páll y el post de bbloomer sobre agregar botones de anterior/siguiente en la página de producto único de WooCommerce, creé este código.

Ordena todos los productos por clave meta y agrega botones de anterior/siguiente arriba + abajo del producto.

(¡La clave meta puede ser también un campo ACF!)

/**
 * @snippet       Agregar botones anterior/siguiente ordenados por clave meta o campo ACF @ WooCommerce Página de Producto Único
 * @testedwith    WooCommerce 4.8.0
 * @source        Elron : https://wordpress.stackexchange.com/a/365334/98773
 * @thanks        bbloomer : https://businessbloomer.com/?p=20567
 * @thanks        Szabolcs Páll : https://wordpress.stackexchange.com/a/284045/98773
 */

add_action('woocommerce_before_single_product', 'elron_prev_next_product');

// y si también los quieres al final...
add_action('woocommerce_after_single_product', 'elron_prev_next_product');

function elron_prev_next_product()
{
   global $post;

   echo '<div class="prev-next-buttons">';

   $all_posts = new WP_Query(
      array(
         'post_type' => 'product',
         'meta_key' => 'the_meta_key_or_acf_field', // <-- CAMBIA ESTO
         'orderby' => 'meta_value',
         'order' => 'DESC',
         'posts_per_page' => -1
      )
   );

   foreach ($all_posts->posts as $key => $value) {
      if ($value->ID == $post->ID) {
         $nextID = $all_posts->posts[$key + 1]->ID;
         $prevID = $all_posts->posts[$key - 1]->ID;
         break;
      }
   }

   if ($prevID) : ?>
      <a href="<?= get_the_permalink($prevID) ?>" rel="prev" class="prev" title="<?= get_the_title($prevID) ?>"><?= esc_attr__('Producto anterior') ?></a>
   <?php endif; ?>
   <?php if ($nextID) : ?>
      <a href="<?= get_the_permalink($nextID) ?>" rel="next" class="next" title="<?= get_the_title($nextID) ?>"><?= esc_attr__('Producto siguiente') ?></a>
   <?php endif; ?>
<?php

   echo '</div>';
}

Si quieres el archivo scss adicional que usé: _prev-next-buttons.scss

.prev-next-buttons {
    background: $lightpurple;
    padding: 2em;
    text-align: center;

    a {
        opacity: 0.7;
        border-radius: 0.5em;
        border: $white 1px solid;
        color: $white;
        display: inline-block;
        padding: 0.5em 0.8em;
        text-decoration: none;
        margin: 0 0.1em;
        &:hover, &:focus {
            opacity: 1;
        }
    }

    .prev {
        &:before {
            content: "  ";
        }
    }
    .next {
        &:after {
            content: "  ";
        }
    }
}

.rtl {
    .prev-next-buttons {
        .prev {
            &:before {
                content: "  ";
            }
        }
        .next {
            &:after {
                content: "  ";
            }
        }
    }
}

Ninguna de las respuestas listadas aquí o en internet en general que pude encontrar al momento de escribir esto parecía ofrecer una solución razonablemente simple/elegante para presentar los enlaces de Siguiente/Anterior Post ordenados por meta key. Esto funciona bien para mí y es fácil de adaptar. ¡Disfrútalo!

add_filter( 'get_previous_post_where', function( $where ) {
    return get_adjacent_post_where( $where, false) ;
});
add_filter( 'get_next_post_where', function ( $where ) {
    return get_adjacent_post_where( $where, true );
}); 

function get_adjacent_post_where( $where, $is_next ) {  

    global $post;

    /* Ingresa tu tipo de post -> */
    $post_type = "_my_post_type_";

    if ($post_type == $post->post_type){

        global $wpdb;

        $show_private = current_user_can( 'read_private_pages', $post->ID );
        /* Ingresa el nombre de tu meta key personalizada -> */
        $meta_key = '_my_meta_key_name_'; 
        $meta_value = get_post_meta($post->ID,$meta_key,true);
        $operand = $is_next?">":"<";
        $direction = $is_next?"ASC":"DESC";

        $sub_query = "(SELECT m.post_id FROM `" . $wpdb->postmeta . "` AS m JOIN `" . $wpdb->posts . "` as p1 ON m.post_id = p1.ID "
        . "WHERE m.meta_key = '$meta_key' AND m.meta_value $operand '$meta_value' "
        . "AND (p1.post_status = 'publish'" . ($show_private?" OR p1.post_status = 'private') ":") ")
        . "ORDER BY m.meta_value $direction LIMIT 1)";
         
        /* La subconsulta anidada soluciona limitaciones actuales de mysql/mariadb */
        $where = "WHERE p.post_type = '$post_type'  AND p.ID IN (SELECT * FROM $sub_query as sq)";  
    }

    return $where;

}

Este pequeño plugin me resulta muy útil: http://wordpress.org/plugins/wp-query-powered-adjacent-post-link/

WP_Query Powered Adjacent Post Link es un plugin para desarrolladores. Añade la función wpqpapl(); a WordPress, la cual puede devolver información sobre el post anterior y siguiente al actual. Acepta argumentos para ser usados en la clase WP_Query.

Esto funcionó para mí:

add_filter( 'get_previous_post_where', 'so16495117_mod_adjacent_bis' );
add_filter( 'get_next_post_where', 'so16495117_mod_adjacent_bis' );
function so16495117_mod_adjacent_bis( $where ) {
    global $wpdb;
    return $where . " AND p.ID NOT IN ( SELECT post_id FROM $wpdb->postmeta WHERE ($wpdb->postmeta.post_id = p.ID ) AND $wpdb->postmeta.meta_key = 'archive' AND $wpdb->postmeta.meta_value = 1 )";
}

Tomado de: https://stackoverflow.com/questions/16495117/how-to-skip-certain-links-on-adjacent-posts-in-wordpress

Yo también tuve problemas con esto. Mágicamente logré que funcionara de esta manera:

• Asegúrate de que tu tipo de contenido (post type) esté configurado para tener posts jerárquicos.
• Luego usa el plugin simple custom post type order. https://wordpress.org/plugins/simple-custom-post-order/
  Además de permitir ordenar fácilmente con arrastrar y soltar, este plugin asegura que prev y next funcionen según el orden del menú. Desafortunadamente podría funcionar en orden inverso con DSC en lugar de ASC. Para solucionar esto podemos crear una función de navegación inversa entre posts.
• Usa una función de navegación inversa. Encontré una en gist. (agrégala al archivo functions.php de tu tema) https://gist.github.com/jaredchu/3e3bcb866240d1d32a3b4ae55905b135#file-the_reverse_post_navigation

Y no tuve que escribir ni una sola línea de código yo mismo :)

Edite el código de Szabolcs Páll mencionado anteriormente para ordenar por una meta_key personalizada y dentro de una categoría específica, pero también para intentar agregar condicionales para el primer y último post.

En el primer y último post no mostraba el enlace siguiente/anterior correcto con el código original, solo mostraba un enlace para el ID de post actual en el que me encontraba.

Esto funcionó para mí como se muestra a continuación, pero no estoy seguro si hay posibles problemas con ello. (No soy el programador más avanzado)

<?php
$all_posts = new WP_Query(array(
    'taxonomy' => 'category',
    'category_name' => 'projects',
    'meta_key' => 'grid_number_projects',
    'orderby' => 'meta_value',
    'order' => 'ASC',
    'posts_per_page' => -1
));
foreach($all_posts->posts as $key => $value) {
    if($value->ID == $post->ID){
        $nextID = isset($all_posts->posts[$key + 1]) ? $all_posts->posts[$key + 1]->ID : null;
        $prevID = isset($all_posts->posts[$key - 1]) ? $all_posts->posts[$key - 1]->ID : null;
        break;
    }
}

?>

<div class="project-nav-prev">
    <?php if($prevID): ?>
        <a href="<?= get_the_permalink($prevID) ?>" rel="prev"><span class="arrow">←</span> PROYECTO ANTERIOR </br><?= get_the_title($prevID) ?></a>
    <?php endif; ?>
</div>
<div class="project-nav-next">
    <?php if($nextID): ?>
        <a href="<?= get_the_permalink($nextID) ?>" rel="next">SIGUIENTE PROYECTO <span class="arrow">→</span> </br><?= get_the_title($nextID) ?></a>
    <?php endif; ?>
</div>

He encontrado una forma mucho más fácil de lograr una navegación entre publicaciones basada en meta-claves, sin necesidad de modificar functions.php.

Mi ejemplo: Tienes un products.php y quieres navegar entre productos. El producto anterior es el siguiente más barato, el siguiente producto es el siguiente más caro.

Aquí está mi solución para single.php:

<div class="post_navigation">

<?php

// Preparar el loop
$args = array(
'post_type' => 'products',
'post_status' => 'publish',
'meta_key' => 'price',
'orderby' => 'meta_value_num',
'order' => 'ASC',
'posts_per_page' => -1
);
query_posts($args);

// Inicializar array donde se almacenarán los IDs de TODAS las publicaciones de productos
$posts = array();

// ... y ahora iniciemos el loop
while ( have_posts() ) : the_post();
$posts[] += $post->ID;
endwhile;

// Resetear Query
wp_reset_query();

// Identificar la posición del producto actual dentro del array $posts 
$current = array_search(get_the_ID(), $posts);

// Identificar ID del producto anterior
$prevID = $posts[$current-1];

// Identificar ID del siguiente producto
$nextID = $posts[$current+1];

// Enlace "producto anterior"
if (!empty($prevID)) { ?>
<a href="/?p=<?php echo $prevID; ?>">producto anterior</a>
<?php }
// Enlace "siguiente producto"
if (!empty($nextID)) { ?>
<a href="/?p=<?php echo $nextID; ?>">siguiente producto</a>

<?php } ?>