get_the_privacy_policy_link() │ WP 4.9.6

Возвращает ссылку (html) на страницу политики конфиденциальности.

Страницу конфиденциальности можно указать в админке Настройки > Конфиденциальность. Анкором ссылки служит заголовок страницы.

Используйте the_privacy_policy_link(), когда нужно сразу вывести ссылку на экран.

Работает на основе: get_privacy_policy_url()
Основа для: the_privacy_policy_link()
Хуки из функции

Возвращает

Строку. html код ссылки, если страница политики конфиденциальности указана в админке и опубликована. Иначе ничего не выводит.

Использование

get_the_privacy_policy_link( $before, $after );
$before(строка)
Текст/HTML код, который нужно разместить перед ссылкой.
По умолчанию: ''
$after(строка)
Текст/HTML код, который нужно разместить после ссылки.
По умолчанию: ''

Примеры

0

#1 Выведем ссылку на страницу политики конфиденциальности.

1 способ

$policy_link = get_the_privacy_policy_link();

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

<a class="privacy-policy-link" href="https://example.com/privacy-policy/">Политика конфиденциальности</a>

2 способ

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

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

Перед комментированием прочтите страницу <a class="privacy-policy-link" href="https://example.com/privacy-policy/">Политика конфиденциальности</a>. Это важно!

Если страница не указана или не опубликована:

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

3 способ

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

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

Перед комментированием прочтите страницу <a class="privacy-policy-link" href="https://example.com/privacy-policy/">Политика конфиденциальности</a>. Это важно!

Если страница не установлена или не опубликована, то вернёт пустую строку.

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

С версии 4.9.6 Введена.
С версии 6.2.0 Added 'privacy-policy' rel attribute.

Код get_the_privacy_policy_link() WP 6.7.1

wp-includes/link-template.php 
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(
			'<a class="privacy-policy-link" href="%s" rel="privacy-policy">%s</a>',
			esc_url( $privacy_policy_url ),
			esc_html( $page_title )
		);
	}

	/**
	 * Filters the privacy policy link.
	 *
	 * @since 4.9.6
	 *
	 * @param string $link               The privacy policy link. Empty string if it
	 *                                   doesn't exist.
	 * @param string $privacy_policy_url The URL of the privacy policy. Empty string
	 *                                   if it doesn't exist.
	 */
	$link = apply_filters( 'the_privacy_policy_link', $link, $privacy_policy_url );

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

	return '';
}

Политика конфиденциальности (Privacy policy)