woocommerce/plugins/woocommerce-admin/client/lib/platform/index.js

19 lines
557 B
JavaScript
Raw Normal View History

Add WooCommerce Mobile App Banner Ad for Android and iOS (https://github.com/woocommerce/woocommerce-admin/pull/5037) Fixes woocommerce/woocommerce-admin#4654 The feature calls for a mobile app ad banner to be displayed to users on mobile devices. Based on the discussion in woocommerce/woocommerce-admin#4654 this implements the following: 1. [an iOS Smart App Banner](https://developer.apple.com/library/archive/documentation/AppleApplications/Reference/SafariWebContent/PromotingAppswithAppBanners/PromotingAppswithAppBanners.html). This banner is a meta tag that is generated in PHP. It will only display on iOS devices. One note about this: **This tag is not directly trackable like the implemented Android banner. If we would like to track its success then I believe [these instructions are relevant](https://stackoverflow.com/questions/12906502/is-it-possible-to-track-click-throughs-from-iphone-smart-banner/20422334woocommerce/woocommerce-admin#20422334)**. 2. A mobile app banner ad that **only displays on Android** and only displays at the `738px` breakpoint specified in the issue. To only display this banner ad on Android, we use basic checking of the user agent string. I weighed this up against other approaches and for this kind of niche use case a simple UA string check is (imho) still the best way to do this. 3. The banner ad makes use of user preferences to retain a per user setting that determines if that user has dismissed the Android banner. We don't/can't do anything like this for the iOS Smart App Banner (but in theory we shouldn't need to).
2020-08-27 01:46:53 +00:00
export const ANDROID_PLATFORM = 'android';
export const IOS_PLATFORM = 'ios';
export const UNKNOWN_PLATFORM = 'unknown';
/**
* Provide basic detection of platform based on user agent. This is not
* a robust check for browser features or the like. You should only use
* this for non-critical display logic.
*/
export const platform = () => {
if ( /iPhone|iPad|iPod/i.test( window.navigator.userAgent ) ) {
return IOS_PLATFORM;
} else if ( /Android/i.test( window.navigator.userAgent ) ) {
return ANDROID_PLATFORM;
}
return UNKNOWN_PLATFORM;
};