Places is a system for storing bookmarks, history, and other information about the Web. It is currently enabled in trunk builds, and debuted in Firefox 3. This document covers the design and user-interface of Places. Extension developers should read the [http://developer.mozilla.org/en/docs/Places developer documentation].
StatusQuick links:* [http://developer.mozilla.org/en/docs/Places Developer documentation] on MDC* [http://people.mozilla.org/~dietrich/places/ Doxygen-generated API documentation]* [http://people.mozilla.org/~dietrich/places-erd.png Database schema ERD]* [news://news.mozilla.org/mozilla.dev.apps.firefox mozilla.dev.apps.firefox newsgroup]* [irc://irc.mozilla.org/#places #places] on irc.mozilla.org = Timeline and History = * Initial Places implementation slated for Firefox 2. Landed for early alphas and then backed out and eventually cut from the release. [TODO: proper links and dates needed]* Project re-initialized in fall 2007, slated for Firefox 3.
* History-on-Places was enabled on the trunk in January 2007, first released in Gran Paradiso Alpha 2.
* Bookmarks-on-Places was enabled in May 2007, first released in Gran Paradiso Alpha 5.
Discussion and communication:
* [news://news.mozilla.org/mozilla.dev.apps.firefox mozilla.dev.apps.firefox newsgroup]
* [irc://irc.mozilla.org/#places #places] on irc.mozilla.org
= Goals & Objectives =
The primary objectives of this project are to:
== Performance ==
XXXdietrich - point to thunder's page, and the relevant perf bugs. Bookmarks can have a non-trivial impact on performance, see See [[Places:Performance]] for more information.
= Discussion & Implications =
** [http://groups.google.com/group/mozilla.dev.apps.firefox/browse_frm/thread/173ba1f87d7f88c2 newsgroup thread on sync]
** [http://www.foxcloud.com/Places/ ERD (possibly obsolete)]
= Archived Build Notes (obsolete) =
Milestone 2 (1/30/2006):
What's new in this build:
* Your existing history is now preserved and imported into Places.
* You can search from the Places view
* You can construct queries over your history/bookmarks and save them
* If you are migrating to Firefox from another browser, your history and bookmarks are imported into Places.
* Stability, performance, and bug fixes
Known issues:
* It is recommended that you delete the file "storage.sdb" in your profile directory if you have previously run a Places build.
* This build is based on the Firefox 2.0 branch. It still claims to be 1.5, so 1.5-compatible extensions will continue to function. Extensions that utilize the old bookmarks and history interfaces will not work correctly.
* If you use the installer, you have to do a custom install and disable Quality Feedback Agent. Otherwise, the installation will error out.
* Bookmark keywords do not work yet.
* If your profile directory is on NFS, you will see slower performance.
Milestone 1 (12/15/2005):
This is our first public milestone build. It has a working Places view, history, and bookmarks (with import). There are a few known issues:
* These builds are based on the Firefox trunk. As a result, any extensions which claim only 1.5.0.* compatibility will be disabled.
* If you use the installer, you have to do a custom install and disable Quality Feedback Agent. Otherwise, the installation will error out.
* Existing bookmarks are imported, but history is not yet imported.
* Bookmark keywords do not work yet.
* If your profile directory is on NFS, you will see slower performance.
