Функция get_the_privacy_policy_link()

Функция get_the_privacy_policy_link() в WordPress позволяет получить ссылку на страницу с политикой конфиденциальности. Она возвращает эту ссылку в готовом виде с форматированием, ес��и такая страница существует.

Как это работает?

Эта функция использует другую функцию — get_privacy_policy_url(), чтобы получить URL политики конфиденциальности.

Использование функции

get_the_privacy_policy_link( $before, $after );

• $before (строка) — текст, который будет отображен перед ссылкой на политику конфиденциальности. По умолчанию это пустая строка ''.
• $after (строка) — текст, который будет отображен после ссылки. По умолчанию это пустая строка ''.

Что возвращает?

• Возвращаемое значение — строка с HTML-кодом для ссылки и окружающими её элементами. Если страница не существует, будет возвращена пустая строка.

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

Пример 1: Простая ссылка

Если нужно просто получить ссылку на страницу с политикой конфиденциальности:

$policy_link = get_the_privacy_policy_link();

Если такая страница существует, результат будет выглядеть так:

Privacy Policy

Пример 2: С текстом до и после ссылки

Вы можете включить текст до и после ссылки:

$policy_link = 'Пожалуйста, прочитайте ' . get_the_privacy_policy_link() . ' перед комментированием. Это важно!';

Если страница существует, результат будет следующим:

Пожалуйста, прочитайте Privacy Policy перед комментированием. Это важно!

Если страницы не опубликовано, то результатом будет:

Пожалуйста, прочитайте страницу перед комментированием. Это важно!

Пример 3: Пользовательский текст

Вы можете добавить свою формулировку:

$policy_link = get_the_privacy_policy_link('Сначала ознакомьтесь с ', '. Это действительно важно!');

Если страница существует, результат будет:

Сначала ознакомьтесь с Privacy Policy. Это действительно важно!

Если страницы нет, вернется пустая строка.

Код функции

Вот реализация функции get_the_privacy_policy_link():

function get_the_privacy_policy_link( $before = '', $after = '' ) {
$link = '';
$privacy_policy_url = get_privacy_policy_url();
$policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );
$page_title = ( $policy_page_id ) ? get_the_title( $policy_page_id ) : '';

if ( $privacy_policy_url && $page_title ) {
    $link = sprintf(
        '%s',
        esc_url( $privacy_policy_url ),
        esc_html( $page_title )
    );
}

$link = apply_filters( 'the_privacy_policy_link', $link, $privacy_policy_url );

if ( $link ) {
    return $before . $link . $after;
}

return '';

}

Список изменений

• С версии 4.9.6 — функция была введена.
• С версии 6.2.0 — добавлен атрибут rel с значением privacy-policy.

Связанные функции

• the_privacy_policy_link() — функция, которая выводит ссылку на политику конфиденциальности на экран.

Данная функция полезна для сайтов, которые придерживаются современных стандартов конфиденциальности и защиты данных. Правильное использование этой функции помогает пользователям легко находить информацию о том, как обрабатываются их данные.