1347312 - Add a universal Firefox download button for non-firefox users

Status: RESOLVED INVALID

(support.mozilla.org :: Knowledge Base Software, task, P2)

Description

[Justin Crawford [:hoosteeno] [:jcrawford]]

Attachment: Screen Shot 2017-03-14 at 4.08.28 PM.png

We should add a prominent, universal "Download Firefox Now" button to SUMO. See attached screenshot for a potential placement/treatment. 

==Detailed specs==

1. The button should use a URL like this: https://www.mozilla.org/firefox/new/?utm_source=support.mozilla.org&utm_campaign=universal_cta&utm_medium=article&utm_content={{article_slug}}

In that URL I include {{article_slug}}. This is where it would be fantastic to put a urlencoded article slug. If it's possible to do so, we'll learn which SUMO articles convert the best!

2. The button should say, "Download Firefox Now".

3. The button should be everywhere for non-Firefox users.

==Measurement==

There are currently no Firefox downloads attributable to SUMO in www.mozilla.org analytics. This is probably because links from SUMO to www aren't using UTM parameters. The button should -- see detailed specs. If it does, SUMO's measurable contribution to Firefox downloads will go from 0 to some number greater than 0: Infinitely better!

==Justification==

SUMO ranks higher than www.mozilla.org in search result pages for lots of key terms that might signal a need for support, OR an intent to download. For example, SUMO often ranks higher for "private browser". If we give non-Firefox users a big obvious way to enter the Firefox download funnel from SUMO, we may help more of those users who intended to download get to the right place.

Comment 1

[Justin Crawford [:hoosteeno] [:jcrawford]]

Hi, does this seem like work we can accomplish in the near term? If it's blocked, can I help unblock it?

Comment 2

[Justin Crawford [:hoosteeno] [:jcrawford]]

:rolandtanglao, Patrick recommended I needinfo you on this. Can you help make it a priority?

Comment 3

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

Hi Justin: we are blocking working on redirects and other higher priority problems. I am hoping we (Joni and I) can get to this next week or the week after.

Comment 4

[Chris More [:cmore]]

