Question

I’ve read this article on MDN:

https://developer.mozilla.org/en/Places_utilities_for_JavaScript#Bookmark_Dialog
But still has no clue how to call for function like

showAddBookmarkUI()

I tried PlacesUtils.showAddBookmarkUI(), but it didn’t work.

Answer 1

This article is outdated as of Firefox 4. This functionality is now implemented in the PlacesUIUtils module, method showBookmarkDialog(). You would call it like this:

Components.utils.import("resource://gre/modules/Services.jsm");
var uri = Services.io.newURI("http://example.com/", null, null);

Components.utils.import("resource:///modules/PlacesUIUtils.jsm");
PlacesUIUtils.showBookmarkDialog({
  action: "add",
  type: "bookmark",
  uri: uri,
  title: "Example bookmark"
}, window);

This is an internal module so it isn’t really documented and the API might change again in future. You can see an example of how it is being used in the source code. Btw, if what you actually want to open is the list of bookmarks rather than the “Add Bookmark” dialog then you do it like this:

Components.utils.import("resource://gre/modules/Services.jsm");

var organizer = Services.wm.getMostRecentWindow("Places:Organizer");
if (!organizer)
{
  // No currently open places window, so open one with the specified mode.
  openDialog("chrome://browser/content/places/places.xul", 
             "", "chrome,toolbar=yes,dialog=no,resizable", "AllBookmarks");
}
else
{
  organizer.PlacesOrganizer.selectLeftPaneQuery("AllBookmarks");
  organizer.focus();
}

(code mostly copied from PlacesCommandHook implementation).