Jotlet.net Calendar Widget
Created on: Apr 17, 2008 3:32 PM by Adam Wulf - Last Modified: Oct 17, 2008 2:56 PM by Adam Wulf
Here is a simple Jotlet.net Calendar plugin that lets you show and edit any or all of your Jotlet.net calendars on your Clearspace community, homepage, or project pages.
Technologies
The simple example code here illustrates:
The Jotlet.net JavaScript API
Basics of plugin development, including i18n properties files
What's Included
plugin.xml -- Plugin descriptor required by Clearspace.
src/plugin_i18n.properties -- for simple internationalization
src/com.jivesoftware.community.widget.impl.JotletCalendarWidget.java -- The Jotlet Calendar widget class
Deploying the Plugin
To deploy the plugin manually, you can do that in one of two ways:
Just copy the plugin JAR file into the <jiveHome>/plugins directory. Your running Clearspace instance will deploy it automatically.
Open the admin console and navigate to System > Settings > Plugins, then browse for your plugin JAR file.
Viewing the Plugin
After installing the plugin, personalize your homepage and drag the Jotlet Calendar widget to a column
Edit the widget properties, and enter in your Jotlet.net API Key
Save the properties and save your homepage, enjoy!
Dependencies
none
Copyright and Licensing
Copyright 2008 Jive Software Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0 Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.
Dawn Foster
says
in response to jake.morgan:
Hi Jake,
We're working on a little bug right now that is dropping a few attachments. We should have them back up soon. If you urgently need it, let me know and I can email / ftp the files. The source can still be found in svn https://svn.jivesoftware.com/svn/dev/repos/jive/clearspace_2_0/jotlet/
Nathan Krake
says:
Hi Dawn, I've downloaded the plugin and installed it on my Clearspace 2.0.2 server. I've added the widget to my home page and created an API, which I have configured the widget with.. (so far so good).
How ever, after saving/publishing my home page, re-freshing the page, I attempt to add a calender item and get the following messages:
"loading events failed" followed by "there are no calendars that you can add events to. Please add a calendar first."
I went back to Jotlet.net and ensured that I had created the api to be able to read/write to my personal calendar..
Any suggestons?
Thanks - Nathan
Adam Wulf
says
in response to Nathan Krake:
Nathan,
When configuring the widget on your homepage, make sure that the Read-Only radio button is set to "No". The API Key needs to be set to read-write in Jotlet.net and in the Clearspace widget.
Another thought, make sure that you're setting up the domain in Jotlet.net correctly. Don't use subdomains, only the primary domain: so yourdomain.com not www.yourdomain.com.
Let me know if you continue to have trouble.
Cheers,
Adam
mrudski
says:
One thing I noticed...when trying to "edit" an event and change the description, I'm unable to do so. Is this a bug with the calendar or the widget?
Thanks.
-Marc
Nathan Krake
says
in response to Adam Wulf:
Hi Adam,
I tried your suggestions and the same result occurred.
I've documented the steps I am undertaking as perhaps I am doing something wrong?
To summarise:
1. Created a new Calendar at Jotlet.net
2. Created an API selecting the Calendar as both read only and read/write
3. Obtained the API using our domain name (no www and no subdomains)
4. Accessed clearspace admin and removed the existing Jotlet plugin.
5. Re-downloaded the plugin (above) and re-installed into Clearspace
6. Opened my personal space in Clearspace and added the jotlet widget
7. Pasted in the API and ensured that the readonly widget property was set to No
8. saved the properties and published the page
9. Received the error "loading events failed" when viewing calendar objects
I can email you a PDF of all of the screenshots if you would like.
Its such a shame as I am very keen on using it for a number of purposes..
thanks for any help
Nathan
Jeremy Castro
says:
has anyone figured out the loading problem? i've followed all the instructions but keep running into the "loading events failed". Would it make a difference if my domain is an IP address and not an actual domain name?
Adam Wulf
says
in response to Jeremy Castro:
@jeremy,
if your domain is a subdomain, only put the primary domain in for the api key, so if installing the widget on "mysub.mydomain.com", only use "mydomain.com" when setting up the api key in jotlet.
there's a bug w/ how it handles ip addresses, so if you access yours site at "111.222.333.444", then in jotlet.net, put in "333.444" as the domain.
Cheers,
Adam
Adam Wulf
says
in response to Nathan Krake:
@Nathan,
apologies for getting back to you so incredibly late - i apparently didn't set up my email notifications correctly :/
ping me on aol im and i'll walk though it with you. aim name: JotletNet
@Marc,
Yes, this is a known current bug w/ the widget
Adam Wulf
says
in response to Chris Britt:
Chris,
Jotlet does offer 2-way Outlook sync, and you can find tutorials and walkthroughs here.
I should note that while the Jotlet Plugin is officially supported by Jive, the Outlook sync is not.
Cheers
rrutan
says:
Just a note, with 2.5.1 the Jotlet Calendar will not show up in SocialGroup Personalization. Looks like you just need to update the JotletCalendarWidget to include the WidgetType.SOCIALGROUP annotaton.
Adam Wulf
says
in response to rrutan:
Thanks for the heads up - we're going to post a new version of the plugin soon that'll address this issue, as well as the ability to edit/delete events/tasks from within the widget.
Cheers
vhighland
says:
I have a question about how the calendar is displaying. I got the API working fine, but the only display option is the Month view. Is there a way to default to the List view?
Adam Wulf
says
in response to vhighland:
List view is not available in the plugin, only month, day, and event/task detail views
Cheers
Riley Bestvater
says:
Hi Adam,
Cool widget. I'm getting the "loading events failed" message too. It also does not load the events I put in the calendar. I've made APIs that are read-only and read-write as well as and API that is just read-write. I've set the readOnly radio button on the widget to No, but I still get the message.
Also I was wondering about the new version that allows edits from within clearspace. has that been released? I downloaded the widget from the Clearspace 2.5 link at the top of the page but the one I have seems to be un-editable.
Adam Wulf
says
in response to Riley Bestvater:
hey Riley,
when setting up your key in jotlet, make sure that the domain is set to just the hostname - no subdomains. use mydomain.com, not internal.mydomain.com. That should clear up the "loading events failed" message.
once the events start loading correctly, should should also be able to edit events from within the widget. The edit option is only available when the widget is in a wide column, not in a thin column.
Cheers
Riley Bestvater
says
in response to Adam Wulf:
It looks like I was using a subdomain in my domain name. However, just putting the main domain didn't fix the error. Not sure what else I'm doing wrong.
When creating the API I've set it to read-only, read-write, and read-only & read-write together. None of those combinations along with the correct domain name worked.
Nathan Krake
says
in response to Riley Bestvater:
Hi Adam/Riley,
I think I found why this issue is caused - well.. caused for me anyway..
I use the domain name format that Adam suggests - i.e. no subdomains, however, being in Australia, my domain is actually mydomain.com.au.. but I naturally made the assumption that when is was said that I could not use sub domains, but I only the primary domain - mydoman.com, I thought that this extended to mydomain.com.au..
So I would try different read/write attribute combinations when creating the API, but it alway resulted in the same error - frustrating..
By chance, we can also access our site by the primary 'mydomain.com' too (although this is not a preferred method of access).. that aside, I tried using this instead when creating the API..
I then made sure that I amended the URL (wtihin my browser) to access our site - i.e. so instead of mydomain.com.au/index.jspa - I needed to enter mydomain.com.au/index.jspa.. and bingo.. it worked..
After doing this, the API worked and I could see appointements etc - no errors..
I would expect that this might also be the same if someone's domain is mydomain.net or mydomain.org, but as I don't have these domain's registered for our site I'm not able to test..
I hope this sheds more light..
Kind regards
Nathan
innonord
says:
Hi Adam,
the jotlets calendar plugin sounds good. I just downloaded the plugin, installed it in admin and it is shown in "personalize your homepage". But I cannot drag 'n drop the plugin. But not only the jotlet ... none of the items can be drag 'n droped anymore ... before installating jotlet it worked. We use CS 2.5.3 ...
Looking foreward for your advice ... thanks!
Yours
Volker
karthik_chowdary
says
in response to innonord:
Hello-
I am getting the loading events failed when i click any day in the calendar? any suggestions to fix that issue?
Thank you-
Karthik.
Wally Rogers
says
in response to innonord:
Did the drag and drop problem get fixed with the 2.5.4 upgrade for you? We had the same problem (without jotlet) and 2.5.4 fixed it for us.
I'm here trying to determine if we should install the Jotlet pluging. Is anyone using it successfully?
karthik_chowdary
says
in response to Wally Rogers:
Hello All -
I could able to test the Jotlet Widget successfully in our test env in 2.5.3, need to test that in 2.5.4 once we upgrade. The only question i have now is that the API Key needs to be unique for each space if i am correct? Can anyone clarify me on this?
Thanks -
Karthik.
Adam Wulf
says
in response to karthik_chowdary:
If you want a different set of calendars/events to show up on different spaces, then yes you need to use a different API key. If you want the same calendars/events to show up on different spaces, then you can use the same API key. The API key is not required to be different per space.
Cheers
chris.o.bohnert@gmail.com
says
in response to Adam Wulf:
Is there a updated plugin on the horizon? One that would allow users to see the description of an event without having to go to the jotlet calendar?
Nevermind, I didn't allot enough room for the calendar widget so I didn't see the whole widget
Wally Rogers
says
in response to chris.o.bohnert@gmail.com:
Hi Adam,
Are there any directions we can point users to on how to create a new Jotlet event from within a Clearspace Space? They can click on a time and a small subject bar will come up but there is nothing to tell them how to fill out all of the details and description.
I don't want to create documentation for Jotlet and I don't see any basic information like this on the Jotlet site.
Adam Wulf
says
in response to Wally Rogers:
to fill out the description for an event and mark events as all day:
1. add the event by click/dragging on a time in day view
2. double click the new event, then click Edit Event link on the details screen
there is not a dedicated add form with all the feilds.
Cheers
Eric Butler
says:
Hi Adam...we've gotten hooked on this plugin! We were going to upgrade to SBS (3.0.3) tonight, but this is one of the critical widgets we need. Any sense for timing for an updated widget?
Alan Blake
says
in response to Alan Blake:
I downloaded the 2.5 jar file and it seems to work in my 3.0 test environment. I hesitate to push it out to production until I hear from some others.
drgoochmobile
says
in response to heatherjstrout:
willardamyl
says
in response to heatherjstrout:
Wally Rogers
says
in response to levi.watters:
We are using it in 3.0.6 now. It works the same as it did in 2.5 (not so good). (its not broken, it's just kind of klugy) The users really haven't taken to it. I would be in favor of letting the Jive programmers recreate it. It's clearly not cut from the same cloth. Users really, really liked the idea but they didn't like using Jotlet.
We also tried Google calendar integration as an alternative but it was hard for users to update collaboratively or we didn't know the secret to get that part to work. We have some issues with their terms of use for what we are trying to do anyway.
karthik_chowdary
says
in response to Wally Rogers:
I have a small question about the API key, the key seems to be good for one year after we get that from site and does anyone know what happens after 1 year?
- jotlet
- by Adam Wulf
- Compatible with 2.0.x, 2.5.x
- Last updated: 6/1/2008
-
This plugin has been certified by Jive.
What happen to the download?