Extension:GoogleWave

From MediaWiki.org

Manual on MediaWiki Extensions
List of MediaWiki Extensions

GoogleWave Release status: experimental
Implementation	Tag
Description	Makes it possible to embed Google Waves in MediaWiki
Author(s)	Micke Nordin (MickeTalk)
Last Version	0.3.3 (7 October 2009)
MediaWiki	1.15
License	GPL v.3 or later
Download	[1] [2]
Example	http://mickenordin.se/wiki/Wave
Hooks used ParserFirstCallInit
check usage (experimental)

[edit] Note

Google Waves are still experimental, and only open to a few invited people at this time so bugs may be present both in the extension code and in the Wave code itself. Waves are meant to go public later in 2009. The code have only been tested in MediaWiki v. 1.15 but might work with earlier versions too (please leave a note on the talk page if you find that it doesn't). Waves are only supported for new versions of Firefox, Google Chrome and Safari so it won't work in e.g. Internet explorer at this time (unless you use the Google Chrome Frame extension).

[edit] What can this extension do?

The GoogleWave extension makes it possible to embed Google Waves in your installation of MediaWiki using the The Google Wave Embed API.

[edit] Usage

You can use this extension to embed Waves in your wiki. This can be achieved with the wave-tag and id attribute like this:

<wave id="googlewave.com!w+iKC6DzJwC" />

Place the tag in your regular WikiML code in any page and you should be good to go (you must of course change the id to the actual id of the wave that you want to embed). At this point, there are two ways of getting the wave id from the Google wave server that I know of(and none of them are good).

1. Use the URL
   • Click on a wave in the Google Wave site, the resulting URL might look something like this: https://wave.google.com/wave/#restored:wave:googlewave.com!w%252BP9PIf1t-A
   • remove everything except googlewave.com!w%252BP9PIf1t-A
   • change the part after the exclamation mark from w%252B to: w+
   • you are done and you wave id is googlewave.com!w+P9PIf1t-A
   • Note: Sometimes Google Wave displays a dot and a digit at the end of a wave url, for example: googlewave.com!w+P9PIf1t-A.1 that dot and digit should be removed as well.
2. Use a bot
   • add blog-bot@appspot.com to you wave, it will spit out the wave id (among other things). Once you get the id you can delete the bots messages
3. Note: In the wave sandbox UI you can also get the wave-id directly:
   • Press the "Debug" link at the top of the page next to your username and select "Get current Wave ID".

The MediaWiki wave tag now supports all the attributes that a wave can handle:

• id (required)
• height
• width
• color
• bgcolor
• font
• fontsize

Only the id attribute is required how ever. You can specify a wave server with this attribute:

• waveServer

waveServer="https://wave.google.com/wave/" The extension defaults to the Google Wave server.

A full wave tag could e.g. look like this:

<wave id="googlewave.com!w+iKC6DzJwC" height="500px" width="80%" color="green" bgcolor="yellow" font="sans" fontsize="12pts" waveServer="https://wave.google.com/wave/"/>

The Google wave docs specify that only pts format works for fontsize attribute, but px seems to work ok as well.

[edit] Known Wave Servers

• https://wave.google.com/wave/ - The Google wave server
• http://wave.google.com/a/wavesandbox.com/ - The sandbox wave server
• http://pygowave.net/waves/ - PyGoWave server

[edit] Download instructions

[edit] svn

You can download the latest version of the code from svn with the command: svn checkout http://micke.googlecode.com/svn/GoogleWave GoogleWave

Make sure you issue this command from the directory $IP/extensions/.

Note: $IP stands for the root directory of your MediaWiki installation, the same directory that holds LocalSettings.php.

[edit] Archive

Download the code ^tar.gzzip, unpack the archive and place the folder named GoogleWave in $IP/extensions/.

Note: $IP stands for the root directory of your MediaWiki installation, the same directory that holds LocalSettings.php.

[edit] Installation

To install this extension, add the following to LocalSettings.php:

#GoogleWave extension
require_once("$IP/extensions/GoogleWave/GoogleWave.php");

[edit] Known issues

• There are no know bugs at this time

Should you find another bug, please report it at the talk page.

[edit] See also

• Extension:MediaWiki-Wave - A WYSIWYG interface where multiple people can edit the same MediaWiki article using Google Wave technology.