11-30-2006, 01:54 PM
!!! NEW FOR VERSION 2.0 !!!
SUMMARY:
This add-on provides a visual indicator of new Thunderbird mail availability in supported clients (Firefox, Sunbird) and Thunderbird itself. You MUST install this add-on in BOTH Thunderbird and supported clients as there are both client AND server portions which communicate via a TCP/IP socket.
RATIONALE:
Having recently switched from the Mozilla Suite to Firefox/Thunderbird, I was sorry to loose some aspects of the integration between browser and email. The one for which I could not find some existing add-on was the ability to show a prominent visual indicator that new mail is ready (even if not automatically downloaded).
I know that Thunderbird shows a popup message when mail is ready. But the popup may be shown and not seen if I am away from my computer at the time. I also auto-hide my windows task bar so the tray icon is not always visible. Also, since I do not automatically download new messages, I am not always aware that new mail is waiting to be downloaded.
DETAILS:
After a default installation, a new icon is added on the right side of the status bar in Thunderbird and supported clients. Icon tool tips are provided. In Firefox (Sunbird does not seem to support this currently), you may left-click the icon to start/show the default mail program (which I hope will be Thunderbird). Note: use of the left click feature only makes sense if both Firefox and Thunderbird are meant to be used on the same computer (see the thunderbirdbiff.hostname option below). In all applications, a right-click of the icon will display the version of this add-on.
If the client application is started prior to starting Thunderbird, this add-on will show an unplugged cable icon. When Thunderbird is running, you should see either a plain mail icon (indicates no new mail) or a mail icon with a flashing green arrow (indicates new mail is waiting). In case of error, an "X" icon is shown. Details of the error may be seen in the Thunderbird JavaScript Console and/or the client's Error Console.
OPTIONS:
The following options/preferences can be specified via each application's about:config display (all preferences start with "thundebirdbiff.") but the preferred method is to employ this add-on's Options panel (available from the installed add-ons/extensions list):
(a) thunderbirdbiff.hostname - each client will look for a Thunderbird server on the computer with the name specified in this string option. By default the value is "localhost", the same machine on which the client application runs. The name/IP address of a reachable, remote computer may be specified if the client application is running on a machine other than the one which runs Thunderbird. It is a good idea to try to ping the hostname you plan to specify to be sure the computer is "reachable". This option is used only by client installations. If specified in Thunderbird, it is ignored.
(b) thunderbirdbiff.port - all clients and the Thunderbird server MUST agree on the TCP/IP port via which communication will occur. By default this add-on uses the TCP/IP port 25501. You may change this integer option to a value greater than 1023 if you find the default port setting blocked or otherwise in use.
© thunderbirdbiff.intervalSeconds - each client installation will poll the Thunderbird server to check for the presence of new mail at an interval specified by this integer option. 10 seconds is the default and the minimum value permitted. This option is used only by client installations. If specified in Thunderbird, it is ignored.
(d) thunderbirdbiff.useAnimation - by default, this add-on uses an animated gif to yield a "flashing arrow" effect when new mail arrives. It is possible that animated gifs may be blocked or otherwise disabled on your computer and prevent the new mail icon from being displayed properly. By toggling the default setting of this boolean option from "true" to "false", the animated gif will be replaced with a static image.
(e) thunderbirdbiff.position - by default, this add-on will place its icon on the right of the application's status bar. Toggling this string option's value from "right" to "left" will allow you to change the icon's position. Unfortunately, different add-ons contend for these highly desired locations
on the status bar and there seems to be no way to warranty that your choice will be strictly respected after all add-ons have been loaded.
Note - a restart of the application is NOT required when changing option settings. New option settings take effect immediately.
OTHER:
Because this add-on makes use of TCP/IP sockets for communication, problems can arise if your firewall is not properly configured. If you have installed this add-on in Thunderbird and Thunderbird is running but your client installation shows only the unplugged cable icon, then be sure to check your firewall settings (after first confirming that the thunderbirdbiff.port and
thunderbirdbiff.hostname options are properly set).
Some Thunderbird settings can affect the behavior of this add-on:
(a) Tools|Account Settings|Server Settings|Check for new messages every X minutes MUST be enabled. This add-on's results are triggered by the same mechanism through which the built-in Thunderbird biff is triggered. However, the built-in Thunderbird biff does not need to be enabled for this add-on to function. But if Thunderbird is not set to check for new messages on at least one account, do not expect to see much value in this add-on.
(b) Only IMAP and POP3 accounts are checked for new mail arrival. RSS and Newsgroup accounts are ignored.
PLATFORMS:
I have personally tested version 2 of this add-on only under Windows 2000 and XP Professional. Some users have informed me that the 1.x version also worked on some linux distributions and some MAC OS. So this version may work on those platforms as well - no warranty - please let me know what you find. I have tested this add-on using the following Thunderbird email account types: pop3, IMAP, and those employing the webmail add-on.
Posted on Thu, 30 Nov 2006 08:44:09 PST at https://addons.mozilla.org/firefox/3788/
SUMMARY:
This add-on provides a visual indicator of new Thunderbird mail availability in supported clients (Firefox, Sunbird) and Thunderbird itself. You MUST install this add-on in BOTH Thunderbird and supported clients as there are both client AND server portions which communicate via a TCP/IP socket.
RATIONALE:
Having recently switched from the Mozilla Suite to Firefox/Thunderbird, I was sorry to loose some aspects of the integration between browser and email. The one for which I could not find some existing add-on was the ability to show a prominent visual indicator that new mail is ready (even if not automatically downloaded).
I know that Thunderbird shows a popup message when mail is ready. But the popup may be shown and not seen if I am away from my computer at the time. I also auto-hide my windows task bar so the tray icon is not always visible. Also, since I do not automatically download new messages, I am not always aware that new mail is waiting to be downloaded.
DETAILS:
After a default installation, a new icon is added on the right side of the status bar in Thunderbird and supported clients. Icon tool tips are provided. In Firefox (Sunbird does not seem to support this currently), you may left-click the icon to start/show the default mail program (which I hope will be Thunderbird). Note: use of the left click feature only makes sense if both Firefox and Thunderbird are meant to be used on the same computer (see the thunderbirdbiff.hostname option below). In all applications, a right-click of the icon will display the version of this add-on.
If the client application is started prior to starting Thunderbird, this add-on will show an unplugged cable icon. When Thunderbird is running, you should see either a plain mail icon (indicates no new mail) or a mail icon with a flashing green arrow (indicates new mail is waiting). In case of error, an "X" icon is shown. Details of the error may be seen in the Thunderbird JavaScript Console and/or the client's Error Console.
OPTIONS:
The following options/preferences can be specified via each application's about:config display (all preferences start with "thundebirdbiff.") but the preferred method is to employ this add-on's Options panel (available from the installed add-ons/extensions list):
(a) thunderbirdbiff.hostname - each client will look for a Thunderbird server on the computer with the name specified in this string option. By default the value is "localhost", the same machine on which the client application runs. The name/IP address of a reachable, remote computer may be specified if the client application is running on a machine other than the one which runs Thunderbird. It is a good idea to try to ping the hostname you plan to specify to be sure the computer is "reachable". This option is used only by client installations. If specified in Thunderbird, it is ignored.
(b) thunderbirdbiff.port - all clients and the Thunderbird server MUST agree on the TCP/IP port via which communication will occur. By default this add-on uses the TCP/IP port 25501. You may change this integer option to a value greater than 1023 if you find the default port setting blocked or otherwise in use.
© thunderbirdbiff.intervalSeconds - each client installation will poll the Thunderbird server to check for the presence of new mail at an interval specified by this integer option. 10 seconds is the default and the minimum value permitted. This option is used only by client installations. If specified in Thunderbird, it is ignored.
(d) thunderbirdbiff.useAnimation - by default, this add-on uses an animated gif to yield a "flashing arrow" effect when new mail arrives. It is possible that animated gifs may be blocked or otherwise disabled on your computer and prevent the new mail icon from being displayed properly. By toggling the default setting of this boolean option from "true" to "false", the animated gif will be replaced with a static image.
(e) thunderbirdbiff.position - by default, this add-on will place its icon on the right of the application's status bar. Toggling this string option's value from "right" to "left" will allow you to change the icon's position. Unfortunately, different add-ons contend for these highly desired locations
on the status bar and there seems to be no way to warranty that your choice will be strictly respected after all add-ons have been loaded.
Note - a restart of the application is NOT required when changing option settings. New option settings take effect immediately.
OTHER:
Because this add-on makes use of TCP/IP sockets for communication, problems can arise if your firewall is not properly configured. If you have installed this add-on in Thunderbird and Thunderbird is running but your client installation shows only the unplugged cable icon, then be sure to check your firewall settings (after first confirming that the thunderbirdbiff.port and
thunderbirdbiff.hostname options are properly set).
Some Thunderbird settings can affect the behavior of this add-on:
(a) Tools|Account Settings|Server Settings|Check for new messages every X minutes MUST be enabled. This add-on's results are triggered by the same mechanism through which the built-in Thunderbird biff is triggered. However, the built-in Thunderbird biff does not need to be enabled for this add-on to function. But if Thunderbird is not set to check for new messages on at least one account, do not expect to see much value in this add-on.
(b) Only IMAP and POP3 accounts are checked for new mail arrival. RSS and Newsgroup accounts are ignored.
PLATFORMS:
I have personally tested version 2 of this add-on only under Windows 2000 and XP Professional. Some users have informed me that the 1.x version also worked on some linux distributions and some MAC OS. So this version may work on those platforms as well - no warranty - please let me know what you find. I have tested this add-on using the following Thunderbird email account types: pop3, IMAP, and those employing the webmail add-on.
Posted on Thu, 30 Nov 2006 08:44:09 PST at https://addons.mozilla.org/firefox/3788/