This is an old revision of the document!
x2goplugin is a Firefox plugin. It can be used to access a x2go session via a Webbrowser instead of using x2goclient.
This is a short tutorial how to integrate the x2go plugin into a website.
First of all you'll need a porperties file. This file should be stored accessible by the website, for example inside the same directory. You can choose a name by yourself, but in this tutorial the file will be called x2go.server. Please us a suitable file editor like vi for editing:
session=phoca server=localhost user=verstandk sshport=22 command=KDE rootless=false
You can choose the value “session” to whatever you like - it is just the name of the session. The value “server” should be the hostname or the IP-address of the x2goserver which should be contacted by the plugin. The value “user” can be left blank, otherwise this username will be used as login for the x2go session. The value “sshport” should be set to 22 - you should only change this if you've previously changed the sshd config of the x2goserver. You can choose the used Desktop Environment or application by changing the value “command”. You can use KDE, Gnome or any application which can be excecuted by the previosly entered user. The value “rootless” should be false for the use with whole Desktop Environments and Window Manager. If you plan to use single applications you can use this feature to use the local running window manager.
You'll need a Website to carry the plugin. Please feel free to use your own Website code. This is just a example which should be used to get started:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> <html> <head> <title>x2go Plugin</title> </head> <body> <div id="x2goplugin"> <--x2goplugin //--> </div> </body> </html>
You can use either use a
container with the help of css to set the size of the plugin or with the help of the <option></option> tag. As the plugin and a connected x2go session can be resized inside a website, we recommend using a
container for this purpose and to set the <option></option> with and height value to 100%.
<object src="location" type="application/x2go" pluginspage="http://plugin.x2go.org/index.html" pluginurl="http://plugin.x2go.org/download/x2goplugin_linux32.xpi" data="server.x2go" hidden="false" name="x2goplugin" palette="background" height="100%" hspace="0" vspace="0" width="100%"> <--x2goplugin //--> </object>
As long as you wan't to use the automatical update service (recommended), please don't change the urls used in the values“pluginspage” and “pluginurl”. The value “data” is the name of the previously created properties file. Please make sure that this file is readable by the www-data (apache) user and that you've entered the exact path to the file. In this case, the file should be inside the same directroy as the website. The value “name” is mandatory and should not be changed. If you don't want to use the
container, you shoult take care of reasonable height and width settings.