Compare Revisions

Add-on guidelines

Change Revisions

Revision 325517:

Revision 325517 by Jorge.villalobos on

Revision 325527:

Revision 325527 by Jorge.villalobos on

Title:
Add-on guidelines
Add-on guidelines
Slug:
Addons/Add-on_guidelines
Addons/Add-on_guidelines
Tags:
"add-ons"
"Add-ons"
Content:

Revision 325517
Revision 325527
n8      These add-on guidelines were created to foster an open and n8      These add-on guidelines were created to foster an open and 
>diverse add-on developer community while ensuring an excellent us>diverse add-on developer community while ensuring an excellent us
>er experience. They apply to all add-ons and add-on updates regar>er experience. They apply to all add-ons and add-on updates regar
>dless of where they are hosted, and maalso apply to customizati>dless of where they are hosted, and also applto customizations 
>ons performed by installers that configure Firefox without using >performed by installers that configure Firefox without using an a
>an add-on. Add-ons hosted on <a class="external text" href="https>dd-on. Add-ons hosted on <a class="external text" href="https://a
>://addons.mozilla.org/" rel="nofollow">AMO</a> are subject to <a >ddons.mozilla.org/" rel="nofollow">AMO</a> are subject to <a href
>href="https://addons.mozilla.org/developers/docs/policies" title=>="https://addons.mozilla.org/developers/docs/policies" title="htt
>"https://addons.mozilla.org/developers/docs/policies">additional >ps://addons.mozilla.org/developers/docs/policies">additional poli
>policies</a>.>cies</a>.
n10    <h2>n10    <h2 id="Be_Transparent">
n16          <li>We want our users to be aware of what they are instn16          <li>We want our users to know what they are installing 
>alling so that they are not unpleasantly surprised by an add-on t>so that they are not unpleasantly surprised by changes they did n
>hey did not expect. We also want them to know what add-on to remo>ot expect. We also want them to know what to remove if they decid
>ve if they decide not to keep it. Add-ons installed through appli>e not to keep it.
>cation installers should <a class="external text" href="/en-US/do 
>cs/Adding_Extensions_using_the_Windows_Registry" rel="nofollow">u 
>se the Windows Registry</a> or equivalent global install methods  
>so that Firefox displays the opt-in screen. The opt-in screen mus 
>t not be tampered with in any way, including overlaying additiona 
>l information or images on top of it. 
17          </li>
18          <li>Add-ons installed through application installers sh
 >ould <a class="external text" href="/en-US/docs/Adding_Extensions
 >_using_the_Windows_Registry" rel="nofollow">use the Windows Regis
 >try</a> or equivalent global install methods so that Firefox disp
 >lays the opt-in screen. The opt-in screen must not be tampered wi
 >th in any way, including overlaying additional information or ima
 >ges on top of it.
n28          <li>Using the same ID for multiple products, or multipln30          <li>Using the same ID for multiple products, or multipl
>e IDs for a single product, can lead to problems with automatic u>e IDs for a single product, can lead to problems with automatic u
>pdates, as well as blocklisting conflicts. Add-ons may change the>pdates as well as blocklisting conflicts. Add-ons may change thei
>ir IDs due to ownership changes, as they commonly use an email ad>r IDs due to ownership changes, as they commonly use an email add
>dress-like format (<i>e.g.,</i> personasplus@mozilla.com).>ress-like format (<i>e.g.,</i> personasplus@mozilla.com).
n32      <li>Add-ons must not use brand names, trademarks, or other n34      <li>Add-ons must not use brand names, trademarks, or other 
>terms in ways that deceive users. Using Mozilla trademarks must f>terms in ways that deceive users. Using Mozilla trademarks must f
>ollow <a class="external text" href="http://www.mozilla.org/found>ollow <a class="external text" href="http://www.mozilla.org/found
>ation/trademarks/policy.html" rel="nofollow">our policy</a>.>ation/trademarks/policy.html" rel="nofollow">our trademark policy
 ></a>.
n34      <li>Add-ons should clearly communicate their intended purpon36      <li>Add-ons should clearly communicate their intended purpo
>se and active features, including features added through updates.>se and active features, including features introduced through upd
 >ates.
