-
Notifications
You must be signed in to change notification settings - Fork 453
GuiUrls
GUI URLs is a mechanism that projects to pass URLs to the client, for display as hyperlinks in the GUI. These links will be shown when the project is selected in the Projects tab. To use this feature, include a file 'gui_urls.xml' in the project root directory, with the following form:
<gui_urls>
<gui_url>
<name>Your account</name>
<description>View your account information and credit totals</description>
<url>http://foo.project.com/home.php</url>
</gui_url>
<gui_url>
<name>Help</name>
<description>Get help about SETI@home</description>
<url>http://foo.project.com/help.php</url>
</gui_url>
<ifteam>
<gui_url>
<name>Team</name>
<description>Info about <team_name/></description>
<url>http://foo.project.com/team_display.php?teamid=<teamid/></url>
</gui_url>
</ifteam>
...
</gui_urls>
Each entry describes a GUI URL. These URLs (macro-substituted as described below) will be sent to client hosts in the reply to scheduler RPCs. Team-specific entries should be enclosed in <ifteam>; they will be sent only if the user belongs to a team.
Like with any XML file, all text (including URLs) must be entity-escaped:
Character | Escape Code | |
Ampersand | & | & |
Single Quote | ' | ' |
Double Quote | " | " |
Greater Than | > | > |
Less Than | < | < |
The components of a <gui_url> element are:
A short name, used e.g. as a button name or menu item
An explanation, used e.g. as a rollover popup
The URL
All items are macro-substituted as follows:
The user's account key
The host ID
The project's master URL
The project name (from config.xml) <rss_auth/>:" An authenticator used by notices.php
The team ID
The team name
The user ID
The user name
The enclosed items are included only if the user belongs to a team.