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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

Popups

Type: Checkbox
Default Status: Hidden

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

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

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

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

Cookie Warning

Type: Checkbox
Default Status: Hidden

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

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

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

Mem Cache

Type: Checkbox
Default Status: Hidden

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

Send Referrer

Type: Checkbox
Default Status: Hidden

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

Separator

Type: Separator
Default Status: Visible

Another separator.


Clear Mem Cache

Type: Button
Default Status: Hidden

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

Clear Disk Cache

Type: Button
Default Status: Hidden

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

Clear Cache

Type: Button
Default Status: Visible

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

Clears mozilla's global browser history.

Clear Location Bar

Type: Button
Default Status: Hidden

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

Clear Cookies

Type: Button
Default Status: Hidden

Clears all Cookies.

Clear All

Type: Button
Default Status: Hidden

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

Separator

Type: Separator
Default Status: Visible

Another separator.


Resize

Type: Extlist
Default Status: Hidden

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

Separator

Type: Separator
Default Status: Visible

Another separator.


New Tab

Type: Button
Default Status: Hidden

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

Another separator.


Save Page

Type: Button
Default Status: Visible

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!

Kill Flash

Type: Button
Default Status: Hidden

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

Another separator.


Font -

Type: Button
Default Status: Hidden

Decrease the font size.

Font +

Type: Button
Default Status: Hidden

Increase the font size.

Separator

Type: Separator
Default Status: Visible

Another separator.


User Agent

Type: Menulist
Default Status: Visible

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

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

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

Help

Type: Link
Default Status: Visible

A link to the index page of this help system.

What's New

Type: Link
Default Status: Visible

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


Separator

Type: Separator
Default Status: Visible

A separator for the left edge of the web links.

XulPlanet.com

Type: Link
Default Status: Hidden

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

Mozilla.org

Type: Link
Default Status: Hidden

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

MozillaZine.org

Type: Link
Default Status: Hidden

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

MozillaNews.org

Type: Link
Default Status: Hidden

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


Separator

Type: Separator
Default Status: Visible

A separator for the left edge of the customize button.

Customize

Type: Button
Default Status: Visible

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


Separator

Type: Separator
Default Status: Hidden

Another separator.

Hide Toolbar

Type: Button
Default Status: Hidden

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

Proxylist

Type: Menulist
Default Status: Hidden

A list where you can add some proxies you need with the needed ports. This makes it easy to switch between the proxies.

Flash

Type: Checkbox
Default Status: Hidden

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

Execute Demo Buttons

Type: Button
Default Status: Hidden

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.