Описание paginate_links_output
— Filter
Хук paginate_links_output позволяет изменить HTML-код, генерируемый функцией paginate_links в WordPress. Он срабатывает при выводе пагинации на страницах с постами и позволяет настроить ее внешний вид и структуру
Примеры использования
Пример изменения HTML-кода пагинации:
add_filter('paginate_links_output', function($output, $args) {
$output = '<div class="custom-pagination">' . $output . '</div>';
return $output;
}, 10, 2);
В этом примере мы оборачиваем пагинацию в кастомный div с классом ‘custom-pagination’.
Пример изменения текста для следующей и предыдущей страниц:
add_filter('paginate_links_output', function($output, $args) {
$args['prev_text'] = 'Назад';
$args['next_text'] = 'Вперед';
return paginate_links($args);
}, 10, 2);
Здесь мы изменяем текст для кнопок ‘Назад’ и ‘Вперед’ в пагинации.
Пример добавления кастомного класса к ссылкам пагинации:
add_filter('paginate_links_output', function($output, $args) {
$output = str_replace('<a', '<a class="custom-class"', $output);
return $output;
}, 10, 2);
Мы добавляем класс ‘custom-class’ ко всем ссылкам пагинации.
— Лучшие практики
– Использование
Используйте этот хук, когда необходимо изменить вывод пагинации на страницах с постами
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только вывода HTML
– Предупреждения
Убедитесь, что изменения не нарушают функциональность навигации на сайте
Альтернативы
Тип: function
Функция, генерирующая HTML-код пагинации, может быть использована для создания кастомной пагинации без использования хуков
Используйте её, если необходимо полностью контролировать генерацию пагинации без применения фильтров
