This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
wiki:components:x2goplugin [2010/03/24 00:49] bmullan minor format edits |
— (current) | ||
---|---|---|---|
Line 1: | Line 1: | ||
- | ====== x2goplugin ====== | ||
- | x2goplugin is a Firefox plugin. It can be used to access a x2go session via a Webbrowser instead of using x2goclient. | ||
- | |||
- | ===== Installation of x2goplugin ===== | ||
- | |||
- | Please visit the webssite http:// | ||
- | |||
- | Currently the x2goplugin is available for the following systems: | ||
- | * Linux 32 bit | ||
- | * Linux 64 bit | ||
- | * Windows 32 bit | ||
- | |||
- | |||
- | ===== Inserting x2goplugin into a webpage ===== | ||
- | |||
- | This is a short tutorial how to integrate the x2go plugin into a website. | ||
- | |||
- | ==== create a properties file ==== | ||
- | |||
- | First of all you'll need a properties 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 (re vi, nano, gedit) for editing: | ||
- | |||
- | < | ||
- | session=phoca | ||
- | server=localhost | ||
- | user=verstandk | ||
- | sshport=22 | ||
- | command=KDE | ||
- | rootless=false | ||
- | </ | ||
- | |||
- | You can choose the value " | ||
- | |||
- | The value " | ||
- | |||
- | The value " | ||
- | |||
- | The value " | ||
- | |||
- | You can choose the used Desktop Environment or application by changing the value " | ||
- | * If you specify " | ||
- | * If you specify any application (such as: firefox) which is executable by the user then only that application will appear __without__ the entire remote desktop. | ||
- | |||
- | The value " | ||
- | |||
- | If you plan to use single applications you can use this feature to use the local running window manager. | ||
- | |||
- | ==== building a minimal website ==== | ||
- | |||
- | 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: | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | </ | ||
- | < | ||
- | <div id=" | ||
- | < | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | |||
- | You can use either use a < | ||
- | |||
- | ==== inserting the < | ||
- | |||
- | Please paste the following code inside you website inside the < | ||
- | |||
- | < | ||
- | <object src=" | ||
- | type=" | ||
- | pluginspage=" | ||
- | pluginurl=" | ||
- | data=" | ||
- | hidden=" | ||
- | name=" | ||
- | palette=" | ||
- | height=" | ||
- | hspace=" | ||
- | vspace=" | ||
- | width=" | ||
- | < | ||
- | </ | ||
- | </ | ||
- | |||
- | If you intend to utilize the automatic update service (recommended), | ||
- | |||
- | The value " | ||
- | |||
- | 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 directory as the website. | ||
- | |||
- | The value " | ||
- | |||
- | ==== checking if the plugin is already installed (and offering it if not) ==== | ||
- | |||
- | If you are visiting the created website, you'll only get a x2goplugin shown if it was previously installed by the user. If not, only a white space will appear. To check whether the plugin is installed or not, we'll need to add a javascript to the website. This too will offer the user the plugin if it wasn't installed before or inform him about the availability. | ||
- | |||
- | Inside the website' | ||
- | |||
- | You should use the plugin directly from our server to make sure that you'll get the latest version. The download url of the x2goplugin can change, because we want to store it on the Mozilla Add On site in future. Of cause you can also download the script here (http:// | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | <script src=" | ||
- | </ | ||
- | </ | ||
- | |||
- | The javascript will need to be started, so you should add the the command " | ||
- | |||
- | < | ||
- | <body onload=" | ||
- | </ | ||
- | |||
- | ==== a complete website example ==== | ||
- | |||
- | Your whole Website should be look something like this now (This site makes use of an already existing css file on our server. You can also use the <div id=" | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | < | ||
- | <link rel=" | ||
- | <script src=" | ||
- | </ | ||
- | <body onload=" | ||
- | <div id=" | ||
- | <object src=" | ||
- | type=" | ||
- | pluginspage=" | ||
- | pluginurl=" | ||
- | data=" | ||
- | hidden=" | ||
- | name=" | ||
- | palette=" | ||
- | height=" | ||
- | hspace=" | ||
- | vspace=" | ||
- | width=" | ||
- | < | ||
- | </ | ||
- | </ | ||
- | <div id=" | ||
- | < | ||
- | < | ||
- | plugin you'll be able to start or recover a session running on a x2goserver. | ||
- | The server needs to be preconfigured. | ||
- | To get more information about what x2go is, please visit <a href=" | ||
- | </p> | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | </ |