Описание функции get_the_privacy_policy_link()
Функция get_the_privacy_policy_link() возвращает HTML-ссылку на страницу политики конфиденциальности сайта. Эта функция полезна для отображения ссылки на политику конфиденциальности в куки-банне, формах и других местах на сайте, чтобы соответствовать требованиям GDPR и другим законодательным нормам.
Если политика конфиденциальности не установлена, функция возвращает пустую строку.
Параметры
$text
Тип: string
Обязательный: Нет
По умолчанию: ‘Политика конфиденциальности’
Описание: Текст для ссылки
Возможные значения:
$echo
Тип: boolean
Обязательный: Нет
По умолчанию: true
Описание: Определяет, выводить ли ссылку сразу или возвращать ее
Возможные значения:
0: 1
1:
Возвращаемое значение
Тип: string|null
Описание: HTML-код ссылки на политику конфиденциальности или пустая строка
Возможные значения:
• HTML-код ссылки при наличии страницы политики конфиденциальности
• Пустая строка если не установлена политика конфиденциальности
Примеры использования
Вывод ссылки на политику конфиденциальности с текстом по умолчанию
echo get_the_privacy_policy_link();
// Результат: <a href="https://example.com/privacy-policy" target="_blank" rel="noopener">Политика конфиденциальности</a>
Вывод ссылки с индивидуальным текстом
echo get_the_privacy_policy_link('Читать политику конфиденциальности');
// Результат: <a href="https://example.com/privacy-policy" target="_blank" rel="noopener">Читать политику конфиденциальности</a>
Получение ссылки без ее немедленного вывода
$link = get_the_privacy_policy_link(null, false);
// $link будет содержать HTML-код ссылки, но не выведет его
Безопасность
Валидация входных данных: Функция проверяет наличие установленной политики конфиденциальности
Санитизация: Текст ссылки автоматически очищается WordPress
Рекомендации: Необходимо использовать esc_html() при выводе пользовательского текста
— Связанные функции
Получает ID страницы политики конфиденциальности
Получает информацию о записи по ID
— Хуки
Фильтрует HTML-ссылку на политику конфиденциальности перед выводом
— Примечания
– Ограничения
Возвращает пустую строку, если политика конфиденциальности не установлена
– Частые проблемы
- Проблемы с выводом, если страница политики удалена
- Отсутствие текста по умолчанию при использовании пользовательского текста
