Latest revision as of 16:24, 2 May 2013

Last updated: 2013/05/02

Elevator Pitch

Firefox OS will land on devices in specific countries at different times. This project will allow us to use the snippets area of about:home to notify users only in those countries about the availability of Firefox OS devices.

Geolocated Snippets launched in Q12013.

Overview

Code name: geolocated-snippets
Prod URL:
Stage URL:
Dev URL:
Code Repo:
L10N Repo:
Code: https://github.com/mozilla/geodude
Product Owner: Engagement; Winston Bowden
Dev Team: Web Production
IRC Channel: #snippets on irc.mozilla.com

Responsibility Assignments

Responsible: Justin Crawford
Accountable: Winston Bowden
Consulted: Privacy, Brand, IT, Security, Mike Kelly
Informed: Chris More, Chris Beard, Dave Slater, Mary Colvig, Pete Scanlon

Documentation

How does about:home decide what snippets to display?

Testing on Staging

The new client-side code is now online. This means there is a working end-to-end system ready for review. In order to exercise it, you need to take the following steps (in Firefox):

Visit https://snippets.stage.mozilla.com/ and accept the security certificate.
Navigate to about:config
Search for browser.aboutHomeSnippets.updateUrl
Change the url to https://snippets.stage.mozilla.com/%STARTPAGE_VERSION%/%NAME%/%VERSION%/%APPBUILDID%/%BUILD_TARGET%/%LOCALE%/%CHANNEL%/%OS_VERSION%/%DISTRIBUTION%/%DISTRIBUTION_VERSION%/
After saving the value, restart the browser.
Navigate to about:home.
Open the Web Developer > Web Console (ctrl+shift+k).
At the prompt (">") type the following and hit return: localStorage['snippets-last-update'] = 0
At the prompt (">") type the following and hit return: localStorage.geoLastUpdated = 0
Keep the Web Console open and refresh about:home. In the Web Console you should see a request to snippets.stage.mozilla.com and another request to geo.mozilla.com.
At the prompt (">") type the following and hit return: localStorage.geoCountry
You should see a country code derived from your IP address ("US" for United States).

You have now requested the new snippets code from the staging snippets server; and the new snippets code has made a request to the new geo server and stored the result in your browser. If you were in a country that had country specific snippets, you would see them. (There are none yet.)

To restore your browser, navigate to about:home again and modify the snippets server URL (steps 1-3 above). Its default value is:

https://snippets.mozilla.com/%STARTPAGE_VERSION%/%NAME%/%VERSION%/%APPBUILDID%/%BUILD_TARGET%/%LOCALE%/%CHANNEL%/%OS_VERSION%/%DISTRIBUTION%/%DISTRIBUTION_VERSION%/

Meetings

Considerations

Project Management

Tracking Bugs:

bug 836532

Timeline:

@@ Line 1: / Line 1: @@
+{{LastUpdated}}
+{{TOC_limit|3}}
 = Elevator Pitch =
 Firefox OS will land on devices in specific countries at different times. This project will allow us to use the snippets area of about:home to notify users only in those countries about the availability of Firefox OS devices.
+'''Geolocated Snippets launched in Q12013.'''
 == Overview ==
@@ Line 24: / Line 29: @@
 = Documentation =
+== How does about:home decide what snippets to display?==
+[[File:geolocated_snippets_flowchart.gif]]
 == Testing on Staging ==
 The new client-side code is now online. This means there is a working end-to-end system ready for review. In order to exercise it, you need to take the following steps (in Firefox):
+# Visit https://snippets.stage.mozilla.com/ and accept the security certificate.
 # Navigate to about:config
 # Search for browser.aboutHomeSnippets.updateUrl
-# Change the url to https://snippets.stage.mozilla.com....(the rest of the url that was already there)
+# Change the url to https://snippets.stage.mozilla.com/%STARTPAGE_VERSION%/%NAME%/%VERSION%/%APPBUILDID%/%BUILD_TARGET%/%LOCALE%/%CHANNEL%/%OS_VERSION%/%DISTRIBUTION%/%DISTRIBUTION_VERSION%/
 # After saving the value, restart the browser.
 # Navigate to about:home.
 # Open the Web Developer > Web Console (ctrl+shift+k).
-# At the prompt (">") enter localStorage['snippets-last-update'] = 0
+# At the prompt (">") type the following and hit return: localStorage['snippets-last-update'] = 0
-# At the prompt (">") enter localStorage.geoLastUpdated = 0
+# At the prompt (">") type the following and hit return: localStorage.geoLastUpdated = 0
-# Refresh about:home. You should see a request to snippets.stage.mozilla.com and another request to geo.mozilla.com.
+# Keep the Web Console open and refresh about:home. In the Web Console you should see a request to snippets.stage.mozilla.com and another request to geo.mozilla.com.
-# At the prompt (">") enter localStorage.geoCountry. You should see a country code derived from your IP address ("US" for United States).
+# At the prompt (">") type the following and hit return: localStorage.geoCountry
+# You should see a country code derived from your IP address ("US" for United States).
 You have now requested the new snippets code from the staging snippets server; and the new snippets code has made a request to the new geo server and stored the result in your browser. If you were in a country that had country specific snippets, you would see them. (There are none yet.)
@@ Line 46: / Line 55: @@
 = Meetings =
+* [https://webprod.etherpad.mozilla.org/geo-snippets-weekly-2013-03-27 Weekly meeting 20130327]
+* [https://webprod.etherpad.mozilla.org/geo-snippets-weekly-2013-03-20 Weekly meeting 20130320]
+* [https://webprod.etherpad.mozilla.org/geo-snippets-weekly-2013-03-13 Weekly meeting 20130313]
 * [https://webprod.etherpad.mozilla.org/geolocated-snippets-QA-2013-03-08 2013-03-08 QA Meeting]
 * [https://webprod.etherpad.mozilla.org/geo-snippets-weekly-2013-03-06 Weekly meeting 20130306]
@@ Line 62: / Line 74: @@
 Tracking Bugs:
-* {{Bug|836099}} Geolocated Snippets
+* {{Bug|836532}}
-* {{Bug|836532}} Automatically generated private tracking bug for process gates
 Timeline:

Websites/Snippets/Geolocated-Snippets: Difference between revisions