n36          <li>While we understand and support add-on developers wn38          <li>While we understand and support add-on developers w
>ho choose to monetize their products, this should not come at the>ho choose to monetize their products, this should not come at the
> expense of users' browsing experience. If an add-on inserts adve> expense of users' browsing experience. If an add-on inserts adve
>rtisements, affiliate codes, sponsored search results, or the lik>rtisements, affiliate codes, sponsored search results, or the lik
>e, into content web pages, the user should be made aware of this >e, into web pages, the user should be made aware of this when the
>when the add-on is installed. Likewise, if some features require > add-on is installed. Likewise, if some features require payment 
>payment to use, or will require payment to remain active after a >to use, or require payment to remain active after a trial period,
>trial period, users should be made aware of this.> users should be made aware of this.
n41    <h2>n43    <h2 id="Be_Respectful_to_Users">
n47          <li>Uninstalling an add-on using the regular uninstall n49          <li>Uninstalling an add-on using the regular uninstall 
>process should generally suffice. This guideline primarily applie>process should generally suffice. This guideline primarily applie
>s to changes made to preferences not specific to the add-on such >s to changes made to preferences such as the homepage, default se
>as the homepage, default search URL, network settings, and so for>arch URL, network settings, and so forth. These preferences shoul
>th. These preferences should be restored to their previous values>d be restored to their previous values when the add-on is uninsta
> when the add-on is uninstalled. Most add-ons can easily accompli>lled. Most add-ons can easily accomplish this by making such chan
>sh this by making such changes via a <a class="external text" hre>ges via a <a class="external text" href="/en-US/docs/Building_an_
>f="/en-US/docs/Building_an_Extension#Defaults_Files" rel="nofollo>Extension#Defaults_Files" rel="nofollow">default preferences file
>w">default preferences file</a>.></a>.
n53          <li>For instance, users generally do not expect an add-n55          <li>For instance, users generally do not expect an add-
>on to change the Firefox homepage. Asking users to opt-in to such>on to change the Firefox homepage. Asking users to opt-in to such
> extra changes is recommended. Making them difficult or impossibl> extra changes is recommended. Making them difficult or impossibl
>e to revert is discouraged.>e to revert is strongly discouraged.
n59          <li>Add-ons which send user data over the Internet shoun61          <li>Add-ons which send user data over the Internet shou
>ld generally provide a Privacy Policy. Bonus points if it is conc>ld generally provide a Privacy Policyideally concise and easily
>ise and easily readable.> readable.
n70    <h2>n72    <h2 id="Be_Safe">
n94          <li>It's worth stressing that PBM is about avoiding ston96          <li>It's worth stressing that PBM is about avoiding sto
>ring <i>local</i> data while browsing, not about sending data els>ring <i>local</i> data while browsing, not about sending data els
>ewhere. To learn more about PBM we recommend <a class="external t>ewhere. To learn more about PBM we recommend reading <a class="ex
>ext" href="http://ehsanakhgari.org/tag/privatebrowsing" rel="nofo>ternal text" href="http://ehsanakhgari.org/tag/privatebrowsing" r
>llow">Ehsan's blog posts</a> about it.>el="nofollow">Ehsan's blog posts</a> about it.
n99    <h2>n101    <h2 id="Be_Stable">
n107          <li>This includes features like tabbed browsing, Privatn109          <li>This includes features like tabbed browsing, Privat
>e Browsing Mode, and the location bar. Add-ons which users instal>e Browsing Mode, and the location bar. Add-ons that are specifica
>l specifically for these purposes are exempt.>lly meant to do this are exempt.
n122    <h2>n124    <h2 id="Exceptions">
n126      <li>Add-ons with the intended purpose of breaking any of thn128      <li>Add-ons can break some of these guidelines if that's th
>ese guidelines with non-malicious intent (<i>e.g.,</i> a security>eir intended purpose and there isn't malicious intent (<i>e.g.,</
> exploit proof of concept).>i> a security exploit proof of concept).
n130      <li>As add-ons can only run clean up code if they are uninsn132      <li>As add-ons can only run clean up code if they are unins
>talled while Firefox is running and they are enabled, we do not r>talled while Firefox is running and they are enabled, we do not r
>equire that they attempt to clean up after themselves when they a>equire that they attempt to clean up after themselves when they a
>re uninstalled under other circumstances. Application installers >re uninstalled under other circumstances. Application installers 
>that configure Firefox without add-ons should, however, also reve>that configure Firefox without add-ons should revert any changes 
>rt any changes when uninstalled.>when uninstalled.
n138    <h2>n140    <h2 id="Enforcement">
t145      The Add-ons Team will do their best to contact the add-on'st147      The Add-ons Team will do their best to contact the add-on's
> developers and provide a reasonable time frame for the problems > developers and provide a reasonable time frame for the problems 
>to be corrected before a block is put in place. Exceptions are ma>to be corrected before a block is put in place. If an add-on is c
>de only for add-ons which are considered malicious, or whose deve>onsidered malicious or its developers have proven unreachable or 
>lopers have proven unreachable or unresponsive, in which case blo>unresponsive, blocklisting may be immediate.
>cklisting may be immediate. 

Back to History