View source for User:P.A./Panel-based Download Manager/Status

This is your friendly feature status page!

<div style="margin: 1em 0px; border: 2px solid orange; padding: 1em; background-color: #FFC; text-align: center;">
'''If you want to help with testing the Downloads Panel, you're in the right place!'''

Read this page in detail first, because it tells what you can expect from this experimental feature.<br>
Then feel free to share your ideas with us, with the modalities indicated below.
</div>

== BRIEF DESCRIPTION ==

The old, separate window for managing downloads has been replaced by a simpler, unobtrusive Downloads Panel integrated in the main browser window.

When you start a download, it appears in the panel, and the progress is shown in the navigation bar. When the file finishes downloading, you are discreetly notified. A single click on the finished download in the panel opens it.

[[File:DownloadsPanel-Downloading.png]]

The panel shows only your recent downloads in the current browsing session. Older downloads are accessed through the Library window, in the same way as your browsing history, and with the same search and display capabilities.

[[File:DownloadsPanel-History.png]]

The feature is still in development and has several known issues.

=== More details ===

The Downloads Panel is based on an [http://limi.net/articles/improving-download-behaviors-web-browsers original design by Alexander Limi], who is a specialist in user experience design in Mozilla. The design [http://limi.net/articles/safari-downloads/ has since been adopted by the Safari web browser for Mac] as well.

The design, and the brief description above, show how the feature should work in common cases, but a lot of other use cases and solutions were discussed. The [[User:P.A./Panel-based Download Manager|feature page]] is the place where all the design details are noted, and links to all the other technical details can be found.

You can read more about our design goals in the [[User:P.A./Panel-based Download Manager|feature page]].

<br>

== STATUS OVERVIEW ==

=== Where to find the feature ===

We recommend testing from the Nightly channel with a clean user profile.

<br>

<div style="font-size: large;">Release status as of '''April 20, 2012''':</div>

{|class="wikitable"
| [http://nightly.mozilla.org/ '''Nightly''' channel]
| Feature is present and enabled by default.<br>'''Has [[#KNOWN ISSUES|known issues]], detailed below.'''
|-
| [http://www.mozilla.org/firefox/aurora/ '''Aurora''' channel]
| Feature is not present.
|-
| [http://www.mozilla.org/firefox/beta/ '''Beta''' channel]
| Feature is not present.
|-
| [http://www.mozilla.org/firefox/ '''Release''' channel]
| Feature is not present.
|-
| [[UX_Branch|'''UX''' channel]]
| Feature is present, but not always the latest version.
|}


<div style="font-size: large;">Projected release status as of '''May 1, 2012''':</div>

{|class="wikitable"
| [http://nightly.mozilla.org/ Nightly channel]
| Feature is present and enabled by default. Has known issues.
|-
| [http://www.mozilla.org/firefox/aurora/ '''Aurora''' channel]
| '''Feature is hidden, disabled by default.<br>When enabled, has known issues and makes some data inaccessible.'''
|-
| [http://www.mozilla.org/firefox/beta/ '''Beta''' channel]
| Feature is not present.
|-
| [http://www.mozilla.org/firefox/ '''Release''' channel]
| Feature is not present.
|-
| [[UX_Branch|'''UX''' channel]]
| Feature is present and enabled by default. Has known issues.
|}


=== How to enable or disable ===

To control whether the Downloads Panel is enabled, navigate to <tt>about:config</tt> and switch the preference named '''<tt>browser.download.useToolkitUI</tt>'''.

'''The browser should be restarted after switching the preference.'''

The Library window interface is always enabled and its behavior is not controlled by this preference.

<br>

== KNOWN ISSUES ==

=== The panel won't work with custom themes ===

This is expected. Theme authors will have to update their themes to include the new stylesheets and icons.

{{note|'''The structure of the theme and required icons will change for sure in future versions of the feature.'''}}

=== Downloads that finished in previous sessions can't be opened ===

The panel is designed as a temporary notification area for downloads in the current session only. Only in-progress downloads are preserved across browsing sessions.

For downloads made in previous browsing sessions, shown in the Library window, at present you won't be able to open the target file and go to the page from which the download started.

The data required to perform these commands is just hidden, and these commands will be available in future versions. '''See {{bug|675902}} for details.'''

=== Very old items in the Downloads window will be cleaned up automatically ===

Historical downloads data was collected in the Library window, in addition to the Downloads window, starting from Firefox 11 (released [[RapidRelease/Calendar|March 13, 2012]]), and partially in Firefox 8 (released [[RapidRelease/Calendar|August 11, 2011]]). This data is separate from the list in the Downloads window.

In case you made downloads before you started using Firefox 11, and you haven't already cleaned them up in the meantime, Firefox will clean up those old downloads for you.

You'll start with an empty Downloads Panel in any case, as the panel only contains temporary notifications for the session. Historical downloads will still be visible in the Library window, when you select "Show All Downloads" from the panel.

=== The panel should display a limited number of downloads, but it doesn't ===

When the feature is used for the first time, the panel should be empty, except for active downloads. Sometimes you can see all the downloads from the old Downloads window instead. '''See {{bug|746756}} for details.'''

=== The panel should never extend to the full screen height ===

The panel should never extend to the full screen height, even if you have many active downloads. When this happens, the panel's arrow disappears and the panel is not positioned correctly.

=== Peculiar toolbar customization behavior, and several appearance issues ===

Customization of the Downloads button position doesn't work as expected. See '''{{bug|746772}}''' for one instance of the problem.

There are also several other issues related to style and appearance. '''See {{bug|726447}} for details.'''

<br>

== HOW TO SUBMIT FEEDBACK ==

# Read the feature description and the known issues.
# If you've experienced one of the known issues, you might find more information in the linked bug, if any, and contribute to the existing discussion in Bugzilla.
# If you've found what you think is a new problem, or you have a suggestion, first take a look at the '''[https://bugzilla.mozilla.org/showdependencytree.cgi?id=564934&maxdepth=1&hide_resolved=1 the full list of Downloads Panel bugs]''' to see if it's already been reported.
# If there's a new issue, [https://bugzilla.mozilla.org/enter_bug.cgi?product=Firefox&component=Downloads+Panel file a new bug in the Firefox / Downloads Panel component], and if you can, mark it as blocking bug 564934. Note that we will update the bug to block the appropriate tracking bug as we categorize it.
# If none of the above works for you, post a comment in {{bug|564934}}. We'll probably ask you to file a separate bug anyway ;-)