wp_link_pages

Примеры использования

Применение фильтра для изменения HTML-вывода ссылок на страницы

function custom_link_pages_output( $output, $args ) {
    // Изменяем HTML-вывод ссылок на страницы
    $output = str_replace( '<div class="wp-link-pages">', '<div class="custom-link-pages">', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_output', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_output, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для замены класса wp-link-pages на custom-link-pages. Затем мы возвращаем измененный HTML-вывод.

Изменение текста, добавляемого перед каждой ссылкой

function custom_link_pages_before( $output, $args ) {
    // Изменяем текст, добавляемый перед каждой ссылкой
    $output = str_replace( 'Pages:', 'Страницы:', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_before', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_before, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для замены текста «Pages:» на «Страницы:». Затем мы возвращаем измененный HTML-вывод.

Изменение текста, добавляемого после каждой ссылки

function custom_link_pages_after( $output, $args ) {
    // Изменяем текст, добавляемый после каждой ссылки
    $output = str_replace( '</a>', '</a> |', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_after', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_after, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для добавления символа «|» после каждой ссылки. Затем мы возвращаем измененный HTML-вывод.

Изменение текста, добавляемого перед каждой ссылкой и текущим элементом

function custom_link_pages_link_before( $output, $args ) {
    // Изменяем текст, добавляемый перед каждой ссылкой и текущим элементом
    $output = str_replace( '<a', '<span class="link-before">Before</span> <a', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_link_before', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_link_before, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для добавления текста «Before» перед каждой ссылкой и текущим элементом. Затем мы возвращаем измененный HTML-вывод.

Изменение текста, добавляемого после каждой ссылки и текущим элементом

function custom_link_pages_link_after( $output, $args ) {
    // Изменяем текст, добавляемый после каждой ссылки и текущим элементом
    $output = str_replace( '</a>', '</a> <span class="link-after">After</span>', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_link_after', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_link_after, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для добавления текста «After» после каждой ссылки и текущего элемента. Затем мы возвращаем измененный HTML-вывод.

Изменение значения атрибута aria-current

function custom_link_pages_aria_current( $output, $args ) {
    // Изменяем значение атрибута aria-current
    $output = str_replace( 'aria-current="page"', 'aria-current="step"', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_aria_current', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_aria_current, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для изменения значения атрибута aria-current с «page» на «step». Затем мы возвращаем измененный HTML-вывод.

Использование только номеров страниц вместо текстовых ссылок

function custom_link_pages_next_or_number( $output, $args ) {
    // Используем только номера страниц вместо текстовых ссылок
    $output = str_replace( 'next', 'number', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_next_or_number', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_next_or_number, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для замены значения «next» на «number». Затем мы возвращаем измененный HTML-вывод.

Изменение текста между ссылками на страницы

function custom_link_pages_separator( $output, $args ) {
    // Изменяем текст между ссылками на страницы
    $output = str_replace( ' | ', ' / ', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_separator', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_separator, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для замены текста » | » на » / «. Затем мы возвращаем измененный HTML-вывод.

Изменение текста ссылки на следующую страницу

function custom_link_pages_nextpagelink( $output, $args ) {
    // Изменяем текст ссылки на следующую страницу
    $output = str_replace( 'Next Page', 'Next', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_nextpagelink', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_nextpagelink, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для замены текста «Next Page» на «Next». Затем мы возвращаем измененный HTML-вывод.

Изменение текста ссылки на предыдущую страницу

function custom_link_pages_previouspagelink( $output, $args ) {
    // Изменяем текст ссылки на предыдущую страницу
    $output = str_replace( 'Previous Page', 'Previous', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_previouspagelink', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_previouspagelink, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для замены текста «Previous Page» на «Previous». Затем мы возвращаем измененный HTML-вывод.

Изменение формата строки с номером страницы

function custom_link_pages_pagelink( $output, $args ) {
    // Изменяем формат строки с номером страницы
    $output = str_replace( '%', 'Page %', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_pagelink', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_pagelink, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для замены символа «%» на «Page %». Затем мы возвращаем измененный HTML-вывод.

Отключение вывода HTML-кода

function custom_link_pages_echo( $output, $args ) {
    // Отключаем вывод HTML-кода
    return '';
}
add_filter( 'wp_link_pages', 'custom_link_pages_echo', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_echo, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы просто возвращаем пустую строку, чтобы отключить вывод HTML-кода. Таким образом, никакой HTML-код не будет выведен.

Изменение порядка аргументов в функции apply_filters

function custom_link_pages_arguments( $output, $args ) {
    // Изменяем порядок аргументов
    $output = str_replace( 'string $output', '$output string', $output );
    $output = str_replace( 'array|string $args', '$args array|string', $output );
    return $output;
}
add_filter( 'wp_link_pages', 'custom_link_pages_arguments', 10, 2 );

В данном примере мы создаем функцию custom_link_pages_arguments, которая принимает два параметра: $output (HTML-вывод ссылок на страницы) и $args (аргументы функции wp_link_pages). Внутри функции мы используем функцию str_replace для изменения порядка аргументов в строке документации. Затем мы возвращаем измененный HTML-вывод.