Automattic\Jetpack\Device_Detection
User_Agent_Info{} │ WPSCache 1.0
A class providing device properties detection.
Note: str_contains() and other PHP8+ functions that have a polyfill in core are not used here, as wp-includes/compat.php may not be loaded yet.
Хуков нет.
Использование
$User_Agent_Info = new User_Agent_Info(); // use class methods
Методы
- public __construct( $ua = '' )
- public static detect_blackberry_browser_version()
- public static get_blackbeberry_OS_version()
- public get_browser()
- public get_desktop_platform()
- public get_mobile_user_agent_name()
- public get_platform()
- public isTierIphone()
- public isTierRichCss()
- public static is_J2ME_platform()
- public static is_MaemoTablet()
- public static is_MeeGo()
- public static is_Nintendo_3DS()
- public static is_PalmWebOS()
- public static is_S60_OSSBrowser()
- public static is_TouchPad()
- public static is_WindowsPhone7()
- public static is_android()
- public static is_android_tablet()
- public static is_blackbeberry()
- public static is_blackberry_10()
- public static is_blackberry_tablet()
- public static is_bot()
- public static is_bot_user_agent( $ua = null )
- public static is_chrome_desktop()
- public static is_chrome_for_iOS()
- public static is_edge_browser()
- public static is_facebook_for_ipad()
- public static is_facebook_for_iphone()
- public static is_firefox_desktop()
- public static is_firefox_mobile()
- public static is_firefox_os()
- public static is_ie_browser()
- public static is_ipad( $type = 'ipad-any' )
- public is_iphoneOrIpod()
- public static is_iphone_or_ipod( $type = 'iphone-any' )
- public static is_kindle_fire()
- public static is_kindle_touch()
- public static is_linux_desktop()
- public static is_mac_desktop()
- public static is_mobile_app()
- public static is_opera_desktop()
- public static is_opera_mini()
- public static is_opera_mini_dumb()
- public static is_opera_mobile()
- public static is_safari_browser()
- public static is_symbian_platform()
- public static is_symbian_s40_platform()
- public is_tablet()
- public static is_twitter_for_ipad()
- public static is_twitter_for_iphone()
- public static is_webkit()
- public static is_windows8_auth()
- public static is_windows_desktop()
- public static is_windows_phone_8()
- public static is_wordpress_desktop_app()
- public static is_wordpress_for_ios()
- public static is_wordpress_for_win8()
Код User_Agent_Info{} User Agent Info{} WPSCache 1.12.4
class User_Agent_Info { /** * Provided or fetched User-Agent string. * * @var string */ public $useragent; /** * A device group matched user agent, e.g. 'iphone'. * * @var string */ public $matched_agent; /** * Stores whether is the iPhone tier of devices. * * @var bool */ public $isTierIphone; /** * Stores whether the device can probably support Rich CSS, but JavaScript (jQuery) support is not assumed. * * @var bool */ public $isTierRichCss; /** * Stores whether it is another mobile device, which cannot be assumed to support CSS or JS (eg, older BlackBerry, RAZR) * * @var bool */ public $isTierGenericMobile; /** * Stores the device platform name * * @var null|string */ private $platform = null; const PLATFORM_WINDOWS = 'windows'; const PLATFORM_IPHONE = 'iphone'; const PLATFORM_IPOD = 'ipod'; const PLATFORM_IPAD = 'ipad'; const PLATFORM_BLACKBERRY = 'blackberry'; const PLATFORM_BLACKBERRY_10 = 'blackberry_10'; const PLATFORM_SYMBIAN = 'symbian_series60'; const PLATFORM_SYMBIAN_S40 = 'symbian_series40'; const PLATFORM_J2ME_MIDP = 'j2me_midp'; const PLATFORM_ANDROID = 'android'; const PLATFORM_ANDROID_TABLET = 'android_tablet'; const PLATFORM_FIREFOX_OS = 'firefoxOS'; const PLATFORM_DESKTOP_LINUX = 'linux'; const PLATFORM_DESKTOP_MAC = 'mac'; const PLATFORM_DESKTOP_WINDOWS = 'windows'; const PLATFORM_DESKTOP_CHROME = 'chrome'; const BROWSER_CHROME = 'chrome'; const BROWSER_FIREFOX = 'firefox'; const BROWSER_SAFARI = 'safari'; const BROWSER_EDGE = 'edge'; const BROWSER_OPERA = 'opera'; const BROWSER_IE = 'ie'; const OTHER = 'other'; /** * A list of dumb-phone user agent parts. * * @var array */ public $dumb_agents = array( 'nokia', 'blackberry', 'philips', 'samsung', 'sanyo', 'sony', 'panasonic', 'webos', 'ericsson', 'alcatel', 'palm', 'windows ce', 'opera mini', 'series60', 'series40', 'au-mic,', 'audiovox', 'avantgo', 'blazer', 'danger', 'docomo', 'epoc', 'ericy', 'i-mode', 'ipaq', 'midp-', 'mot-', 'netfront', 'nitro', 'palmsource', 'pocketpc', 'portalmmm', 'rover', 'sie-', 'symbian', 'cldc-', 'j2me', 'smartphone', 'up.browser', 'up.link', 'up.link', 'vodafone/', 'wap1.', 'wap2.', 'mobile', 'googlebot-mobile', ); /** * The constructor. * * @param string $ua (Optional) User agent. */ public function __construct( $ua = '' ) { if ( $ua ) { $this->useragent = $ua; } elseif ( ! empty( $_SERVER['HTTP_USER_AGENT'] ) ) { $this->useragent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This class is all about validating. } } /** * This method detects the mobile User Agent name. * * @return string The matched User Agent name, false otherwise. */ public function get_mobile_user_agent_name() { if ( static::is_chrome_for_iOS() ) { // Keep this check before the safari rule. return 'chrome-for-ios'; } elseif ( static::is_iphone_or_ipod( 'iphone-safari' ) ) { return 'iphone'; } elseif ( static::is_ipad( 'ipad-safari' ) ) { return 'ipad'; } elseif ( static::is_android_tablet() ) { // Keep this check before the android rule. return 'android_tablet'; } elseif ( static::is_android() ) { return 'android'; } elseif ( static::is_blackberry_10() ) { return 'blackberry_10'; } elseif ( static::is_blackbeberry() ) { return 'blackberry'; } elseif ( static::is_WindowsPhone7() ) { return 'win7'; } elseif ( static::is_windows_phone_8() ) { return 'winphone8'; } elseif ( static::is_opera_mini() ) { return 'opera-mini'; } elseif ( static::is_opera_mini_dumb() ) { return 'opera-mini-dumb'; } elseif ( static::is_opera_mobile() ) { return 'opera-mobi'; } elseif ( static::is_blackberry_tablet() ) { return 'blackberry_tablet'; } elseif ( static::is_kindle_fire() ) { return 'kindle-fire'; } elseif ( static::is_PalmWebOS() ) { return 'webos'; } elseif ( static::is_S60_OSSBrowser() ) { return 'series60'; } elseif ( static::is_firefox_os() ) { return 'firefoxOS'; } elseif ( static::is_firefox_mobile() ) { return 'firefox_mobile'; } elseif ( static::is_MaemoTablet() ) { return 'maemo'; } elseif ( static::is_MeeGo() ) { return 'meego'; } elseif ( static::is_TouchPad() ) { return 'hp_tablet'; } elseif ( static::is_facebook_for_iphone() ) { return 'facebook-for-iphone'; } elseif ( static::is_facebook_for_ipad() ) { return 'facebook-for-ipad'; } elseif ( static::is_twitter_for_iphone() ) { return 'twitter-for-iphone'; } elseif ( static::is_twitter_for_ipad() ) { return 'twitter-for-ipad'; } elseif ( static::is_wordpress_for_ios() ) { return 'ios-app'; } elseif ( static::is_iphone_or_ipod( 'iphone-not-safari' ) ) { return 'iphone-unknown'; } elseif ( static::is_ipad( 'ipad-not-safari' ) ) { return 'ipad-unknown'; } elseif ( static::is_Nintendo_3DS() ) { return 'nintendo-3ds'; } else { $agent = $this->useragent; $dumb_agents = $this->dumb_agents; foreach ( $dumb_agents as $dumb_agent ) { if ( false !== strpos( $agent, $dumb_agent ) ) { return $dumb_agent; } } } return false; } /** * This method detects the mobile device's platform. All return strings are from the class constants. * Note that this function returns the platform name, not the UA name/type. You should use a different function * if you need to test the UA capabilites. * * @return string|bool Name of the platform, false otherwise. */ public function get_platform() { if ( isset( $this->platform ) ) { return $this->platform; } if ( empty( $this->useragent ) ) { return false; } if ( strpos( $this->useragent, 'windows phone' ) !== false ) { $this->platform = self::PLATFORM_WINDOWS; } elseif ( strpos( $this->useragent, 'windows ce' ) !== false ) { $this->platform = self::PLATFORM_WINDOWS; } elseif ( strpos( $this->useragent, 'ipad' ) !== false ) { $this->platform = self::PLATFORM_IPAD; } elseif ( strpos( $this->useragent, 'ipod' ) !== false ) { $this->platform = self::PLATFORM_IPOD; } elseif ( strpos( $this->useragent, 'iphone' ) !== false ) { $this->platform = self::PLATFORM_IPHONE; } elseif ( strpos( $this->useragent, 'android' ) !== false ) { if ( static::is_android_tablet() ) { $this->platform = self::PLATFORM_ANDROID_TABLET; } else { $this->platform = self::PLATFORM_ANDROID; } } elseif ( static::is_kindle_fire() ) { $this->platform = self::PLATFORM_ANDROID_TABLET; } elseif ( static::is_blackberry_10() ) { $this->platform = self::PLATFORM_BLACKBERRY_10; } elseif ( strpos( $this->useragent, 'blackberry' ) !== false ) { $this->platform = self::PLATFORM_BLACKBERRY; } elseif ( static::is_blackberry_tablet() ) { $this->platform = self::PLATFORM_BLACKBERRY; } elseif ( static::is_symbian_platform() ) { $this->platform = self::PLATFORM_SYMBIAN; } elseif ( static::is_symbian_s40_platform() ) { $this->platform = self::PLATFORM_SYMBIAN_S40; } elseif ( static::is_J2ME_platform() ) { $this->platform = self::PLATFORM_J2ME_MIDP; } elseif ( static::is_firefox_os() ) { $this->platform = self::PLATFORM_FIREFOX_OS; } else { $this->platform = false; } return $this->platform; } /** * Returns the platform for desktops * * @return string */ public function get_desktop_platform() { $ua = $this->useragent; if ( empty( $ua ) ) { return false; } $platform = self::OTHER; if ( static::is_linux_desktop() ) { $platform = self::PLATFORM_DESKTOP_LINUX; } elseif ( static::is_mac_desktop() ) { $platform = self::PLATFORM_DESKTOP_MAC; } elseif ( static::is_windows_desktop() ) { $platform = self::PLATFORM_DESKTOP_WINDOWS; } elseif ( static::is_chrome_desktop() ) { $platform = self::PLATFORM_DESKTOP_CHROME; } return $platform; } /** * A simple pattern matching method for extracting the browser from the user agent. * * @return string */ public function get_browser() { $ua = $this->useragent; if ( empty( $ua ) ) { return self::OTHER; } if ( static::is_opera_mini() || static::is_opera_mobile() || static::is_opera_desktop() || static::is_opera_mini_dumb() ) { return self::BROWSER_OPERA; } elseif ( static::is_edge_browser() ) { return self::BROWSER_EDGE; } elseif ( static::is_chrome_desktop() || self::is_chrome_for_iOS() ) { return self::BROWSER_CHROME; } elseif ( static::is_safari_browser() ) { return self::BROWSER_SAFARI; } elseif ( static::is_firefox_mobile() || static::is_firefox_desktop() ) { return self::BROWSER_FIREFOX; } elseif ( static::is_ie_browser() ) { return self::BROWSER_IE; } return self::OTHER; } /** * This method detects for UA which can display iPhone-optimized web content. * Includes iPhone, iPod Touch, Android, WebOS, Fennec (Firefox mobile), etc. */ public function isTierIphone() { if ( isset( $this->isTierIphone ) ) { return $this->isTierIphone; } if ( $this->is_iphoneOrIpod() ) { $this->matched_agent = 'iphone'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_android() ) { $this->matched_agent = 'android'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_windows_phone_8() ) { $this->matched_agent = 'winphone8'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_WindowsPhone7() ) { $this->matched_agent = 'win7'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_blackberry_10() ) { $this->matched_agent = 'blackberry-10'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_blackbeberry() && 'blackberry-webkit' === static::detect_blackberry_browser_version() ) { $this->matched_agent = 'blackberry-webkit'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_blackberry_tablet() ) { $this->matched_agent = 'blackberry_tablet'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_PalmWebOS() ) { $this->matched_agent = 'webos'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_TouchPad() ) { $this->matched_agent = 'hp_tablet'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_firefox_os() ) { $this->matched_agent = 'firefoxOS'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_firefox_mobile() ) { $this->matched_agent = 'fennec'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_opera_mobile() ) { $this->matched_agent = 'opera-mobi'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_MaemoTablet() ) { $this->matched_agent = 'maemo'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_MeeGo() ) { $this->matched_agent = 'meego'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_kindle_touch() ) { $this->matched_agent = 'kindle-touch'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } elseif ( static::is_Nintendo_3DS() ) { $this->matched_agent = 'nintendo-3ds'; $this->isTierIphone = true; $this->isTierRichCss = false; $this->isTierGenericMobile = false; } else { $this->isTierIphone = false; } return $this->isTierIphone; } /** * This method detects for UA which are likely to be capable * but may not necessarily support JavaScript. * Excludes all iPhone Tier UA. */ public function isTierRichCss() { if ( isset( $this->isTierRichCss ) ) { return $this->isTierRichCss; } if ( $this->isTierIphone() ) { return false; } // The following devices are explicitly ok. if ( static::is_S60_OSSBrowser() ) { $this->matched_agent = 'series60'; $this->isTierIphone = false; $this->isTierRichCss = true; $this->isTierGenericMobile = false; } elseif ( static::is_opera_mini() ) { $this->matched_agent = 'opera-mini'; $this->isTierIphone = false; $this->isTierRichCss = true; $this->isTierGenericMobile = false; } elseif ( static::is_blackbeberry() ) { $detectedDevice = static::detect_blackberry_browser_version(); if ( 'blackberry-5' === $detectedDevice || 'blackberry-4.7' === $detectedDevice || 'blackberry-4.6' === $detectedDevice ) { $this->matched_agent = $detectedDevice; $this->isTierIphone = false; $this->isTierRichCss = true; $this->isTierGenericMobile = false; } } else { $this->isTierRichCss = false; } return $this->isTierRichCss; } /** * Detects if the user is using a tablet. * props Corey Gilmore, BGR.com * * @return bool */ public function is_tablet() { return ( 0 // Never true, but makes it easier to manage our list of tablet conditions. || self::is_ipad() || self::is_android_tablet() || self::is_blackberry_tablet() || self::is_kindle_fire() || self::is_MaemoTablet() || self::is_TouchPad() ); } /** * Detects if the current UA is the default iPhone or iPod Touch Browser. * * DEPRECATED: use is_iphone_or_ipod */ public function is_iphoneOrIpod() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( ( strpos( $ua, 'iphone' ) !== false ) || ( strpos( $ua, 'ipod' ) !== false ) ) { if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } else { return false; } } /** * Detects if the current UA is iPhone Mobile Safari or another iPhone or iPod Touch Browser. * * They type can check for any iPhone, an iPhone using Safari, or an iPhone using something other than Safari. * * Note: If you want to check for Opera mini, Opera mobile or Firefox mobile (or any 3rd party iPhone browser), * you should put the check condition before the check for 'iphone-any' or 'iphone-not-safari'. * Otherwise those browsers will be 'catched' by the iphone string. * * @param string $type Type of iPhone detection. */ public static function is_iphone_or_ipod( $type = 'iphone-any' ) { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $is_iphone = ( strpos( $ua, 'iphone' ) !== false ) || ( strpos( $ua, 'ipod' ) !== false ); $is_safari = ( false !== strpos( $ua, 'safari' ) ); if ( 'iphone-safari' === $type ) { return $is_iphone && $is_safari; } elseif ( 'iphone-not-safari' === $type ) { return $is_iphone && ! $is_safari; } else { return $is_iphone; } } /** * Detects if the current UA is Chrome for iOS * * The User-Agent string in Chrome for iOS is the same as the Mobile Safari User-Agent, with CriOS/<ChromeRevision> instead of Version/<VersionNum>. * - Mozilla/5.0 (iPhone; U; CPU iPhone OS 5_1_1 like Mac OS X; en) AppleWebKit/534.46.0 (KHTML, like Gecko) CriOS/19.0.1084.60 Mobile/9B206 Safari/7534.48.3 */ public static function is_chrome_for_iOS() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( self::is_iphone_or_ipod( 'iphone-safari' ) === false ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'crios/' ) !== false ) { return true; } else { return false; } } /** * Detects if the current UA is Twitter for iPhone * * Mozilla/5.0 (iPhone; U; CPU iPhone OS 4_3_5 like Mac OS X; nb-no) AppleWebKit/533.17.9 (KHTML, like Gecko) Mobile/8L1 Twitter for iPhone * Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Mobile/9B206 Twitter for iPhone */ public static function is_twitter_for_iphone() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'ipad' ) !== false ) { return false; } if ( strpos( $ua, 'twitter for iphone' ) !== false ) { return true; } else { return false; } } /** * Detects if the current UA is Twitter for iPad * * Old version 4.X - Mozilla/5.0 (iPad; U; CPU OS 4_3_5 like Mac OS X; en-us) AppleWebKit/533.17.9 (KHTML, like Gecko) Mobile/8L1 Twitter for iPad * Ver 5.0 or Higher - Mozilla/5.0 (iPad; CPU OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Mobile/9B206 Twitter for iPhone */ public static function is_twitter_for_ipad() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'twitter for ipad' ) !== false ) { return true; } elseif ( strpos( $ua, 'ipad' ) !== false && strpos( $ua, 'twitter for iphone' ) !== false ) { return true; } else { return false; } } /** * Detects if the current UA is Facebook for iPhone * - Facebook 4020.0 (iPhone; iPhone OS 5.0.1; fr_FR) * - Mozilla/5.0 (iPhone; U; CPU iPhone OS 5_0 like Mac OS X; en_US) AppleWebKit (KHTML, like Gecko) Mobile [FBAN/FBForIPhone;FBAV/4.0.2;FBBV/4020.0;FBDV/iPhone3,1;FBMD/iPhone;FBSN/iPhone OS;FBSV/5.0;FBSS/2; FBCR/O2;FBID/phone;FBLC/en_US;FBSF/2.0] * - Mozilla/5.0 (iPhone; CPU iPhone OS 5_1_1 like Mac OS X) AppleWebKit/534.46 (KHTML, like Gecko) Mobile/9B206 [FBAN/FBIOS;FBAV/5.0;FBBV/47423;FBDV/iPhone3,1;FBMD/iPhone;FBSN/iPhone OS;FBSV/5.1.1;FBSS/2; FBCR/3ITA;FBID/phone;FBLC/en_US] */ public static function is_facebook_for_iphone() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false === strpos( $ua, 'iphone' ) ) { return false; } if ( false !== strpos( $ua, 'facebook' ) && false === strpos( $ua, 'ipad' ) ) { return true; } elseif ( false !== strpos( $ua, 'fbforiphone' ) && false === strpos( $ua, 'tablet' ) ) { return true; } elseif ( false !== strpos( $ua, 'fban/fbios;' ) && false === strpos( $ua, 'tablet' ) ) { // FB app v5.0 or higher. return true; } else { return false; } } /** * Detects if the current UA is Facebook for iPad * - Facebook 4020.0 (iPad; iPhone OS 5.0.1; en_US) * - Mozilla/5.0 (iPad; U; CPU iPhone OS 5_0 like Mac OS X; en_US) AppleWebKit (KHTML, like Gecko) Mobile [FBAN/FBForIPhone;FBAV/4.0.2;FBBV/4020.0;FBDV/iPad2,1;FBMD/iPad;FBSN/iPhone OS;FBSV/5.0;FBSS/1; FBCR/;FBID/tablet;FBLC/en_US;FBSF/1.0] * - Mozilla/5.0 (iPad; CPU OS 6_0 like Mac OS X) AppleWebKit/536.26 (KHTML, like Gecko) Mobile/10A403 [FBAN/FBIOS;FBAV/5.0;FBBV/47423;FBDV/iPad2,1;FBMD/iPad;FBSN/iPhone OS;FBSV/6.0;FBSS/1; FBCR/;FBID/tablet;FBLC/en_US] */ public static function is_facebook_for_ipad() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false === strpos( $ua, 'ipad' ) ) { return false; } if ( false !== strpos( $ua, 'facebook' ) || false !== strpos( $ua, 'fbforiphone' ) || false !== strpos( $ua, 'fban/fbios;' ) ) { return true; } else { return false; } } /** * Detects if the current UA is WordPress for iOS */ public static function is_wordpress_for_ios() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false !== strpos( $ua, 'wp-iphone' ) ) { return true; } else { return false; } } /** * Detects if the current device is an iPad. * They type can check for any iPad, an iPad using Safari, or an iPad using something other than Safari. * * Note: If you want to check for Opera mini, Opera mobile or Firefox mobile (or any 3rd party iPad browser), * you should put the check condition before the check for 'iphone-any' or 'iphone-not-safari'. * Otherwise those browsers will be 'catched' by the ipad string. * * @param string $type iPad type. */ public static function is_ipad( $type = 'ipad-any' ) { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $is_ipad = ( false !== strpos( $ua, 'ipad' ) ); $is_safari = ( false !== strpos( $ua, 'safari' ) ); if ( 'ipad-safari' === $type ) { return $is_ipad && $is_safari; } elseif ( 'ipad-not-safari' === $type ) { return $is_ipad && ! $is_safari; } else { return $is_ipad; } } /** * Detects if the current browser is Firefox Mobile (Fennec) * * See http://www.useragentstring.com/pages/Fennec/ * Mozilla/5.0 (Windows NT 6.1; WOW64; rv:2.1.1) Gecko/20110415 Firefox/4.0.2pre Fennec/4.0.1 * Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.1b2pre) Gecko/20081015 Fennec/1.0a1 */ public static function is_firefox_mobile() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'fennec' ) !== false ) { return true; } else { return false; } } /** * Detects if the current browser is Firefox for desktop * * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent/Firefox * Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion * The platform section will include 'Mobile' for phones and 'Tablet' for tablets. */ public static function is_firefox_desktop() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false !== strpos( $ua, 'firefox' ) && false === strpos( $ua, 'mobile' ) && false === strpos( $ua, 'tablet' ) ) { return true; } else { return false; } } /** * Detects if the current browser is FirefoxOS Native browser * * Mozilla/5.0 (Mobile; rv:14.0) Gecko/14.0 Firefox/14.0 */ public static function is_firefox_os() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'mozilla' ) !== false && strpos( $ua, 'mobile' ) !== false && strpos( $ua, 'gecko' ) !== false && strpos( $ua, 'firefox' ) !== false ) { return true; } else { return false; } } /** * Detect Safari browser */ public static function is_safari_browser() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( false === strpos( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ), 'Safari' ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return false; } return true; } /** * Detect Edge browser */ public static function is_edge_browser() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( false === strpos( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ), 'Edge' ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return false; } return true; } /** * Detect Edge browser */ public static function is_ie_browser() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = wp_unslash( $_SERVER['HTTP_USER_AGENT'] ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false === ( strpos( $ua, 'MSIE' ) || strpos( $ua, 'Trident/7' ) ) ) { return false; } return true; } /** * Detect modern Opera desktop * * Mozilla/5.0 (Macintosh; Intel Mac OS X 11_2_2) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/88.0.4324.182 Safari/537.36 OPR/74.0.3911.203 * * Looking for "OPR/" specifically. */ public static function is_opera_desktop() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( false === strpos( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ), 'OPR/' ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return false; } return true; } /** * Detects if the current browser is Opera Mobile * * What is the difference between Opera Mobile and Opera Mini? * - Opera Mobile is a full Internet browser for mobile devices. * - Opera Mini always uses a transcoder to convert the page for a small display. * (it uses Opera advanced server compression technology to compress web content before it gets to a device. * The rendering engine is on Opera's server.) * * Opera/9.80 (Windows NT 6.1; Opera Mobi/14316; U; en) Presto/2.7.81 Version/11.00" * Opera/9.50 (Nintendo DSi; Opera/507; U; en-US) */ public static function is_opera_mobile() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'opera' ) !== false && strpos( $ua, 'mobi' ) !== false ) { return true; } elseif ( strpos( $ua, 'opera' ) !== false && strpos( $ua, 'nintendo dsi' ) !== false ) { return true; } else { return false; } } /** * Detects if the current browser is Opera Mini * * Opera/8.01 (J2ME/MIDP; Opera Mini/3.0.6306/1528; en; U; ssr) * Opera/9.80 (Android;Opera Mini/6.0.24212/24.746 U;en) Presto/2.5.25 Version/10.5454 * Opera/9.80 (iPhone; Opera Mini/5.0.019802/18.738; U; en) Presto/2.4.15 * Opera/9.80 (J2ME/iPhone;Opera Mini/5.0.019802/886; U; ja) Presto/2.4.15 * Opera/9.80 (J2ME/iPhone;Opera Mini/5.0.019802/886; U; ja) Presto/2.4.15 * Opera/9.80 (Series 60; Opera Mini/5.1.22783/23.334; U; en) Presto/2.5.25 Version/10.54 * Opera/9.80 (BlackBerry; Opera Mini/5.1.22303/22.387; U; en) Presto/2.5.25 Version/10.54 */ public static function is_opera_mini() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'opera' ) !== false && strpos( $ua, 'mini' ) !== false ) { return true; } else { return false; } } /** * Detects if the current browser is Opera Mini, but not on a smart device OS(Android, iOS, etc) * Used to send users on dumb devices to m.wor */ public static function is_opera_mini_dumb() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( self::is_opera_mini() ) { if ( strpos( $ua, 'android' ) !== false || strpos( $ua, 'iphone' ) !== false || strpos( $ua, 'ipod' ) !== false || strpos( $ua, 'ipad' ) !== false || strpos( $ua, 'blackberry' ) !== false ) { return false; } else { return true; } } else { return false; } } /** * Detects if the current browser is a Windows Phone 7 device. * ex: Mozilla/4.0 (compatible; MSIE 7.0; Windows Phone OS 7.0; Trident/3.1; IEMobile/7.0; LG; GW910) */ public static function is_WindowsPhone7() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false === strpos( $ua, 'windows phone os 7' ) ) { return false; } elseif ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } /** * Detects if the current browser is a Windows Phone 8 device. * ex: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; ARM; Touch; IEMobile/10.0; <Manufacturer>; <Device> [;<Operator>]) */ public static function is_windows_phone_8() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'windows phone 8' ) === false ) { return false; } else { return true; } } /** * Detects if the current browser is on a Palm device running the new WebOS. This EXCLUDES TouchPad. * * Ex1: Mozilla/5.0 (webOS/1.4.0; U; en-US) AppleWebKit/532.2 (KHTML, like Gecko) Version/1.0 Safari/532.2 Pre/1.1 * Ex2: Mozilla/5.0 (webOS/1.4.0; U; en-US) AppleWebKit/532.2 (KHTML, like Gecko) Version/1.0 Safari/532.2 Pixi/1.1 */ public static function is_PalmWebOS() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false === strpos( $ua, 'webos' ) ) { return false; } elseif ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } /** * Detects if the current browser is the HP TouchPad default browser. This excludes phones wt WebOS. * * TouchPad Emulator: Mozilla/5.0 (hp-desktop; Linux; hpwOS/2.0; U; it-IT) AppleWebKit/534.6 (KHTML, like Gecko) wOSBrowser/233.70 Safari/534.6 Desktop/1.0 * TouchPad: Mozilla/5.0 (hp-tablet; Linux; hpwOS/3.0.0; U; en-US) AppleWebKit/534.6 (KHTML, like Gecko) wOSBrowser/233.70 Safari/534.6 TouchPad/1.0 */ public static function is_TouchPad() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $http_user_agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false !== strpos( $http_user_agent, 'hp-tablet' ) || false !== strpos( $http_user_agent, 'hpwos' ) || false !== strpos( $http_user_agent, 'touchpad' ) ) { if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } else { return false; } } /** * Detects if the current browser is the Series 60 Open Source Browser. * * OSS Browser 3.2 on E75: Mozilla/5.0 (SymbianOS/9.3; U; Series60/3.2 NokiaE75-1/110.48.125 Profile/MIDP-2.1 Configuration/CLDC-1.1 ) AppleWebKit/413 (KHTML, like Gecko) Safari/413 * * 7.0 Browser (Nokia 5800 XpressMusic (v21.0.025)) : Mozilla/5.0 (SymbianOS/9.4; U; Series60/5.0 Nokia5800d-1/21.0.025; Profile/MIDP-2.1 Configuration/CLDC-1.1 ) AppleWebKit/413 (KHTML, like Gecko) Safari/413 * * Browser 7.1 (Nokia N97 (v12.0.024)) : Mozilla/5.0 (SymbianOS/9.4; Series60/5.0 NokiaN97-1/12.0.024; Profile/MIDP-2.1 Configuration/CLDC-1.1; en-us) AppleWebKit/525 (KHTML, like Gecko) BrowserNG/7.1.12344 */ public static function is_S60_OSSBrowser() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } $pos_webkit = strpos( $agent, 'webkit' ); if ( false !== $pos_webkit ) { // First, test for WebKit, then make sure it's either Symbian or S60. if ( strpos( $agent, 'symbian' ) !== false || strpos( $agent, 'series60' ) !== false ) { return true; } else { return false; } } elseif ( strpos( $agent, 'symbianos' ) !== false && strpos( $agent, 'series60' ) !== false ) { return true; } elseif ( strpos( $agent, 'nokia' ) !== false && strpos( $agent, 'series60' ) !== false ) { return true; } return false; } /** * Detects if the device platform is the Symbian Series 60. */ public static function is_symbian_platform() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_webkit = strpos( $agent, 'webkit' ); if ( false !== $pos_webkit ) { // First, test for WebKit, then make sure it's either Symbian or S60. if ( strpos( $agent, 'symbian' ) !== false || strpos( $agent, 'series60' ) !== false ) { return true; } else { return false; } } elseif ( strpos( $agent, 'symbianos' ) !== false && strpos( $agent, 'series60' ) !== false ) { return true; } elseif ( strpos( $agent, 'nokia' ) !== false && strpos( $agent, 'series60' ) !== false ) { return true; } elseif ( strpos( $agent, 'opera mini' ) !== false ) { if ( strpos( $agent, 'symbianos' ) !== false || strpos( $agent, 'symbos' ) !== false || strpos( $agent, 'series 60' ) !== false ) { return true; } } return false; } /** * Detects if the device platform is the Symbian Series 40. * Nokia Browser for Series 40 is a proxy based browser, previously known as Ovi Browser. * This browser will report 'NokiaBrowser' in the header, however some older version will also report 'OviBrowser'. */ public static function is_symbian_s40_platform() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $agent, 'series40' ) !== false ) { if ( strpos( $agent, 'nokia' ) !== false || strpos( $agent, 'ovibrowser' ) !== false || strpos( $agent, 'nokiabrowser' ) !== false ) { return true; } } return false; } /** * Returns if the device belongs to J2ME capable family. * * @return bool */ public static function is_J2ME_platform() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $agent, 'j2me/midp' ) !== false ) { return true; } elseif ( strpos( $agent, 'midp' ) !== false && strpos( $agent, 'cldc' ) ) { return true; } return false; } /** * Detects if the current UA is on one of the Maemo-based Nokia Internet Tablets. */ public static function is_MaemoTablet() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_maemo = strpos( $agent, 'maemo' ); if ( false === $pos_maemo ) { return false; } // Must be Linux + Tablet, or else it could be something else. if ( strpos( $agent, 'tablet' ) !== false && strpos( $agent, 'linux' ) !== false ) { if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } else { return false; } } /** * Detects if the current UA is a MeeGo device (Nokia Smartphone). */ public static function is_MeeGo() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( false === strpos( $ua, 'meego' ) ) { return false; } elseif ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } /** * The is_webkit() method can be used to check the User Agent for an webkit generic browser. */ public static function is_webkit() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_webkit = strpos( $agent, 'webkit' ); if ( false !== $pos_webkit ) { return true; } else { return false; } } /** * Detects if the current browser is the Native Android browser. * * @return boolean true if the browser is Android otherwise false */ public static function is_android() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_android = strpos( $agent, 'android' ); if ( false !== $pos_android ) { if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } else { return false; } } /** * Detects if the current browser is the Native Android Tablet browser. * Assumes 'Android' should be in the user agent, but not 'mobile' * * @return boolean true if the browser is Android and not 'mobile' otherwise false */ public static function is_android_tablet() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_android = strpos( $agent, 'android' ); $pos_mobile = strpos( $agent, 'mobile' ); $post_android_app = strpos( $agent, 'wp-android' ); if ( false !== $pos_android && false === $pos_mobile && false === $post_android_app ) { if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } else { return false; } } /** * Detects if the current browser is the Kindle Fire Native browser. * * Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_3; en-us; Silk/1.1.0-84) AppleWebKit/533.16 (KHTML, like Gecko) Version/5.0 Safari/533.16 Silk-Accelerated=true * Mozilla/5.0 (Macintosh; U; Intel Mac OS X 10_6_3; en-us; Silk/1.1.0-84) AppleWebKit/533.16 (KHTML, like Gecko) Version/5.0 Safari/533.16 Silk-Accelerated=false * * @return boolean true if the browser is Kindle Fire Native browser otherwise false */ public static function is_kindle_fire() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_silk = strpos( $agent, 'silk/' ); $pos_silk_acc = strpos( $agent, 'silk-accelerated=' ); if ( false !== $pos_silk && false !== $pos_silk_acc ) { return true; } else { return false; } } /** * Detects if the current browser is the Kindle Touch Native browser * * Mozilla/5.0 (X11; U; Linux armv7l like Android; en-us) AppleWebKit/531.2+ (KHTML, like Gecko) Version/5.0 Safari/533.2+ Kindle/3.0+ * * @return boolean true if the browser is Kindle monochrome Native browser otherwise false */ public static function is_kindle_touch() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_kindle_touch = strpos( $agent, 'kindle/3.0+' ); if ( false !== $pos_kindle_touch && false === self::is_kindle_fire() ) { return true; } else { return false; } } /** * Detect if user agent is the WordPress.com Windows 8 app (used ONLY on the custom oauth stylesheet) */ public static function is_windows8_auth() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos = strpos( $agent, 'msauthhost' ); if ( false !== $pos ) { return true; } else { return false; } } /** * Detect if user agent is the WordPress.com Windows 8 app. */ public static function is_wordpress_for_win8() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos = strpos( $agent, 'wp-windows8' ); if ( false !== $pos ) { return true; } else { return false; } } /** * Detect if user agent is the WordPress.com Desktop app. */ public static function is_wordpress_desktop_app() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos = strpos( $agent, 'WordPressDesktop' ); if ( false !== $pos ) { return true; } else { return false; } } /** * The is_blackberry_tablet() method can be used to check the User Agent for a RIM blackberry tablet. * The user agent of the BlackBerry® Tablet OS follows a format similar to the following: * Mozilla/5.0 (PlayBook; U; RIM Tablet OS 1.0.0; en-US) AppleWebKit/534.8+ (KHTML, like Gecko) Version/0.0.1 Safari/534.8+ */ public static function is_blackberry_tablet() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_playbook = stripos( $agent, 'PlayBook' ); $pos_rim_tablet = stripos( $agent, 'RIM Tablet' ); if ( ( false === $pos_playbook ) || ( false === $pos_rim_tablet ) ) { return false; } else { return true; } } /** * The is_blackbeberry() method can be used to check the User Agent for a blackberry device. * Note that opera mini on BB matches this rule. */ public static function is_blackbeberry() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_blackberry = strpos( $agent, 'blackberry' ); if ( false !== $pos_blackberry ) { if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { return false; } else { return true; } } else { return false; } } /** * The is_blackberry_10() method can be used to check the User Agent for a BlackBerry 10 device. */ public static function is_blackberry_10() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return ( strpos( $agent, 'bb10' ) !== false ) && ( strpos( $agent, 'mobile' ) !== false ); } /** * Determines whether a desktop platform is Linux OS * * @return bool */ public static function is_linux_desktop() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( ! preg_match( '/linux/i', wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return false; } return true; } /** * Determines whether a desktop platform is Mac OS * * @return bool */ public static function is_mac_desktop() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( ! preg_match( '/macintosh|mac os x/i', wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return false; } return true; } /** * Determines whether a desktop platform is Windows OS * * @return bool */ public static function is_windows_desktop() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( ! preg_match( '/windows|win32/i', wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return false; } return true; } /** * Determines whether a desktop platform is Chrome OS * * @return bool */ public static function is_chrome_desktop() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( ! preg_match( '/chrome/i', wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. return false; } return true; } /** * Retrieve the blackberry OS version. * * Return strings are from the following list: * - blackberry-10 * - blackberry-7 * - blackberry-6 * - blackberry-torch //only the first edition. The 2nd edition has the OS7 onboard and doesn't need any special rule. * - blackberry-5 * - blackberry-4.7 * - blackberry-4.6 * - blackberry-4.5 * * @return string Version of the BB OS. * If version is not found, get_blackbeberry_OS_version will return boolean false. */ public static function get_blackbeberry_OS_version() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( self::is_blackberry_10() ) { return 'blackberry-10'; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. $pos_blackberry = stripos( $agent, 'blackberry' ); if ( false === $pos_blackberry ) { // Not a blackberry device. return false; } // Blackberry devices OS 6.0 or higher. // Mozilla/5.0 (BlackBerry; U; BlackBerry 9670; en) AppleWebKit/534.3+ (KHTML, like Gecko) Version/6.0.0.286 Mobile Safari/534.3+. // Mozilla/5.0 (BlackBerry; U; BlackBerry 9800; en) AppleWebKit/534.1+ (KHTML, Like Gecko) Version/6.0.0.141 Mobile Safari/534.1+. // Mozilla/5.0 (BlackBerry; U; BlackBerry 9900; en-US) AppleWebKit/534.11+ (KHTML, like Gecko) Version/7.0.0 Mobile Safari/534.11+. $pos_webkit = stripos( $agent, 'webkit' ); if ( false !== $pos_webkit ) { // Detected blackberry webkit browser. $pos_torch = stripos( $agent, 'BlackBerry 9800' ); if ( false !== $pos_torch ) { return 'blackberry-torch'; // Match the torch first edition. the 2nd edition should use the OS7 and doesn't need any special rule. } elseif ( preg_match( '#Version\/([\d\.]+)#i', $agent, $matches ) ) { // Detecting the BB OS version for devices running OS 6.0 or higher. $version = $matches[1]; $version_num = explode( '.', $version ); if ( false === is_array( $version_num ) || count( $version_num ) <= 1 ) { return 'blackberry-6'; // not a BB device that match our rule. } else { return 'blackberry-' . $version_num[0]; } } else { // if doesn't match returns the minimun version with a webkit browser. we should never fall here. return 'blackberry-6'; // not a BB device that match our rule. } } // Blackberry devices <= 5.XX. // BlackBerry9000/5.0.0.93 Profile/MIDP-2.0 Configuration/CLDC-1.1 VendorID/179. if ( preg_match( '#BlackBerry\w+\/([\d\.]+)#i', $agent, $matches ) ) { $version = $matches[1]; } else { return false; // not a BB device that match our rule. } $version_num = explode( '.', $version ); if ( is_array( $version_num ) === false || count( $version_num ) <= 1 ) { return false; } $version_num_major = (int) $version_num[0]; $version_num_minor = (int) $version_num[1]; if ( 5 === $version_num_major ) { return 'blackberry-5'; } elseif ( 4 === $version_num_major && 7 === $version_num_minor ) { return 'blackberry-4.7'; } elseif ( 4 === $version_num_major && 6 === $version_num_minor ) { return 'blackberry-4.6'; } elseif ( 4 === $version_num_major && 5 === $version_num_minor ) { return 'blackberry-4.5'; } else { return false; } } /** * Retrieve the blackberry browser version. * * Return string are from the following list: * - blackberry-10 * - blackberry-webkit * - blackberry-5 * - blackberry-4.7 * - blackberry-4.6 * * @return string Type of the BB browser. * If browser's version is not found, detect_blackbeberry_browser_version will return boolean false. */ public static function detect_blackberry_browser_version() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( self::is_blackberry_10() ) { return 'blackberry-10'; } $pos_blackberry = strpos( $agent, 'blackberry' ); if ( false === $pos_blackberry ) { // Not a blackberry device. return false; } $pos_webkit = strpos( $agent, 'webkit' ); if ( ! ( false === $pos_webkit ) ) { return 'blackberry-webkit'; } else { if ( ! preg_match( '#BlackBerry\w+\/([\d\.]+)#i', $agent, $matches ) ) { return false; // not a BB device that match our rule. } $version_num = explode( '.', $matches[1] ); if ( false === is_array( $version_num ) || count( $version_num ) <= 1 ) { return false; } $version_num_major = (int) $version_num[0]; $version_num_minor = (int) $version_num[1]; if ( 5 === $version_num_major ) { return 'blackberry-5'; } elseif ( 4 === $version_num_major && 7 === $version_num_minor ) { return 'blackberry-4.7'; } elseif ( 4 === $version_num_major && 6 === $version_num_minor ) { return 'blackberry-4.6'; } else { // A very old BB device is found or this is a BB device that doesn't match our rules. return false; } } } /** * Checks if a visitor is coming from one of the WordPress mobile apps. * * @return bool */ public static function is_mobile_app() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $agent = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( isset( $_SERVER['X_USER_AGENT'] ) && preg_match( '|wp-webos|', $_SERVER['X_USER_AGENT'] ) ) { // phpcs:ignore WordPress.Security.ValidatedSanitizedInput -- This is validating. return true; // Wp4webos 1.1 or higher. } $app_agents = array( 'wp-android', 'wp-blackberry', 'wp-iphone', 'wp-nokia', 'wp-webos', 'wp-windowsphone' ); // the mobile reader on iOS has an incorrect UA when loading the reader // currently it is the default one provided by the iOS framework which // causes problems with 2-step-auth // User-Agent WordPress/3.1.4 CFNetwork/609 Darwin/13.0.0. $app_agents[] = 'wordpress/3.1'; foreach ( $app_agents as $app_agent ) { if ( false !== strpos( $agent, $app_agent ) ) { return true; } } return false; } /** * Detects if the current browser is Nintendo 3DS handheld. * * Example: Mozilla/5.0 (Nintendo 3DS; U; ; en) Version/1.7498.US * can differ in language, version and region */ public static function is_Nintendo_3DS() { if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } $ua = strtolower( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. if ( strpos( $ua, 'nintendo 3ds' ) !== false ) { return true; } return false; } /** * Was the current request made by a known bot? * * @return boolean */ public static function is_bot() { static $is_bot = null; if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { return false; } if ( $is_bot === null ) { $is_bot = self::is_bot_user_agent( wp_unslash( $_SERVER['HTTP_USER_AGENT'] ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating. } return $is_bot; } /** * Is the given user-agent a known bot? * If you want an is_bot check for the current request's UA, use is_bot() instead of passing a user-agent to this method. * * @param string $ua A user-agent string. * * @return boolean */ public static function is_bot_user_agent( $ua = null ) { if ( empty( $ua ) ) { return false; } $bot_agents = array( 'alexa', 'altavista', 'ask jeeves', 'attentio', 'baiduspider', 'bingbot', 'chtml generic', 'crawler', 'fastmobilecrawl', 'feedfetcher-google', 'firefly', 'froogle', 'gigabot', 'googlebot', 'googlebot-mobile', 'heritrix', 'httrack', 'ia_archiver', 'irlbot', 'iescholar', 'infoseek', 'jumpbot', 'linkcheck', 'lycos', 'mediapartners', 'mediobot', 'motionbot', 'msnbot', 'mshots', 'openbot', 'pss-webkit-request', 'pythumbnail', 'scooter', 'slurp', 'snapbot', 'spider', 'taptubot', 'technoratisnoop', 'teoma', 'twiceler', 'yahooseeker', 'yahooysmcm', 'yammybot', 'ahrefsbot', 'pingdom.com_bot', 'kraken', 'yandexbot', 'twitterbot', 'tweetmemebot', 'openhosebot', 'queryseekerspider', 'linkdexbot', 'grokkit-crawler', 'livelapbot', 'germcrawler', 'domaintunocrawler', 'grapeshotcrawler', 'cloudflare-alwaysonline', 'cookieinformationscanner', // p1699315886066389-slack-C0438NHCLSY 'facebookexternalhit', // https://www.facebook.com/externalhit_uatext.php 'feedburner', 'yacybot', // http://yacy.net/bot.html 'trendictionbot', // http://www.trendiction.de/bot; 'elisabot', 'linkfluence', // http://linkfluence.com/ 'semrushbot', // https://www.semrush.com/bot/ 'archive.org_bot', // http://archive.org/details/archive.org_bot 'ezlynxbot', // https://www.ezoic.com/bot 'siteauditbot', // https://www.semrush.com/bot/ 'snapchat', // https://developers.snap.com/robots 'applebot', // https://support.apple.com/en-ca/HT204683 'bne.es_bot', // https://www.bne.es/es/colecciones/archivo-web-espanola/aviso-webmasters 'google-safety;', // https://www.google.com/bot.html 'mojeekbot', // https://www.mojeek.com/bot.html 'linkwalker', // https://www.linkwalker.com/ ); foreach ( $bot_agents as $bot_agent ) { if ( false !== stripos( $ua, $bot_agent ) ) { return true; } } return false; } }