• Tuesday February 9th 2010
• Do you want fries with that project?

Skip to Content

gcontactsync

resources:	Home Blog Forum Wiki Downloads Preferences Bugs Screenshots Source Code FAQs Members

gContactSync - Preferences

To access the Preferences

1. Open Thunderbird if necessary
2. Go to the Tools menu and left-click on Add-ons
3. Select gContactSync from the list of add-ons and click the Preferences or Options button

Preferences

There are three tabs for preferences. The label of the preference is in bold, followed by a space and the default value in parentheses.

Main Preferences

1. Synchronize contacts automatically (checked) - Check this to enable automatic synchronization. If it is disabled, Synchronize interval and Initial sync delay are ignored and the extension will only synchronize your contacts when you click the Sync button in the toolbar of the Address Book window.
2. Synchronize Interval (30)- Choose the length of time you would like to pass between the end of one synchronization and the start of the next. Set to 0 to disable all scheduled synchronization except for the first sync when the Address Book window is open (see #3).
3. Initial Sync Delay (500) - The length of time, in milliseconds, after the Address Book opens before your contacts are synchronized. Set to 0 to disable synchronizing when the Address Book window opens. If this is set to 0, there will be no automatic syncing until you press the button manually.
4. Always update Gmail during conflicts (checked) - Check this if Gmail should be updated if a contact is updated in both Gmail and Thunderbird. In other works, give Thunderbird priority over Gmail.
5. Synchronize Groups with Mailing Lists (checked) - Check this to enable synchronizing Groups in Google Contacts with Mailing Lists in Thunderbird. Please note that mailing lists are somewhat buggy. If you delete an address book that contains a mailing list you must restart Thunderbird (not just the Address Book window) before doing anything else, especially synchronizing.
6. Request confirmation before deleting duplicates (checked) - Check this is you would like to be asked before duplicates are deleted. Google only allows one contact per e-mail address, so you cannot have two contacts with the same e-mail address. You will be asked about it until you change the offending e-mail address(es).
7. Enable Verbose Logging (checked) - Verbose logging will make synchronization take slightly longer, but it is very difficult to find the cause of errors/bugs without it enabled.
8. Enable the Sync toolbar button - gContactSync adds a toolbar button that cannot be removed like normal buttons. Uncheck this to remove the button.

Accounts

This tab will help you to add, remove, or change accounts and the address books with which they are synchronized

Extended Preferences

Google allows storing 10 custom attributes, although you cannot see them from Gmail. I suggest you leave them alone unless you are familiar with the address book source code unless you want to replace something with Custom3 or Custom4 or ask me. The values must be the name of the attribute in Thunderbird. Here are the defaults:

1. Sync extended properties (checked) - Check this to synchronize attributes that Thunderbird has, but Google doesn't. You won't be able to see them from Gmail (possibly in the future?), but it is possible to add up to 10 extra attributes.
2. WebPage1 - The work website
3. WebPage2 - The home website
4. Department - The department the contact is in at work
5. FirstName - The contact's first name
6. LastName - The last name of the contact
7. NickName - The contact's nickname
8. PreferMailFormat - The preferred mail format (unknown, HTML, or text)
9. AllowRemoteContent - A boolean value to determine if remote content is allowed from this contact
10. Custom1 - The first custom attribute
11. Custom2 - The second custom attribute