(In reply to Roland Tanglao :rolandtanglao from comment #3)
> Hi Justin: we are blocking working on redirects and other higher priority
> problems. I am hoping we (Joni and I) can get to this next week or the week
> after.

Hi Roland. We would like to get this prioritized on your sprint as soon as possible. Given that Firefox the #1 KR result for 2017 for Mozilla and our acquisition rates have dramatically dropped in the past year, we are trying to keep the top-of-funnel from running dry because then all of the amazing Q4 product launch will have a smaller user base to impact retention. I understand that there may be other competing priorities for SUMO, but right now, the push we are getting from the highest levels is to grow Firefox's user base as quick as possible given that the Desktop Growth model is predicting this loss in acquisition will impact Mozilla mid-2017. Let me know who I need to talk to, to get this escalated.

Comment 5

[Chris More [:cmore]]

Justin: one thing that would help here is if you could create relative assets for the HTML/CSS for the download button that has the same style and copy as the /firefox/new/ download button. This will help the SUMO team take that code and put it into the CMS quicker. It could also be inline CSS as a single HTML file.

Comment 6

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

Hi Justin and Chris:

Still waiting for your download button code and assets. Once we get that, we'll take it from there. Please need info Joni and I when you have attached the download button code and assets to this bug. Until then un-needinfo'ing Joni and I.

Cheers!

...Roland

Comment 7

[Justin Crawford [:hoosteeno] [:jcrawford]]

Here's an HTML file with a button in it matching the button on /new (except slightly different copy):

https://people-mozilla.org/~jcrawford/first_dir/second_dir/third_dir/sumo-page-with-button.html

The CSS/HTML for the button starts on line 1189 of that file and looks a bit like this:

<!-- bug 1347312 button code -->

(...codez...)

<!-- end bug 1347312 button code -->

There is a script block in that code that _demonstrates_ the preferred functionality for the utm_comment parameter (it should get the page slug, which sits in the "second_dir" node on SUMO now), but we should not use that script block in production. We should either figure out how to use Lithium's templating language to inject the slug into the utm_content parameter (preferred), or omit the parameter.

This button isn't as flashy as the one I pitched above, but it is far better than nothing. We can circle back and experiment with UI treatments.

Comment 8

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

Hi Justin:

Thanks for the code!

Unfortunately we need Lithium's help to do this so we have opened a support case with them:
https://supportcases.lithium.com/5006100000AblYZ aka Case 00138183

Comment 9

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

Finally got a reply from Lithium 2 business days later:

BEGIN COPY AND PASTE from Lithium case 00138183
Created By: Chad Beatty (4/5/2017 7:53 AM)
[Recipients: Sumo Team, [e-mail]]

Hi team,

Thank you for contacting Lithium Customer Support. Creating custom components is outside of our scope of support. If you need a assistance creating a customization it would have to be scoped by our Professional Services team.

If you have the code available, you can create your own custom component on your staging environment in Studio on the Components tab:

https://support-stage.allizom.org/t5/bizapps/page/tab/community%3Astudio%3Acustom-content

We have more information on creating custom components in our documentation here:

https://community.lithium.com/t5/Components-endpoints-and-the/Create-a-custom-component/ta-p/108973

Best,
Chad

END COPY AND PASTE from Lithium case 00138183

Comment 10

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

My reply to chad

BEGIN COPY AND PASTE from Lithium case 00138183
Created By: Sumo Team (4/5/2017 11:54 AM)

Hi Chad:

Unfortunately your directions don't work
because, I think, of Lithium guru Tyson's customizations for showfor.

We'd like to place component above Tyson's custom customization
e.g. above "Customize this article" on
https://support.mozilla.org/t5/Manage-preferences-and-add-ons/How-to-change-your-default-browser-in-Windows-10/ta-p/35222
on the right sidebar but can't figure out how?

How do we do that?

Cheers!
...Roland 
END COPY AND PASTE from Lithium case 00138183

Comment 11

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

:joni please reply in the supportcase to lithium if imy reply in comment 10 is in anyway inaccurate

Comment 12

[Justin Crawford [:hoosteeno] [:jcrawford]]

Is the thread with lithium in comment 10 still open? If so can we bump it?

Comment 13

[Roland Tanglao needinfo please :rolandtanglao, :mohnkuchen, :adobo, :sinigang, :roland]

Hi :hosteeno

We've temporarily reverted back to kitsune which means we can't do the download button in Lithium until we switch back to Lithium which won't be for a few days to a few weeks. (the lithium thread in comment 10 is still open but lithium is not visible to users now, only kitsune is visible until we switch back to Lithium)

I assume you need it sooner so I'm needinfo'ing :bensternthal who can help us add a download button in Kitsune I think!

Comment 14

[Ben (:bensternthal)]

The rollback to kitsune is temporary (and is an emergency fix), we are not doing any feature development on the platform. Any work such as this should be scheduled for lithium where it will live long and prosper.

Comment 15

[madalina]

We're documenting the steps taken to implement this using the Lithium documentation and then give it another shot.

Comment 16

[Alice Wyman]

Attachment: DownloadFirefoxNow-05-18-2017.png

This bug proposed a Firefox download button for non-firefox users but a "Download Firefox Now" button is now included for all Mozilla Support KB articles on Lithium, centered above the article title, WHETHER OR NOT Firefox is used to view the page. Examples:
https://hwsfp35778.lithium.com/t5/Manage-preferences-and-add-ons/How-to-change-your-default-browser-in-Windows-10/ta-p/35222
https://hwsfp35778.lithium.com/t5/Basic-Browsing/Use-tabs-in-Firefox-for-iOS/ta-p/36406
https://hwsfp35778.lithium.com/t5/Basics/Thunderbird-and-Hotmail/ta-p/14219
 
Also, the placement of the download button is different from what was shown in attachment 8847308 [details] and https://people-mozilla.org/~jcrawford/first_dir/second_dir/third_dir/sumo-page-with-button.html which both placed the button in the right sidebar. The new location of the download button directly above the article title may confuse users, especially when viewing KB articles for products other than desktop Firefox.

Comment 17

[Alice Wyman]

Joni, Can you review this bug?  See my comment 16 above.

Comment 18

[Joni Chan]

Hi Alice,

We were trying to figure out how to move the button to the write spot and you caught it in the middle of that. We've figured it out now, so this is the layout we were going for: https://support-stage.allizom.org/t5/Bookmarks-and-Tabs/This-is-a-Test-Article/ta-p/294

Thanks for bringing this to my attention.

Comment 19

[Alice Wyman]

Hi, Joni.  Thanks for the link, which goes to a test article with the "Download Firefox Now" button in the right sidebar, above the "Customize this article" picker. (The link did require authentication but I had my "mozilla" password for the Lithium staging site saved). 

I'm still wondering if the "Download Firefox Now"  button is supposed to appear when using Firefox desktop (it does) since this bug proposed to add that button for non-Firefox users.  I'm also wondering if the "Download Firefox Now" button is going to appear in every single KB article (including Thunderbird articles, "How to contribute" articles, etc.) which it currently does at https://hwsfp35778.lithium.com/

Comment 20

[Justin Crawford [:hoosteeno] [:jcrawford]]

> I'm still wondering if the "Download Firefox Now"  button is supposed to
> appear when using Firefox desktop 

It's not necessary to show to non-Firefox users, but I wouldn't advocate blocking release of this feature waiting on user-agent detection.

> I'm also wondering if the "Download
> Firefox Now" button is going to appear in every single KB article (including
> Thunderbird articles, "How to contribute" articles, etc.) which it currently
> does at https://hwsfp35778.lithium.com/

