Функция wp_check_browser_version() проверяет, нуждается ли браузер пользователя в обновлении. Она отправляет запрос с использованием строки $_SERVER['HTTP_USER_AGENT'] к внешнему API (http://api.wordpress.org/core/browse-happy/1.1/), который анализирует данные и возвращает информацию о браузере.
wp_check_browser_version(): array|falseВозвращаемое значение
- array|false — массив с данными о браузере при успешной проверке или
false, если произошла ошибка.
Дополнительная информация
- Результаты выполнения функции кэшируются на неделю с помощью временных опций, что ускоряет последующие вызовы.
- Функция расположена в файле
wp-admin/includes/dashboard.php, и перед ее использованием необходимо подключить этот файл.
Использование
$browser_data = wp_check_browser_version();
Пример возвращаемого массива
array(
'platform' => 'Windows',
'name' => 'Chrome',
'version' => '90.0',
'update_url' => 'http://www.google.com/chrome/',
'img_src' => 'http://s.wordpress.org/images/browsers/chrome.png',
'img_src_ssl' => 'https://wordpress.org/images/browsers/chrome.png',
'current_version' => '92',
'upgrade' => true,
'insecure' => false,
);
- platform — название операционной системы пользователя.
- name — название браузера.
- version — версия браузера.
- update_url — ссылка на страницу браузера для обновления.
- img_src — ссылка на логотип браузера по HTTP.
- img_src_ssl — ссылка на логотип браузера по HTTPS.
- current_version — последняя версия браузера.
- upgrade — логическое значение (true или false), указывающее, нужно ли обновить браузер.
- insecure — логическое значение (true или false), указывающее на безопасность текущей версии браузера.
Пример 1: Использование в админке
В следующем примере мы получаем информацию о браузере в админ-панели WordPress. Для этого добавим код в файл плагина или темы:
add_action( 'admin_head', function () {
if ( ! function_exists( 'wp_check_browser_version' ) ) {
include_once( ABSPATH . 'wp-admin/includes/dashboard.php' );
}
$browser_info = wp_check_browser_version();
if ( $browser_info ) {
var_dump( $browser_info );
} else {
echo '<p>Не удалось получить информацию о браузере.</p>';
}
});
Пример 2: Использование на фронтенде
Вы можете также получить информацию о браузере на внешней части сайта. Вот как это сделать:
add_action( 'wp', function () {
if ( ! function_exists( 'wp_check_browser_version' ) ) {
include_once( ABSPATH . 'wp-admin/includes/dashboard.php' );
}
$browser_info = wp_check_browser_version();
if ( $browser_info ) {
var_dump( $browser_info );
} else {
echo '<p>Не удалось получить информацию о браузере.</p>';
}
});
Заключение
Функция wp_check_browser_version() полезна для проверки совместимости браузера пользователя с сайтом. Она позволяет разработчикам предоставлять актуальную информацию о браузерах и их версиях, что может помочь улучшить пользовательский опыт и безопасность. Использование этой функции в админке или на фронтенде позволяет адаптировать интерфейс под различные браузеры.