Функция get_self_link() в WordPress возвращает URL текущей страницы или запроса. Это может быть полезно для вывода ссылки на текущую страницу в RSS-лентах, для работы с ссылками в шаблонах, а также в ситуациях, когда необходимо узнать адрес текущего запроса.
get_self_link(): stringget_self_link() формирует ссылку на текущую страницу, учитывая настройки WordPress и запросы пользователя. Например, вызов этой функции на главной странице сайта вернет ссылку на главную страницу, а при вызове на странице записи — ссылку на эту запись.
Возвращаемое значение
Возвращает строку — URL текущей страницы, в соответствии с запросом пользователя.
1. Получение текущего URL
На любой странице сайта, используя get_self_link(), можно получить текущий URL. Это удобно, когда нужно вывести ссылку на ту же страницу:
echo get_self_link();
// На главной странице: вернет http://example.com/
// На странице записи: вернет URL записи, например http://example.com/my-post
2. Использование в RSS-лентах
get_self_link() особенно полезна при создании RSS-ленты, так как позволяет точно отобразить текущий URL для элемента <atom:self>.
// Пример для RSS-ленты
echo '<link rel="self" type="application/rss+xml" href="' . esc_url( get_self_link() ) . '" />';
// Вставляет текущий URL как ссылку на RSS-ленты
3. Получение ссылки в админке и категориях
Функция может использоваться и в админ-панели или на странице категорий, отображая точный URL для этих страниц.
// Используем в админке:
if ( is_admin() ) {
echo 'Адрес этой страницы: ' . get_self_link();
// Например, в админке это может вывести http://example.com/wp-admin/dashboard.php
}
// На странице категории с кастомными параметрами:
echo get_self_link();
// Пример: http://example.com/category/news/?view=grid
5. Использование в шорткодах для вывода ссылки на текущую страницу
Можно использовать функцию get_self_link() в шорткодах, чтобы динамически генерировать ссылки на текущую страницу:
function display_self_link() {
return '<a href="' . esc_url( get_self_link() ) . '">Ссылка на текущую страницу</a>';
}
add_shortcode( 'self_link', 'display_self_link' );
// Пример использования шорткода: [self_link]
Важные замечания
- Экранирование ссылки: При выводе URL на экран важно использовать
esc_url(), чтобы избежать потенциальных уязвимостей, связанных с XSS. - Работа на разных страницах: Функция возвращает URL текущего запроса, независимо от его типа (страница, категория, запись, админка и т.д.).
Заключение
Функция get_self_link() — это простой, но полезный инструмент для получения ссылки на текущую страницу, особенно когда требуется универсальность при работе с динамическими URL.