XUL Planet PrefBar Help
Introduction Using the Preferences Toolbar What's New in 2.2? 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 | JavaScript | Java | Popups | Proxies | Proxy Menulist | Cookies | Cookie Warning
Dev Checks:Pipelining | Disk Cache | Mem Cache | XUL Cache | Debug XUL Boxes | Send Referrer
Dev Buttons:Clear Mem Cache | Clear Disk Cache | Clear Cache | Clear History | Clear Location Bar | Clear All
Size Buttons:Resize 640x480 | Resize 800x600 | Resize 1024x768
New Tab:New Tab
Kill Flash:Kill 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

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

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

XUL Cache

Type: Checkbox
Default Status: Hidden

This toggles XUL cache. Leave this alone if you are not a XUL developer testing a XUL application.

Debug XUL Boxes

Type: Checkbox
Default Status: Hidden

Don't even think about turning this on unless you know what you're doing.

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

Type: Button
Default Status: Hidden

Resizes the browser window to 640px by 480px.

Resize 800x600

Type: Button
Default Status: Hidden

Resizes the browser window to 800px by 600px.

Resize 1024x768

Type: Button
Default Status: Hidden

Resizes the browser window to 1024px by 768px.

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.


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. It has a few problems with frames (actually, I don't think it works at all with frames) but otherwise it is extremely useful.

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.



That should be all of them. If you notice any errors in this file, be sure to let me know.