0.2.3.1

Crossforum theatre

Crossforum theatre is a UI over the Outcast voting network [obsolete name].

Server

This section concerns the general support services at the back end of the theatre application.

Setting up the server

Crossforum theatre may be deployed with either a stage 2 rollout from the pollwiki, or a full stage 3.

  1. Follow the instructions for setting up a deployment area.

  2. Start the servlet container. For example:

    % /etc/init.d/tomcat-6 start

    Test it by querying the dummy feed service:

    http://localhost:8080/voff/xfDum?form=json&pretty=y

    If the vote-server name (voff) is correct, then it should respond with a series of dummy bites, like this.

  3. Test the local client:

    http://localhost:8080/voff/xf/#c=DumDum

    By default, the client is configured to use the local server. You should see something like this.

Building the server code

The server code is built by the x build target when calling votorola/b/build.

Service APIs

Client

This section concerns the general user interface at the front end of the theatre application.

Setting up the client

  1. Ensure you have set up an offline vote-server, which is typically named voff.

    You should find the theatre client running at:

    http://localhost:8080/voff/xf/#c=DumDum

  2. Use the bookmarklet controls to switch among the feed and scene components.

    Compare with the running demo.

  3. Refer to file gwt.js for configuration instructions.

    Client configuration. Shows the location of the configuration file for a typical offline vote-server. (Complete example in /home/vdev/votorola/web/publicConfig.)
  4. Follow a similar procedure for the online vote-server, which is typically named v.

Building the client code

  1. [refer to regular build instructions]

  2. [special instructions on running in devmode]

Copyright 2011, Michael Allan and Christian Weilbach. Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Votorola Software"), to deal in the Votorola Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicence, and/or sell copies of the Votorola Software, and to permit persons to whom the Votorola Software is furnished to do so, subject to the following conditions: The preceding copyright notice and this permission notice shall be included in all copies or substantial portions of the Votorola Software. THE VOTOROLA SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE VOTOROLA SOFTWARE OR THE USE OR OTHER DEALINGS IN THE VOTOROLA SOFTWARE.