Mozilla Sidebar installer class
+(
+_title, //stringSidebar title
+_url, //stringSidebar URL
+_customize //stringSidebar customization
+){
+const
+INTERFACES = Components.interfaces,
+nsIRDFRemoteDataSource = INTERFACES.nsIRDFRemoteDataSource,
+nsIRDFService = INTERFACES.nsIRDFService, RDF_CID = "@mozilla.org/rdf/rdf-service;1",
+nsIRDFContainer = INTERFACES.nsIRDFContainer, CONTAINER_CID = "@mozilla.org/rdf/container;1",
+nsIProperties = INTERFACES.nsIProperties, DIR_SERV_CID = "@mozilla.org/file/directory_service;1",
+nsIIOService = INTERFACES.nsIIOService, IO_SERVICE_CID = '@mozilla.org/network/io-service;1',
+NC_NAMESPACE = 'http://home.netscape.com/NC-rdf#',
+SIDEBAR_PANEL_URN = NC_NAMESPACE + 'panel-list',
+SIDEBAR_CUR_URN = 'urn:sidebar:current-panel-list',
+SIDEBAR_3RD_URN = 'urn:sidebar:3rdparty-panel:',
+PANELS_RDF_FILE = "UPnls"; //directory services property to find panels.rdf
+const
+MSG_PANEL_IN_LIST = ' panel is already in Sidebar list\nSelect it in the Tabs > Customize Sidebar... menu',
+MSG_PANEL_REFRESHED = ' panel successfully refreshed',
+MSG_PANEL_ADDED = ' panel has been successfully added to your sidebar',
+MSG_PANEL_SOURCE = 'Sidebar datasource is busted',
+MSG_NO_RDF_FILE = 'panels.rdf file does not exist in your profile\nInstallation aborted';
+
+
+
+//================
+this.MOZ_SidebarInstaller = function //voidprivateclass constructor
+(
+title, //stringSidebar panel title
+url, //stringSidebar panel URL
+customize //stringSidebar panel customization preferences
+){
+this.className = 'MOZ_SidebarInstaller';
+this.title = title;
+this.url = url;
+this.customize = customize;
+this.setIn();
+}//
MOZ_SidebarInstaller
+
+
+
+//================
+this.setIn = function //voidprivateInstance i12n
+(){
+this.rdf = Components.classes[RDF_CID].getService(nsIRDFService);
+this.container = Components.classes[CONTAINER_CID].createInstance(nsIRDFContainer);
+this.source = this.rdf.GetDataSource(this.getSource());
+this.currentResource = this.rdf.GetResource(SIDEBAR_CUR_URN);
+this.installResource = this.rdf.GetResource(SIDEBAR_3RD_URN + this.url);
+}//setIn
+
+
+
+//================
+this.setUp = function //voidpublicInstallation execution method
+(){
+if(!this.source) return;
+this.container.Init(this.source, this.getPanelList());
+if (this.container.IndexOf(this.installResource) == -1) {
+ this.setPanelResource(this.installResource);
+ this.setPanelRefresh();
+ this.setOutput(this.title + MSG_PANEL_ADDED);
+} else {
+ this.setPanelRefresh();
+ this.setOutput(this.title + MSG_PANEL_REFRESHED);
+}
+}//setUp
+
+
+
+//================
+this.setPanelResource = function //voidpublicCreate a resource for the new panel and add it to the sidebar panel list
+(
+resource //ObjectSidebar panel RDF resource
+){
+this.setRDFTriple(resource, 'title', this.title, true);
+this.setRDFTriple(resource, 'content', this.url, true);
+if(this.customize) this.setRDFTriple(resource, 'customize', this.customize, true);
+this.container.AppendElement(resource);
+}//
setPanelResource
+
+
+
+//================
+this.setPanelRefresh = function //voidpublicRefresh Sidebar panels
+(){
+this.setRDFTriple(this.currentResource, 'refresh', 'true', true);
+this.setRDFTriple(this.currentResource, 'refresh', 'false', false);
+this.source.QueryInterface(nsIRDFRemoteDataSource).Flush();
+}//setPanelRefresh&
+/*
+We pass a "refresh" event to all sidebars observers watching for this assertion (in sidebarOverlay.js)
+*/
+
+
+
+//================
+this.getPanelList = function //ObjectpublicGet Sidebar panel resource
+(){
+var
+panelList = this.source.GetTarget(this.currentResource, this.rdf.GetResource(SIDEBAR_PANEL_URN), true);
+if(panelList) panelList.QueryInterface(INTERFACES.nsIRDFResource);
+else this.setOutput(MSG_PANEL_SOURCE);
+return panelList;
+}//getPanelList
+
+
+
+//================
+this.getSource = function //stringprivateGet the Sidebar panels.rdf datasource URL
+(){
+try{
+ var
+ dirService = Components.classes[DIR_SERV_CID].getService();
+ dirService = dirService.QueryInterface(nsIProperties);
+ var
+ sidebarFile = dirService.get(PANELS_RDF_FILE, INTERFACES.nsIFile);
+ if(!sidebarFile.exists()) throw MSG_NO_RDF_FILE;
+ var
+ ioService = Components.classes[IO_SERVICE_CID].getService(nsIIOService),
+ fileURL = ioService.newFileURI(sidebarFile);
+ fileURL = fileURL.QueryInterface(INTERFACES.nsIFileURL);
+ return fileURL.spec;
+ }
+catch(e){
+ return this.setOutput(e);
+ }
+}//getSource&
+/*
+panels.rdf file is located in the user profile directory
+If the file does not exist already, it is copied from /bin/defaults/profile/panels.rdf
+*/
+
+
+
+//================
+this.setRDFTriple = function //voidprivateSetup an assertion in the RDF datasource member
+(
+subject, //stringAssertion subject
+property, //stringAssertion property
+object, //stringAssertion object
+asserting //booleanSet or remove Assertion
+){
+this.source[asserting ? 'Assert' : 'Unassert'](subject, this.rdf.GetResource(NC_NAMESPACE + property), this.rdf.GetLiteral(object), true);
+}//
setRDFTriple
+
+
+
+//================
+this.setOutput = function //booleanprivateDump message to output console
+(
+output //stringMessage to output
+){
+var
+/*string*/out = //'[' + this.className + ']\n' +
+ output + '\n';
+window.alert(out); //dump(output);
+return null;
+}//
setOutput&
+/*
+Use either console or window alert output
+*/
+
+
+
+this.MOZ_SidebarInstaller(_title, _url, _customize);
+}//