Google Calendar Sync 2.1

From Boru Wiki

Jump to: navigation, search

Boru's Google-vTiger Calendar Sync is designed to automatically synchronize your vTiger and Google Calendars. Events created in vTiger are immediately duplicated in the user's Google Calendar, while events created in Google are periodically imported into vTiger (up to once per minute).

Contents

User Setup

AuthSub

NOTE: If you are on a Hosted Domain (not gmail). Please login to your Google Account before beginning.

Each user can enable and disable Google Calendar Sync individually. To enable the Google Calendar Sync you must first ask Google to grant vTiger access to your Google Contact list.

  1. Login to vTiger as usual
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-106.png
  2. Go to "Tools"
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-116.png
  3. Follow the link to obtain a new session token.
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-117.png
  4. Google will take you through a sequence of login screens. These steps vary depending on your current login status with Google. Ensure that you are syncing the correct Google account and grant access.
    Note that the URL may display your server's IP address, rather than the domain name.
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-108.png
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-118.png
  5. After granting access, you may have to login to vTiger again.

Now your Google Calendar Sync is authorized to connect to your Google Calendar. However, you must configure your settings, before the sync will function.

Settings Page

  1. Go to "Tools"
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-116.png
  2. This is the Settings Page.
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-119.png

Google to vTiger Settings

You can set the defaults for how Google events are created in vtiger. Click "Save" when finished.
http://prodl01php5.borugroup.com/web2project/user_images/images/MHMILLER/SNAG-00006%201-10-2011.png

Revoking Access Privileges

You can disable the Contact Sync at any time by revoking access privileges to your Google Account.

  1. Click "My Preferences"
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-116.png
  2. Follow the link to revoke your session token.
    http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-120.png

Manually Syncing

The Calendar Sync will automatically send new vTiger Contacts to your Google Account, but you may have to run it manually if you install on a system with existing events. To do this, go to "My Preferences", the the Calendar Settings page and click the "Send to Google" button.

http://prodl01php5.borugroup.com/web2project/user_images/images/MHMILLER/SNAG-00008%201-10-2011.png

vTiger will periodically check Google for new and updated contacts. The frequency depends on what you set in your cron tab during installation. To manually retrieve Contacts from Google. Go to "My Preferences, then the Calendar Settings page and click the "Sync from GA" button.

http://prodl01php5.borugroup.com/web2project/user_images/images/MHMILLER/SNAG-00009%201-10-2011.png

Troubleshooting

Error 500

This can be caused by incorrect permissions.

Permissions should be 755 for these directories:

  • CalendarSync
  • ContactSync
  • Zend

To change permissions: 

chmod -R 644 CalendarSync
chmod -R 755 Zend

Note: In some cases you may be required to be logged in as root user.

Site Not Registered

http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-162.png

AuthSub Target Path Prefix

http://prodl01php5.borugroup.com/web2project/user_images/image/MMICHALAK/MM-163.png

Time Zone Not Correct

Matching Time Zones - Set timezone in vTiger to the same timezone in Google Calendar. 

Ex: In Google set timezone is "(GMT-06:00) Central Time" (America/Chicago). 

In vTiger set $default_timezone = 'America/Chicago' in config.inc.php

Server is redirecting the request for this address in a way that will never complete

If you get the message " Firefox has detected that the server is redirecting the request for this address in a way that will never complete." do the following:

  • Please turn off all redirects in .httaccess file
  • Change the permissions for "/modules/ConactSync/" and "/modules/CalendarSync/" to 755

Reporting Bugs

To report bugs, please contact mmichalak@boruapps.com

When filing a bug report, the more details the better. What operating system are you using? Is your Google account a Gmail account (i.e. @gmail, @googlemail) or is it a hosted domain? (i.e. @myaddress.com)

Please forward any error messages you receive. Screenshots can also help to diagnose a problem.

Retrieved from "http://wiki.boruapps.com/index.php/Google_Calendar_Sync_2.1"
Personal tools