PrefBar Help
Introduction Using the Preferences Toolbar What's New? Button List PrefBar FAQ Credits Help/Feedback

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

Type: Button
Default Status: Hidden
Customizable: NO

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

Type: Button
Default Status: Hidden
Customizable: NO

This is a very simple forward button, just like the very simple back button described above. All limitations mentioned there also apply here.

Reload

Type: Button
Default Status: Hidden
Customizable: NO

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

Type: Button
Default Status: Hidden
Customizable: NO

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).

Type: Separator
Default Status: Hidden
Customizable: NO

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

Type: Button
Default Status: Hidden
Customizable: NO

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

Type: Separator
Default Status: Hidden
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

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

Type: Checkbox
Default Status: Visible
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

Toggles between the colors chosen in the prefs dialog and your system colors. Only useful when the Colors pref is turned off.

Images

Type: Checkbox
Default Status: Visible
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

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

Type: Checkbox
Default Status: Visible
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

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

Type: Menulist
Default Status: Hidden
Customizable: NO

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

Type: Checkbox
Default Status: Hidden
Customizable: NO

This toggles the cookie preferences from "Enable all cookies" (enabled) to "Disable cookies" (disabled).

Cookie Warning

Type: Checkbox
Default Status: Hidden
Customizable: NO

When turned on, mozilla will put up a warning dialog before any site it allowed to store a cookie or modify a cookie.

Pipelining

Type: Checkbox
Default Status: Hidden
Customizable: NO

Enables or disables http pipelining. This is supposed to speed up page loads over dialup, but not all servers support it.

Disk Cache

Type: Checkbox
Default Status: Hidden
Customizable: NO

This toggles the disk cache on and off. This might require a restart to work.

Mem Cache

Type: Checkbox
Default Status: Hidden
Customizable: NO

Toggles the memory cache on and off. This might require a restart to work.

Send Referrer

Type: Checkbox
Default Status: Hidden
Customizable: NO

When disabled, mozilla will not send referrer url information with page requests.

Separator

Type: Separator
Default Status: Visible
Customizable: NO

Another separator.


Clear Mem Cache

Type: Button
Default Status: Hidden
Customizable: NO

This clears mozilla's memory cache, except for XUL chrome items.

Clear Disk Cache

Type: Button
Default Status: Hidden
Customizable: NO

This clears mozilla's disk cache. Good for testing web pages.

Clear Cache

Type: Button
Default Status: Visible
Customizable: NO

This clears mozilla's memory chache and disk cache, just like clicking "Clear Mem Cache" and then clicking "Clear Disk Cache".

Clear History

Type: Button
Default tatus: Disabled
Customizable: NO

Clears mozilla's global browser history.

Clear Location Bar

Type: Button
Default Status: Hidden
Customizable: NO

Clears the history of urls you typed into the location bar.

Clear Cookies

Type: Button
Default Status: Hidden
Customizable: NO

Clears all Cookies.

Clear All

Type: Button
Default Status: Hidden
Customizable: NO

Clears The History, The Location Bar, Disk Cache, and Memory Cache.

Separator

Type: Separator
Default Status: Visible
Customizable: NO

Another separator.


Resize

Type: Extlist
Default Status: Hidden
Customizable: YES

Resizes the browser window to the resolution you select in the menulist.

Separator

Type: Separator
Default Status: Visible
Customizable: NO

Another separator.


New Tab

Type: Button
Default Status: Hidden
Customizable: NO

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

Type: Separator
Default Status: Visible
Customizable: NO

Another separator.


Save Page

Type: Button
Default Status: Visible
Customizable: NO

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

Type: Button
Default Status: Hidden
Customizable: NO

This button will restore up to 10 of the last closed tabs including the "Back" and "Forward" History.

Kill Flash

Type: Button
Default Status: Hidden
Customizable: NO

Click this button to remove all flash embeds in the current page. This was the number one requested feature in 2.0.

Separator

Type: Separator
Default Status: Visible
Customizable: NO

Another separator.


Font -

Type: Button
Default Status: Hidden
Customizable: NO

Decrease the font size.

Font +

Type: Button
Default Status: Hidden
Customizable: NO

Increase the font size.

Separator

Type: Separator
Default Status: Visible
Customizable: NO

Another separator.


User Agent

Type: Menulist
Default Status: Visible
Customizable: YES

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

Type: Spacer
Default Status: Visible
Customizable: NO

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

Type: Separator
Default Status: Visible
Customizable: NO

A separator for the left edge of the help links (after the spacer).

Help

Type: Link
Default Status: Visible
Customizable: NO

A link to the index page of this help system.

What's New

Type: Link
Default Status: Visible
Customizable: NO

A link to the What's New in 2.0 page in this help system.


Separator

Type: Separator
Default Status: Visible
Customizable: NO

A separator for the left edge of the web links.

XulPlanet.com

Type: Link
Default Status: Hidden
Customizable: NO

A link to XulPlanet.com, where you can learn to make cool XUL apps (like this one).

Mozilla.org

Type: Link
Default Status: Hidden
Customizable: NO

A link to mozilla.org, homepage of the mozilla project.

MozillaZine.org

Type: Link
Default Status: Hidden
Customizable: NO

A link to MozillaZine.org, gathering place for mozila developers and users.

MozillaNews.org

Type: Link
Default Status: Hidden
Customizable: NO

A link to MozillaNews.org, for the latest mozilla related news from around the web. :)


Separator

Type: Separator
Default Status: Visible
Customizable: NO

A separator for the left edge of the customize button.

Customize

Type: Button
Default Status: Visible
Customizable: NO

This will quickly take you to the preferences toolbar customization panel in the preferences dialog.


Separator

Type: Separator
Default Status: Hidden
Customizable: NO

Another separator.

Hide Toolbar

Type: Button
Default Status: Hidden
Customizable: NO

A button to hide the preferences toolbar. Does the same thing as pressing F8.

Proxylist

Type: Menulist
Default Status: Hidden
Customizable: YES

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

Type: Extlist
Default Status: Hidden
Customizable: NO (but reads the browser-internal language list)

Enables to configure the language identifier sent to webservers.

Execute Demo Buttons

Type: Button
Default Status: Hidden
Customizable: NO

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.