User:P.A./Panel-based Download Manager/Status: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
m (Fix spacing)
(The final overview of the feature is now available at http://mikeconley.ca/blog/2013/04/02/downloading-stuff-in-firefox-its-better-now/)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
This is your friendly feature status page!
<div style="margin: 1em 0px; border: 2px solid orange; padding: 1em; background-color: #FFC; text-align: center; font-size: large;">
THE DOWNLOADS PANEL HAS BEEN RELEASED IN FIREFOX 20.


<div style="margin: 1em 0px; border: 2px solid orange; padding: 1em; background-color: #FFC; text-align: center;">
YOU CAN READ MORE ABOUT THE FEATURE IN THE '''[http://mikeconley.ca/blog/2013/04/02/downloading-stuff-in-firefox-its-better-now/ INTRODUCTORY BLOG POST]'''.</div>
'''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 style="margin: 1em; border: 2px solid orange; padding: 1em; background-color: #FCC;">'''The feature design has changed recently, more details below.'''</div>
</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 '''Aug 24, 2012''':</div>
 
 
{|class="wikitable"
| [http://nightly.mozilla.org/ Nightly channel]
| Feature is present with its first design, and is enabled by default. Has known issues.
|-
| [http://www.mozilla.org/firefox/aurora/ '''Aurora''' channel]
| '''Feature is hidden, disabled by default.<br>When enabled, it's the first design. It has known issues and makes some data inaccessible.'''
|-
| [http://www.mozilla.org/firefox/beta/ '''Beta''' channel]
| '''Feature is hidden, disabled by default.<br>When enabled, it's the first design. It has known issues and makes some data inaccessible.'''
|-
| [http://www.mozilla.org/firefox/ '''Release''' channel]
| '''Feature is hidden, disabled by default.<br>When enabled, it's the first design. It has known issues and makes some data inaccessible.'''
|-
| [[UX_Branch|'''UX''' channel]]
| Feature is present in its first iteration, and is enabled by default. Has known issues.
|}
 
 
<div style="font-size: large;">Projected release status as of '''Aug 28, 2012''':</div>
 
{|class="wikitable"
| [http://nightly.mozilla.org/ Nightly channel]
| Feature is present with its newest design, and is enabled by default. Has known issues.
|-
| [http://www.mozilla.org/firefox/aurora/ '''Aurora''' channel]
| '''Feature is hidden, disabled by default.<br>When enabled, it's the newest design. It has known issues and makes some data inaccessible.'''
|-
| [http://www.mozilla.org/firefox/beta/ '''Beta''' channel]
| '''Feature is hidden, disabled by default.<br>When enabled, it's the first design. It has known issues and makes some data inaccessible.'''
|-
| [http://www.mozilla.org/firefox/ '''Release''' channel]
| '''Feature is hidden, disabled by default.<br>When enabled, it's the first design. It has known issues and makes some data inaccessible.'''
|}
 
 
=== 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>
 
== RECENT CHANGES ==
 
=== The panel only displays a limited number of recent downloads ===
 
As a temporary notification area, now the panel only displays the more recently started downloads, and it doesn't obtrusively expand over the page content area anymore.
 
=== The old Downloads window temporarily replaces the new Library window view ===
 
In the final version, the Library window will provide full download management functionality. For the moment, the old Downloads window is displayed to allow management of all the ongoing downloads.
 
=== The Downloads toolbar button is always visible in the navigation bar ===
 
The button that opens the Downloads Panel is always visible in the navigation bar. When there are no recent downloads, the button gives access to the old Downloads window only. The button can be removed or moved to another toolbar manually, since the customization behavior is now the same as other buttons.
 
'''Removing the button from the toolbar now disables the panel functionality.'''
 
<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 Downloads window won't display downloads from previous sessions anymore.
 
The data required to perform these commands from the Library window 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 be empty the first time the feature is activated ===
 
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.'''
 
<br>
 
== HOW TO SUBMIT FEEDBACK ==
 
=== Help with Quality Assurance ===
 
If you want to help by running our formal test suites for new features, there is a '''[https://litmus.mozilla.org/run_tests.cgi?test_run_id=459 manual test suite]''' available.
 
=== Submit bug and test reports ===
 
# 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 ;-)

Latest revision as of 17:45, 2 April 2013

THE DOWNLOADS PANEL HAS BEEN RELEASED IN FIREFOX 20.

YOU CAN READ MORE ABOUT THE FEATURE IN THE INTRODUCTORY BLOG POST.
Retrieved from "https://wiki.mozilla.org/index.php?title=User:P.A./Panel-based_Download_Manager/Status&oldid=643316"