MM3-ProxySwitch - Firefox Extension (Add-ons)

In the Firefox Browser (and other Mozilla programs) you can per default configure only the setting for one internet connection. If you liked to use once a direct connection or different proxy configurations, then the dialog "Connection Settings" has respectively to be executed newly.

With the ProxySwitch you can manage different configurations and simply switch over between these.

The ProxySwitch completes ideally the WebAssistant - Proxy Offline Browser.

Installation

You still must add the symbol for the ProxySwitch to the toolbar (Menu Bar or Navigation Toolbar) now.
Click with the right mouse button on the toolbar and select the entry from the popup menu: Custumize ...
Drag the symbol ProxySwitch into the toolbar.

Note

If you use the Mozilla Suite or SeaMonkey, then the symbol

is put in the status bar automatically. You don't need as in the case of the Firefox to add the symbol manually.

Use

With a click on the symbol ProxySwitch you can change between the direct connection to the internet and a proxy configuration.

You recognize the used connection by the symbol:
- direct Internet connection
- a proxy configuration (If you don't use symbols in the Firefox, the configuration name is then highlighted in addition.)
Tool Tipp
The name of the used configuration and the name after switching are displayed.
The names indicate:
- Direct: Direct Internet connection
- Manual: Proxy configuration entered in the browser manually
You can select a proxy configuration from the popup menu.
You can edit the proxy configurations with the menu Edit.

Editor for the proxy configuration

You can use the following keywords for the configuration:

http, ssl, ftp, gopher and socks
Enter the proxy for any required protocol.
all
The same proxy is used for all protocols.
noProxy
For the given domains the proxy shall not be used.
url
A script is used for the proxy configuration.

Every configuration has a definite name and starts with the bracket [ and ends with the bracket ].
This name is displayed in the popup menu.
The bracket [ and ] as well as every keyword must be in a new line.
According to the structure in the following example.

Example

   [MM3-WebAssistant
     http=127.0.0.1:8080
     ssl =127.0.0.1:8080
     ftp =127.0.0.1:8080
     noProxy=127.0.0.1:8888
   ]
   [localProxy
     all=192.168.0.1:8080
   ]
   [provider
     http=HTTP-Proxy of you provider
   ]
   [script
     url=Automatic proxy configuration URL
   ]

Shortcut

You can define short keys to switch between different proxy configurations.

Used keywords:

modifiers alt, control, shift, accel, meta (only for Macintosh)
If you need several modifiers, then you separate these by comma.
keycode
- Only be used for printable characters e.g. a-z 0-9
- Or special code start with VK_
  See: http://developer.mozilla.org/en/docs/XUL_Tutorial:Keyboard_Shortcuts

Note

Please, restart the program after the definition.
If it shouldn't work after this, the short key is already used by another function.

Example

  [MM3-WebAssistant
    http=...

    modifiers=alt,control
    keycode=w
  ]

At the same time press the short key: <alt> <control> <w>
The proxy configuration MM3-WebAssistant is then used.

Delete browser cache

Before you use the Offline Browser WebAssistant - Proxy Offline Browser, the cache of your browser should be deleted. With the keyword clear this is carried out automatically.

Example

  [MM3-WebAssistant
    http=...
 
    clear=cache
  ]

Automation of the proxy configuration

If you use different networks with your laptop computer, then the required configuration can be determined automatically. There are two possibilities for it.

IP-Address determines proxy configuration

The IP address used currently determines the matching proxy configuration from several deposited entries.

The respective IP address is the name of the proxy configuration. If you need an area of IP addresses, then you indicate only the constant part with that the IP address starts.

Example

You use two different proxy configurations.

For the IP address: 192.168.0.1
For the IP address area: 10.0.0.0 to 10.255.255.255

Enter for this in the editor:

     [192.168.0.1
       http=...
     ]
     [10.
       http=...
     ]
     import=IP

The entry import=IP activates this function so that at every restart of the Firefox the matching proxy configuration is used.
Alternative: Use the ProxySwitch menu: Import IP

Import of the proxy configuration from the Internet Explorer

If your Internet Explorer is already configured automatically into dependence of your network environment, then you can use this configuration also in the Firefox.

This proxy configuration gets the name in the ProxySwitch: IE

Enter for this in the editor:

    import=IE

Now every restart of the Firefox imports the active proxy configuration of the Internet Explorer.
Alternative: Use the ProxySwitch menu: Import IE

Note: This function is only available in the Firefox (version 1.5 and higher) for Windows.