Описание get_pagenum_link
— Filter
Хук get_pagenum_link позволяет изменять URL-ссылки для пагинации страниц в WordPress. Он срабатывает при генерации ссылки на конкретную страницу в списке записей и позволяет настроить структуру URL-адреса пагинации
Примеры использования
Пример изменения структуры URL для пагинации:
add_filter('get_pagenum_link', function($pagenum_link, $paged) {
return str_replace('/page/', '/страница/', $pagenum_link);
}, 10, 2);
В этом примере мы изменяем часть URL с ‘/page/’ на ‘/страница/’.
Пример добавления параметра к ссылке пагинации:
add_filter('get_pagenum_link', function($pagenum_link, $paged) {
return add_query_arg('custom_param', 'value', $pagenum_link);
}, 10, 2);
Здесь мы добавляем кастомный параметр ‘custom_param’ к ссылке пагинации.
Пример изменения пагинации для пользовательского типа записи:
add_filter('get_pagenum_link', function($pagenum_link, $paged) {
if (is_post_type_archive('my_custom_post_type')) {
return str_replace('/archives/', '/my-custom-archive/', $pagenum_link);
}
return $pagenum_link;
}, 10, 2);
В этом примере мы изменяем пагинацию только для архивов пользовательского типа записи.
— Лучшие практики
– Использование
Используйте этот хук, когда нужно изменить ссылки пагинации на страницах с записями в WordPress
– Производительность
Хук не должен значительно влиять на производительность, так как изменения касаются только формирования URL
– Предупреждения
Следите за тем, чтобы изменения не нарушали логику навигации на сайте
Альтернативы
Тип: filter
Этот хук позволяет изменять ссылки для пагинации, используемой в функции paginate_links()
Используйте его, если вам нужно контролировать вывод пагинации в кастомных шаблонах
