Configuration

Configuration

A webapp profile is a simple, INI-style text file that specifies some parameters about a webapp. The profile can be used to launch the webapp in Prism. The parameters also control some of the features of the Prism host window. Here is the list of parameters:

id

the unique name of this web application. Remember that other people can create different webapps using the same uri and this webapp is only your particular instance or mashup. So make sure the identifier is not only unique to the web application, but also to you. This identifier becomes the name of the profile folder where your webapp is installed: google.mail@your.name

uri

the uri/url of the web app: http://mail.google.com

name

the display name of the application: Gmail

icon

the icon you want to use for the Prism window when running this web app. The actual icon file should be stored in the webapp bundle.

status

turns the status messages on or off for this web app: yes or no

location

turns the readonly location bar on or off for this web app: yes or no

navigation

turns the hotkey history navigation (ALT+LEFT, ALT+RIGHT and ALT+HOME) on or off for this web app: yes or no

splashscreen

filename of an HTML page to be displayed while the app is loading. The file must be located in the web app home directory: splashscreen.html

include

uris that should be opened in the web app, rather than in the default browser. An asterisk is used to match any string. Separate multiple uris with commas: *google.com, *yahoo.com

exclude

urls that should be opened in the default browser, rather than in the web app. Syntax is the same as for include.

trayicon

Indicates that a system tray (notification area) icon should be displayed for the application on Windows: yes or no.

iconic

Specifies that the application should be opened in iconic state. Currently support only on Windows in conjunction with the trayicon, causes the application to open minimized to the system tray: yes or no.

Launch Prism with -webapp [bundle] to load the specified web profile and install the webapp to your Prism profile folder. Once the webapp is installed, it can be launched using -webapp [webapp-id] and Prism will skip the installation and run the webapp directly.

Any of the profile parameters can also be passed directly on the command line as well.

Example

Here is an example of a webapp.ini profile:

[Parameters]
name=Gmail
id=google.mail@developer.mozilla.org
uri=https://mail.google.com
icon=gmail
status=yes
location=no
sidebar=no
navigation=no