I am in favor of encouraging non-Firefox visitors to this site to try Firefox, regardless of what page they visit. 

Update: Since this bug was filed, we have launched a completely new Firefox marketing section that has download buttons everywhere. We should point this button at the home of that section. Here's a URL for the button:

https://www.mozilla.org/firefox/?utm_source=support.mozilla.org&utm_campaign=universal_cta&utm_medium=article&utm_content={{article_slug}}

Comment 21

[Justin Crawford [:hoosteeno] [:jcrawford]]

> It's not necessary to show to non-Firefox users, but I wouldn't advocate
> blocking release of this feature waiting on user-agent detection.

Correction: "It's not necessary to show to _Firefox_ users...". It should _definitely_ be shown to non-Firefox visitors.

Comment 22

[Justin Crawford [:hoosteeno] [:jcrawford]]

Since this bug is still in flight, I'd like to improve the URL for the button. Let's make it:

https://www.mozilla.org/firefox/?utm_source=support.mozilla.org&utm_campaign=universal_cta&utm_medium=referral&utm_content={{article_slug}}

Comment 23

[John Hesling [:John99] (NeedInfo me)]

(In reply to Justin Crawford [:hoosteeno] [:jcrawford] from comment #0)
> ... 
> In that URL I include {{article_slug}}. This is where it would be fantastic
> to put a urlencoded article slug. If it's possible to do so, we'll learn
> which SUMO articles convert the best!
> ...

1.) Has anyone given this any thought yet ? 
2.) Or started drafting any new article ? 
3.) & if so where ?

I imagine adapting an existing article will not work.
A.) Existing articles on installation are multiple by platform then further OS version  specific etc articles exist.
B.) A single comprehensive article may be difficult to write and maintain. 
Far simpler to write a new short article linking to existing articles that will be maintained.
C.) Remember we need to cope with different hardware and OS versions going in and out of support.

== A list of some related Firefox KB articles & other resources == 
Remember for instance XP is eol but is supported still on esr  


    Interactive tour and main product page 

Get started with Firefox - An overview of the main features 
>https://support.mozilla.org/kb/get-started-firefox-overview-main-features
Mozilla.org product page
> https://www.mozilla.org/firefox/

    Main Platforms 

Install Firefox on your phone or tablet 
> https://support.mozilla.org/kb/install-firefox-your-phone-or-tablet
How to download and install Firefox on Windows 
>https://support.mozilla.org/kb/how-download-and-install-firefox-windows
How to download and install Firefox on Mac 
> https://support.mozilla.org/kb/how-download-and-install-firefox-mac

    Some important secondary articles 

Important - Firefox is ending support for Windows XP and Vista 
> https://support.mozilla.org/kb/end-support-windows-xp-and-vista
How to change your default browser in Windows 10 
> https://support.mozilla.org/kb/how-change-your-default-browser-windows-10
Import Bookmarks and personal data from another browser 
> https://support.mozilla.org/kb/import-bookmarks-data-another-browser
Install Firefox on your iPad, iPhone or iPod 
> https://support.mozilla.org/kb/install-firefox-your-ipad-iphone-or-ipod
Install Firefox on an Android device using Google Play 
> https://support.mozilla.org/kb/install-firefox-android-device-using-google-play
Mozilla.org Android channel 
> https://www.mozilla.org/firefox/channel/android/
We could even help the millions of users of RaspberyPi to get hold of and install Firefox
Guide: Firefox Release on Raspbian Jessie  https://www.raspberrypi.org/forums/viewtopic.php?t=153853  <== Note also open bug1254933 comment9  - Who knows they may get hold of Firefox that way as a child before they choose and buy or are bought another device that is capable of running Firefox.Introduce them to Firefox they may stick with it.

Comment 24

[madalina]

