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:42] bmullan corrected value of "data" to match previous examples which named the file "x2go.server" |
— (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:// | ||
- | |||
- | ===== 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 a 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 previosly installed by the user. If not, only a white space will appear. To check wether 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 availibility. Inside the website' | ||
- | |||
- | < | ||
- | < | ||
- | < | ||
- | <script src=" | ||
- | </ | ||
- | </ | ||
- | |||
- | The javacript 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> | ||
- | </ | ||
- | </ | ||
- | </ | ||
- | </ |