Функция GET_PRIVACY_POLICY_URL() в WordPress

Функция GET_PRIVACY_POLICY_URL() возвращает URL страницы с политикой конфиденциальности вашего сайта на WordPress. Это полезно, если вы хотите, чтобы пользователи могли быстро находить вашу политику конфиденциальности.

Как работает функция

Функция использует две другие функции: get_option() и get_permalink(). Первая получает настройки сайта, а вторая формирует ссылку на конкретную страницу.

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

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

$url = get_privacy_policy_url();

Если страница с политикой конфиденциальности отсутствует, функция вернёт пустую строку.

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

Как отобразить ссылку на страницу с политикой конфиденциальности

Этот код покажет ссылку на страницу с политикой конфиденциальности. Если страница не создана, ссылка будет вести на #.

$url = get_privacy_policy_url() ?: '#';
echo 'Нажимая кнопку "Регистрация", вы соглашаетесь с политикой конфиденциальности.';

Что делает этот код?

1. Получение URL: Функция get_privacy_policy_url() получает URL страницы с политикой конфиденциальности.
2. Проверка: Если страницы нет, используется значение #, что означает, что ссылка ведёт в никуда.
3. Вывод ссылки: Мы выводим текст с ссылкой на политику конфиденциальности.

Возвращаемое значение

Функция возвращает строку:

• URL страницы с политикой конфиденциальности, или
• Пустая строка, если страница не существует.

История изменений

Функция была добавлена в версии WordPress 4.9.6.

Код функции

Вот сам код функции для полного понимания:

function get_privacy_policy_url() {
$url = '';
$policy_page_id = (int) get_option( 'wp_page_for_privacy_policy' );

if ( ! empty( $policy_page_id ) && get_post_status( $policy_page_id ) === 'publish' ) {
    $url = (string) get_permalink( $policy_page_id );
}

/**
 * Фильтрует URL страницы с политикой конфиденциальности.
 *
 * @since 4.9.6
 *
 * @param string $url            URL страницы с политикой конфиденциальности. Пустая строка
 *                               если она не существует.
 * @param int    $policy_page_id ID страницы с политикой конфиденциальности.
 */
return apply_filters( 'privacy_policy_url', $url, $policy_page_id );

}

Пояснение коду

1. Получение ID страницы: Мы получаем ID страницы с политикой конфиденциальности из настроек сайта.
2. Проверка статуса: Проверяем, опубликована ли страница. Если она существует и опубликована, то получаем её URL.
3. Фильтрация: Мы используем фильтр privacy_policy_url, чтобы другие функции или плагины могли изменять этот URL перед его возвратом.

Похожие функции

Существуют и другие функции в WordPress, связанные с URL, например:

• admin_url(): Получает URL панели администратора.
• get_home_url(): Возвращает URL главной страницы сайта.
• get_permalink(): Получает постоянную ссылку на пост или страницу.

Каждая из этих функций предназначена для получения различных типов URL на вашем сайте.