Push Translation

added locale/language detection
localeIdentifier gets automatically populated whenever an installation is saved/updated

Author: Lukas Koebis

Parse/Internal/Installation/Constants/PFInstallationConstants.h

@@ -17,5 +17,6 @@ extern NSString *const PFInstallationKeyAppName;
 extern NSString *const PFInstallationKeyAppVersion;
 extern NSString *const PFInstallationKeyAppIdentifier;
 extern NSString *const PFInstallationKeyTimeZone;
+extern NSString *const PFInstallationKeyLocaleIdentifier;
 extern NSString *const PFInstallationKeyBadge;
 extern NSString *const PFInstallationKeyChannels;

Parse/Internal/Installation/Constants/PFInstallationConstants.m

@@ -17,5 +17,6 @@
 NSString *const PFInstallationKeyAppVersion = @"appVersion";
 NSString *const PFInstallationKeyAppIdentifier = @"appIdentifier";
 NSString *const PFInstallationKeyTimeZone = @"timeZone";
+NSString *const PFInstallationKeyLocaleIdentifier = @"localeIdentifier";
 NSString *const PFInstallationKeyBadge = @"badge";
 NSString *const PFInstallationKeyChannels = @"channels";

Parse/Internal/Installation/PFInstallationPrivate.h

@@ -28,5 +28,6 @@
 @property (nonatomic, copy, readwrite) NSString *deviceType;
 @property (nonatomic, copy, readwrite) NSString *installationId;
 @property (nonatomic, copy, readwrite) NSString *timeZone;
+@property (nonatomic, copy, readwrite) NSString *localeIdentifier;
 
 @end

Parse/PFInstallation.h

@@ -85,6 +85,11 @@ PF_ASSUME_NONNULL_BEGIN
  */
 @property (PF_NULLABLE_PROPERTY nonatomic, copy, readonly) NSString *timeZone;
 
+/*!
+ @abstract The localeIdentifier for the `PFInstallation` ([language code]-[COUNTRY CODE]).
+ */
+@property (PF_NULLABLE_PROPERTY nonatomic, copy, readonly) NSString *localeIdentifier;
+
 /*!
  @abstract The channels for the `PFInstallation`.
  */

Parse/PFInstallation.m

@@ -38,6 +38,7 @@ + (void)initialize {
         protectedKeys = PF_SET(PFInstallationKeyDeviceType,
                                PFInstallationKeyInstallationId,
                                PFInstallationKeyTimeZone,
+                               PFInstallationKeyLocaleIdentifier,
                                PFInstallationKeyParseVersion,
                                PFInstallationKeyAppVersion,
                                PFInstallationKeyAppName,
@@ -107,6 +108,7 @@ @implementation PFInstallation
 @dynamic installationId;
 @dynamic deviceToken;
 @dynamic timeZone;
+@dynamic localeIdentifier;
 @dynamic channels;
 @dynamic badge;
 
@@ -199,6 +201,12 @@ - (void)setTimeZone:(NSString *)timeZone {
     [self _setObject:timeZone forKey:PFInstallationKeyTimeZone onlyIfDifferent:YES];
 }
 
+- (void)setLocaleIdentifier:(NSString *)localeIdentifier {
+    [self _setObject:localeIdentifier
+              forKey:PFInstallationKeyLocaleIdentifier
+     onlyIfDifferent:YES];
+}
+
 - (void)setChannels:(NSArray *)channels {
     [self _setObject:channels forKey:PFInstallationKeyChannels onlyIfDifferent:YES];
 }
@@ -256,6 +264,7 @@ - (void)_updateAutomaticInfo {
             [self _updateTimeZoneFromDevice];
             [self _updateBadgeFromDevice];
             [self _updateVersionInfoFromDevice];
+            [self _updateLocaleIdentifierFromDevice];
         }
     }
 }
@@ -301,6 +310,37 @@ - (void)_updateVersionInfoFromDevice {
     }
 }
 
+/*!
+ @abstract Save localeIdentifier in the following format: [language code]-[COUNTRY CODE].
+ 
+ @discussion The language codes are two-letter lowercase ISO language codes (such as "en") as defined by
+ <a href="http://en.wikipedia.org/wiki/ISO_639-1">ISO 639-1</a>.
+ The country codes are two-letter uppercase ISO country codes (such as "US") as defined by
+ <a href="http://en.wikipedia.org/wiki/ISO_3166-1_alpha-3">ISO 3166-1</a>.
+ 
+ Many iOS locale identifiers don't contain the country code -> inconsistencies with Android/Windows Phone.
+ */
+- (void)_updateLocaleIdentifierFromDevice {
+    NSLocale *currentLocale = [NSLocale currentLocale];
+    NSString *language = [currentLocale objectForKey:NSLocaleLanguageCode];
+    NSString *countryCode = [currentLocale objectForKey:NSLocaleCountryCode];
+    
+    if (language.length == 0) {
+        return;
+    }
+    
+    NSString *localeIdentifier = nil;
+    if (countryCode.length > 0) {
+        localeIdentifier = [NSString stringWithFormat:@"%@-%@", language, countryCode];
+    } else {
+        localeIdentifier = language;
+    }
+
+    if (localeIdentifier.length > 0 && ![localeIdentifier isEqualToString:self.localeIdentifier]) {
+        self.localeIdentifier = localeIdentifier;
+    }
+}
+
 ///--------------------------------------
 #pragma mark - Data Source
 ///--------------------------------------