Update:RequirementsV33

From MozillaWiki
Jump to: navigation, search

« Back to Update:Remora

The goal of AMO Version 3.3 is to support Web API access to AMO content. There are two target clients of the API: Firefox 3 and extension authors.

Firefox 3

The new Add-Ons Manager for Firefox 3 includes a revised dialog that allows content from AMO to be displayed. A design walkthru depict this new set of interactions.

Add-Ons in this context refers to the triumvirate of extensions/add-ons, themes and plugins.

Add-Ons Details

ID Priority Requirement Assignee Bug/Design links
DTL-1 P1 Retrieve Add-Ons attributes laura bug 399913
  • Attributes should include:
    • name
    • type (plugin/extension/theme)?
    • description
    • thumbnail?
    • rating
    • "reviews" URL
    • "learn more" URL
    • "install" URL
DTL-2 P1 Support the UpdateInfoURL mechanism bug 395857
  • Firefox 3 now supports display of "release notes" when add-ons updates are available. More details

Add-Ons Lists

ID Priority Requirement Assignee Bug/Design links
LIST-1 P1 Retrieve a list of recommended add-ons from a single or all categories (n random results) laura bug 400715
  • Since only the first n (3? 5?) recommendations are listed, the API doesn't need to return the entire recommended set. In fact, the results should appear to be "random" so that the same list of n addons doesn't always appear at the top of the list. Note also that since the Fx 3 client will need to subtract out the already installed addons, we may want to return more than simply n.
  • Open Issue: What happens if we change the AMO design to allow for multiple recommendation lists (e.g. based on user type - new user, advanced user, extension developer, web developers, etc...)
  • Possible Answer: The reco list only returns results from the new and adv user reco lists.
  • Given : app name/version, (list of installed addons)
  • Return: list of recommended addons, link to "more results" on AMO, total number of recommended
LIST-2 P1 Retrieve a list of featured add-ons for the AMO site laura bug 400716
LIST-3 P2 Retrieve a list of new add-ons (n results) laura bug 400718

Add-Ons Search

ID Priority Requirement Assignee Bug/Design links
SRCH-1 P1 Ability to retrieve AMO search results laura bug 400719
  • Given : text query, app name/version
  • Return: list of compatible, public addons matching query
SRCH-2 P1 Limit search results to addons only or plugins only or themes only laura bug 400721

Add-Ons Ratings

ID Priority Requirement Assignee Bug/Design links
RATE-1 P2 Ability to submit/upload a user ratings of an addon laura bug 400722
  • Open Issue: Do we require login to submit a rating? How to prevent abuse if no login is collected?
  • This has been deferred until we agree on an authentication mechanism.

Extension Authors

Extension authors and developers have indicated that they are looking for more metrics and information about the current usage and popularity of their add-on on AMO. To that end, we should offer a read-only API to allow extension authors access that data.

Download Details

ID Priority Requirement Assignee Bug/Design links
DOWN-1 P1 API should be web-ready (REST) and format should be XML for easier integration into PHP and AJAX sites laura not a functional req hence no bug #
DOWN-2 P1 Retrieve Cumulative Downloads laura bug 403939
  • Parameters should include:
    • GUID or identifier for addons
    • Version number: either all versions of the addon or only the current version
    • Locale Specification: either all locales or a specific locale
    • Firefox version: either all or a specific version of Firefox {need spec}
    • OS Platform: either all or a specific OS platform {need spec}
DOWN-3 P2 Retrieve Period X Downloads
  • Parameters should include:
    • Period: enum of either {Day, Week or Month}
    • Date: specific day, specific week or specific month
DOWN-4 P2 Offer the cumulative download count for all addons versions, locales, platforms, fx versions as an RSS 1.0/RSS 2.0/ATOM feed

Usage Details

ID Priority Requirement Assignee Bug/Design links
USE-1 P1 Retrieve Period X Update Pings laura bug 405900
  • Parameters should include:
    • GUID or identifier for addons
    • Version number: either all versions of the addon or only the current version
    • Locale Specification: either all locales or a specific locale
    • Firefox version: either all or a specific version of Firefox {need spec}
    • OS Platform: either all or a specific OS platform {need spec}
    • Period: enum of either {Day, Week or Month}
    • Date: specific day, specific week or specific month

Future Ideas

  • Offer an upload API for extension authors to send their XPI to AMO
  • Offer an upload API for sites like MozDev.org to be able to send XPI's in batches (perhaps a sync API?)