diff --git a/class.jetpack-user-agent.php b/class.jetpack-user-agent.php index cbf7a21ea0721..eabb17881567d 100644 --- a/class.jetpack-user-agent.php +++ b/class.jetpack-user-agent.php @@ -1,207 +1,40 @@ false, - 'dumb' => false, - 'any' => false, - ); - static $first_run = true; - static $matched_agent = ''; - - // If an invalid kind is passed in, reset it to default. - if ( ! isset( $kinds[ $kind ] ) ) { - $kind = 'any'; - } - - if ( function_exists( 'apply_filters' ) ) { - /** - * Filter the value of jetpack_is_mobile before it is calculated. - * - * Passing a truthy value to the filter will short-circuit determining the - * mobile type, returning the passed value instead. - * - * @since 4.2.0 - * - * @param bool|string $matches Boolean if current UA matches $kind or not. If - * $return_matched_agent is true, should return the UA string - * @param string $kind Category of mobile device being checked - * @param bool $return_matched_agent Boolean indicating if the UA should be returned - */ - $pre = apply_filters( 'pre_jetpack_is_mobile', null, $kind, $return_matched_agent ); - - if ( null !== $pre ) { - return $pre; - } - } - - $ua_info = new Jetpack_User_Agent_Info(); - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) || strpos( strtolower( $_SERVER['HTTP_USER_AGENT'] ), 'ipad' ) ) { - return false; - } - - // Remove Samsung Galaxy tablets (SCH-I800) from being mobile devices - if ( strpos( strtolower( $_SERVER['HTTP_USER_AGENT'] ), 'sch-i800' ) ) { - return false; - } - - if ( $ua_info->is_android_tablet() && false === $ua_info->is_kindle_touch() ) { - return false; - } - - if ( $ua_info->is_blackberry_tablet() ) { - return false; - } - - if ( $first_run ) { - $first_run = false; - // checks for iPhoneTier devices & RichCSS devices - if ( $ua_info->isTierIphone() || $ua_info->isTierRichCSS() ) { - $kinds['smart'] = true; - $matched_agent = $ua_info->matched_agent; - } - - if ( ! $kinds['smart'] ) { - // if smart, we are not dumb so no need to check - $dumb_agents = $ua_info->dumb_agents; - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - foreach ( $dumb_agents as $dumb_agent ) { - if ( false !== strpos( $agent, $dumb_agent ) ) { - $kinds['dumb'] = true; - $matched_agent = $dumb_agent; - - break; - } - } - - if ( ! $kinds['dumb'] ) { - if ( isset( $_SERVER['HTTP_X_WAP_PROFILE'] ) ) { - $kinds['dumb'] = true; - $matched_agent = 'http_x_wap_profile'; - } elseif ( isset( $_SERVER['HTTP_ACCEPT'] ) && ( preg_match( '/wap\.|\.wap/i', $_SERVER['HTTP_ACCEPT'] ) || false !== strpos( strtolower( $_SERVER['HTTP_ACCEPT'] ), 'application/vnd.wap.xhtml+xml' ) ) ) { - $kinds['dumb'] = true; - $matched_agent = 'vnd.wap.xhtml+xml'; - } - } - } - - if ( $kinds['dumb'] || $kinds['smart'] ) { - $kinds['any'] = true; - } - } - - $value = $kinds[ $kind ]; - - if ( $return_matched_agent ) { - $value = $matched_agent; - } - - if ( function_exists( 'apply_filters' ) ) { - /** - * Filter the value of jetpack_is_mobile - * - * @since 4.2.0 - * - * @param bool|string $matches Boolean if current UA matches $kind or not. If - * $return_matched_agent is true, should return the UA string - * @param string $kind Category of mobile device being checked - * @param bool $return_matched_agent Boolean indicating if the UA should be returned - */ - $value = apply_filters( 'jetpack_is_mobile', $value, $kind, $return_matched_agent ); - } - - return $value; -} +use \Automattic\Jetpack\Device_Detection\User_Agent_Info; +/** + * A class providing device properties detection. + * + * Deprecated. Use Automattic\Jetpack\Device_Detection\User_Agent_Info instead. + */ class Jetpack_User_Agent_Info { - public $useragent; - public $matched_agent; - public $isTierIphone; // Stores whether is the iPhone tier of devices. - public $isTierRichCss; // Stores whether the device can probably support Rich CSS, but JavaScript (jQuery) support is not assumed. - public $isTierGenericMobile; // Stores whether it is another mobile device, which cannot be assumed to support CSS or JS (eg, older BlackBerry, RAZR) - - private $_platform = null; // Stores the device platform name - 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'; - - 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', - ); + /** + * User_Agent_Info instance from the `jetpack-device-detection` package. + * + * @var User_Agent_Info + */ + private $ua_info; - // The constructor. Initializes default variables. - function __construct() { - if ( ! empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - $this->useragent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - } + /** + * The constructor. + * + * @param string $ua (Optional) User agent. + */ + public function __construct( $ua = '' ) { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info from the `automattic/jetpack-device-detection` package' ); + $this->ua_info = new User_Agent_Info( $ua ); } /** @@ -209,76 +42,9 @@ function __construct() { * * @return string The matched User Agent name, false otherwise. */ - function get_mobile_user_agent_name() { - if ( $this->is_chrome_for_iOS() ) { // keep this check before the safari rule - return 'chrome-for-ios'; - } elseif ( $this->is_iphone_or_ipod( 'iphone-safari' ) ) { - return 'iphone'; - } elseif ( $this->is_ipad( 'ipad-safari' ) ) { - return 'ipad'; - } elseif ( $this->is_android_tablet() ) { // keep this check before the android rule - return 'android_tablet'; - } elseif ( $this->is_android() ) { - return 'android'; - } elseif ( $this->is_blackberry_10() ) { - return 'blackberry_10'; - } elseif ( $this->is_blackbeberry() ) { - return 'blackberry'; - } elseif ( $this->is_WindowsPhone7() ) { - return 'win7'; - } elseif ( $this->is_windows_phone_8() ) { - return 'winphone8'; - } elseif ( $this->is_opera_mini() ) { - return 'opera-mini'; - } elseif ( $this->is_opera_mini_dumb() ) { - return 'opera-mini-dumb'; - } elseif ( $this->is_opera_mobile() ) { - return 'opera-mobi'; - } elseif ( $this->is_blackberry_tablet() ) { - return 'blackberry_tablet'; - } elseif ( $this->is_kindle_fire() ) { - return 'kindle-fire'; - } elseif ( $this->is_PalmWebOS() ) { - return 'webos'; - } elseif ( $this->is_S60_OSSBrowser() ) { - return 'series60'; - } elseif ( $this->is_firefox_os() ) { - return 'firefoxOS'; - } elseif ( $this->is_firefox_mobile() ) { - return 'firefox_mobile'; - } elseif ( $this->is_MaemoTablet() ) { - return 'maemo'; - } elseif ( $this->is_MeeGo() ) { - return 'meego'; - } elseif ( $this->is_TouchPad() ) { - return 'hp_tablet'; - } elseif ( $this->is_facebook_for_iphone() ) { - return 'facebook-for-iphone'; - } elseif ( $this->is_facebook_for_ipad() ) { - return 'facebook-for-ipad'; - } elseif ( $this->is_twitter_for_iphone() ) { - return 'twitter-for-iphone'; - } elseif ( $this->is_twitter_for_ipad() ) { - return 'twitter-for-ipad'; - } elseif ( $this->is_wordpress_for_ios() ) { - return 'ios-app'; - } elseif ( $this->is_iphone_or_ipod( 'iphone-not-safari' ) ) { - return 'iphone-unknown'; - } elseif ( $this->is_ipad( 'ipad-not-safari' ) ) { - return 'ipad-unknown'; - } elseif ( $this->is_Nintendo_3DS() ) { - return 'nintendo-3ds'; - } else { - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $dumb_agents = $this->dumb_agents; - foreach ( $dumb_agents as $dumb_agent ) { - if ( false !== strpos( $agent, $dumb_agent ) ) { - return $dumb_agent; - } - } - } - - return false; + public function get_mobile_user_agent_name() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->get_mobile_user_agent_name from the `automattic/jetpack-device-detection` package' ); + return $this->ua_info->get_mobile_user_agent_name(); } /** @@ -289,223 +55,52 @@ function get_mobile_user_agent_name() { * @return string Name of the platform, false otherwise. */ public function get_platform() { - if ( isset( $this->_platform ) ) { - return $this->_platform; - } - - 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 ( $this->is_android_tablet() ) { - $this->_platform = self::PLATFORM_ANDROID_TABLET; - } else { - $this->_platform = self::PLATFORM_ANDROID; - } - } elseif ( $this->is_kindle_fire() ) { - $this->_platform = self::PLATFORM_ANDROID_TABLET; - } elseif ( $this->is_blackberry_10() ) { - $this->_platform = self::PLATFORM_BLACKBERRY_10; - } elseif ( strpos( $this->useragent, 'blackberry' ) !== false ) { - $this->_platform = self::PLATFORM_BLACKBERRY; - } elseif ( $this->is_blackberry_tablet() ) { - $this->_platform = self::PLATFORM_BLACKBERRY; - } elseif ( $this->is_symbian_platform() ) { - $this->_platform = self::PLATFORM_SYMBIAN; - } elseif ( $this->is_symbian_s40_platform() ) { - $this->_platform = self::PLATFORM_SYMBIAN_S40; - } elseif ( $this->is_J2ME_platform() ) { - $this->_platform = self::PLATFORM_J2ME_MIDP; - } elseif ( $this->is_firefox_os() ) { - $this->_platform = self::PLATFORM_FIREFOX_OS; - } else { - $this->_platform = false; - } - - return $this->_platform; + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->get_platform from the `automattic/jetpack-device-detection` package' ); + return $this->ua_info->get_platform(); } - /* + /** * This method detects for UA which can display iPhone-optimized web content. * Includes iPhone, iPod Touch, Android, WebOS, Fennec (Firefox mobile), etc. - * */ - 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 ( $this->is_android() ) { - $this->matched_agent = 'android'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_windows_phone_8() ) { - $this->matched_agent = 'winphone8'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_WindowsPhone7() ) { - $this->matched_agent = 'win7'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_blackberry_10() ) { - $this->matched_agent = 'blackberry-10'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_blackbeberry() && $this->detect_blackberry_browser_version() == 'blackberry-webkit' ) { - $this->matched_agent = 'blackberry-webkit'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_blackberry_tablet() ) { - $this->matched_agent = 'blackberry_tablet'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_PalmWebOS() ) { - $this->matched_agent = 'webos'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_TouchPad() ) { - $this->matched_agent = 'hp_tablet'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_firefox_os() ) { - $this->matched_agent = 'firefoxOS'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_firefox_mobile() ) { - $this->matched_agent = 'fennec'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_opera_mobile() ) { - $this->matched_agent = 'opera-mobi'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_MaemoTablet() ) { - $this->matched_agent = 'maemo'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_MeeGo() ) { - $this->matched_agent = 'meego'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_kindle_touch() ) { - $this->matched_agent = 'kindle-touch'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } elseif ( $this->is_Nintendo_3DS() ) { - $this->matched_agent = 'nintendo-3ds'; - $this->isTierIphone = true; - $this->isTierRichCss = false; - $this->isTierGenericMobile = false; - } else { - $this->isTierIphone = false; - } - return $this->isTierIphone; + public function isTierIphone() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->isTierIphone from the `automattic/jetpack-device-detection` package' ); + return $this->ua_info->isTierIphone(); } - /* + /** * This method detects for UA which are likely to be capable * but may not necessarily support JavaScript. * Excludes all iPhone Tier UA. - * */ - function isTierRichCss() { - if ( isset( $this->isTierRichCss ) ) { - return $this->isTierRichCss; - } - if ( $this->isTierIphone() ) { - return false; - } - - // The following devices are explicitly ok. - if ( $this->is_S60_OSSBrowser() ) { - $this->matched_agent = 'series60'; - $this->isTierIphone = false; - $this->isTierRichCss = true; - $this->isTierGenericMobile = false; - } elseif ( $this->is_opera_mini() ) { - $this->matched_agent = 'opera-mini'; - $this->isTierIphone = false; - $this->isTierRichCss = true; - $this->isTierGenericMobile = false; - } elseif ( $this->is_blackbeberry() ) { - $detectedDevice = $this->detect_blackberry_browser_version(); - if ( $detectedDevice === 'blackberry-5' || $detectedDevice == 'blackberry-4.7' || $detectedDevice === 'blackberry-4.6' ) { - $this->matched_agent = $detectedDevice; - $this->isTierIphone = false; - $this->isTierRichCss = true; - $this->isTierGenericMobile = false; - } - } else { - $this->isTierRichCss = false; - } - - return $this->isTierRichCss; + public function isTierRichCss() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->isTierRichCss from the `automattic/jetpack-device-detection` package' ); + return $this->ua_info->isTierRichCss(); } - // Detects if the user is using a tablet. - // props Corey Gilmore, BGR.com - static 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 user is using a tablet. + * props Corey Gilmore, BGR.com + * + * @return bool + */ + public function is_tablet() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->is_tablet from the `automattic/jetpack-device-detection` package' ); + return $this->ua_info->is_tablet(); } - /* + /** * Detects if the current UA is the default iPhone or iPod Touch Browser. * * DEPRECATED: use is_iphone_or_ipod - * */ - static function is_iphoneOrIpod() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - 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; - } + public function is_iphoneOrIpod() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->is_iphone_or_ipod from the `automattic/jetpack-device-detection` package' ); + return $this->ua_info->is_iphoneOrIpod(); } - /* + /** * 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. @@ -514,170 +109,77 @@ static function is_iphoneOrIpod() { * 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. */ - static function is_iphone_or_ipod( $type = 'iphone-any' ) { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $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; - } + public static function is_iphone_or_ipod( $type = 'iphone-any' ) { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_iphone_or_ipod from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_iphone_or_ipod( $type ); } - - /* - * 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/ instead of Version/. - * - 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 - */ - 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( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $ua, 'crios/' ) !== false ) { - return true; - } else { - return false; - } + /** + * 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/ instead of Version/. + * - 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() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_chrome_for_iOS from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_chrome_for_iOS(); } - - /* + /** * 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 - * */ - static function is_twitter_for_iphone() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $ua, 'ipad' ) !== false ) { - return false; - } - - if ( strpos( $ua, 'twitter for iphone' ) !== false ) { - return true; - } else { - return false; - } + public static function is_twitter_for_iphone() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_twitter_for_iphone from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_twitter_for_iphone(); } - /* + /** * 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 - * */ - static function is_twitter_for_ipad() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - 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; - } + public static function is_twitter_for_ipad() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_twitter_for_ipad from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_twitter_for_ipad(); } - - /* + /** * 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] */ - static function is_facebook_for_iphone() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - 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; - } + public static function is_facebook_for_iphone() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_facebook_for_iphone from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_facebook_for_iphone(); } - /* + /** * 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] */ - static function is_facebook_for_ipad() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - 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; - } + public static function is_facebook_for_ipad() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_facebook_for_ipad from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_facebook_for_ipad(); } - /* + /** * Detects if the current UA is WordPress for iOS */ - static function is_wordpress_for_ios() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - if ( false !== strpos( $ua, 'wp-iphone' ) ) { - return true; - } else { - return false; - } + public static function is_wordpress_for_ios() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_wordpress_for_ios from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_wordpress_for_ios(); } - /* + /** * 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. * @@ -685,95 +187,48 @@ static function is_wordpress_for_ios() { * 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. * - */ - static function is_ipad( $type = 'ipad-any' ) { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - $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; - } + * @param string $type iPad type. + */ + public static function is_ipad( $type = 'ipad-any' ) { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_ipad from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_ipad( $type ); } - /* + /** * Detects if the current browser is Firefox Mobile (Fennec) * - * http://www.useragentstring.com/pages/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 */ - static function is_firefox_mobile() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $ua, 'fennec' ) !== false ) { - return true; - } else { - return false; - } + public static function is_firefox_mobile() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_firefox_mobile from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_firefox_mobile(); } - /* + /** * Detects if the current browser is Firefox for desktop * - * https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent/Firefox + * 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. - * */ - static function is_firefox_desktop() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( false !== strpos( $ua, 'firefox' ) && false === strpos( $ua, 'mobile' ) && false === strpos( $ua, 'tablet' ) ) { - return true; - } else { - return false; - } + public static function is_firefox_desktop() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_firefox_desktop from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_firefox_desktop(); } - /* + /** * Detects if the current browser is FirefoxOS Native browser - * - * Mozilla/5.0 (Mobile; rv:14.0) Gecko/14.0 Firefox/14.0 - * - */ - static function is_firefox_os() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $ua, 'mozilla' ) !== false && strpos( $ua, 'mobile' ) !== false && strpos( $ua, 'gecko' ) !== false && strpos( $ua, 'firefox' ) !== false ) { - return true; - } else { - return false; - } + * + * Mozilla/5.0 (Mobile; rv:14.0) Gecko/14.0 Firefox/14.0 + */ + public static function is_firefox_os() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_firefox_os from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_firefox_os(); } - - /* + /** * Detects if the current browser is Opera Mobile * * What is the difference between Opera Mobile and Opera Mini? @@ -785,25 +240,13 @@ static function is_firefox_os() { * 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) */ - static function is_opera_mobile() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - 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; - } + public static function is_opera_mobile() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_opera_mobile from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_opera_mobile(); } - /* + /** * Detects if the current browser is Opera Mini * * Opera/8.01 (J2ME/MIDP; Opera Mini/3.0.6306/1528; en; U; ssr) @@ -813,164 +256,76 @@ static function is_opera_mobile() { * 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 - * */ - static function is_opera_mini() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $ua, 'opera' ) !== false && strpos( $ua, 'mini' ) !== false ) { - return true; - } else { - return false; - } + public static function is_opera_mini() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_opera_mini from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_opera_mini(); } - /* + /** * 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 */ - static function is_opera_mini_dumb() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - 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; - } + public static function is_opera_mini_dumb() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_opera_mini_dumb from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_opera_mini_dumb(); } - /* + /** * Detects if the current browser is Opera Mobile or Mini. * DEPRECATED: use is_opera_mobile or is_opera_mini * * Opera Mini 5 Beta: Opera/9.80 (J2ME/MIDP; Opera Mini/5.0.15650/756; U; en) Presto/2.2.0 * Opera Mini 8: Opera/8.01 (J2ME/MIDP; Opera Mini/3.0.6306/1528; en; U; ssr) */ - static function is_OperaMobile() { - _deprecated_function( __FUNCTION__, 'always', 'is_opera_mini() or is_opera_mobile()' ); - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $ua, 'opera' ) !== false ) { - if ( ( strpos( $ua, 'mini' ) !== false ) || ( strpos( $ua, 'mobi' ) !== false ) ) { - return true; - } else { - return false; - } - } else { - return false; - } + public static function is_OperaMobile() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_opera_mini() or \Automattic\Jetpack\Device_Detection\User_Agent_Info::is_opera_mobile() from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_OperaMobile(); } - /* + /** * 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) */ - static function is_WindowsPhone7() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( false === strpos( $ua, 'windows phone os 7' ) ) { - return false; - } else { - if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { - return false; - } else { - return true; - } - } + public static function is_WindowsPhone7() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_WindowsPhone7 from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_WindowsPhone7(); } - /* + /** * 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; ; [;]) */ - static function is_windows_phone_8() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - if ( strpos( $ua, 'windows phone 8' ) === false ) { - return false; - } else { - return true; - } + public static function is_windows_phone_8() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_windows_phone_8 from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_windows_phone_8(); } - /* + /** * 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 - * + * 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 */ - static function is_PalmWebOS() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( false === strpos( $ua, 'webos' ) ) { - return false; - } else { - if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { - return false; - } else { - return true; - } - } + public static function is_PalmWebOS() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_PalmWebOS from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_PalmWebOS(); } - /* + /** * 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 - * */ - static function is_TouchPad() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $http_user_agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - 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; - } + public static function is_TouchPad() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_TouchPad from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_TouchPad(); } - /* + /** * 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 @@ -978,181 +333,64 @@ static function is_TouchPad() { * 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 - * */ - static function is_S60_OSSBrowser() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { - return false; - } - - $pos_webkit = strpos( $agent, 'webkit' ); - if ( $pos_webkit !== false ) { - // 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; + public static function is_S60_OSSBrowser() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_S60_OSSBrowser from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_S60_OSSBrowser(); } - /* - * + /** * Detects if the device platform is the Symbian Series 60. - * */ - static function is_symbian_platform() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - $pos_webkit = strpos( $agent, 'webkit' ); - if ( $pos_webkit !== false ) { - // 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; + public static function is_symbian_platform() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_symbian_platform from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_symbian_platform(); } - /* - * + /** * 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'. - * */ - static function is_symbian_s40_platform() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $agent, 'series40' ) !== false ) { - if ( strpos( $agent, 'nokia' ) !== false || strpos( $agent, 'ovibrowser' ) !== false || strpos( $agent, 'nokiabrowser' ) !== false ) { - return true; - } - } - - return false; + public static function is_symbian_s40_platform() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_symbian_s40_platform from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_symbian_s40_platform(); } - static function is_J2ME_platform() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( strpos( $agent, 'j2me/midp' ) !== false ) { - return true; - } elseif ( strpos( $agent, 'midp' ) !== false && strpos( $agent, 'cldc' ) ) { - return true; - } - - return false; + /** + * Returns if the device belongs to J2ME capable family. + * + * @return bool + */ + public static function is_J2ME_platform() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_J2ME_platform from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_J2ME_platform(); } - /* + /** * Detects if the current UA is on one of the Maemo-based Nokia Internet Tablets. */ - static function is_MaemoTablet() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - $pos_maemo = strpos( $agent, 'maemo' ); - if ( $pos_maemo === false ) { - 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; - } + public static function is_MaemoTablet() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_MaemoTablet from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_MaemoTablet(); } - /* + /** * Detects if the current UA is a MeeGo device (Nokia Smartphone). */ - static function is_MeeGo() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( false === strpos( $ua, 'meego' ) ) { - return false; - } else { - if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { - return false; - } else { - return true; - } - } + public static function is_MeeGo() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_MeeGo from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_MeeGo(); } - /* - is_webkit() can be used to check the User Agent for an webkit generic browser + /** + * The is_webkit() method can be used to check the User Agent for an webkit generic browser. */ - static function is_webkit() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - $pos_webkit = strpos( $agent, 'webkit' ); - - if ( $pos_webkit !== false ) { - return true; - } else { - return false; - } + public static function is_webkit() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_webkit from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_webkit(); } /** @@ -1160,51 +398,21 @@ static function is_webkit() { * * @return boolean true if the browser is Android otherwise false */ - static function is_android() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $pos_android = strpos( $agent, 'android' ); - if ( $pos_android !== false ) { - if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { - return false; - } else { - return true; - } - } else { - return false; - } + public static function is_android() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_android from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_android(); } /** * Detects if the current browser is the Native Android Tablet browser. - * Assumes 'Android' should be in the user agent, but not 'mobile' + * Assumes 'Android' should be in the user agent, but not 'mobile' * * @return boolean true if the browser is Android and not 'mobile' otherwise false */ - static function is_android_tablet() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - $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; - } + public static function is_android_tablet() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_android_tablet from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_android_tablet(); } /** @@ -1215,22 +423,11 @@ static function is_android_tablet() { * * @return boolean true if the browser is Kindle Fire Native browser otherwise false */ - static function is_kindle_fire() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $pos_silk = strpos( $agent, 'silk/' ); - $pos_silk_acc = strpos( $agent, 'silk-accelerated=' ); - if ( $pos_silk !== false && $pos_silk_acc !== false ) { - return true; - } else { - return false; - } + public static function is_kindle_fire() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_kindle_fire from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_kindle_fire(); } - /** * Detects if the current browser is the Kindle Touch Native browser * @@ -1238,120 +435,61 @@ static function is_kindle_fire() { * * @return boolean true if the browser is Kindle monochrome Native browser otherwise false */ - static function is_kindle_touch() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $pos_kindle_touch = strpos( $agent, 'kindle/3.0+' ); - if ( false !== $pos_kindle_touch && false === self::is_kindle_fire() ) { - return true; - } else { - return false; - } + public static function is_kindle_touch() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_kindle_touch from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_kindle_touch(); } - // Detect if user agent is the WordPress.com Windows 8 app (used ONLY on the custom oauth stylesheet) - static function is_windows8_auth() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $pos = strpos( $agent, 'msauthhost' ); - if ( false !== $pos ) { - 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() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_windows8_auth from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_windows8_auth(); } - // Detect if user agent is the WordPress.com Windows 8 app. - static function is_wordpress_for_win8() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $pos = strpos( $agent, 'wp-windows8' ); - 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() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_wordpress_for_win8 from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_wordpress_for_win8(); } - - // Detect if user agent is the WordPress.com Desktop app. - static function is_wordpress_desktop_app() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $pos = strpos( $agent, 'WordPressDesktop' ); - 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() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_wordpress_desktop_app from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_wordpress_desktop_app(); } - - /* - * is_blackberry_tablet() can be used to check the User Agent for a RIM blackberry tablet + /** + * 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+ - * */ - static function is_blackberry_tablet() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - $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; - } + public static function is_blackberry_tablet() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_blackberry_tablet from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_blackberry_tablet(); } - /* - is_blackbeberry() can be used to check the User Agent for a blackberry device - Note that opera mini on BB matches this rule. + /** + * 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. */ - static function is_blackbeberry() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - $pos_blackberry = strpos( $agent, 'blackberry' ); - if ( $pos_blackberry !== false ) { - if ( self::is_opera_mini() || self::is_opera_mobile() || self::is_firefox_mobile() ) { - return false; - } else { - return true; - } - } else { - return false; - } + public static function is_blackbeberry() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_blackbeberry from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_blackbeberry(); } - /* - is_blackberry_10() can be used to check the User Agent for a BlackBerry 10 device. - */ - static function is_blackberry_10() { - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - return ( strpos( $agent, 'bb10' ) !== false ) && ( strpos( $agent, 'mobile' ) !== 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() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_blackberry_10 from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_blackberry_10(); } /** @@ -1370,76 +508,9 @@ static function is_blackberry_10() { * @return string Version of the BB OS. * If version is not found, get_blackbeberry_OS_version will return boolean false. */ - static function get_blackbeberry_OS_version() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - if ( self::is_blackberry_10() ) { - return 'blackberry-10'; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - $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 - } else { - // detecting the BB OS version for devices running OS 6.0 or higher - if ( preg_match( '#Version\/([\d\.]+)#i', $agent, $matches ) ) { - $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; - } - if ( $version_num[0] == 5 ) { - return 'blackberry-5'; - } elseif ( $version_num[0] == 4 && $version_num[1] == 7 ) { - return 'blackberry-4.7'; - } elseif ( $version_num[0] == 4 && $version_num[1] == 6 ) { - return 'blackberry-4.6'; - } elseif ( $version_num[0] == 4 && $version_num[1] == 5 ) { - return 'blackberry-4.5'; - } else { - return false; - } - + public static function get_blackbeberry_OS_version() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::get_blackbeberry_OS_version from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::get_blackbeberry_OS_version(); } /** @@ -1455,99 +526,30 @@ static function get_blackbeberry_OS_version() { * @return string Type of the BB browser. * If browser's version is not found, detect_blackbeberry_browser_version will return boolean false. */ - static function detect_blackberry_browser_version() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - 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 ) ) { - $version = $matches[1]; - } else { - return false; // not a BB device that match our rule. - } - - $version_num = explode( '.', $version ); - - if ( false === is_array( $version_num ) || count( $version_num ) <= 1 ) { - return false; - } - - if ( $version_num[0] == 5 ) { - return 'blackberry-5'; - } elseif ( $version_num[0] == 4 && $version_num[1] == 7 ) { - return 'blackberry-4.7'; - } elseif ( $version_num[0] == 4 && $version_num[1] == 6 ) { - 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; - } - } - + public static function detect_blackberry_browser_version() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::detect_blackberry_browser_version from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::detect_blackberry_browser_version(); } - // Checks if a visitor is coming from one of the WordPress mobile apps - static function is_mobile_app() { - - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - - if ( isset( $_SERVER['X_USER_AGENT'] ) && preg_match( '|wp-webos|', $_SERVER['X_USER_AGENT'] ) ) { - 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; + /** + * Checks if a visitor is coming from one of the WordPress mobile apps. + * + * @return bool + */ + public static function is_mobile_app() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_mobile_app from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_mobile_app(); } - /* + /** * Detects if the current browser is Nintendo 3DS handheld. * - * example: Mozilla/5.0 (Nintendo 3DS; U; ; en) Version/1.7498.US + * Example: Mozilla/5.0 (Nintendo 3DS; U; ; en) Version/1.7498.US * can differ in language, version and region */ - static function is_Nintendo_3DS() { - if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { - return false; - } - - $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); - if ( strpos( $ua, 'nintendo 3ds' ) !== false ) { - return true; - } - return false; + public static function is_Nintendo_3DS() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_Nintendo_3DS from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_Nintendo_3DS(); } /** @@ -1555,99 +557,21 @@ static function is_Nintendo_3DS() { * * @return boolean */ - static function is_bot() { - static $is_bot = null; - - if ( is_null( $is_bot ) ) { - $is_bot = self::is_bot_user_agent( $_SERVER['HTTP_USER_AGENT'] ); - } - - return $is_bot; + public static function is_bot() { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_bot from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::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 $ua (string) A user-agent string + * @param string $ua A user-agent string. + * * @return boolean */ - 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', - ); - - foreach ( $bot_agents as $bot_agent ) { - if ( false !== stripos( $ua, $bot_agent ) ) { - return true; - } - } - - return false; + public static function is_bot_user_agent( $ua = null ) { + _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_bot_user_agent from the `automattic/jetpack-device-detection` package' ); + return User_Agent_Info::is_bot_user_agent( $ua ); } - - - } diff --git a/class.jetpack.php b/class.jetpack.php index 1dbc058f6c728..4464f9cd528e6 100644 --- a/class.jetpack.php +++ b/class.jetpack.php @@ -18,6 +18,7 @@ use Automattic\Jetpack\Tracking; use Automattic\Jetpack\Plugin\Tracking as Plugin_Tracking; use Automattic\Jetpack\Redirect; +use Automattic\Jetpack\Device_Detection\User_Agent_Info; /* Options: @@ -709,10 +710,14 @@ private function __construct() { jetpack_require_lib( 'functions.wp-notify' ); } - // Hide edit post link if mobile app. - if ( Jetpack_User_Agent_Info::is_mobile_app() ) { - add_filter( 'get_edit_post_link', '__return_empty_string' ); - } + add_action( + 'plugins_loaded', + function() { + if ( User_Agent_Info::is_mobile_app() ) { + add_filter( 'get_edit_post_link', '__return_empty_string' ); + } + } + ); // Update the Jetpack plan from API on heartbeats. add_action( 'jetpack_heartbeat', array( 'Jetpack_Plan', 'refresh_from_wpcom' ) ); diff --git a/composer.json b/composer.json index 10cbfa418a590..ed3d98f4a4589 100644 --- a/composer.json +++ b/composer.json @@ -19,6 +19,7 @@ "automattic/jetpack-config": "@dev", "automattic/jetpack-connection": "@dev", "automattic/jetpack-constants": "@dev", + "automattic/jetpack-device-detection": "@dev", "automattic/jetpack-error": "@dev", "automattic/jetpack-jitm": "@dev", "automattic/jetpack-logo": "@dev", diff --git a/composer.lock b/composer.lock index 61bfe3c54b157..65e74040ea00f 100644 --- a/composer.lock +++ b/composer.lock @@ -4,15 +4,15 @@ "Read more about it at https://getcomposer.org/doc/01-basic-usage.md#installing-dependencies", "This file is @generated automatically" ], - "content-hash": "58f387a3c22ca2f1f72bbe45c61535e3", + "content-hash": "b7a561c610eae014a3cd8709e7decc72", "packages": [ { "name": "automattic/jetpack-abtest", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/abtest", - "reference": "b873be98786907a49ac5cd21836167f662212aa0" + "reference": "c3681b3eac3d0e5625de758218fd1e8994e06302" }, "require": { "automattic/jetpack-connection": "@dev", @@ -24,9 +24,9 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -41,24 +41,25 @@ }, { "name": "automattic/jetpack-assets", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/assets", - "reference": "e93b5911e77ff0abfad498e99edbb5f6a8a124a9" + "reference": "b97ce83f38d0ccf58be9eefd2d676973279ad066" }, "require": { "automattic/jetpack-constants": "@dev" }, "require-dev": { + "brain/monkey": "2.4.0", "php-mock/php-mock": "^2.1", "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5" }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -73,7 +74,7 @@ }, { "name": "automattic/jetpack-autoloader", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/autoloader", @@ -107,20 +108,20 @@ }, { "name": "automattic/jetpack-backup", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/backup", - "reference": "3dd44f29c9c6ab41cc2492675078ba8b808caea7" + "reference": "0ae8bfd8b87d9140066915c643fc6a00783d0032" }, "type": "library", "autoload": { "files": [ "actions.php" ], - "psr-4": { - "Automattic\\Jetpack\\Backup\\": "src/" - } + "classmap": [ + "src/" + ] }, "license": [ "GPL-2.0-or-later" @@ -129,7 +130,7 @@ }, { "name": "automattic/jetpack-compat", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/compat", @@ -161,7 +162,7 @@ }, { "name": "automattic/jetpack-config", - "version": "dev-add/deterministic-init", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/config", @@ -180,15 +181,16 @@ }, { "name": "automattic/jetpack-connection", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/connection", - "reference": "59fa2bc973303b013ce63978ff8d875d1223f510" + "reference": "ac53d3e65b1be0a24206dc32ef2d17a17e387fcd" }, "require": { "automattic/jetpack-constants": "@dev", - "automattic/jetpack-options": "@dev" + "automattic/jetpack-options": "@dev", + "automattic/jetpack-roles": "@dev" }, "require-dev": { "php-mock/php-mock": "^2.1", @@ -196,14 +198,12 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\Connection\\": "src" - }, "files": [ "legacy/load-ixr.php" ], "classmap": [ - "legacy" + "legacy", + "src/" ] }, "scripts": { @@ -219,20 +219,21 @@ }, { "name": "automattic/jetpack-constants", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/constants", - "reference": "a6ab6360f4b48962ec7d62b06b39d1470b1dbe95" + "reference": "9401a1595eba4aaa79711851ca810d497575317c" }, "require-dev": { + "php-mock/php-mock": "^2.1", "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5" }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -245,22 +246,51 @@ ], "description": "A wrapper for defining constants in a more testable way." }, + { + "name": "automattic/jetpack-device-detection", + "version": "dev-add/jetpack-mobile-package", + "dist": { + "type": "path", + "url": "./packages/device-detection", + "reference": "4d838c69f4869dbba9ee2752ff7c1f13b79a7d76" + }, + "require-dev": { + "php-mock/php-mock": "^2.1", + "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5" + }, + "type": "library", + "autoload": { + "classmap": [ + "src/" + ] + }, + "scripts": { + "phpunit": [ + "@composer install", + "./vendor/phpunit/phpunit/phpunit --colors=always" + ] + }, + "license": [ + "GPL-2.0-or-later" + ], + "description": "A way to detect device types based on User-Agent header." + }, { "name": "automattic/jetpack-error", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/error", - "reference": "1707cf33a92fc66f1635dfe1e4215819101e9bb4" + "reference": "2f35acfb871c772dd3a81755d093b1cb295b8830" }, "require-dev": { "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5" }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -275,11 +305,11 @@ }, { "name": "automattic/jetpack-jitm", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/jitm", - "reference": "b0c2da6ce6a0137f3a1895ab82a93ad7769fddca" + "reference": "0b6037dafd9d0c92b6f1106e5a468065c6d2c7c5" }, "require": { "automattic/jetpack-assets": "@dev", @@ -287,6 +317,9 @@ "automattic/jetpack-constants": "@dev", "automattic/jetpack-logo": "@dev", "automattic/jetpack-options": "@dev", + "automattic/jetpack-partner": "@dev", + "automattic/jetpack-redirect": "@dev", + "automattic/jetpack-status": "@dev", "automattic/jetpack-tracking": "@dev" }, "require-dev": { @@ -296,9 +329,9 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\JITMS\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -313,11 +346,11 @@ }, { "name": "automattic/jetpack-logo", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/logo", - "reference": "d8a31dfd40166c4867fa2c526a03d9df481d5610" + "reference": "f2b7828deb34f7bb6da24380f2a88ab98d3733df" }, "require-dev": { "php-mock/php-mock": "^2.1", @@ -325,9 +358,9 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\Assets\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -342,7 +375,7 @@ }, { "name": "automattic/jetpack-options", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/options", @@ -368,14 +401,14 @@ }, { "name": "automattic/jetpack-partner", - "version": "dev-add/upgrade-url-subsidiary-id", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/partner", - "reference": "d0174e06e76927cefcedcded30c38405357ddea6" + "reference": "b2726c079aec6821a02cb44829841ee01ee17c91" }, "require-dev": { - "brain/monkey": "^2.4", + "brain/monkey": "2.4.0", "mockery/mockery": "^1.2", "php-mock/php-mock": "^2.1", "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5" @@ -399,11 +432,11 @@ }, { "name": "automattic/jetpack-redirect", - "version": "dev-add/redirect-everything-dependency", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/redirect", - "reference": "3f0328ec369ca80af8eba39d9bc452e1bf9f222c" + "reference": "1ca7f6fe907efa8c7cc4a9e961d4a7d2e08fa5ce" }, "require-dev": { "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5" @@ -427,11 +460,11 @@ }, { "name": "automattic/jetpack-roles", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/roles", - "reference": "f38b3379c11a05e4711b4fb29b390c8107daccd7" + "reference": "22dd28b575dc20f2a8e7d44f024223033c66517a" }, "require-dev": { "php-mock/php-mock": "^2.1", @@ -439,9 +472,9 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -456,21 +489,22 @@ }, { "name": "automattic/jetpack-status", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/status", - "reference": "99ecd79ed31dc3432892df709ba745ebc6f747e9" + "reference": "3844d803985e418e51e32bf7cc9c0a00b038a9f4" }, "require-dev": { + "brain/monkey": "2.4.0", "php-mock/php-mock": "^2.1", "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5" }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -485,11 +519,11 @@ }, { "name": "automattic/jetpack-sync", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/sync", - "reference": "1cad05fcfd38ad123af0bbf08b5a1224bd95312a" + "reference": "f163052f84a9656349985737f75c0e20c9a3c8e0" }, "require": { "automattic/jetpack-connection": "@dev", @@ -500,10 +534,9 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\Sync\\": "src/", - "Automattic\\Jetpack\\Sync\\Modules\\": "src/modules/" - } + "classmap": [ + "src/" + ] }, "license": [ "GPL-2.0-or-later" @@ -512,11 +545,11 @@ }, { "name": "automattic/jetpack-terms-of-service", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/terms-of-service", - "reference": "6f53f2987be1c025edcd7820759df50c134065e6" + "reference": "f97742a361eb772f8bc6f13ae9437b3e8233cb0e" }, "require": { "automattic/jetpack-connection": "@dev", @@ -529,9 +562,9 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - } + "classmap": [ + "src/" + ] }, "scripts": { "phpunit": [ @@ -546,11 +579,11 @@ }, { "name": "automattic/jetpack-tracking", - "version": "dev-retry/phpcs-changed", + "version": "dev-add/jetpack-mobile-package", "dist": { "type": "path", "url": "./packages/tracking", - "reference": "fd194dfc4f01a66de9c5b9caf239cdd806a8d3eb" + "reference": "f4e52837194537e90f9fa10ac7b48f25519765bd" }, "require": { "automattic/jetpack-options": "@dev", @@ -562,11 +595,9 @@ }, "type": "library", "autoload": { - "psr-4": { - "Automattic\\Jetpack\\": "src/" - }, "classmap": [ - "legacy" + "legacy", + "src/" ] }, "scripts": { @@ -1019,6 +1050,7 @@ "automattic/jetpack-config": 20, "automattic/jetpack-connection": 20, "automattic/jetpack-constants": 20, + "automattic/jetpack-device-detection": 20, "automattic/jetpack-error": 20, "automattic/jetpack-jitm": 20, "automattic/jetpack-logo": 20, diff --git a/functions.global.php b/functions.global.php index 8c66e5bed8555..d1f4e1a88c3dc 100644 --- a/functions.global.php +++ b/functions.global.php @@ -12,6 +12,7 @@ use Automattic\Jetpack\Connection\Client; use Automattic\Jetpack\Redirect; +use Automattic\Jetpack\Device_Detection; /** * Disable direct access. @@ -305,3 +306,61 @@ function jetpack_is_file_supported_for_sideloading( $file ) { return in_array( $type, $supported_mime_types, true ); } + +/** + * Determine if the current User Agent matches the passed $kind + * + * @param string $kind Category of mobile device to check for. + * Either: any, dumb, smart. + * @param bool $return_matched_agent Boolean indicating if the UA should be returned. + * + * @return bool|string Boolean indicating if current UA matches $kind. If + * $return_matched_agent is true, returns the UA string + */ +function jetpack_is_mobile( $kind = 'any', $return_matched_agent = false ) { + + /** + * Filter the value of jetpack_is_mobile before it is calculated. + * + * Passing a truthy value to the filter will short-circuit determining the + * mobile type, returning the passed value instead. + * + * @since 4.2.0 + * + * @param bool|string $matches Boolean if current UA matches $kind or not. If + * $return_matched_agent is true, should return the UA string + * @param string $kind Category of mobile device being checked + * @param bool $return_matched_agent Boolean indicating if the UA should be returned + */ + $pre = apply_filters( 'pre_jetpack_is_mobile', null, $kind, $return_matched_agent ); + if ( $pre ) { + return $pre; + } + + $return = false; + $device_info = Device_Detection::get_info(); + + if ( 'any' === $kind ) { + $return = $device_info['is_phone']; + } elseif ( 'smart' === $kind ) { + $return = $device_info['is_smartphone']; + } elseif ( 'dumb' === $kind ) { + $return = $device_info['is_phone'] && ! $device_info['is_smartphone']; + } + + if ( $return_matched_agent && true === $return ) { + $return = $device_info['is_phone_matched_ua']; + } + + /** + * Filter the value of jetpack_is_mobile + * + * @since 4.2.0 + * + * @param bool|string $matches Boolean if current UA matches $kind or not. If + * $return_matched_agent is true, should return the UA string + * @param string $kind Category of mobile device being checked + * @param bool $return_matched_agent Boolean indicating if the UA should be returned + */ + return apply_filters( 'jetpack_is_mobile', $return, $kind, $return_matched_agent ); +} diff --git a/modules/custom-css/custom-css.php b/modules/custom-css/custom-css.php index 8c93dd9d07203..f91b1c5565e2c 100644 --- a/modules/custom-css/custom-css.php +++ b/modules/custom-css/custom-css.php @@ -2,6 +2,7 @@ use Automattic\Jetpack\Assets; use Automattic\Jetpack\Redirect; +use Automattic\Jetpack\Device_Detection\User_Agent_Info; class Jetpack_Custom_CSS { static function init() { @@ -24,7 +25,7 @@ static function init() { define( 'SAFECSS_USE_ACE', ! jetpack_is_mobile() && - ! Jetpack_User_Agent_Info::is_ipad() && + ! User_Agent_Info::is_ipad() && /** * Should the Custom CSS module use ACE to process CSS. * @see https://ace.c9.io/ diff --git a/modules/infinite-scroll/themes/twentyfourteen.php b/modules/infinite-scroll/themes/twentyfourteen.php index 54a1fbc8f0402..c9710abdbf5f5 100644 --- a/modules/infinite-scroll/themes/twentyfourteen.php +++ b/modules/infinite-scroll/themes/twentyfourteen.php @@ -5,6 +5,8 @@ * Register support for Twenty Fourteen. */ +use Automattic\Jetpack\Device_Detection\User_Agent_Info; + /** * Add theme support for infinite scroll */ @@ -27,7 +29,7 @@ function jetpack_twentyfourteen_infinite_scroll_init() { */ function jetpack_twentyfourteen_has_footer_widgets() { if ( function_exists( 'jetpack_is_mobile' ) ) { - if ( ( Jetpack_User_Agent_Info::is_ipad() && is_active_sidebar( 'sidebar-1' ) ) + if ( ( User_Agent_Info::is_ipad() && is_active_sidebar( 'sidebar-1' ) ) || ( jetpack_is_mobile( '', true ) && ( is_active_sidebar( 'sidebar-1' ) || is_active_sidebar( 'sidebar-2' ) ) ) || is_active_sidebar( 'sidebar-3' ) ) diff --git a/modules/masterbar/masterbar.php b/modules/masterbar/masterbar.php index 6c46d5bbdacc4..2d63e9c1a60f7 100644 --- a/modules/masterbar/masterbar.php +++ b/modules/masterbar/masterbar.php @@ -5,6 +5,7 @@ use Automattic\Jetpack\Connection\Manager as Connection_Manager; use Automattic\Jetpack\Redirect; use Automattic\Jetpack\Scan\Admin_Bar_Notice; +use Automattic\Jetpack\Device_Detection\User_Agent_Info; require_once dirname( __FILE__ ) . '/rtl-admin-bar.php'; @@ -99,7 +100,7 @@ public function init() { } // Don't show the masterbar on WordPress mobile apps. - if ( Jetpack_User_Agent_Info::is_mobile_app() ) { + if ( User_Agent_Info::is_mobile_app() ) { add_filter( 'show_admin_bar', '__return_false' ); return; } diff --git a/modules/sharedaddy/sharing-sources.php b/modules/sharedaddy/sharing-sources.php index 2a681a9026b26..eaf7890238c4c 100644 --- a/modules/sharedaddy/sharing-sources.php +++ b/modules/sharedaddy/sharing-sources.php @@ -1,5 +1,7 @@ (bool) Whether the current device is a mobile phone. + * 'is_smartphone' => (bool) Whether the current device is a smartphone. + * 'is_tablet' => (bool) Whether the current device is a tablet device. + * 'is_handheld' => (bool) Whether the current device is a handheld device. + * 'is_desktop' => (bool) Whether the current device is a laptop / desktop device. + * 'platform' => (string) Detected platform. + * 'is_phone_matched_ua' => (string) Matched UA. + * ); + */ +``` + +Detect any mobile phone. + +```php +use Automattic\Jetpack\Device_Detection; + +$is_phone = Device_Detection::is_phone(); +``` + +Detect a smartphone. + +```php +use Automattic\Jetpack\Device_Detection; + +$is_smartphone = Device_Detection::is_smartphone(); +``` + +Detect a dumbphone. + +```php +use Automattic\Jetpack\Device_Detection; + +$is_dumbphone = Device_Detection::is_phone() && ! Device_Detection::is_smartphone(); +``` + +Detect a tablet. + +```php +use Automattic\Jetpack\Device_Detection; + +$is_tablet = Device_Detection::is_tablet(); +``` + +Detect a desktop device. + +```php +use Automattic\Jetpack\Device_Detection; + +$is_desktop = Device_Detection::is_desktop(); +``` + +Detect any handheld device. + +```php +use Automattic\Jetpack\Device_Detection; + +$is_handheld = Device_Detection::is_handheld(); +``` diff --git a/packages/device-detection/composer.json b/packages/device-detection/composer.json new file mode 100644 index 0000000000000..de73a86a60665 --- /dev/null +++ b/packages/device-detection/composer.json @@ -0,0 +1,24 @@ +{ + "name": "automattic/jetpack-device-detection", + "description": "A way to detect device types based on User-Agent header.", + "type": "library", + "license": "GPL-2.0-or-later", + "require": {}, + "require-dev": { + "phpunit/phpunit": "^5.7 || ^6.5 || ^7.5", + "php-mock/php-mock": "^2.1" + }, + "autoload": { + "classmap": [ + "src/" + ] + }, + "scripts": { + "phpunit": [ + "@composer install", + "./vendor/phpunit/phpunit/phpunit --colors=always" + ] + }, + "minimum-stability": "dev", + "prefer-stable": true +} diff --git a/packages/device-detection/phpunit.xml.dist b/packages/device-detection/phpunit.xml.dist new file mode 100644 index 0000000000000..443d8a0ace772 --- /dev/null +++ b/packages/device-detection/phpunit.xml.dist @@ -0,0 +1,7 @@ + + + + tests/php + + + diff --git a/packages/device-detection/src/class-device-detection.php b/packages/device-detection/src/class-device-detection.php new file mode 100644 index 0000000000000..e518d10470c04 --- /dev/null +++ b/packages/device-detection/src/class-device-detection.php @@ -0,0 +1,211 @@ + (bool) Whether the current device is a mobile phone. + * 'is_smartphone' => (bool) Whether the current device is a smartphone. + * 'is_tablet' => (bool) Whether the current device is a tablet device. + * 'is_handheld' => (bool) Whether the current device is a handheld device. + * 'is_desktop' => (bool) Whether the current device is a laptop / desktop device. + * 'platform' => (string) Detected platform. + * 'is_phone_matched_ua' => (string) Matched UA. + * ); + */ + public static function get_info( $ua = '' ) { + $ua_info = new User_Agent_Info( $ua ); + + $info = array( + 'is_phone' => self::is_mobile( 'any', false, $ua_info ), + 'is_phone_matched_ua' => self::is_mobile( 'any', true, $ua_info ), + 'is_smartphone' => self::is_mobile( 'smart', false, $ua_info ), + 'is_tablet' => $ua_info->is_tablet(), + 'platform' => $ua_info->get_platform(), + ); + + $info['is_handheld'] = $info['is_phone'] || $info['is_tablet']; + $info['is_desktop'] = ! $info['is_handheld']; + + if ( function_exists( 'apply_filters' ) ) { + /** + * Filter the value of Device_Detection::get_info. + * + * @since 8.7.0 + * + * @param array $info Array of device information. + * @param string $ua User agent string passed to Device_Detection::get_info. + * @param User_Agent_Info $ua_info Instance of Automattic\Jetpack\Device_Detection\User_Agent_Info. + */ + $info = apply_filters( 'jetpack_device_detection_get_info', $info, $ua, $ua_info ); + } + return $info; + } + + /** + * Detects phone devices. + * + * @param string $ua User-Agent string. + * + * @return bool + */ + public static function is_phone( $ua = '' ) { + $device_info = self::get_info( $ua ); + return true === $device_info['is_phone']; + } + + /** + * Detects smartphone devices. + * + * @param string $ua User-Agent string. + * + * @return bool + */ + public static function is_smartphone( $ua = '' ) { + $device_info = self::get_info( $ua ); + return true === $device_info['is_smartphone']; + } + + /** + * Detects tablet devices. + * + * @param string $ua User-Agent string. + * + * @return bool + */ + public static function is_tablet( $ua = '' ) { + $device_info = self::get_info( $ua ); + return true === $device_info['is_tablet']; + } + + /** + * Detects desktop devices. + * + * @param string $ua User-Agent string. + * + * @return bool + */ + public static function is_desktop( $ua = '' ) { + $device_info = self::get_info( $ua ); + return true === $device_info['is_desktop']; + } + + /** + * Detects handheld (i.e. phone + tablet) devices. + * + * @param string $ua User-Agent string. + * + * @return bool + */ + public static function is_handheld( $ua = '' ) { + $device_info = self::get_info( $ua ); + return true === $device_info['is_handheld']; + } + + /** + * Determine if the current User Agent matches the passed $kind. + * + * @param string $kind Category of mobile device to check for. Either: any, dumb, smart. + * @param bool $return_matched_agent Boolean indicating if the UA should be returned. + * @param User_Agent_Info $ua_info Boolean indicating if the UA should be returned. + * + * @return bool|string Boolean indicating if current UA matches $kind. If `$return_matched_agent` is true, returns the UA string. + */ + private static function is_mobile( $kind = 'any', $return_matched_agent = false, $ua_info ) { + $kinds = array( + 'smart' => false, + 'dumb' => false, + 'any' => false, + ); + $first_run = true; + $matched_agent = ''; + + // If an invalid kind is passed in, reset it to default. + if ( ! isset( $kinds[ $kind ] ) ) { + $kind = 'any'; + } + + if ( empty( $_SERVER['HTTP_USER_AGENT'] ) || strpos( strtolower( $_SERVER['HTTP_USER_AGENT'] ), 'ipad' ) ) { + return false; + } + + // Remove Samsung Galaxy tablets (SCH-I800) from being mobile devices. + if ( strpos( strtolower( $_SERVER['HTTP_USER_AGENT'] ), 'sch-i800' ) ) { + return false; + } + + if ( $ua_info->is_android_tablet() && false === $ua_info->is_kindle_touch() ) { + return false; + } + + if ( $ua_info->is_blackberry_tablet() ) { + return false; + } + + if ( $first_run ) { + $first_run = false; + + // checks for iPhoneTier devices & RichCSS devices. + if ( $ua_info->isTierIphone() || $ua_info->isTierRichCSS() ) { + $kinds['smart'] = true; + $matched_agent = $ua_info->matched_agent; + } + + if ( ! $kinds['smart'] ) { + // if smart, we are not dumb so no need to check. + $dumb_agents = $ua_info->dumb_agents; + $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); + + foreach ( $dumb_agents as $dumb_agent ) { + if ( false !== strpos( $agent, $dumb_agent ) ) { + $kinds['dumb'] = true; + $matched_agent = $dumb_agent; + + break; + } + } + + if ( ! $kinds['dumb'] ) { + if ( isset( $_SERVER['HTTP_X_WAP_PROFILE'] ) ) { + $kinds['dumb'] = true; + $matched_agent = 'http_x_wap_profile'; + } elseif ( isset( $_SERVER['HTTP_ACCEPT'] ) && ( preg_match( '/wap\.|\.wap/i', $_SERVER['HTTP_ACCEPT'] ) || false !== strpos( strtolower( $_SERVER['HTTP_ACCEPT'] ), 'application/vnd.wap.xhtml+xml' ) ) ) { + $kinds['dumb'] = true; + $matched_agent = 'vnd.wap.xhtml+xml'; + } + } + } + + if ( $kinds['dumb'] || $kinds['smart'] ) { + $kinds['any'] = true; + } + } + + $value = $kinds[ $kind ]; + + if ( $return_matched_agent ) { + $value = $matched_agent; + } + return $value; + } +} diff --git a/packages/device-detection/src/class-user-agent-info.php b/packages/device-detection/src/class-user-agent-info.php new file mode 100644 index 0000000000000..9b2ca7b1bac9f --- /dev/null +++ b/packages/device-detection/src/class-user-agent-info.php @@ -0,0 +1,1593 @@ +useragent = $ua; + } else { + if ( ! empty( $_SERVER['HTTP_USER_AGENT'] ) ) { + $this->useragent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); + } + } + } + + /** + * 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 ( $this->is_chrome_for_iOS() ) { // Keep this check before the safari rule. + return 'chrome-for-ios'; + } elseif ( $this->is_iphone_or_ipod( 'iphone-safari' ) ) { + return 'iphone'; + } elseif ( $this->is_ipad( 'ipad-safari' ) ) { + return 'ipad'; + } elseif ( $this->is_android_tablet() ) { // Keep this check before the android rule. + return 'android_tablet'; + } elseif ( $this->is_android() ) { + return 'android'; + } elseif ( $this->is_blackberry_10() ) { + return 'blackberry_10'; + } elseif ( $this->is_blackbeberry() ) { + return 'blackberry'; + } elseif ( $this->is_WindowsPhone7() ) { + return 'win7'; + } elseif ( $this->is_windows_phone_8() ) { + return 'winphone8'; + } elseif ( $this->is_opera_mini() ) { + return 'opera-mini'; + } elseif ( $this->is_opera_mini_dumb() ) { + return 'opera-mini-dumb'; + } elseif ( $this->is_opera_mobile() ) { + return 'opera-mobi'; + } elseif ( $this->is_blackberry_tablet() ) { + return 'blackberry_tablet'; + } elseif ( $this->is_kindle_fire() ) { + return 'kindle-fire'; + } elseif ( $this->is_PalmWebOS() ) { + return 'webos'; + } elseif ( $this->is_S60_OSSBrowser() ) { + return 'series60'; + } elseif ( $this->is_firefox_os() ) { + return 'firefoxOS'; + } elseif ( $this->is_firefox_mobile() ) { + return 'firefox_mobile'; + } elseif ( $this->is_MaemoTablet() ) { + return 'maemo'; + } elseif ( $this->is_MeeGo() ) { + return 'meego'; + } elseif ( $this->is_TouchPad() ) { + return 'hp_tablet'; + } elseif ( $this->is_facebook_for_iphone() ) { + return 'facebook-for-iphone'; + } elseif ( $this->is_facebook_for_ipad() ) { + return 'facebook-for-ipad'; + } elseif ( $this->is_twitter_for_iphone() ) { + return 'twitter-for-iphone'; + } elseif ( $this->is_twitter_for_ipad() ) { + return 'twitter-for-ipad'; + } elseif ( $this->is_wordpress_for_ios() ) { + return 'ios-app'; + } elseif ( $this->is_iphone_or_ipod( 'iphone-not-safari' ) ) { + return 'iphone-unknown'; + } elseif ( $this->is_ipad( 'ipad-not-safari' ) ) { + return 'ipad-unknown'; + } elseif ( $this->is_Nintendo_3DS() ) { + return 'nintendo-3ds'; + } else { + $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); + $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 Name of the platform, false otherwise. + */ + public function get_platform() { + if ( isset( $this->platform ) ) { + return $this->platform; + } + + 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 ( $this->is_android_tablet() ) { + $this->platform = self::PLATFORM_ANDROID_TABLET; + } else { + $this->platform = self::PLATFORM_ANDROID; + } + } elseif ( $this->is_kindle_fire() ) { + $this->platform = self::PLATFORM_ANDROID_TABLET; + } elseif ( $this->is_blackberry_10() ) { + $this->platform = self::PLATFORM_BLACKBERRY_10; + } elseif ( strpos( $this->useragent, 'blackberry' ) !== false ) { + $this->platform = self::PLATFORM_BLACKBERRY; + } elseif ( $this->is_blackberry_tablet() ) { + $this->platform = self::PLATFORM_BLACKBERRY; + } elseif ( $this->is_symbian_platform() ) { + $this->platform = self::PLATFORM_SYMBIAN; + } elseif ( $this->is_symbian_s40_platform() ) { + $this->platform = self::PLATFORM_SYMBIAN_S40; + } elseif ( $this->is_J2ME_platform() ) { + $this->platform = self::PLATFORM_J2ME_MIDP; + } elseif ( $this->is_firefox_os() ) { + $this->platform = self::PLATFORM_FIREFOX_OS; + } else { + $this->platform = false; + } + + return $this->platform; + } + + /** + * 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 ( $this->is_android() ) { + $this->matched_agent = 'android'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_windows_phone_8() ) { + $this->matched_agent = 'winphone8'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_WindowsPhone7() ) { + $this->matched_agent = 'win7'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_blackberry_10() ) { + $this->matched_agent = 'blackberry-10'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_blackbeberry() && 'blackberry-webkit' === $this->detect_blackberry_browser_version() ) { + $this->matched_agent = 'blackberry-webkit'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_blackberry_tablet() ) { + $this->matched_agent = 'blackberry_tablet'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_PalmWebOS() ) { + $this->matched_agent = 'webos'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_TouchPad() ) { + $this->matched_agent = 'hp_tablet'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_firefox_os() ) { + $this->matched_agent = 'firefoxOS'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_firefox_mobile() ) { + $this->matched_agent = 'fennec'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_opera_mobile() ) { + $this->matched_agent = 'opera-mobi'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_MaemoTablet() ) { + $this->matched_agent = 'maemo'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_MeeGo() ) { + $this->matched_agent = 'meego'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->is_kindle_touch() ) { + $this->matched_agent = 'kindle-touch'; + $this->isTierIphone = true; + $this->isTierRichCss = false; + $this->isTierGenericMobile = false; + } elseif ( $this->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 ( $this->is_S60_OSSBrowser() ) { + $this->matched_agent = 'series60'; + $this->isTierIphone = false; + $this->isTierRichCss = true; + $this->isTierGenericMobile = false; + } elseif ( $this->is_opera_mini() ) { + $this->matched_agent = 'opera-mini'; + $this->isTierIphone = false; + $this->isTierRichCss = true; + $this->isTierGenericMobile = false; + } elseif ( $this->is_blackbeberry() ) { + $detectedDevice = $this->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( $_SERVER['HTTP_USER_AGENT'] ); + 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( $_SERVER['HTTP_USER_AGENT'] ); + $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/ instead of Version/. + * - 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + 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( $_SERVER['HTTP_USER_AGENT'] ); + + $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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + if ( strpos( $ua, 'mozilla' ) !== false && strpos( $ua, 'mobile' ) !== false && strpos( $ua, 'gecko' ) !== false && strpos( $ua, 'firefox' ) !== false ) { + return true; + } else { + return false; + } + } + + /** + * 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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 Opera Mobile or Mini. + * DEPRECATED: use is_opera_mobile or is_opera_mini + * + * Opera Mini 5 Beta: Opera/9.80 (J2ME/MIDP; Opera Mini/5.0.15650/756; U; en) Presto/2.2.0 + * Opera Mini 8: Opera/8.01 (J2ME/MIDP; Opera Mini/3.0.6306/1528; en; U; ssr) + */ + public static function is_OperaMobile() { + _deprecated_function( __FUNCTION__, 'always', 'is_opera_mini() or is_opera_mobile()' ); + + if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { + return false; + } + + $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); + + if ( strpos( $ua, 'opera' ) !== false ) { + if ( ( strpos( $ua, 'mini' ) !== false ) || ( strpos( $ua, 'mobi' ) !== false ) ) { + return true; + } else { + return false; + } + } 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( $_SERVER['HTTP_USER_AGENT'] ); + + if ( false === strpos( $ua, 'windows phone os 7' ) ) { + return false; + } else { + if ( 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; ; [;]) + */ + public static function is_windows_phone_8() { + if ( empty( $_SERVER['HTTP_USER_AGENT'] ) ) { + return false; + } + + $ua = strtolower( $_SERVER['HTTP_USER_AGENT'] ); + 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( $_SERVER['HTTP_USER_AGENT'] ); + + if ( false === strpos( $ua, 'webos' ) ) { + return false; + } else { + if ( 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( $_SERVER['HTTP_USER_AGENT'] ); + 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( $_SERVER['HTTP_USER_AGENT'] ); + 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( $_SERVER['HTTP_USER_AGENT'] ); + + $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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + 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( $_SERVER['HTTP_USER_AGENT'] ); + + $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( $_SERVER['HTTP_USER_AGENT'] ); + + if ( false === strpos( $ua, 'meego' ) ) { + return false; + } else { + if ( 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( $_SERVER['HTTP_USER_AGENT'] ); + + $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( $_SERVER['HTTP_USER_AGENT'] ); + $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( $_SERVER['HTTP_USER_AGENT'] ); + + $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( $_SERVER['HTTP_USER_AGENT'] ); + $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( $_SERVER['HTTP_USER_AGENT'] ); + $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( $_SERVER['HTTP_USER_AGENT'] ); + $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( $_SERVER['HTTP_USER_AGENT'] ); + $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( $_SERVER['HTTP_USER_AGENT'] ); + $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( $_SERVER['HTTP_USER_AGENT'] ); + $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( $_SERVER['HTTP_USER_AGENT'] ); + + $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() { + $agent = strtolower( $_SERVER['HTTP_USER_AGENT'] ); + return ( strpos( $agent, 'bb10' ) !== false ) && ( strpos( $agent, 'mobile' ) !== false ); + } + + /** + * 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( $_SERVER['HTTP_USER_AGENT'] ); + + $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. + } else { + // Detecting the BB OS version for devices running OS 6.0 or higher. + if ( preg_match( '#Version\/([\d\.]+)#i', $agent, $matches ) ) { + $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 = intval( $version_num[0] ); + $version_num_minor = intval( $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( $_SERVER['HTTP_USER_AGENT'] ); + + 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 ) ) { + $version = $matches[1]; + } else { + return false; // not a BB device that match our rule. + } + + $version_num = explode( '.', $version ); + + if ( false === is_array( $version_num ) || count( $version_num ) <= 1 ) { + return false; + } + + $version_num_major = intval( $version_num[0] ); + $version_num_minor = intval( $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( $_SERVER['HTTP_USER_AGENT'] ); + + if ( isset( $_SERVER['X_USER_AGENT'] ) && preg_match( '|wp-webos|', $_SERVER['X_USER_AGENT'] ) ) { + 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( $_SERVER['HTTP_USER_AGENT'] ); + 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 ( is_null( $is_bot ) ) { + $is_bot = self::is_bot_user_agent( $_SERVER['HTTP_USER_AGENT'] ); + } + + 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', + ); + + foreach ( $bot_agents as $bot_agent ) { + if ( false !== stripos( $ua, $bot_agent ) ) { + return true; + } + } + + return false; + } +} diff --git a/packages/device-detection/tests/php/bootstrap.php b/packages/device-detection/tests/php/bootstrap.php new file mode 100644 index 0000000000000..f5496b950acfd --- /dev/null +++ b/packages/device-detection/tests/php/bootstrap.php @@ -0,0 +1,9 @@ +assertEquals( $is_type_match_expected, $device_info[ $type ] ); + + // Make sure the appropriate type method exists on Device_Detection. + $this->assertTrue( method_exists( 'Automattic\Jetpack\Device_Detection', $type ) ); + + // Make sure the direct method (e.g. Device_Detection::is_desktop) returns the correct value. + $this->assertEquals( $is_type_match_expected, call_user_func( array( 'Automattic\Jetpack\Device_Detection', $type ), $ua ) ); + } + $this->assertEquals( $device_info['is_phone'] ? $expected_ua_returned : false, $device_info['is_phone_matched_ua'] ); + } + + /** + * Data provider for test_is_mobile. + * + * @return array + */ + public function ua_provider() { + return array( + + // Nokia 6300, dumb phone. + array( + 'Nokia6300/2.0 (05.00) Profile/MIDP-2.0 Configuration/CLDC-1.1', + array( + 'is_phone', + 'is_handheld', + ), + 'nokia', + ), + + // Samsung Galaxy S8 smart phone. + array( + 'Mozilla/5.0 (Linux; Android 9; SM-G950F Build/PPR1.180610.011; wv) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/74.0.3729.157 Mobile Safari/537.36', + array( + 'is_phone', + 'is_smartphone', + 'is_handheld', + ), + 'android', + ), + + // iPhone X smart phone. + array( + 'Mozilla/5.0 (iPhone; CPU iPhone OS 11_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Version/11.0 Mobile/15E148 Safari/604.1', + array( + 'is_phone', + 'is_smartphone', + 'is_handheld', + ), + 'iphone', + ), + + // iPad 2 10.5 tablet. + array( + 'Mozilla/5.0 (iPad; CPU OS 11_4_1 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15G77 [FBAN/FBIOS;FBDV/iPad7,3;FBMD/iPad;FBSN/iOS;FBSV/11.4.1;FBSS/2;FBCR/;FBID/tablet;FBLC/en_US;FBOP/5;FBRV/0]', + array( + 'is_tablet', + 'is_handheld', + ), + false, + ), + + // Kindle 3. + array( + '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+', + array( + 'is_phone', + 'is_smartphone', + 'is_tablet', + 'is_handheld', + ), + 'android', + ), + + // Huawei p20 smartphone. + array( + 'Mozilla/5.0 (Linux; Android 8.1.0; CLT-L09 Build/HUAWEICLT-L09) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Mobile Safari/537.36', + array( + 'is_phone', + 'is_smartphone', + 'is_handheld', + ), + 'android', + ), + + // Googlebot smartphone. + array( + 'Mozilla/5.0 (Linux; Android 6.0.1; Nexus 5X Build/MMB29P) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/W.X.Y.Z‡ Mobile Safari/537.36 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)', + array( + 'is_phone', + 'is_smartphone', + 'is_handheld', + ), + 'android', + ), + + // Googlebot desktop. + array( + 'Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html)', + array( + 'is_desktop', + ), + false, + ), + ); + } +}