domingo, 25 de enero de 2009

Como agregar GoogleCalendar en TikiWiki

URacingWiki está construida sobre TikiWiki 2.2 y desde que la iniciamos hemos querido agregar un calendario. Inicialmente probamos con el calendario de TikiWiki, pero no nos resultó muy funcional para poner en el frame derecho.
Bueno.. ahora probamos con GoogleCalendar y resultó que tampoco es tan simple.. pero.. por lo menos es un poco más amigable y más rápido de editar.

Ya lo tenemos funcionando aunque nos gustaría cambiarle algunos aspectos visuales que quedarán para una segunda instancia.

A continuación va el howto de como quedó funcionando por si alguién más necesita esta info...

How To:
Para agregar el calendario ya creado previamente en Google Calendar tuvimos que instalar un Mod de TikiWiki que está disponible para instalar en la sección "Admin Mods".

El Mod necesario es: Wikiplugins-GoogleCalendar

Para empezar nos tiró un error al tratar de instalarlo:
"wiki-plugins/googlecalendar/wiki-plugins/wikiplugin_googlecalendar.php to impossible to copy"

En está pagina (>>) encontramos la descripción del problema, aunque la solución no nos sirvió tal cual está presentada.

Para solucionarlo te dice que cambies en la línea 11 del archivo: Packages/wikiplugins-googlecalendar.info.txt
la linea: "wiki-plugins/googlecalendar/wiki-plugins/wikiplugin_googlecalendar.php"
por: "wiki-plugins/googlecalendar lib/wiki-plugins/wikiplugin_googlecalendar.php"
si prestan atencion entre "googlecalendar lib" hay un espacio.
esta linea 11, tiene que tener la ruta de origen y la de destino del googlecalendar.php que se debe pasar al lib, separadas por un espacio.. pero tal como se sugiere esta linea no funciona.

A nosotros nos funcionó con la siguiente linea:
"wiki-plugins/googlecalendar/wiki-plugins/wikiplugin_googlecalendar.php lib/wiki-plugins/wikiplugin_googlecalendar.php"
dado que nuestro origen era: "wiki-plugins/googlecalendar/wiki-plugins/wikiplugin_googlecalendar.php" y no solo "wiki-plugins/googlecalendar" como se presentaba en el link.

En fin.. gracias a ese cambio quedó instalado el Mod.

Dado que era el primer Mod que utilizamos en URacingWiki, luego tuvimos dudas de como se usaba porque además no veíamos la documentación.
En realidad si vemos dentro del fichero: wikiplugin_googlecalendar.php veremos la siguiente descripción:

/*
* GOOGLE CALENDAR plugin. Embed a Google Calendar in a wiki page.
* Contributed by Rick Sapir (ricks99) for TikiWiki. Released as LGPL.
*
* Syntax:
* {GOOGLEGALENDAR(calId=XXX, width=###, height=###, view=week|month|agenda, start=1-7, title=y|n, navigation=y|n, date=y|n, tabs=y|n, calendars=y|n, bg=ffffff, border=#) /}
*
* Where:
* Required:
* calId = Your Google calendar address. You can get this from your Calendar Details page.
*
* Optional:
* width = Width (in pixels) of the embedded calendar. Default = 800.
* height = Height (in pixels) of the embedded calendar. Default = 600.
* view = Default view of the calendar: week, month, or agenda. Default = week.
* start = Starting day of the week. Default = 1 (Sunday).
* title = Show the calendar title? Default = y.
* navigation = Show the navigation buttons? Default = y.
* date = Show the calendar date range? Default = y.
* tabs = Show the tabs to switch views? Default = y.
* calendars = Show other calendars (if available, as defined by your Google account)? Default = n.
* bg = Background color (in hexadecimal format) of the calendar. Default = ffffff.
* border = Width (in pixels) of the border around the calendar. Default = 0 (no border).
* links = Show links to the XML, ICAL, and HTML for the calendar? Default = y.
*
*/


Finalmente la forma de usarlo fue la siguiente:

Creamos un Modulo con el siguiente código (y lo asignamos al frame derecho):
{GOOGLECALENDAR(calId="@group.calendar.google.com", width=165, height=300, view=month, start=2, title=n, navigation=n, date=y, tabs=n, calendars=n, bg=FFFFFF, border=0) /}

En realidad este código se puede utilizar en cualquier página de la wiki, y dado que visualmente el frame derecho no da para mucho, también lo agregamos con un tamaño de 600px en una página propia llamado Calendario y agregamos un link a la misma.

Puedes ver como queda en el frame en la portada de URacingWiki
Puedes ver como queda en una página propia en Calendario UracingWiki

Cosas a mejorar:
- deberíamos poder cambiar el lenguaje a español
- deberíamos poder quitar los textos innecesarios de abajo para que quede más corto en el frame

de momento... ya tenemos calendario. ¿Que día es la próxima carrera?

No hay comentarios:

Publicar un comentario