From f94c13df3562f9fa4d440b48f679dbaa7f57dbb3 Mon Sep 17 00:00:00 2001
From: Sawyer Blatz <sdblatz@gmail.com>
Date: Fri, 22 May 2020 16:06:48 -0700
Subject: [PATCH 1/2] For #9488: Add search widget CFR

---
 .../org/mozilla/fenix/cfr/SearchWidgetCFR.kt  |  90 ++++++++++++++++
 .../fenix/components/SearchWidgetCreator.kt   |  33 ++++++
 .../org/mozilla/fenix/home/HomeFragment.kt    |  10 ++
 .../mozilla/fenix/search/SearchController.kt  |   4 +
 .../java/org/mozilla/fenix/utils/Settings.kt  |  57 ++++++++++
 .../search_widget_illustration.png            | Bin 0 -> 23276 bytes
 app/src/main/res/layout/search_widget_cfr.xml | 100 ++++++++++++++++++
 app/src/main/res/values/preference_keys.xml   |   6 ++
 app/src/main/res/values/strings.xml           |  10 +-
 9 files changed, 309 insertions(+), 1 deletion(-)
 create mode 100644 app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt
 create mode 100644 app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt
 create mode 100644 app/src/main/res/drawable-xhdpi/search_widget_illustration.png
 create mode 100644 app/src/main/res/layout/search_widget_cfr.xml

diff --git a/app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt b/app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt
new file mode 100644
index 000000000000..884e7c11fafa
--- /dev/null
+++ b/app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt
@@ -0,0 +1,90 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+package org.mozilla.fenix.cfr
+
+import android.app.Dialog
+import android.content.Context
+import android.graphics.Color
+import android.graphics.drawable.ColorDrawable
+import android.view.Gravity
+import android.view.LayoutInflater
+import android.view.View
+import androidx.core.view.isGone
+import androidx.core.view.isVisible
+import androidx.core.view.marginTop
+import kotlinx.android.synthetic.main.search_widget_cfr.view.*
+import kotlinx.android.synthetic.main.tracking_protection_onboarding_popup.view.drop_down_triangle
+import kotlinx.android.synthetic.main.tracking_protection_onboarding_popup.view.pop_up_triangle
+import org.mozilla.fenix.R
+import org.mozilla.fenix.components.SearchWidgetCreator
+import org.mozilla.fenix.ext.settings
+import org.mozilla.fenix.utils.Settings
+
+/**
+ * Displays a CFR above the HomeFragment toolbar that recommends usage / installation of the search widget.
+ */
+class SearchWidgetCFR(
+    private val context: Context,
+    private val getToolbar: () -> View
+) {
+
+    // TODO: Based on pref && is in the bucket...?
+    fun displayIfNecessary() {
+        if (!context.settings().shouldDisplaySearchWidgetCFR()) { return }
+        showSearchWidgetCFR()
+    }
+
+    @Suppress("MagicNumber", "InflateParams")
+    private fun showSearchWidgetCFR() {
+        context.settings().incrementSearchWidgetCFRDisplayed()
+
+        val searchWidgetCFRDialog = Dialog(context)
+        val layout = LayoutInflater.from(context)
+            .inflate(R.layout.search_widget_cfr, null)
+        val isBottomToolbar = Settings.getInstance(context).shouldUseBottomToolbar
+
+        layout.drop_down_triangle.isGone = isBottomToolbar
+        layout.pop_up_triangle.isVisible = isBottomToolbar
+
+        val toolbar = getToolbar()
+
+        val gravity = if (isBottomToolbar) {
+            Gravity.CENTER_HORIZONTAL or Gravity.BOTTOM
+        } else {
+            Gravity.CENTER_HORIZONTAL or Gravity.TOP
+        }
+
+        layout.cfr_neg_button.setOnClickListener {
+            searchWidgetCFRDialog.dismiss()
+            context.settings().manuallyDismissSearchWidgetCFR()
+        }
+
+        layout.cfr_pos_button.setOnClickListener {
+            //context.components.analytics.metrics.track(Event.)
+            SearchWidgetCreator.createSearchWidget(context)
+            searchWidgetCFRDialog.dismiss()
+            //context.settings().manuallyDismissSearchWidgetCFR()
+        }
+
+        searchWidgetCFRDialog.apply {
+            setContentView(layout)
+        }
+
+        searchWidgetCFRDialog.window?.let {
+            it.setGravity(gravity)
+            val attr = it.attributes
+            attr.y =
+                (toolbar.y + toolbar.height - toolbar.marginTop - toolbar.paddingTop).toInt()
+            it.attributes = attr
+            it.setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))
+        }
+
+        searchWidgetCFRDialog.setOnDismissListener {
+            context.settings().incrementSearchWidgetCFRDismissed()
+        }
+
+        searchWidgetCFRDialog.show()
+    }
+}
diff --git a/app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt b/app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt
new file mode 100644
index 000000000000..f16cc4eef29a
--- /dev/null
+++ b/app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt
@@ -0,0 +1,33 @@
+/* This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at http://mozilla.org/MPL/2.0/. */
+
+package org.mozilla.fenix.components
+
+import android.annotation.TargetApi
+import android.appwidget.AppWidgetManager
+import android.content.ComponentName
+import android.content.Context
+import android.os.Build
+import org.mozilla.gecko.search.SearchWidgetProvider
+
+/**
+ * Handles the creation of search widget.
+ */
+object SearchWidgetCreator {
+
+    /**
+     * Attempts to display a prompt requesting the user pin the search widget
+     * Returns true if the prompt is displayed successfully, and false otherwise.
+     */
+    @TargetApi(Build.VERSION_CODES.O)
+    fun createSearchWidget(context: Context): Boolean {
+        val appWidgetManager: AppWidgetManager = context.getSystemService(AppWidgetManager::class.java)
+        if (!appWidgetManager.isRequestPinAppWidgetSupported) { return false }
+
+        val myProvider = ComponentName(context, SearchWidgetProvider::class.java)
+        appWidgetManager.requestPinAppWidget(myProvider, null, null)
+
+        return true
+    }
+}
diff --git a/app/src/main/java/org/mozilla/fenix/home/HomeFragment.kt b/app/src/main/java/org/mozilla/fenix/home/HomeFragment.kt
index 8d3f9461c020..ccaf1c4b4dd5 100644
--- a/app/src/main/java/org/mozilla/fenix/home/HomeFragment.kt
+++ b/app/src/main/java/org/mozilla/fenix/home/HomeFragment.kt
@@ -26,6 +26,7 @@ import androidx.constraintlayout.widget.ConstraintSet.PARENT_ID
 import androidx.constraintlayout.widget.ConstraintSet.TOP
 import androidx.coordinatorlayout.widget.CoordinatorLayout
 import androidx.core.content.ContextCompat