The Download Firefox button has been added as requested on Lithium prod instance (e.g https://hwsfp35778.lithium.com/t5/Install-and-Update/Update-Firefox-to-the-latest-version/ta-p/2858). 
The layout looks a bit weird as there seems to be a bug with the article header that we will file and deal with separately.

As we're currently still on our old platform so we can revisit this once we're back on Lithium.

Justin, can you also file a separate bug for an url encoded article slug? We will need to deal with these one by one.

Thanks!

Comment 25

[Alice Wyman]

Attachment: Jun7-2017LithiumKBarticle.png

(In reply to madalina from comment #24)
> The Download Firefox button has been added as requested on Lithium prod instance (e.g
> https://hwsfp35778.lithium.com/t5/Install-and-Update/Update-Firefox-to-the-latest-version/ta-p/2858). 
> The layout looks a bit weird as there seems to be a bug with the article
> header that we will file and deal with separately.
> 
> As we're currently still on our old platform so we can revisit this once
> we're back on Lithium.
> 
> Justin, can you also file a separate bug for an url encoded article slug? We
> will need to deal with these one by one.
> 
> Thanks!

Madalina, will you be filing a new bug on the display issues apparently caused by the fix for this bug, or will Justin?  Are you going to wait until we have a definite date for switching back to Lithium?  Multiple SUMO-Lithium bugs now mention the KB article display and navigation issues. 

I've attached an image of how KB articles display on Lithium as of Jun 7, 2017 which I posted to https://support.mozilla.org/en-US/forums/contributors/712475?#post-71880  along with this comment:

... there must be work being done since Lithium pages for KB articles do not display properly.  The article title and everything above it is missing! Only the "body" of the article is shown. 

Edit: You can't sign in from a KB article page or edit the article even if you are signed in. (You can go to "View article history" to find a sign-in link and an Edit button). The article comments section below the body is also missing, even when you're signed in as a contributor. 

For example, see the Font size and zoom - increase the size of web pages KB article:
https://hwsfp35778.lithium.com/t5/Personalize-Firefox/Font-size-and-zoom-increase-the-size-of-web-pages/ta-p/1377129 <snip> Just a guess but the KB article issue might be related to the "Download Firefox Now" button which was just moved from the center of the article above the Title

Comment 26

[Alice Wyman]

(from comment #25)
> 
> Madalina, will you be filing a new bug on the display issues apparently
> caused by the fix for this bug, or will Justin?  Are you going to wait until
> we have a definite date for switching back to Lithium?  Multiple
> SUMO-Lithium bugs now mention the KB article display and navigation issues. 
Never mind.  I see Joni just filed bug 1372283 on the KB article display issue.

Comment 27

[Chris More [:cmore]]

Another thing about the download button as seen in comment 24 is that the font weight is so high that the white all "download Firefox now" all runs together. It is not the easiest to read like the the font seen at https://www.mozilla.org/en-US/firefox/ or https://www.mozilla.org/en-US/firefox/new/

Comment 28

[John Hesling [:John99] (NeedInfo me)]

(For information) Although this was a temporary emergency Rollback 
Rollforward to Lithium, which has the download button may well now be at an indeterminate future date.
From bug1360005 comment17
>We have no information yet about: 1. possible date for roll forward to Lithium 2. other blockers besides the re-directs.
>We will re-evaluate possible blockers once we have a good understanding of re-direct progress.
>I will close this bug for now.

External discussion question:
> Are we now staying on Kitsune for an extended period? ...
> https://support.mozilla.org/en-US/forums/contributors/712489

Comment 29

[madalina]

Chris, can a separate bug be filed for the issue you reported please? We need to deal with these issues separately.

Thanks!

Comment 30

[Chris More [:cmore]]

(In reply to madalina from comment #29)
> Chris, can a separate bug be filed for the issue you reported please? We
> need to deal with these issues separately.
> 
> Thanks!

will do!

Comment 31

[John Hesling [:John99] (NeedInfo me)]

Justin, please be aware that that you have added a dependency to a bug that is already resolved! as fixed. 
* I am not sure that is helpful unless this bug is to be reopened. 
* Also note 
** This bug is ONLY resolved in Lithium, 
** But we are on Kitsune again now - with no indication of when we will roll forward.
** No Firefox download button will appear until and IF we roll forward to Lithium.

Comment 32

[Joni Chan]

Ben, we'd like to put the Firefox download button on article pages in addition to the Firefox product page. Please see the specs in the description.

Comment 33

[Ben (:bensternthal)]

Joni, this bug was closed as it was specific to Lithium. The bug for adding the DL button is #1385087 - that one should be complete in a week or so.