Automattic /
jetpack
Complex classes like Jetpack_User_Agent_Info often do a lot of different things. To break such a class down, we need to identify a cohesive component within that class. A common approach to find such a component is to look for fields/methods that share the same prefixes, or suffixes. You can also have a look at the cohesion graph to spot any un-connected, or weakly-connected components.
Once you have determined the fields that belong together, you can apply the Extract Class refactoring. If the component makes sense as a sub-class, Extract Subclass is also a candidate, and is often faster.
While breaking up the class, it is a good idea to analyze how other classes use Jetpack_User_Agent_Info, and based on these observations, apply Extract Interface, too.
| 1 | <?php |
||
| 23 | class Jetpack_User_Agent_Info { |
||
| 24 | |||
| 25 | /** |
||
| 26 | * User_Agent_Info instance from the `jetpack-device-detection` package. |
||
| 27 | * |
||
| 28 | * @var User_Agent_Info |
||
| 29 | */ |
||
| 30 | private $ua_info; |
||
| 31 | |||
| 32 | /** |
||
| 33 | * The constructor. |
||
| 34 | * |
||
| 35 | * @param string $ua (Optional) User agent. |
||
| 36 | * |
||
| 37 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 38 | */ |
||
| 39 | public function __construct( $ua = '' ) { |
||
| 40 | _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info from the `automattic/jetpack-device-detection` package' ); |
||
| 41 | $this->ua_info = new User_Agent_Info( $ua ); |
||
| 42 | } |
||
| 43 | |||
| 44 | /** |
||
| 45 | * This method detects the mobile User Agent name. |
||
| 46 | * |
||
| 47 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 48 | * |
||
| 49 | * @return string The matched User Agent name, false otherwise. |
||
| 50 | */ |
||
| 51 | public function get_mobile_user_agent_name() { |
||
| 52 | _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' ); |
||
| 53 | return $this->ua_info->get_mobile_user_agent_name(); |
||
| 54 | } |
||
| 55 | |||
| 56 | /** |
||
| 57 | * This method detects the mobile device's platform. All return strings are from the class constants. |
||
| 58 | * Note that this function returns the platform name, not the UA name/type. You should use a different function |
||
| 59 | * if you need to test the UA capabilites. |
||
| 60 | * |
||
| 61 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 62 | * |
||
| 63 | * @return string Name of the platform, false otherwise. |
||
| 64 | */ |
||
| 65 | public function get_platform() { |
||
| 66 | _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->get_platform from the `automattic/jetpack-device-detection` package' ); |
||
| 67 | return $this->ua_info->get_platform(); |
||
| 68 | } |
||
| 69 | |||
| 70 | /** |
||
| 71 | * This method detects for UA which can display iPhone-optimized web content. |
||
| 72 | * Includes iPhone, iPod Touch, Android, WebOS, Fennec (Firefox mobile), etc. |
||
| 73 | * |
||
| 74 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 75 | */ |
||
| 76 | public function isTierIphone() { |
||
| 77 | _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->isTierIphone from the `automattic/jetpack-device-detection` package' ); |
||
| 78 | return $this->ua_info->isTierIphone(); |
||
| 79 | } |
||
| 80 | |||
| 81 | /** |
||
| 82 | * This method detects for UA which are likely to be capable |
||
| 83 | * but may not necessarily support JavaScript. |
||
| 84 | * Excludes all iPhone Tier UA. |
||
| 85 | * |
||
| 86 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 87 | */ |
||
| 88 | public function isTierRichCss() { |
||
| 89 | _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->isTierRichCss from the `automattic/jetpack-device-detection` package' ); |
||
| 90 | return $this->ua_info->isTierRichCss(); |
||
| 91 | } |
||
| 92 | |||
| 93 | /** |
||
| 94 | * Detects if the user is using a tablet. |
||
| 95 | * props Corey Gilmore, BGR.com |
||
| 96 | * |
||
| 97 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 98 | * |
||
| 99 | * @return bool |
||
| 100 | */ |
||
| 101 | public static function is_tablet() { |
||
| 102 | _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->is_tablet from the `automattic/jetpack-device-detection` package' ); |
||
| 103 | return ( new User_Agent_Info() )->is_tablet(); |
||
| 104 | } |
||
| 105 | |||
| 106 | /** |
||
| 107 | * Detects if the current UA is the default iPhone or iPod Touch Browser. |
||
| 108 | * |
||
| 109 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 110 | */ |
||
| 111 | public static function is_iphoneOrIpod() { |
||
| 112 | _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info->is_iphone_or_ipod from the `automattic/jetpack-device-detection` package' ); |
||
| 113 | return ( new User_Agent_Info() )->is_iphoneOrIpod(); |
||
| 114 | } |
||
| 115 | |||
| 116 | |||
| 117 | /** |
||
| 118 | * Detects if the current UA is iPhone Mobile Safari or another iPhone or iPod Touch Browser. |
||
| 119 | * |
||
| 120 | * They type can check for any iPhone, an iPhone using Safari, or an iPhone using something other than Safari. |
||
| 121 | * |
||
| 122 | * Note: If you want to check for Opera mini, Opera mobile or Firefox mobile (or any 3rd party iPhone browser), |
||
| 123 | * you should put the check condition before the check for 'iphone-any' or 'iphone-not-safari'. |
||
| 124 | * Otherwise those browsers will be 'catched' by the iphone string. |
||
| 125 | * |
||
| 126 | * @param string $type Type of iPhone detection. |
||
| 127 | * |
||
| 128 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 129 | */ |
||
| 130 | public static function is_iphone_or_ipod( $type = 'iphone-any' ) { |
||
| 131 | _deprecated_function( __METHOD__, 'Jetpack 8.7', '\Automattic\Jetpack\Device_Detection\User_Agent_Info::is_iphone_or_ipod from the `automattic/jetpack-device-detection` package' ); |
||
| 132 | return User_Agent_Info::is_iphone_or_ipod( $type ); |
||
| 133 | } |
||
| 134 | |||
| 135 | /** |
||
| 136 | * Detects if the current UA is Chrome for iOS |
||
| 137 | * |
||
| 138 | * The User-Agent string in Chrome for iOS is the same as the Mobile Safari User-Agent, with CriOS/<ChromeRevision> instead of Version/<VersionNum>. |
||
| 139 | * - 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 |
||
| 140 | * |
||
| 141 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 142 | */ |
||
| 143 | public static function is_chrome_for_iOS() { |
||
| 147 | |||
| 148 | /** |
||
| 149 | * Detects if the current UA is Twitter for iPhone |
||
| 150 | * |
||
| 151 | * 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 |
||
| 152 | * 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 |
||
| 153 | * |
||
| 154 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 155 | */ |
||
| 156 | public static function is_twitter_for_iphone() { |
||
| 160 | |||
| 161 | /** |
||
| 162 | * Detects if the current UA is Twitter for iPad |
||
| 163 | * |
||
| 164 | * 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 |
||
| 165 | * 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 |
||
| 166 | * |
||
| 167 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 168 | */ |
||
| 169 | public static function is_twitter_for_ipad() { |
||
| 173 | |||
| 174 | /** |
||
| 175 | * Detects if the current UA is Facebook for iPhone |
||
| 176 | * - Facebook 4020.0 (iPhone; iPhone OS 5.0.1; fr_FR) |
||
| 177 | * - 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] |
||
| 178 | * - 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] |
||
| 179 | * |
||
| 180 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 181 | */ |
||
| 182 | public static function is_facebook_for_iphone() { |
||
| 186 | |||
| 187 | /** |
||
| 188 | * Detects if the current UA is Facebook for iPad |
||
| 189 | * - Facebook 4020.0 (iPad; iPhone OS 5.0.1; en_US) |
||
| 190 | * - 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] |
||
| 191 | * - 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] |
||
| 192 | * |
||
| 193 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 194 | */ |
||
| 195 | public static function is_facebook_for_ipad() { |
||
| 199 | |||
| 200 | /** |
||
| 201 | * Detects if the current UA is WordPress for iOS. |
||
| 202 | * |
||
| 203 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 204 | */ |
||
| 205 | public static function is_wordpress_for_ios() { |
||
| 209 | |||
| 210 | /** |
||
| 211 | * Detects if the current device is an iPad. |
||
| 212 | * They type can check for any iPad, an iPad using Safari, or an iPad using something other than Safari. |
||
| 213 | * |
||
| 214 | * Note: If you want to check for Opera mini, Opera mobile or Firefox mobile (or any 3rd party iPad browser), |
||
| 215 | * you should put the check condition before the check for 'iphone-any' or 'iphone-not-safari'. |
||
| 216 | * Otherwise those browsers will be 'catched' by the ipad string. |
||
| 217 | * |
||
| 218 | * @param string $type iPad type. |
||
| 219 | * |
||
| 220 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 221 | */ |
||
| 222 | public static function is_ipad( $type = 'ipad-any' ) { |
||
| 226 | |||
| 227 | /** |
||
| 228 | * Detects if the current browser is Firefox Mobile (Fennec) |
||
| 229 | * |
||
| 230 | * See http://www.useragentstring.com/pages/Fennec/ |
||
| 231 | * Mozilla/5.0 (Windows NT 6.1; WOW64; rv:2.1.1) Gecko/20110415 Firefox/4.0.2pre Fennec/4.0.1 |
||
| 232 | * Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.1b2pre) Gecko/20081015 Fennec/1.0a1 |
||
| 233 | * |
||
| 234 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 235 | */ |
||
| 236 | public static function is_firefox_mobile() { |
||
| 240 | |||
| 241 | /** |
||
| 242 | * Detects if the current browser is Firefox for desktop |
||
| 243 | * |
||
| 244 | * See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/User-Agent/Firefox |
||
| 245 | * Mozilla/5.0 (platform; rv:geckoversion) Gecko/geckotrail Firefox/firefoxversion |
||
| 246 | * The platform section will include 'Mobile' for phones and 'Tablet' for tablets. |
||
| 247 | * |
||
| 248 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 249 | */ |
||
| 250 | public static function is_firefox_desktop() { |
||
| 254 | |||
| 255 | /** |
||
| 256 | * Detects if the current browser is FirefoxOS Native browser |
||
| 257 | * |
||
| 258 | * Mozilla/5.0 (Mobile; rv:14.0) Gecko/14.0 Firefox/14.0 |
||
| 259 | * |
||
| 260 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 261 | */ |
||
| 262 | public static function is_firefox_os() { |
||
| 266 | |||
| 267 | /** |
||
| 268 | * Detects if the current browser is Opera Mobile |
||
| 269 | * |
||
| 270 | * What is the difference between Opera Mobile and Opera Mini? |
||
| 271 | * - Opera Mobile is a full Internet browser for mobile devices. |
||
| 272 | * - Opera Mini always uses a transcoder to convert the page for a small display. |
||
| 273 | * (it uses Opera advanced server compression technology to compress web content before it gets to a device. |
||
| 274 | * The rendering engine is on Opera's server.) |
||
| 275 | * |
||
| 276 | * Opera/9.80 (Windows NT 6.1; Opera Mobi/14316; U; en) Presto/2.7.81 Version/11.00" |
||
| 277 | * Opera/9.50 (Nintendo DSi; Opera/507; U; en-US) |
||
| 278 | * |
||
| 279 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 280 | */ |
||
| 281 | public static function is_opera_mobile() { |
||
| 285 | |||
| 286 | |||
| 287 | /** |
||
| 288 | * Detects if the current browser is Opera Mini |
||
| 289 | * |
||
| 290 | * Opera/8.01 (J2ME/MIDP; Opera Mini/3.0.6306/1528; en; U; ssr) |
||
| 291 | * Opera/9.80 (Android;Opera Mini/6.0.24212/24.746 U;en) Presto/2.5.25 Version/10.5454 |
||
| 292 | * Opera/9.80 (iPhone; Opera Mini/5.0.019802/18.738; U; en) Presto/2.4.15 |
||
| 293 | * Opera/9.80 (J2ME/iPhone;Opera Mini/5.0.019802/886; U; ja) Presto/2.4.15 |
||
| 294 | * Opera/9.80 (J2ME/iPhone;Opera Mini/5.0.019802/886; U; ja) Presto/2.4.15 |
||
| 295 | * Opera/9.80 (Series 60; Opera Mini/5.1.22783/23.334; U; en) Presto/2.5.25 Version/10.54 |
||
| 296 | * Opera/9.80 (BlackBerry; Opera Mini/5.1.22303/22.387; U; en) Presto/2.5.25 Version/10.54 |
||
| 297 | * |
||
| 298 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 299 | */ |
||
| 300 | public static function is_opera_mini() { |
||
| 304 | |||
| 305 | /** |
||
| 306 | * Detects if the current browser is Opera Mini, but not on a smart device OS(Android, iOS, etc) |
||
| 307 | * Used to send users on dumb devices to m.wor |
||
| 308 | * |
||
| 309 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 310 | */ |
||
| 311 | public static function is_opera_mini_dumb() { |
||
| 315 | |||
| 316 | /** |
||
| 317 | * Detects if the current browser is Opera Mobile or Mini. |
||
| 318 | * |
||
| 319 | * Opera Mini 5 Beta: Opera/9.80 (J2ME/MIDP; Opera Mini/5.0.15650/756; U; en) Presto/2.2.0 |
||
| 320 | * Opera Mini 8: Opera/8.01 (J2ME/MIDP; Opera Mini/3.0.6306/1528; en; U; ssr) |
||
| 321 | * |
||
| 322 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 323 | */ |
||
| 324 | public static function is_OperaMobile() { |
||
| 328 | |||
| 329 | /** |
||
| 330 | * Detects if the current browser is a Windows Phone 7 device. |
||
| 331 | * ex: Mozilla/4.0 (compatible; MSIE 7.0; Windows Phone OS 7.0; Trident/3.1; IEMobile/7.0; LG; GW910) |
||
| 332 | * |
||
| 333 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 334 | */ |
||
| 335 | public static function is_WindowsPhone7() { |
||
| 339 | |||
| 340 | /** |
||
| 341 | * Detects if the current browser is a Windows Phone 8 device. |
||
| 342 | * ex: Mozilla/5.0 (compatible; MSIE 10.0; Windows Phone 8.0; Trident/6.0; ARM; Touch; IEMobile/10.0; <Manufacturer>; <Device> [;<Operator>]) |
||
| 343 | * |
||
| 344 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 345 | */ |
||
| 346 | public static function is_windows_phone_8() { |
||
| 350 | |||
| 351 | |||
| 352 | /** |
||
| 353 | * Detects if the current browser is on a Palm device running the new WebOS. This EXCLUDES TouchPad. |
||
| 354 | * |
||
| 355 | * 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 |
||
| 356 | * 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 |
||
| 357 | * |
||
| 358 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 359 | */ |
||
| 360 | public static function is_PalmWebOS() { |
||
| 364 | |||
| 365 | /** |
||
| 366 | * Detects if the current browser is the HP TouchPad default browser. This excludes phones wt WebOS. |
||
| 367 | * |
||
| 368 | * 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 |
||
| 369 | * 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 |
||
| 370 | * |
||
| 371 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 372 | */ |
||
| 373 | public static function is_TouchPad() { |
||
| 377 | |||
| 378 | |||
| 379 | /** |
||
| 380 | * Detects if the current browser is the Series 60 Open Source Browser. |
||
| 381 | * |
||
| 382 | * 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 |
||
| 383 | * |
||
| 384 | * 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 |
||
| 385 | * |
||
| 386 | * 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 |
||
| 387 | * |
||
| 388 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 389 | */ |
||
| 390 | public static function is_S60_OSSBrowser() { |
||
| 394 | |||
| 395 | /** |
||
| 396 | * Detects if the device platform is the Symbian Series 60. |
||
| 397 | * |
||
| 398 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 399 | */ |
||
| 400 | public static function is_symbian_platform() { |
||
| 404 | |||
| 405 | /** |
||
| 406 | * Detects if the device platform is the Symbian Series 40. |
||
| 407 | * Nokia Browser for Series 40 is a proxy based browser, previously known as Ovi Browser. |
||
| 408 | * This browser will report 'NokiaBrowser' in the header, however some older version will also report 'OviBrowser'. |
||
| 409 | * |
||
| 410 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 411 | */ |
||
| 412 | public static function is_symbian_s40_platform() { |
||
| 416 | |||
| 417 | /** |
||
| 418 | * Returns if the device belongs to J2ME capable family. |
||
| 419 | * |
||
| 420 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 421 | * |
||
| 422 | * @return bool |
||
| 423 | */ |
||
| 424 | public static function is_J2ME_platform() { |
||
| 428 | |||
| 429 | |||
| 430 | /** |
||
| 431 | * Detects if the current UA is on one of the Maemo-based Nokia Internet Tablets. |
||
| 432 | * |
||
| 433 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 434 | */ |
||
| 435 | public static function is_MaemoTablet() { |
||
| 439 | |||
| 440 | /** |
||
| 441 | * Detects if the current UA is a MeeGo device (Nokia Smartphone). |
||
| 442 | * |
||
| 443 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 444 | */ |
||
| 445 | public static function is_MeeGo() { |
||
| 449 | |||
| 450 | |||
| 451 | /** |
||
| 452 | * The is_webkit() method can be used to check the User Agent for an webkit generic browser. |
||
| 453 | * |
||
| 454 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 455 | */ |
||
| 456 | public static function is_webkit() { |
||
| 460 | |||
| 461 | /** |
||
| 462 | * Detects if the current browser is the Native Android browser. |
||
| 463 | * |
||
| 464 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 465 | * |
||
| 466 | * @return boolean true if the browser is Android otherwise false |
||
| 467 | */ |
||
| 468 | public static function is_android() { |
||
| 472 | |||
| 473 | |||
| 474 | /** |
||
| 475 | * Detects if the current browser is the Native Android Tablet browser. |
||
| 476 | * Assumes 'Android' should be in the user agent, but not 'mobile' |
||
| 477 | * |
||
| 478 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 479 | * |
||
| 480 | * @return boolean true if the browser is Android and not 'mobile' otherwise false |
||
| 481 | */ |
||
| 482 | public static function is_android_tablet() { |
||
| 486 | |||
| 487 | /** |
||
| 488 | * Detects if the current browser is the Kindle Fire Native browser. |
||
| 489 | * |
||
| 490 | * 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 |
||
| 491 | * 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 |
||
| 492 | * |
||
| 493 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 494 | * |
||
| 495 | * @return boolean true if the browser is Kindle Fire Native browser otherwise false |
||
| 496 | */ |
||
| 497 | public static function is_kindle_fire() { |
||
| 501 | |||
| 502 | /** |
||
| 503 | * Detects if the current browser is the Kindle Touch Native browser |
||
| 504 | * |
||
| 505 | * 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+ |
||
| 506 | * |
||
| 507 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 508 | * |
||
| 509 | * @return boolean true if the browser is Kindle monochrome Native browser otherwise false |
||
| 510 | */ |
||
| 511 | public static function is_kindle_touch() { |
||
| 515 | |||
| 516 | |||
| 517 | /** |
||
| 518 | * Detect if user agent is the WordPress.com Windows 8 app (used ONLY on the custom oauth stylesheet) |
||
| 519 | * |
||
| 520 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 521 | */ |
||
| 522 | public static function is_windows8_auth() { |
||
| 526 | |||
| 527 | /** |
||
| 528 | * Detect if user agent is the WordPress.com Windows 8 app. |
||
| 529 | * |
||
| 530 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 531 | */ |
||
| 532 | public static function is_wordpress_for_win8() { |
||
| 536 | |||
| 537 | /** |
||
| 538 | * Detect if user agent is the WordPress.com Desktop app. |
||
| 539 | * |
||
| 540 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 541 | */ |
||
| 542 | public static function is_wordpress_desktop_app() { |
||
| 546 | |||
| 547 | /** |
||
| 548 | * The is_blackberry_tablet() method can be used to check the User Agent for a RIM blackberry tablet. |
||
| 549 | * The user agent of the BlackBerry® Tablet OS follows a format similar to the following: |
||
| 550 | * 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+ |
||
| 551 | * |
||
| 552 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 553 | */ |
||
| 554 | public static function is_blackberry_tablet() { |
||
| 558 | |||
| 559 | /** |
||
| 560 | * The is_blackbeberry() method can be used to check the User Agent for a blackberry device. |
||
| 561 | * Note that opera mini on BB matches this rule. |
||
| 562 | * |
||
| 563 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 564 | */ |
||
| 565 | public static function is_blackbeberry() { |
||
| 569 | |||
| 570 | /** |
||
| 571 | * The is_blackberry_10() method can be used to check the User Agent for a BlackBerry 10 device. |
||
| 572 | * |
||
| 573 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 574 | */ |
||
| 575 | public static function is_blackberry_10() { |
||
| 579 | |||
| 580 | /** |
||
| 581 | * Retrieve the blackberry OS version. |
||
| 582 | * |
||
| 583 | * Return strings are from the following list: |
||
| 584 | * - blackberry-10 |
||
| 585 | * - blackberry-7 |
||
| 586 | * - blackberry-6 |
||
| 587 | * - blackberry-torch //only the first edition. The 2nd edition has the OS7 onboard and doesn't need any special rule. |
||
| 588 | * - blackberry-5 |
||
| 589 | * - blackberry-4.7 |
||
| 590 | * - blackberry-4.6 |
||
| 591 | * - blackberry-4.5 |
||
| 592 | * |
||
| 593 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 594 | * |
||
| 595 | * @return string Version of the BB OS. If version is not found, get_blackbeberry_OS_version will return boolean false. |
||
| 596 | */ |
||
| 597 | public static function get_blackbeberry_OS_version() { |
||
| 601 | |||
| 602 | /** |
||
| 603 | * Retrieve the blackberry browser version. |
||
| 604 | * |
||
| 605 | * Return string are from the following list: |
||
| 606 | * - blackberry-10 |
||
| 607 | * - blackberry-webkit |
||
| 608 | * - blackberry-5 |
||
| 609 | * - blackberry-4.7 |
||
| 610 | * - blackberry-4.6 |
||
| 611 | * |
||
| 612 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 613 | * |
||
| 614 | * @return string Type of the BB browser. If browser's version is not found, detect_blackbeberry_browser_version will return boolean false. |
||
| 615 | */ |
||
| 616 | public static function detect_blackberry_browser_version() { |
||
| 620 | |||
| 621 | /** |
||
| 622 | * Checks if a visitor is coming from one of the WordPress mobile apps. |
||
| 623 | * |
||
| 624 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 625 | * |
||
| 626 | * @return bool |
||
| 627 | */ |
||
| 628 | public static function is_mobile_app() { |
||
| 632 | |||
| 633 | /** |
||
| 634 | * Detects if the current browser is Nintendo 3DS handheld. |
||
| 635 | * |
||
| 636 | * Example: Mozilla/5.0 (Nintendo 3DS; U; ; en) Version/1.7498.US |
||
| 637 | * can differ in language, version and region |
||
| 638 | * |
||
| 639 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 640 | */ |
||
| 641 | public static function is_Nintendo_3DS() { |
||
| 645 | |||
| 646 | /** |
||
| 647 | * Was the current request made by a known bot? |
||
| 648 | * |
||
| 649 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 650 | * |
||
| 651 | * @return boolean |
||
| 652 | */ |
||
| 653 | public static function is_bot() { |
||
| 657 | |||
| 658 | /** |
||
| 659 | * Is the given user-agent a known bot? |
||
| 660 | * 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. |
||
| 661 | * |
||
| 662 | * @param string $ua A user-agent string. |
||
|
|
|||
| 663 | * |
||
| 664 | * @deprecated 8.7.0 Use Automattic\Jetpack\Device_Detection\User_Agent_Info |
||
| 665 | * |
||
| 666 | * @return boolean |
||
| 667 | */ |
||
| 668 | public static function is_bot_user_agent( $ua = null ) { |
||
| 672 | } |
||
| 673 |
This check looks for
@paramannotations where the type inferred by our type inference engine differs from the declared type.It makes a suggestion as to what type it considers more descriptive.
Most often this is a case of a parameter that can be null in addition to its declared types.