Labs/Jetpack/JEP/30A

From MozillaWiki
< Labs‎ | Jetpack‎ | JEP
Jump to: navigation, search
Draft-template-image.png THIS PAGE IS A WORKING DRAFT Pencil-emoji U270F-gray.png
The page may be difficult to navigate, and some information on its subject might be incomplete and/or evolving rapidly.
If you have any questions or ideas, please add them as a new topic on the discussion page.

JEP 30 - onInstall Event

  • Champion: Aza Raskin <aza at mozilla dot com>
  • Editors: Drew <drew at mozilla dot com>
  • Status: Implementing
  • Type: API Track
  • Created: 2 Dec 2009
  • Reference Implementation: None
  • Relevant Bugs:
  • JEP Index

Introduction and Rationale

This JEP describes an API for allowing Jetpack authors to do something upon first run.

After installing a Jetpack, without some sort of instructions on how to use the features just installed, the user can feel lost, bewildered, and confused. The first-time experience is exactly when users need the greatest reassurance and instruction, which is why so many Firefox add-ons create a first-run page to explain and guide the user through the new functionality. This is a stop-gap measure before we have a better version JEP 30.

Proposal

jetpack.onInstall(function)

Upon install of the Jetpack, this function gets called.

Examples

jetpack.onInstall(function(){
  jetpack.tabs.open("http://example.com/firstRun.html" );
});


jetpack.onInstall(function(){
  jetpack.notifications.show("Use the context menu, Luke!");
});