Automattic\Jetpack\Device_Detection

User_Agent_Info::get_blackbeberry_OS_version │ public static │ WPSCache 1.0

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

Метод класса: User_Agent_Info{}

Хуков нет.

Возвращает

Строку. Version of the BB OS. If version is not found, get_blackbeberry_OS_version will return boolean false.

Использование

$result = User_Agent_Info::get_blackbeberry_OS_version( $user_agent );

$user_agent(строка|null)

User agent string to check. If not provided, uses $_SERVER['HTTP_USER_AGENT'].
По умолчанию: null

Код User_Agent_Info::get_blackbeberry_OS_version() User Agent Info::get blackbeberry OS version ^{WPSCache 3.0.3}

public static function get_blackbeberry_OS_version( $user_agent = null ) {
	$user_agent = self::maybe_get_user_agent_from_server( $user_agent );
	if ( empty( $user_agent ) ) {
		return false;
	}

	if ( self::is_blackberry_10( $user_agent ) ) {
		return 'blackberry-10';
	}

	$agent = strtolower( wp_unslash( $user_agent ) ); // phpcs:ignore WordPress.Security.ValidatedSanitizedInput.InputNotSanitized -- This is validating.

	$pos_blackberry = stripos( $agent, 'blackberry' );
	if ( false === $pos_blackberry ) {
		// Not a blackberry device.
		return false;
	}

	// Blackberry devices OS 6.0 or higher.
	// Mozilla/5.0 (BlackBerry; U; BlackBerry 9670; en) AppleWebKit/534.3+ (KHTML, like Gecko) Version/6.0.0.286 Mobile Safari/534.3+.
	// Mozilla/5.0 (BlackBerry; U; BlackBerry 9800; en) AppleWebKit/534.1+ (KHTML, Like Gecko) Version/6.0.0.141 Mobile Safari/534.1+.
	// Mozilla/5.0 (BlackBerry; U; BlackBerry 9900; en-US) AppleWebKit/534.11+ (KHTML, like Gecko) Version/7.0.0 Mobile Safari/534.11+.
	$pos_webkit = stripos( $agent, 'webkit' );
	if ( false !== $pos_webkit ) {
		// Detected blackberry webkit browser.
		$pos_torch = stripos( $agent, 'BlackBerry 9800' );
		if ( false !== $pos_torch ) {
			return 'blackberry-torch'; // Match the torch first edition. the 2nd edition should use the OS7 and doesn't need any special rule.
		} elseif ( preg_match( '#Version\/([\d\.]+)#i', $agent, $matches ) ) { // Detecting the BB OS version for devices running OS 6.0 or higher.
			$version     = $matches[1];
			$version_num = explode( '.', $version );
			if ( 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 ( count( $version_num ) <= 1 ) {
		return false;
	}

	$version_num_major = (int) $version_num[0];
	$version_num_minor = (int) $version_num[1];

	if ( 5 === $version_num_major ) {
		return 'blackberry-5';
	} elseif ( 4 === $version_num_major && 7 === $version_num_minor ) {
		return 'blackberry-4.7';
	} elseif ( 4 === $version_num_major && 6 === $version_num_minor ) {
		return 'blackberry-4.6';
	} elseif ( 4 === $version_num_major && 5 === $version_num_minor ) {
		return 'blackberry-4.5';
	} else {
		return false;
	}
}