+import androidx.core.view.doOnLayout
 import androidx.core.view.isVisible
 import androidx.core.view.updateLayoutParams
 import androidx.fragment.app.Fragment
@@ -78,6 +79,7 @@ import org.mozilla.fenix.addons.runIfFragmentIsAttached
 import org.mozilla.fenix.browser.BrowserAnimator.Companion.getToolbarNavOptions
 import org.mozilla.fenix.browser.browsingmode.BrowsingMode
 import org.mozilla.fenix.collections.SaveCollectionStep
+import org.mozilla.fenix.cfr.SearchWidgetCFR
 import org.mozilla.fenix.components.FenixSnackbar
 import org.mozilla.fenix.components.PrivateShortcutCreateManager
 import org.mozilla.fenix.components.StoreProvider
@@ -380,6 +382,14 @@ class HomeFragment : Fragment() {
                 )
             }
         }
+
+        // We call this onLayout so that the bottom bar width is correctly set for us to center
+        // the CFR in.
+        view.toolbar_wrapper.doOnLayout {
+            if (!browsingModeManager.mode.isPrivate) {
+                SearchWidgetCFR(view.context) { view.toolbar_wrapper }.displayIfNecessary()
+            }
+        }
     }
 
     override fun onDestroyView() {
diff --git a/app/src/main/java/org/mozilla/fenix/search/SearchController.kt b/app/src/main/java/org/mozilla/fenix/search/SearchController.kt
index c69515c53a98..cbe131f1c8d7 100644
--- a/app/src/main/java/org/mozilla/fenix/search/SearchController.kt
+++ b/app/src/main/java/org/mozilla/fenix/search/SearchController.kt
@@ -81,6 +81,8 @@ class DefaultSearchController(
         val event = if (url.isUrl()) {
             Event.EnteredUrl(false)
         } else {
+            context.settings().incrementActiveSearchCount()
+
             val searchAccessPoint = when (store.state.searchAccessPoint) {
                 NONE -> ACTION
                 else -> store.state.searchAccessPoint
@@ -142,6 +144,8 @@ class DefaultSearchController(
     }
 
     override fun handleSearchTermsTapped(searchTerms: String) {
+        context.settings().incrementActiveSearchCount()
+
         activity.openToBrowserAndLoad(
             searchTermOrURL = searchTerms,
             newTab = store.state.session == null,
diff --git a/app/src/main/java/org/mozilla/fenix/utils/Settings.kt b/app/src/main/java/org/mozilla/fenix/utils/Settings.kt
index f63b874c0767..342e15e5eb23 100644
--- a/app/src/main/java/org/mozilla/fenix/utils/Settings.kt
+++ b/app/src/main/java/org/mozilla/fenix/utils/Settings.kt
@@ -149,6 +149,63 @@ class Settings private constructor(
             preferences.getBoolean(appContext.getString(R.string.pref_key_migrating_from_firefox_nightly_tip), true) &&
             preferences.getBoolean(appContext.getString(R.string.pref_key_migrating_from_fenix_tip), true)
 
+    private val activeSearchCount by intPreference(
+        appContext.getPreferenceKey(R.string.pref_key_search_count),
+        default = 0
+    )
+
+    fun incrementActiveSearchCount() {
+        preferences.edit().putInt(
+            appContext.getPreferenceKey(R.string.pref_key_search_count),
+            activeSearchCount + 1
+        ).apply()
+    }
+
+    private val isActiveSearcher: Boolean
+        get() = activeSearchCount > 2
+
+    fun shouldDisplaySearchWidgetCFR(): Boolean =
+        isActiveSearcher &&
+        searchWidgetCFRDismissCount < 3 &&
+        !searchWidgetInstalled &&
+        !searchWidgetCFRManuallyDismissed
+
+    private val searchWidgetCFRDisplayCount by intPreference(
+        appContext.getPreferenceKey(R.string.pref_key_search_widget_cfr_display_count),
+        default = 0
+    )
+
+    fun incrementSearchWidgetCFRDisplayed() {
+        preferences.edit().putInt(
+            appContext.getPreferenceKey(R.string.pref_key_search_widget_cfr_display_count),
+            searchWidgetCFRDisplayCount + 1
+        ).apply()
+    }
+
+    private val searchWidgetCFRManuallyDismissed by booleanPreference(
+        appContext.getPreferenceKey(R.string.pref_key_search_widget_cfr_manually_dismissed),
+        default = false
+    )
+
+    fun manuallyDismissSearchWidgetCFR() {
+        preferences.edit().putBoolean(
+            appContext.getPreferenceKey(R.string.pref_key_search_widget_cfr_manually_dismissed),
+            true
+        ).apply()
+    }
+
+    private val searchWidgetCFRDismissCount by intPreference(
+        appContext.getPreferenceKey(R.string.pref_key_search_widget_cfr_dismiss_count),
+        default = 0
+    )
+
+    fun incrementSearchWidgetCFRDismissed() {
+        preferences.edit().putInt(
+            appContext.getPreferenceKey(R.string.pref_key_search_widget_cfr_dismiss_count),
+            searchWidgetCFRDismissCount + 1
+        ).apply()
+    }
+
     var defaultSearchEngineName by stringPreference(
         appContext.getPreferenceKey(R.string.pref_key_search_engine),
         default = ""
diff --git a/app/src/main/res/drawable-xhdpi/search_widget_illustration.png b/app/src/main/res/drawable-xhdpi/search_widget_illustration.png
new file mode 100644
index 0000000000000000000000000000000000000000..dc6539813c9afdba638ef3b44e01af4c0042f227
GIT binary patch
literal 23276
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
A`Tzg`

literal 0
HcmV?d00001

diff --git a/app/src/main/res/layout/search_widget_cfr.xml b/app/src/main/res/layout/search_widget_cfr.xml
new file mode 100644
index 000000000000..e5f6be05b60d
--- /dev/null
+++ b/app/src/main/res/layout/search_widget_cfr.xml
@@ -0,0 +1,100 @@
+<?xml version="1.0" encoding="utf-8"?>
+<!-- This Source Code Form is subject to the terms of the Mozilla Public
+   - License, v. 2.0. If a copy of the MPL was not distributed with this
+   - file, You can obtain one at http://mozilla.org/MPL/2.0/. -->
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:app="http://schemas.android.com/apk/res-auto"
+    android:layout_gravity="center_horizontal"
+    android:paddingHorizontal="16dp"
+    android:layout_width="wrap_content"
+    android:layout_height="wrap_content"
+    android:orientation="vertical">
+
+    <androidx.appcompat.widget.AppCompatImageView
+        android:visibility="gone"
+        android:id="@+id/drop_down_triangle"
+        android:layout_width="@dimen/tp_onboarding_triangle_width"
+        android:layout_height="@dimen/tp_onboarding_triangle_height"
+        android:importantForAccessibility="no"
+        android:rotation="0"
+        app:srcCompat="@drawable/ic_pbm_triangle"
+        android:layout_gravity="center" />
+
+    <androidx.constraintlayout.widget.ConstraintLayout
+        android:id="@+id/message"
+        android:layout_width="@dimen/etp_onboarding_popup_width"
+        android:layout_height="wrap_content"
+        android:background="@drawable/cfr_background_gradient"
+        app:layout_constraintTop_toTopOf="parent">
+
+        <androidx.appcompat.widget.AppCompatImageView
+            android:id="@+id/cfr_image"
+            app:srcCompat="@drawable/search_widget_illustration"
+            android:padding="16dp"
+            android:scaleType="fitCenter"
+            android:layout_width="0dp"
+            android:layout_height="140dp"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toTopOf="parent"/>
+
+        <TextView
+            android:id="@+id/cfr_message"
+            android:layout_width="0dp"
+            android:layout_height="wrap_content"
+            android:layout_marginHorizontal="16dp"
+            android:layout_marginTop="8dp"
+            android:layout_marginBottom="8dp"
+            android:lineSpacingExtra="2dp"
+            android:text="@string/search_widget_cfr_message"
+            android:textColor="@color/primary_text_dark_theme"
+            android:textSize="16sp"
+            app:fontFamily="@font/metropolis_medium"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toBottomOf="@id/cfr_image" />
+
+
+        <Button
+            android:id="@+id/cfr_pos_button"
+            style="@style/MetropolisButton"
+            android:layout_width="0dp"
+            android:layout_height="36dp"
+            android:layout_marginStart="16dp"
+            android:layout_marginTop="16dp"
+            android:layout_marginEnd="16dp"
+            android:background="@drawable/rounded_gray_corners"
+            android:text="@string/search_widget_cfr_pos_button_text"
+            android:textAllCaps="false"
+            android:textColor="@color/above_dark_theme"
+            android:textSize="16sp"
+            app:layout_constraintBottom_toTopOf="@id/cfr_neg_button"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toBottomOf="@id/cfr_message" />
+
+        <Button
+            android:id="@+id/cfr_neg_button"
+            style="@style/MetropolisButton"
+            android:layout_width="wrap_content"
+            android:layout_height="wrap_content"
+            android:background="@android:color/transparent"
+            android:text="@string/search_widget_cfr_neg_button_text"
+            android:textAllCaps="false"
+            android:textColor="@color/white_color"
+            android:textSize="16sp"
+            app:layout_constraintBottom_toBottomOf="parent"
+            app:layout_constraintEnd_toEndOf="parent"
+            app:layout_constraintStart_toStartOf="parent"
+            app:layout_constraintTop_toBottomOf="@id/cfr_pos_button" />
+    </androidx.constraintlayout.widget.ConstraintLayout>
+
+    <androidx.appcompat.widget.AppCompatImageView
+        android:id="@+id/pop_up_triangle"
+        android:layout_width="16dp"
+        android:layout_height="@dimen/tp_onboarding_triangle_height"
+        android:importantForAccessibility="no"
+        android:rotation="180"
+        app:srcCompat="@drawable/ic_pbm_triangle"
+        android:layout_gravity="center" />
+</LinearLayout>
diff --git a/app/src/main/res/values/preference_keys.xml b/app/src/main/res/values/preference_keys.xml
index 36aeb3f6bc34..07b77edcfbd7 100644
--- a/app/src/main/res/values/preference_keys.xml
+++ b/app/src/main/res/values/preference_keys.xml
@@ -171,4 +171,10 @@
     <string name="pref_key_enable_new_tab_tray" translatable="false">pref_key_new_tab_tray</string>
 
     <string name="pref_key_debug_settings" translatable="false">pref_key_debug_settings</string>
+
+    <string name="pref_key_search_count" translatable="false">pref_key_search_count</string>
+    <string name="pref_key_search_widget_cfr_display_count" translatable="false">pref_key_search_widget_cfr_display_count</string>
+    <string name="pref_key_search_widget_cfr_dismiss_count" translatable="false">pref_key_search_widget_cfr_dismiss_count</string>
+    <string name="pref_key_search_widget_cfr_manually_dismissed" translatable="false">pref_key_search_widget_cfr_manually_dismissed</string>
+    <string name="pref_key_show_search_widget_cfr" translatable="false">pref_key_show_search_widget_cfr</string>
 </resources>
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index ee4f0a8bd72a..a946856736b0 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -36,7 +36,7 @@
     <!-- Delete session button to erase your history in a private session -->
     <string name="private_browsing_delete_session">Delete session</string>
 
-    <!-- Private mode shortcut "contextual feature recommender" (CFR) -->
+    <!-- Private mode shortcut "contextual feature recommendation" (CFR) -->
     <!-- Text for the main message -->
     <string name="cfr_message">Add a shortcut to open private tabs from your Home screen.</string>
     <!-- Text for the positive button -->
@@ -44,6 +44,14 @@
     <!-- Text for the negative button -->
     <string name="cfr_neg_button_text">No thanks</string>
 
+    <!-- Search widget "contextual feature recommendation" (CFR) -->
+    <!-- Text for the main message. Placeholder text replaced with app name. -->
+    <string name="search_widget_cfr_message">Get to Firefox faster. Add a widget to your Home screen.</string>
+    <!-- Text for the positive button -->
+    <string name="search_widget_cfr_pos_button_text">Add widget</string>
+    <!-- Text for the negative button -->
+    <string name="search_widget_cfr_neg_button_text">Not now</string>
+
     <!-- Home screen icons - Long press shortcuts -->
     <!-- Shortcut action to open new tab -->
     <string name="home_screen_shortcut_open_new_tab_2">New tab</string>

From ee19f3b769eaad06c0d5c25796cff1d2f28c8f3c Mon Sep 17 00:00:00 2001
From: Sawyer Blatz <sdblatz@gmail.com>
Date: Wed, 27 May 2020 10:58:34 -0700
Subject: [PATCH 2/2] For #9488 Add telemetry for search widget CFR

---
 app/metrics.yaml                              | 63 ++++++++++++++++++-
 .../java/org/mozilla/fenix/FeatureFlags.kt    |  6 ++
 .../org/mozilla/fenix/cfr/SearchWidgetCFR.kt  | 16 +++--
 .../fenix/components/SearchWidgetCreator.kt   |  2 +-
 .../components/metrics/GleanMetricsService.kt | 17 +++++
 .../fenix/components/metrics/Metrics.kt       |  4 ++
 .../mozilla/fenix/search/SearchController.kt  |  4 +-
 .../java/org/mozilla/fenix/utils/Settings.kt  |  3 +-
 app/src/main/res/values/strings.xml           |  2 +-
 docs/metrics.md                               |  5 ++
 10 files changed, 111 insertions(+), 11 deletions(-)

diff --git a/app/metrics.yaml b/app/metrics.yaml
index dc1e4f58bd8b..168ba0ceecff 100644
--- a/app/metrics.yaml
+++ b/app/metrics.yaml
@@ -480,7 +480,6 @@ metrics:
     notification_emails:
       - fenix-core@mozilla.com
     expires: "2020-09-01"
-
   toolbar_position:
     type: string
     lifetime: application
@@ -495,7 +494,20 @@ metrics:
     notification_emails:
       - fenix-core@mozilla.com
     expires: "2020-09-01"
-
+  search_widget_installed:
+    type: boolean
+    lifetime: application
+    description: |
+      Whether or not the search widget is installed
+    send_in_pings:
+      - metrics
+    bugs:
+      - https://github.com/mozilla-mobile/fenix/issues/9488
+    data_reviews:
+      - https://github.com/mozilla-mobile/fenix/pull/10958
+    notification_emails:
+      - fenix-core@mozilla.com
+    expires: "2020-09-01"
 
 search.default_engine:
   code:
@@ -1356,6 +1368,53 @@ search_widget:
       - fenix-core@mozilla.com
     expires: "2020-09-01"
 
+search_widget_cfr:
+  displayed:
+    type: event
+    description: |
+      The search widget cfr was displayed.
+    bugs:
+      - https://github.com/mozilla-mobile/fenix/issues/9488
+    data_reviews:
+      - https://github.com/mozilla-mobile/fenix/pull/10958
+    notification_emails:
+      - fenix-core@mozilla.com
+    expires: "2020-09-01"
+  add_widget_pressed:
+    type: event
+    description: |
+      The user pressed the "add widget" button.
+    bugs:
+      - https://github.com/mozilla-mobile/fenix/issues/9488
+    data_reviews:
+      - https://github.com/mozilla-mobile/fenix/pull/10958
+    notification_emails:
+      - fenix-core@mozilla.com
+    expires: "2020-09-01"
+  not_now_pressed:
+    type: event
+    description: |
+      The user pressed the "not now" button.
+    bugs:
+      - https://github.com/mozilla-mobile/fenix/issues/9488
+    data_reviews:
+      - https://github.com/mozilla-mobile/fenix/pull/10958
+    notification_emails:
+      - fenix-core@mozilla.com
+    expires: "2020-09-01"
+  canceled:
+    type: event
+    description: |
+      The user dismissed the search widget cfr by
+      tapping outside of the prompt
+    bugs:
+      - https://github.com/mozilla-mobile/fenix/issues/9488
+    data_reviews:
+      - https://github.com/mozilla-mobile/fenix/pull/10958
+    notification_emails:
+      - fenix-core@mozilla.com
+    expires: "2020-09-01"
+
 private_browsing_mode:
   garbage_icon:
     type: event
diff --git a/app/src/main/java/org/mozilla/fenix/FeatureFlags.kt b/app/src/main/java/org/mozilla/fenix/FeatureFlags.kt
index d539cdecd7c7..9f3dbf6794dc 100644
--- a/app/src/main/java/org/mozilla/fenix/FeatureFlags.kt
+++ b/app/src/main/java/org/mozilla/fenix/FeatureFlags.kt
@@ -53,4 +53,10 @@ object FeatureFlags {
      * Enables new voice search feature
      */
     val voiceSearch = Config.channel.isNightlyOrDebug
+
+    /**
+     * Allows search widget CFR to be displayed.
+     * This is a placeholder for the experimentation framework determining cohorts.
+     */
+    val searchWidgetCFR = Config.channel.isDebug
 }
diff --git a/app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt b/app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt
index 884e7c11fafa..00f0c084f1f5 100644
--- a/app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt
+++ b/app/src/main/java/org/mozilla/fenix/cfr/SearchWidgetCFR.kt
@@ -17,8 +17,11 @@ import androidx.core.view.marginTop
 import kotlinx.android.synthetic.main.search_widget_cfr.view.*
 import kotlinx.android.synthetic.main.tracking_protection_onboarding_popup.view.drop_down_triangle
 import kotlinx.android.synthetic.main.tracking_protection_onboarding_popup.view.pop_up_triangle
+import org.mozilla.fenix.FeatureFlags
 import org.mozilla.fenix.R
 import org.mozilla.fenix.components.SearchWidgetCreator
+import org.mozilla.fenix.components.metrics.Event
+import org.mozilla.fenix.ext.components
 import org.mozilla.fenix.ext.settings
 import org.mozilla.fenix.utils.Settings
 
@@ -30,9 +33,8 @@ class SearchWidgetCFR(
     private val getToolbar: () -> View
 ) {
 
-    // TODO: Based on pref && is in the bucket...?
     fun displayIfNecessary() {
-        if (!context.settings().shouldDisplaySearchWidgetCFR()) { return }
+        if (!context.settings().shouldDisplaySearchWidgetCFR() || !FeatureFlags.searchWidgetCFR) { return }
         showSearchWidgetCFR()
     }
 
@@ -57,15 +59,16 @@ class SearchWidgetCFR(
         }
 
         layout.cfr_neg_button.setOnClickListener {
+            context.components.analytics.metrics.track(Event.SearchWidgetCFRNotNowPressed)
             searchWidgetCFRDialog.dismiss()
             context.settings().manuallyDismissSearchWidgetCFR()
         }
 
         layout.cfr_pos_button.setOnClickListener {
-            //context.components.analytics.metrics.track(Event.)
+            context.components.analytics.metrics.track(Event.SearchWidgetCFRAddWidgetPressed)
             SearchWidgetCreator.createSearchWidget(context)
             searchWidgetCFRDialog.dismiss()
-            //context.settings().manuallyDismissSearchWidgetCFR()
+            context.settings().manuallyDismissSearchWidgetCFR()
         }
 
         searchWidgetCFRDialog.apply {
@@ -81,10 +84,15 @@ class SearchWidgetCFR(
             it.setBackgroundDrawable(ColorDrawable(Color.TRANSPARENT))
         }
 
+        searchWidgetCFRDialog.setOnCancelListener {
+            context.components.analytics.metrics.track(Event.SearchWidgetCFRCanceled)
+        }
+
         searchWidgetCFRDialog.setOnDismissListener {
             context.settings().incrementSearchWidgetCFRDismissed()
         }
 
         searchWidgetCFRDialog.show()
+        context.components.analytics.metrics.track(Event.SearchWidgetCFRDisplayed)
     }
 }
diff --git a/app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt b/app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt
index f16cc4eef29a..41734d7549e6 100644
--- a/app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt
+++ b/app/src/main/java/org/mozilla/fenix/components/SearchWidgetCreator.kt
@@ -12,7 +12,7 @@ import android.os.Build
 import org.mozilla.gecko.search.SearchWidgetProvider
 
 /**
- * Handles the creation of search widget.
+ * Handles the creation of the pinning search widget dialog.
  */
 object SearchWidgetCreator {
 
diff --git a/app/src/main/java/org/mozilla/fenix/components/metrics/GleanMetricsService.kt b/app/src/main/java/org/mozilla/fenix/components/metrics/GleanMetricsService.kt
index bb3e09f11716..7989e6ce1a53 100644
--- a/app/src/main/java/org/mozilla/fenix/components/metrics/GleanMetricsService.kt
+++ b/app/src/main/java/org/mozilla/fenix/components/metrics/GleanMetricsService.kt
@@ -36,6 +36,7 @@ import org.mozilla.fenix.GleanMetrics.SearchDefaultEngine
 import org.mozilla.fenix.GleanMetrics.SearchShortcuts
 import org.mozilla.fenix.GleanMetrics.SearchSuggestions
 import org.mozilla.fenix.GleanMetrics.SearchWidget
+import org.mozilla.fenix.GleanMetrics.SearchWidgetCfr
 import org.mozilla.fenix.GleanMetrics.SyncAccount
 import org.mozilla.fenix.GleanMetrics.SyncAuth
 import org.mozilla.fenix.GleanMetrics.Tab
@@ -529,6 +530,19 @@ private val Event.wrapper: EventWrapper<*>?
         is Event.VoiceSearchTapped -> EventWrapper<NoExtraKeys>(
             { VoiceSearch.tapped.record(it) }
         )
+        is Event.SearchWidgetCFRDisplayed -> EventWrapper<NoExtraKeys>(
+            { SearchWidgetCfr.displayed.record(it) }
+        )
+        is Event.SearchWidgetCFRCanceled -> EventWrapper<NoExtraKeys>(
+            { SearchWidgetCfr.canceled.record(it) }
+        )
+        is Event.SearchWidgetCFRNotNowPressed -> EventWrapper<NoExtraKeys>(
+            { SearchWidgetCfr.notNowPressed.record(it) }
+        )
+        is Event.SearchWidgetCFRAddWidgetPressed -> EventWrapper<NoExtraKeys>(
+            { SearchWidgetCfr.addWidgetPressed.record(it) }
+        )
+
         // Don't record other events in Glean:
         is Event.AddBookmark -> null
         is Event.OpenedBookmark -> null
@@ -584,6 +598,9 @@ class GleanMetricsService(private val context: Context) : MetricsService {
             adjustAdGroup.set(context.settings().adjustAdGroup)
             adjustCreative.set(context.settings().adjustCreative)
             adjustNetwork.set(context.settings().adjustNetwork)
+
+            searchWidgetInstalled.set(context.settings().searchWidgetInstalled)
+
             val topSitesSize = context.settings().topSitesSize
             hasTopSites.set(topSitesSize > 0)
             if (topSitesSize > 0) {
diff --git a/app/src/main/java/org/mozilla/fenix/components/metrics/Metrics.kt b/app/src/main/java/org/mozilla/fenix/components/metrics/Metrics.kt
index 4b7d49839f2c..3bcc9ead4014 100644
--- a/app/src/main/java/org/mozilla/fenix/components/metrics/Metrics.kt
+++ b/app/src/main/java/org/mozilla/fenix/components/metrics/Metrics.kt
@@ -168,6 +168,10 @@ sealed class Event {
     object AddonsOpenInSettings : Event()
     object AddonsOpenInToolbarMenu : Event()
     object VoiceSearchTapped : Event()
+    object SearchWidgetCFRDisplayed : Event()
+    object SearchWidgetCFRCanceled : Event()
+    object SearchWidgetCFRNotNowPressed : Event()
+    object SearchWidgetCFRAddWidgetPressed : Event()
 
     // Interaction events with extras
 
diff --git a/app/src/main/java/org/mozilla/fenix/search/SearchController.kt b/app/src/main/java/org/mozilla/fenix/search/SearchController.kt
index cbe131f1c8d7..5a01ba3cea52 100644
--- a/app/src/main/java/org/mozilla/fenix/search/SearchController.kt
+++ b/app/src/main/java/org/mozilla/fenix/search/SearchController.kt
@@ -81,7 +81,7 @@ class DefaultSearchController(
         val event = if (url.isUrl()) {
             Event.EnteredUrl(false)
         } else {
-            context.settings().incrementActiveSearchCount()
+            activity.settings().incrementActiveSearchCount()
 
             val searchAccessPoint = when (store.state.searchAccessPoint) {
                 NONE -> ACTION
@@ -144,7 +144,7 @@ class DefaultSearchController(
     }
 
     override fun handleSearchTermsTapped(searchTerms: String) {
-        context.settings().incrementActiveSearchCount()
+        activity.settings().incrementActiveSearchCount()
 
         activity.openToBrowserAndLoad(
             searchTermOrURL = searchTerms,
diff --git a/app/src/main/java/org/mozilla/fenix/utils/Settings.kt b/app/src/main/java/org/mozilla/fenix/utils/Settings.kt
index 342e15e5eb23..f7caa06c0b47 100644
--- a/app/src/main/java/org/mozilla/fenix/utils/Settings.kt
+++ b/app/src/main/java/org/mozilla/fenix/utils/Settings.kt
@@ -55,6 +55,7 @@ class Settings private constructor(
         const val trackingProtectionOnboardingMaximumCount = 1
         const val FENIX_PREFERENCES = "fenix_preferences"
 
+        private const val showSearchWidgetCFRMaxCount = 3
         private const val BLOCKED_INT = 0
         private const val ASK_TO_ALLOW_INT = 1
         private const val ALLOWED_INT = 2
@@ -166,7 +167,7 @@ class Settings private constructor(
 
     fun shouldDisplaySearchWidgetCFR(): Boolean =
         isActiveSearcher &&
-        searchWidgetCFRDismissCount < 3 &&
+        searchWidgetCFRDismissCount < showSearchWidgetCFRMaxCount &&
         !searchWidgetInstalled &&
         !searchWidgetCFRManuallyDismissed
 
diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml
index a946856736b0..3d5cb1ba0ce1 100644
--- a/app/src/main/res/values/strings.xml
+++ b/app/src/main/res/values/strings.xml
@@ -45,7 +45,7 @@
     <string name="cfr_neg_button_text">No thanks</string>
 
     <!-- Search widget "contextual feature recommendation" (CFR) -->
-    <!-- Text for the main message. Placeholder text replaced with app name. -->
+    <!-- Text for the main message. 'Firefox' intentionally hardcoded here.-->
     <string name="search_widget_cfr_message">Get to Firefox faster. Add a widget to your Home screen.</string>
     <!-- Text for the positive button -->
     <string name="search_widget_cfr_pos_button_text">Add widget</string>
diff --git a/docs/metrics.md b/docs/metrics.md
index 519dea92789d..1bbfc0fb3302 100644
--- a/docs/metrics.md
+++ b/docs/metrics.md
@@ -146,6 +146,10 @@ The following metrics are added to the ping:
 | search_suggestions.enable_in_private |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |A user enabled receiving search suggestions in private sessions  |[1](https://github.com/mozilla-mobile/fenix/pull/6746)||2020-09-01 |
 | search_widget.new_tab_button |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |A user pressed anywhere from the Firefox logo until the start of the microphone icon, opening a new tab search screen.  |[1](https://github.com/mozilla-mobile/fenix/pull/4714)||2020-09-01 |
 | search_widget.voice_button |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |A user pressed the microphone icon, opening a new voice search screen.  |[1](https://github.com/mozilla-mobile/fenix/pull/4714)||2020-09-01 |
+| search_widget_cfr.add_widget_pressed |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |The user pressed the "add widget" button.  |[1](https://github.com/mozilla-mobile/fenix/pull/10958)||2020-09-01 |
+| search_widget_cfr.canceled |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |The user dismissed the search widget cfr by tapping outside of the prompt  |[1](https://github.com/mozilla-mobile/fenix/pull/10958)||2020-09-01 |
+| search_widget_cfr.displayed |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |The search widget cfr was displayed.  |[1](https://github.com/mozilla-mobile/fenix/pull/10958)||2020-09-01 |
+| search_widget_cfr.not_now_pressed |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |The user pressed the "not now" button.  |[1](https://github.com/mozilla-mobile/fenix/pull/10958)||2020-09-01 |
 | sync_account.closed |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |A user closed the sync account page  |[1](https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532)||2020-09-01 |
 | sync_account.opened |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |A user opened the sync account page  |[1](https://github.com/mozilla-mobile/fenix/pull/2745#issuecomment-494918532)||2020-09-01 |
 | sync_account.send_tab |[event](https://mozilla.github.io/glean/book/user/metrics/event.html) |A user sent the current tab to another FxA device  |[1](https://github.com/mozilla-mobile/fenix/pull/5106)||2020-09-01 |
@@ -233,6 +237,7 @@ The following metrics are added to the ping:
 | metrics.has_top_sites |[boolean](https://mozilla.github.io/glean/book/user/metrics/boolean.html) |A boolean that indicates if the user has top sites  |[1](https://github.com/mozilla-mobile/fenix/pull/9556)||2020-09-01 |
 | metrics.mozilla_products |[string_list](https://mozilla.github.io/glean/book/user/metrics/string_list.html) |A list of all the Mozilla products installed on device. We currently scan for: Firefox, Firefox Beta, Firefox Aurora, Firefox Nightly, Firefox Fdroid, Firefox Lite, Reference Browser, Reference Browser Debug, Fenix, Focus, and Lockwise.  |[1](https://github.com/mozilla-mobile/fenix/pull/1953/), [2](https://github.com/mozilla-mobile/fenix/pull/5216)||2020-09-01 |
 | metrics.search_count |[labeled_counter](https://mozilla.github.io/glean/book/user/metrics/labeled_counters.html) |The labels for this counter are `<search-engine-name>.<source>`.  If the search engine is bundled with Fenix `search-engine-name` will be the name of the search engine. If it's a custom search engine (defined: https://github.com/mozilla-mobile/fenix/issues/1607) the value will be `custom`.  `source` will be: `action`, `suggestion`, `widget` or `shortcut` (depending on the source from which the search started). Also added the `other` option for the source but it should never enter on this case.  |[1](https://github.com/mozilla-mobile/fenix/pull/1677), [2](https://github.com/mozilla-mobile/fenix/pull/5216), [3](https://github.com/mozilla-mobile/fenix/pull/7310)||2020-09-01 |
+| metrics.search_widget_installed |[boolean](https://mozilla.github.io/glean/book/user/metrics/boolean.html) |Whether or not the search widget is installed  |[1](https://github.com/mozilla-mobile/fenix/pull/10958)||2020-09-01 |
 | metrics.toolbar_position |[string](https://mozilla.github.io/glean/book/user/metrics/string.html) |A string that indicates the new position of the toolbar TOP or BOTTOM  |[1](https://github.com/mozilla-mobile/fenix/pull/6608)||2020-09-01 |
 | metrics.top_sites_count |[counter](https://mozilla.github.io/glean/book/user/metrics/counter.html) |A counter that indicates how many top sites a user has. This value will only be set if the user has at least *one* top site. If they have 0, this ping will not get sent, resulting in a null value. To disambiguate between a failed `top_sites_count` ping and 0 top sites, please see `has_top_sites`.  |[1](https://github.com/mozilla-mobile/fenix/pull/9556)||2020-09-01 |
 | perf.awesomebar.bookmark_suggestions |[timing_distribution](https://mozilla.github.io/glean/book/user/metrics/timing_distribution.html) |Duration of a bookmarks awesomebar suggestion query.  |[1](https://github.com/mozilla-mobile/fenix/pull/10276#pullrequestreview-411101979)||2020-09-15 |