mozilla
Your Search Results

    Proxy UI

    Products

    Firefox
    • Menu: Preferences > Advanced Tab > Networking tab > Connection button.
    Thunderbird
    • Menu: Preferences > Advanced Tab > Networking tab > Connection button.
    Seamonkey
    • Menu: Preferences > Advanced group > Proxies panel
    • Menu: right-click on Offline-online button (on browser windows).
    Camino
    • Configured in OS (Networking Preferences)

    (Recently Added - some support for reading OS and account settings.)

    UI Elements

    Preferences Panel

    Overview

    The UI is based on selecting a proxy mode, then filling out any additional needed information in "related" UI.

    The "OK" button saves the preferences. The preference changes

    Selecting the proxy "mode"

    All product's Proxy preference panels share a basic design: a radio button that selects the proxy mode, then "related proxy mode" UI when needed. For the purposes of this document, "proxy mode" means both:

    • Whatever was selected in the UI (as opposed to the value of the network.proxy.type.
    • The underlying behavior.

    The currently available modes are based on "network.proxy.type".

    For example, Firefox 3:

    [ ] No Proxy
    [ ] Auto-detect proxy settings for this network
    [ ] Manual proxy configuration:
    [ ] Automatic proxy configuration URL:
    
    Behavior

    Default value:

    • "No Proxy" is selected
    • All other "type" radio buttons are enabled, but not selected.

    "related" UI elements

    Only two proxy modes have related UI.

    • Manual proxy is a list of proxy types that require a hostname and a port number.
    • Proxy autoconfiguration has a URL field and a reload button.

    When a radio button is selected, the related UI elements are enabled (and editable). The previously selected radio button becomes unselected, and the related UI of the previous button is disabled (and is not editable).

    Saving changes

    • Click "OK" to save changes to prefs.
    • Click "Cancel" to discard changes.

    The radio buttons do not map to the proxy type in order (due the evolution of the UI):

    Proxy mode "network.proxy.type"
    No Proxy (direct) network.proxy.type=0
    Auto-detect proxy settings... (WPAD) network.proxy.type=4
    Manual proxy configuration (manual) network.proxy.type=1
    Automatic proxy configuration URL (PAC) network.proxy.type=2

    Manual

    Manual allows the entry of a proxy server hostname name and server.

    The entries are on a per-protocol basis for: HTTP, SSL (https), FTP, Gopher.

    If configured, SOCKS is used as a default: If the protocol was proxyable and did not match any of the previous protocols), then use SOCKS.

    The socks version is selected by radio buttons: ( ) SOCKS v4 ( ) SOCKS v5

    "No proxy for:"

    Discussed in detail elsewhere... but should be noted that if you cut and paste from IE, the semi-colons are automatically converted to commas when you save changes (FF, TB, SM).

     

    Automatic proxy configuration URL

    Supports a URL (which is checked via URIfixup) and a reload button.

    Offline|Online "plug"

    Location

    Status bar on the right side.

    Right-click

    A menu is displayed that has the following items:

    Online (Proxy: None) Online (Proxy: Auto Discover) Online (Proxy: Auto URL) Online (Proxy: Manual) --- Proxy Configuration...

    <h7 name="Details">Details</h7> The menu should display the current proxy mode with a dot. The modes that can have an empty configuration (Auto URL and Manual) will be disabled if the prefs are blank. Selecting an enabled item sets the menu selection and the proxy mode (network.proxy.type) Selecting a disabled item is not allowed. Selecting "Proxy Configuration..." opens the Preferences panel to "Advanced > Proxies"

    (TBdescribed: changing the prefs values).

    Unfiled bug: changing proxy mode does not update the menu.

    Mouseover

    When online, the tooltip will include the current proxy mode:

    Code

    http://mxr.mozilla.org/seamonkey/sou...ityOverlay.xul

    Bugs

    Bug 243624

    Reference

    network.proxy.type

    Document Tags and Contributors

    Contributors to this page: Benc
    Last updated by: Benc,