Calendar:GDATA Provider: Difference between revisions

Jump to navigation Jump to search
no edit summary
No edit summary
Line 8: Line 8:
Note it is recommended to use the latest version of Sunbird or Lightning together with the latest Provider for Google Calendar version.
Note it is recommended to use the latest version of Sunbird or Lightning together with the latest Provider for Google Calendar version.


If you are using the latest nightly versions of Sunbird/Lightning, please use a CVS version from [ftp://ftp.mozilla.org/pub/calendar/lightning/nightly/latest-mozilla1.8 ftp.mozilla.org]
If you are using the latest nightly versions of Sunbird/Lightning, please use a comm-central version from [ftp://ftp.mozilla.org/pub/calendar/lightning/nightly/latest-comm-central ftp.mozilla.org]


==Building from CVS==
==Building from Source==
If you want to build your own copy of the provider from a CVS tree, you currently need to add the gdata directory to <code>/mozilla/calendar/providers/Makefile.in</code>. Once you have compiled, the resulting extension should be at <code>''obj-dir''/dist/xpi-stage/gdata-provider.xpi</code>
If you want to build your own copy of the provider from the comm-central tree, all you need to do is follow the [https://developer.mozilla.org/en/Comm-central_source_code_(Mercurial)#Sunbird_and_Lightning build instructions] for Sunbird/Lightning. Once you have compiled, the resulting extension should be at <code>''obj-dir''/mozilla/dist/xpi-stage/gdata-provider.xpi</code>


=Accessing your Calendar=
=Accessing your Calendar=
Line 22: Line 22:
Note that the provider does not directly use your private url. The Calendar is still accessible when you [http://www.google.com/support/calendar/bin/answer.py?answer=34576 reset your private url].
Note that the provider does not directly use your private url. The Calendar is still accessible when you [http://www.google.com/support/calendar/bin/answer.py?answer=34576 reset your private url].


You may now use this url as the ''Location'' in the new remote calendar wizard.
You may now use this url as the ''Location'' when clicking File > New > Calendar > On the Network > Google Calendar in Sunbird/Lightning. There is also a graphical tutorial available at [http://bfish.xaedalus.net/?p=239 bfish.xaedalus.net].
 
There is a graphical tutorial available at [http://bfish.xaedalus.net/?p=239 bfish.xaedalus.net].


=Bugs and Limitations=
=Bugs and Limitations=
Before reporting a bug, carefully check this list to see if the issue you are having is not a known limitation. The list is in FAQ format to make it easier to find your issue. If your question was not answered here, please add it to this page's discussion page. If you believe you have found a bug, please file it in [https://bugzilla.mozilla.org/enter_bug.cgi?product=Calendar&component=Provider:%20GData bugzilla]
Before reporting a bug, carefully check this list to see if the issue you are having is not a known limitation. The list is in FAQ format to make it easier to find your issue. If your question was not answered here, please discuss it [http://groups.google.com/group/provider-for-google-calendar/topics on the newsgroup]. If you believe you have found a bug, please file it in [https://bugzilla.mozilla.org/enter_bug.cgi?product=Calendar&component=Provider:%20GData bugzilla]
 
Also, if you are using a nightly version of Sunbird/Lightning, be sure to try the CVS version of the provider first.


==Enabling calendar.debug.log==
==Enabling calendar.debug.log==
Line 44: Line 40:


Now you have enabled the preference. If you were experiencing a problem, you will get the most debug messages if you restart the application, then do whatever you were doing again until you experience the issue. Then check out the error console ("Tools" menu).
Now you have enabled the preference. If you were experiencing a problem, you will get the most debug messages if you restart the application, then do whatever you were doing again until you experience the issue. Then check out the error console ("Tools" menu).
If you are testing CalDAV support, you should do the same steps above for the "calendar.debug.log.verbose" preference.


==I want to stay up to date on all GData Provider bugs!==
==I want to stay up to date on all GData Provider bugs!==
Line 50: Line 48:
==Calendar Access==
==Calendar Access==
===I cannot access my calendar at all!===
===I cannot access my calendar at all!===
Now this is very general. First things first: Do you see any error console messages? If not, please enable <code>calendar.debug.log</code> in the advanced config editor. You should be getting more debug messages now.
Now this is very general. First things first: Do you see any error console messages? If not, please enable <code>calendar.debug.log</code> in the advanced config editor. See above for how to do that. You should be getting more debug messages now.


Are you using a calendar nightly? (i.e 0.9pre) If so, you must use a CVS compiled version of the gdata provider, not the official release.
Are you using a calendar nightly? (i.e 1.0pre) If so, you must use a mercurial compiled version of the gdata provider, not the official release. This is also described above in this FAQ.


===I want to be able to pick my calendars from a list, is there a way to do so?===
===I want to be able to pick my calendars from a list, is there a way to do so?===
Line 60: Line 58:
For public calendars you don't need the Provider for Google Calendar. Just use the standard iCalendar Provider and the ICS feed from Google. If you want to change a public calendar, there is no way around entering your password.
For public calendars you don't need the Provider for Google Calendar. Just use the standard iCalendar Provider and the ICS feed from Google. If you want to change a public calendar, there is no way around entering your password.


===I am getting an error with nsISimpleEnumerator.getNext!===
===I want to access a friend's calendar I have access too, but I am asked for a password!===
It seems your password database is corrupted. The quick fix is to create a new profile, but this might not be an option for you. See [https://addons.mozilla.org/en-US/sunbird/discussions/comments.php?DiscussionID=1496 this discussion thread] for more details.
No problem! As long as you have this calendar added in the Google Calendar web interface, just enter your own credentials.


==Missing Features==
==Missing Features==
Line 73: Line 71:
<code>calendar.google.sendEventNotifications = true</code> When set to true, invitations are sent out to attendees on event modifications.
<code>calendar.google.sendEventNotifications = true</code> When set to true, invitations are sent out to attendees on event modifications.


<code>calendar.google.enableAttendees = false</code> When set to false (default), attendees are disabled. This is the case due to an issue with the Google Server.
<code>calendar.google.enableAttendees = false</code> When set to false, attendees are disabled. This might be needed if you experience problems when accepting invitations.
 
<code>calendar.google.sendEmailNotifications = false</code> Setting this to true allows selecting a Google Calendar when accepting an invitation you received via email. ''WARNING:'' Enabling this option may cause you to unknowingly spam all attendees with an extra invitation! Only enable this option if you know what you are doing.


===Can I create or view comments made within the Google Calendar Interface?===
===Can I create or view comments made within the Google Calendar Interface?===
Line 84: Line 84:


==Event Interaction==
==Event Interaction==
===I have set a category, but it does not show!===
===I have set a category, but when changing the event it vanishes===
Google's API does not support setting event categories, so there is no easy way to implement this for the Provider.
This could be caused due to {{bug|461995}}. I hope this will be fixed in the next version.


===I want to modify an Event but nothing happens. What am I doing wrong?===
===I want to modify an Event but nothing happens. What am I doing wrong?===
Line 94: Line 94:
===After creating a recurring event, I am having problems with alarms. Why?===
===After creating a recurring event, I am having problems with alarms. Why?===
Aside from the fact that there is no standardized scheme to store dismissing and snoozing alarms, Google doesn't allow setting certain properties on recurring events. This is especially the case for shared calendars. See bug {{bug|424185}} for details.
Aside from the fact that there is no standardized scheme to store dismissing and snoozing alarms, Google doesn't allow setting certain properties on recurring events. This is especially the case for shared calendars. See bug {{bug|424185}} for details.


===Why do all events I create or edit through Sunbird/Lightning have wrong times?===
===Why do all events I create or edit through Sunbird/Lightning have wrong times?===
Is your local timezone set up correctly in Sunbird/Lightning preferences? If not, all events you edit will have the first timezone with the same offset as the original timezone it was set in. Also, created events will use the timezone that was originally set in your timezones preference.
Is your local timezone set up correctly in Sunbird/Lightning preferences? If not, all events you edit will have the first timezone with the same offset as the original timezone it was set in. Also, created events will use the timezone that was originally set in your timezones preference.
Also if you are using windows, make sure you have all timezone upgrades installed.


===Why can't I create tasks on a Google Calendar?===
===Why can't I create tasks on a Google Calendar?===
Google doesn't support Tasks, so there is no way the provider can support them.
Google doesn't support Tasks, so there is no way the provider can support them.


==Attendees==
==Attendees==
===After updating to version 0.4, I cannot manipulate attendees, why?===
===I recieved an invitation from a friend. When trying to accept, my Google Calendars are not in the select calendar dialog, or no dialog is shown===
Due to a [http://code.google.com/p/gdata-issues/issues/detail?id=319 Server Issue], there are some major complications with attendees. Enabling them and then accepting meeting invitations in an office scenario will send reminder emails from Google 24 hours before the event to '''every non-gmail attendee'''. This can be very aggravating if you are just an attendee and not the organizer.
Accepting an invitation onto your Google Calendar can cause extra invitations being sent out to each attendee. Due to some Google Calendar limitations when adding invitations to your calendar its impossible to allow this in a way that new users will not shoot themselves in the foot.
 
If you have read and understood the issue and still want to enable attendees, you can do so by setting the <code>calendar.google.enableAttendees</code> to <code>true</code>.
 
The corresponding mozilla bug is {{bug|407961}}.
 
===I recieved an invitation from a friend and accepted it in lightning. Now there are two events in the calendar===
You probably have told google to automatically show invitations in the calendar. Currently there are some problems with correctly accepting email invitations from google.


You can turn off the "feature" to automatically show event inivitations in your calendar in the Google Calendar Settings.
If you know what you are doing, you can still re-enable this behavior. See the FAQ question regarding options.


===After accepting an invitation, the attendees all get an additional invitation from me===
===After accepting an invitation, the attendees all get an additional invitation from me===
Line 128: Line 123:
Since Google supports multiple alarms and sunbird/lightning only supports one alarm, its hard to find a good way to map between the possible alarms. The provider will read the alarm either closest to or furthest away from the event. If you change a popup alarm in sunbird/lightning, and another popup alarm gets closer  to (or further away from) the event, then the provider will read the other alarm.
Since Google supports multiple alarms and sunbird/lightning only supports one alarm, its hard to find a good way to map between the possible alarms. The provider will read the alarm either closest to or furthest away from the event. If you change a popup alarm in sunbird/lightning, and another popup alarm gets closer  to (or further away from) the event, then the provider will read the other alarm.


Another possibility is that you have set an alarm value that is not supported by Google. Currently, they only accept alarm values that are also in the Google UI. In this case, the value will be rounded to the next best value.
Another possibility is that you have set an alarm value that is not supported by Google. Currently, Google only accepts values between 5 minutes and 4 weeks before the event starts.


===I want to set more than one alarm, but the Event dialog only shows one!===
===I want to set more than one alarm, but the Event dialog only shows one!===
Since Sunbird/Lightning also does not support multiple alarms, its very hard to do so without massive UI and calendar backend changes. I'd like to fix this in calendar rather than in the provider. See {{bug|353492}} for multiple alarms support.
Since Sunbird/Lightning also does not support multiple alarms, its very hard to do so without massive UI and calendar backend changes. I'd like to fix this in calendar rather than in the provider. See {{bug|353492}} for multiple alarms support.
264

edits

Navigation menu