Button List
This file contains a list of every button (checkbox, button, link, menulist, etc.) available in the default Prefbar installation, along with information on using each. All items are listed in the order in which they appear when first installed.
Nav Buttons: | Back | Forward | Reload | Stop | Home |
Pref Checks: | Fonts | Colors | System Colors | Images | Animation | JavaScript | Java | Popups | Proxies | Proxy Menulist | Cookies | Cookie Warning | Proxylist |
Dev Checks: | Pipelining | Disk Cache | Mem Cache | Send Referrer |
Dev Buttons: | Clear Mem Cache | Clear Disk Cache | Clear Cache | Clear History | Clear Location Bar | Clear Cookies | Clear All |
Resize Menulist: | Resize |
New Tab: | New Tab |
Save Page: | Save Page |
Restore Tab: | Restore Tab |
Kill Flash: | Kill Flash | Flash |
Font Size: | Font - | Font + |
UA Menulist: | User Agent |
Help Links: | Help | What's New |
Web Links: | XulPlanet.com | Mozilla.org | MozillaZine.org | MozillaNews.org |
Cust Button: | Customize |
Hide Button: | Hide Toolbar |
Demo: | executedemo1 | executedemo2 |
Back
This is a very simple back button that takes you to the previous page in your browser history, just like the back button on the navigation toolbar. Unlike the back button on the navigation toolbar however, this button doesn't have a history drop down menu, doesn't have an icon, and doesn't become disabled when there is no page to go back to. Like I said, it's just a simpe back button.
Forward
This is a very simple forward button, just like the very simple back button described above. All limitations mentioned there also apply here.
Reload
This is a very simple reload button, to go with the very simple back button and the very simple forward button. Unlike the aforementioned other two, this button actually has all the functionality of its navigation bar equivlent, meaning that you can click it with shift to get a cacheless reload, or just click it for a regular reload.
Stop
A very simple stop button to finish off the group. This doesn't have observers setup either, so it will be enabled even when navigator is not currently doing anything (at which time clicking it will have absolutely no effect whatsoever).
Separator
This is a separator to go between the navigation buttons and the home button (or whatever else you put to the the right of the navigation buttons). There are several separators defined in the prefbar button list, one for each group of items. They do take a small amound of horizontal space on the toolbar, but they make things look so nice that I'd recomend having them enabled, unless you have a really small moniter (or just want to enabled a large number of buttons at once.)
Home
Although this button doesn't look as nice as the real home button (it doesn't have the icon, at least not yet) clicking it will bring you to your homepage just as fast.
Separator
A separator designed to go to the right of the home button. You can (of course) move this to where ever place on the toolbar you want.
Fonts
This toggles the "Allow documents to use other fonts" preferences. When you encounter a webpage with really horrible font settings, turn this off to have the page rendered with normal fonts instead.
Colors
Perhaps the most useful checkbox of them all, this turns off author specified colors, rendering everything with your defaults instead. Just because some moron thinks that yellow text on a red background looks good doesn't mean you should have to read it like that. From now on, you don't.
System Colors
Toggles between the colors chosen in the prefs dialog and your system colors. Only useful when the Colors pref is turned off.
Images
This switches the image loading pref from "Accept all images" when enabled, to "Don't load any images" when disabled. You have to either set this before loading a page or reload the page after changing the pref. (I have no idea why this one doesn't work automatically like the fonts and colors prefs; it's probably a bug, but I don't know the number.)
Animation
This switches controls whether animated images are allowed. It does not affect other kinds of animation such as Javascript or Flash. You have to either set this before loading a page or reload the page after changing the pref.
JavaScript
Enables or disables JavaScript. This can be very useful at times. Note that--like all preferences--this is global, so turning it off in one browser window or tab will disable JavaScript for the entire product.
Java
Enables or disables Java. Personally, I like to leave java off most of the time, and only turn it on when I encounter a java applet that I really need. That way I don't have to deal with java based advertisements, or wait for java to load before viewing a page containing one.
Flash
This is a checkbox to completely deactivate flash if it isn't needed. Flash is deactivated by renaming the flash plugin, which seems to be the only way to get rid of that plugin. If you run a multiuser system you have to move the plugin to your plugins directory in your profile to be able to use this checkbox (~/.mozilla/plugins).
Popups
Toggles the "Open unrequested windows" pref. I have heard that there are still some popups that can get through this, but I don't know any details. This was called "onLoad Popups" in the original PrefBar (version 1.x).
Proxies
This switches the proxy settings between "No Proxies" (disabled) and "Manual Proxy Configuration" (enabled). You need to have the proxy info setup in the preferences dialog in order to use this. If you need to use an automatic proxy configuration, see the next item.
Proxy Menulist
This allows you to chose which type of proxy you currently need. You need to have the info setup in the preferences dialog for whatever type(s) of proxies you plan to use.
Cookies
This toggles the cookie preferences from "Enable all cookies" (enabled) to "Disable cookies" (disabled).
Cookie Warning
When turned on, mozilla will put up a warning dialog before any site it allowed to store a cookie or modify a cookie.
Pipelining
Enables or disables http pipelining. This is supposed to speed up page loads over dialup, but not all servers support it.
Disk Cache
This toggles the disk cache on and off. This might require a restart to work.
Mem Cache
Toggles the memory cache on and off. This might require a restart to work.
Send Referrer
When disabled, mozilla will not send referrer url information with page requests.
Separator
Another separator.
Clear Mem Cache
This clears mozilla's memory cache, except for XUL chrome items.
Clear Disk Cache
This clears mozilla's disk cache. Good for testing web pages.
Clear Cache
This clears mozilla's memory chache and disk cache, just like clicking "Clear Mem Cache" and then clicking "Clear Disk Cache".
Clear History
Clears mozilla's global browser history.
Clear Location Bar
Clears the history of urls you typed into the location bar.
Clear Cookies
Clears all Cookies.
Clear All
Clears the History, the Location Bar, Disk Cache, and Memory Cache.
Separator
Another separator.
Resize
Resizes the browser window to the resolution you select in the menulist.
Separator
Another separator.
New Tab
Opens a new browser tab. I don't really know how useful this would be, but somebody wanted it so I put it in.
Separator
Another separator.
Save Page
Click this button to save the current page on disk. Much like "File -> Save as" in Mozilla, but this button uses the title to generate the default filename!
Restore Tab
This button will restore up to 10 of the last closed tabs including the "Back" and "Forward" History.
Kill Flash
Click this button to remove all flash embeds in the current page. This was the number one requested feature in 2.0.
Separator
Another separator.
Font -
Decrease the font size.
Font +
Increase the font size.
Separator
Another separator.
User Agent
This allows you to quickly change mozilla's user agent string, which is useful when viewing sites that attempt to block non-IE browsers. This works for all server side and some client side detectors.
The PrefBar automatically resets your user agent to the default (correct) value when you exit mozilla. This prevents you from running into bug 83376 (unless mozilla crashes), and makes sure you don't forgot that you changed the UA string and leave it spoofed for three weeks.
Spacer
This widget doesn't display anything, but expands as big as it can, taking up all the extra space available and forcing everything to its right to the far right edge of the toolbar.
Separator
A separator for the left edge of the help links (after the spacer).
Help
A link to the index page of this help system.
What's New
A link to the What's New in 2.0 page in this help system.
Separator
A separator for the left edge of the web links.
XulPlanet.com
A link to XulPlanet.com, where you can learn to make cool XUL apps (like this one).
Mozilla.org
A link to mozilla.org, homepage of the mozilla project.
MozillaZine.org
A link to MozillaZine.org, gathering place for mozila developers and users.
MozillaNews.org
A link to MozillaNews.org, for the latest mozilla related news from around the web. :)
Separator
A separator for the left edge of the customize button.
Customize
This will quickly take you to the preferences toolbar customization panel in the preferences dialog.
Separator
Another separator.
Hide Toolbar
A button to hide the preferences toolbar. Does the same thing as pressing F8.
Proxylist
A list where you can add some proxies you need with the needed ports. This makes it easy to switch between the proxies.
Language list
Enables to configure the language identifier sent to webservers.
Execute Demo Buttons
The Buttons "executedemo1" and "executedemo2" demonstrate how to execute external applications with the new prefbarExecute.
executedemo1: shows how to execute applications without giving command line arguments to it.
executedemo2: shows how to execute applications and give an array with command line arguments to it.
That should be all of them. If you notice any errors in this file, be sure to let me know.