Функция get_page_link() в WordPress с примером использования.

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

get_page_link( int $page_id = 0, bool $leavename = false, bool $sample = false )

Параметры

• $page_id (int) — ID страницы, для которой нужно получить ссылку. Если не указан, используется ID текущей страницы.
• $leavename (bool) — Определяет, оставлять ли холдер %pagename% без замены на имя страницы. Установите в true, чтобы оставить холдер без изменений. По умолчанию: false.
• $sample (bool) — Указывает, нужно ли получить ссылку в виде структуры постоянных ссылок (ЧПУ). Если true, функция вернёт ссылку в формате ЧПУ. По умолчанию: false.

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

Функция возвращает строку, представляющую собой URL страницы.

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

Функция get_page_link() предназначена для получения URL постоянной страницы (типа page). В WordPress она используется в случаях, когда требуется сформировать ссылку на страницу по её ID. В большинстве случаев для универсальности рекомендуется использовать функцию get_permalink(), которая также может работать с типами записей, отличными от page.

Функция get_page_link() работает на основе внутренней функции _get_page_link() и является основой для get_permalink().

Хуки из функции

• page_link — Хук, используемый функцией для фильтрации URL страницы.

Пример 1: Получение ссылки на страницу по ID

// Получение ссылки на страницу с ID 42
$page_id = 42;
$page_link = get_page_link( $page_id );
echo 'Ссылка на страницу: ' . esc_url( $page_link );

В этом примере мы используем функцию get_page_link() для получения URL страницы с ID 42 и выводим его на экран. Функция esc_url() используется для экранирования URL, что является хорошей практикой для обеспечения безопасности.

Пример 2: Использование ссылки в шаблоне

// Получение ссылки на страницу "О нас" и создание ссылки для меню
$page_id = get_option( 'page_on_front' ); // Получаем ID страницы главной страницы
$page_link = get_page_link( $page_id );

echo '<a href="' . esc_url( $page_link ) . '">Перейти на главную страницу</a>';

В этом примере мы получаем ID главной страницы сайта с помощью функции get_option() и затем получаем URL этой страницы с помощью get_page_link(). Ссылка выводится в виде HTML элемента <a>.

Пример 3: Простое использование

// Получение ссылки на страницу с ID 24568
echo get_page_link( 24568 ); // Пример: https://example.com/about/our-services

// Получение ссылки, оставляя холдер %pagename% без замены
echo get_page_link( 24568, true ); // Пример: https://example.com/%pagename%

Важно: Функция предназначена для страниц (page). Для записей (post) или произвольных типов записей лучше использовать get_permalink(), так как get_page_link() может вернуть некорректный результат.

Заключение

Функция get_page_link() в WordPress предоставляет удобный способ получения URL страниц по их ID. Несмотря на то что она предназначена исключительно для страниц, в большинстве случаев лучше использовать get_permalink() для универсальности и корректности работы с различными типами записей.