Merge pull request #7720 from woocommerce/issue/7710-last-refreshed

Widget: Last refreshed label

Author: Ecarrion

WooCommerce/StoreWidgets/StoreInfoProvider.swift

@@ -44,6 +44,10 @@ struct StoreInfoData {
     /// Conversion at the range (eg: today)
     ///
     var conversion: String
+
+    /// Time when the widget was last refreshed (eg: 10.24PM)
+    ///
+    var updatedTime: String
 }
 
 /// Type that provides data entries to the widget system.
@@ -67,7 +71,8 @@ final class StoreInfoProvider: TimelineProvider {
                                          revenue: Self.formattedAmountString(for: 132.234, with: dependencies?.storeCurrencySettings),
                                          visitors: "67",
                                          orders: "23",
-                                         conversion: Self.formattedConversionString(for: 23/67)))
+                                         conversion: Self.formattedConversionString(for: 23/67),
+                                         updatedTime: Self.currentFormattedTime()))
     }
 
     /// Quick Snapshot. Required when previewing the widget.
@@ -94,7 +99,8 @@ final class StoreInfoProvider: TimelineProvider {
                                                       revenue: Self.formattedAmountString(for: todayStats.revenue, with: dependencies.storeCurrencySettings),
                                                       visitors: "\(todayStats.totalVisitors)",
                                                       orders: "\(todayStats.totalOrders)",
-                                                      conversion: Self.formattedConversionString(for: todayStats.conversion)))
+                                                      conversion: Self.formattedConversionString(for: todayStats.conversion),
+                                                      updatedTime: Self.currentFormattedTime()))
 
                 let reloadDate = Date(timeIntervalSinceNow: reloadInterval)
                 let timeline = Timeline<StoreInfoEntry>(entries: [entry], policy: .after(reloadDate))
@@ -160,6 +166,15 @@ private extension StoreInfoProvider {
         return numberFormatter.string(from: conversionRate as NSNumber) ?? Constants.valuePlaceholderText
     }
 
+    /// Returns the current time formatted as `10:24 PM` or `22:24` depending on the phone settings.
+    ///
+    static func currentFormattedTime() -> String {
+        let timeFormatter = DateFormatter()
+        timeFormatter.timeStyle = .short
+        timeFormatter.dateStyle = .none
+        return timeFormatter.string(from: Date())
+    }
+
     enum Constants {
         static let valuePlaceholderText = "-"
     }

WooCommerce/StoreWidgets/StoreInfoWidget.swift

@@ -94,6 +94,10 @@ private struct StoreInfoView: View {
                     }
                     .frame(maxWidth: .infinity, alignment: .leading)
                 }
+
+                Text(Localization.updatedAt(entry.updatedTime))
+                    .statRangeStyle()
+                    .frame(maxWidth: .infinity, alignment: .leading)
             }
             .padding(.horizontal)
         }
@@ -187,6 +191,12 @@ private extension StoreInfoView {
             value: "Conversion",
             comment: "Conversion title label for the store info widget"
         )
+        static func updatedAt(_ updatedTime: String) -> LocalizedString {
+            let format = AppLocalizedString("storeWidgets.infoView.updatedAt",
+                                            value: "as of %1$@",
+                                            comment: "Displays the time when the widget was last updated. %1$@ is the time to render.")
+            return LocalizedString.localizedStringWithFormat(format, updatedTime)
+        }
     }
 
     enum Layout {
@@ -244,7 +254,8 @@ struct StoreWidgets_Previews: PreviewProvider {
                                  revenue: "$132.234",
                                  visitors: "67",
                                  orders: "23",
-                                 conversion: "37%")
+                                 conversion: "37%",
+                                 updatedTime: "10:24 PM")
         )
         .previewContext(WidgetPreviewContext(family: .systemMedium))