Мені двічі траплялися сайти, де записи в категоріях треба було показувати не за датою, а за алфавітом: каталог пісень, довідник. Першого разу я витратив на це майже цілий день. Перший знайдений спосіб посортував записи, але заодно зламав віджет «Останні записи». Другий працював, але, як я зрозумів значно пізніше, робив зайвий запит до бази і ламав посторінкову навігацію. Тож розповім, як відсортувати записи у WordPress правильно, і про ще один підводний камінь, на який натрапляють саме українські сайти: літери Є, І, Ї та Ґ, які раптом опиняються не на своєму місці.

Сортування за алфавітом від А до Я і навпаки

Правильний спосіб: хук pre_get_posts

Ще до того, як відкрити шаблон сторінки, WordPress сам вирішує, які записи на ній показати, і робить запит до бази. Хук pre_get_posts дає змінити цей запит в останній момент: порядок, кількість, типи записів. Тож сортування записів у WordPress найправильніше робити саме тут. Додаємо у functions.php:

function mytheme_sort_categories_by_title( $query ) {
    if ( is_admin() || ! $query->is_main_query() ) {
        return;
    }

    if ( $query->is_category() ) {
        $query->set( 'orderby', 'title' );
        $query->set( 'order', 'ASC' );
    }
}

add_action( 'pre_get_posts', 'mytheme_sort_categories_by_title' );

Усе вирішують дві перевірки на початку:

  • is_admin() – не чіпаємо адмінку, інакше список записів у Записи → Усі записи теж посортується за алфавітом.
  • $query->is_main_query() – змінюємо лише головний запит сторінки, тобто сам список записів категорії. А віджети, меню, блоки «Схожі записи» роблять свої окремі запити, і їх наш код не зачепить.

Саме друга перевірка лікує ту проблему, через яку я колись втратив день. Мій перший код змінював порядок для всіх запитів на сторінці категорії, і віджет «Останні записи» замість свіжих статей почав показувати перші за алфавітом.

Зверни увагу і на $query->is_category() замість звичного is_category(): так ми питаємо саме про запит, який зараз змінюємо.

Лише для деяких категорій

Якщо за алфавітом треба сортувати лише певні категорії, передай їхні слаги або ID:

if ( $query->is_category( array( 'songs', 'glossary' ) ) ) {

Що ще можна змінити

Тим самим способом змінюється будь-що в головному запиті. Кілька прикладів того, що можна написати всередині умови:

// Від Я до А
$query->set( 'order', 'DESC' );

// Спершу нещодавно оновлені
$query->set( 'orderby', 'modified' );

// Спершу за полем «Порядок», а з однаковим порядком – за назвою
$query->set( 'orderby', array( 'menu_order' => 'ASC', 'title' => 'ASC' ) );

// 30 записів на сторінці замість стандартних 10
$query->set( 'posts_per_page', 30 );

Так само, до речі, обмежують пошук лише записами – приклад є у статті про форму та результати пошуку.

Чому не query_posts()

Другим моїм способом колись був рядок у archive.php перед циклом:

query_posts( $query_string . '&orderby=title&order=asc' );

Він справді не чіпає віджетів, але проблем у нього інших вистачає:

  • WordPress уже зробив запит до бази, а query_posts() викидає його результат і робить новий. Подвійна робота на кожній сторінці.
  • Посторінкова навігація рахує сторінки за першим запитом, тож на останніх сторінках легко отримати порожнечу чи помилку 404.
  • Умовні функції на кшталт is_category() після нього можуть відповідати не те, що ти очікуєш.

Сама документація WordPress радить query_posts() не використовувати. Шаблон категорії чи архіву має лише показувати записи, а вирішувати, які саме і в якому порядку, – справа pre_get_posts.

Чому Є, І, Ї та Ґ стоять не на своєму місці

Відсортував/ла записи, відкриваєш категорію, а там «Їжачок» і «Євшан-зілля» стоять перед «Абеткою», а «Ґанок» опинився аж після «Яблука». Знайомо? WordPress тут ні до чого: сортує база даних MySQL, а як саме вона порівнює літери, залежить від кодування порівняння (collation) таблиці.

  • utf8mb4_unicode_ci, utf8mb4_unicode_520_ci чи utf8mb4_0900_ai_ci порівнюють за правилами Unicode, і український алфавіт у них іде як треба: Е, Є, Ж, З, И, І, Ї, Й. Єдиний нюанс – Ґ вони вважають різновидом Г, тож «Ґанок» стане між «Гарбузом» і «Горою», а не після всіх слів на Г. Для більшості сайтів це не страшно.
  • utf8mb4_general_ci – спрощений варіант, який по суті порівнює номери символів у таблиці Unicode. А в ній Є, І та Ї стоять раніше за основний ряд кириличних літер від А до Я, а Ґ – після нього. Звідси й «Їжачок» перед «Абеткою».

Подивитися, яке порівняння в таблиці записів, можна в phpMyAdmin (вкладка Структура таблиці wp_posts, колонка «Порівняння») або SQL-запитом:

SHOW FULL COLUMNS FROM wp_posts LIKE 'post_title';

Якщо там general_ci, є два виходи.

Змінити порівняння в базі

Найчистіший варіант – змінити порівняння колонки з назвами. Обов'язково зроби резервну копію бази перед цим.

ALTER TABLE wp_posts
    MODIFY post_title TEXT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL;

Префікс таблиць у тебе може бути іншим, ніж wp_, – його видно у файлі wp-config.php.

Указати порівняння лише для сортування

Якщо лізти в структуру бази не хочеться (або хостинг не дає), можна попросити MySQL сортувати за правильними правилами лише в нашому запиті. Для цього є фільтр posts_orderby, який змінює сам SQL:

function mytheme_ukrainian_title_order( $orderby, $query ) {
    global $wpdb;

    if ( ! is_admin() && $query->is_main_query() && $query->is_category() ) {
        $orderby = "{$wpdb->posts}.post_title COLLATE utf8mb4_unicode_ci ASC";
    }

    return $orderby;
}

add_filter( 'posts_orderby', 'mytheme_ukrainian_title_order', 10, 2 );

Перевірки ті самі, що й раніше, тож віджети і адмінка в безпеці. $wpdb->posts підставить назву таблиці з правильним префіксом – детальніше про об'єкт $wpdb я писав у статті взаємодія з базою даних WordPress. З цим фільтром рядки з orderby у pre_get_posts для цих категорій уже не потрібні.

Що далі

Якщо ти робиш свою тему і ще не маєш окремого шаблону для категорій, почни зі статті шаблон категорії у WordPress. А більше прикладів того, що можна робити хуками, знайдеш за позначкою нижче.

А на твоєму сайті є розділ, де записи йдуть не за датою? Пиши в коментарях 🙂