Appendix: Using WebSiphon with Quid Pro Quo

1. Installing as an Action
2. Installing as a Pre-processor

Whether installing WebSiphon as a pre-processor or as an action, this documentation assumes either a copy or an alias of the WebSiphon.acgi is in a folder named "cgi-bin" located in the root directory of your server.

Installing WebSiphon as an action (or suffix mapping) will configure Quid Pro Quo to process any files ending with the suffix ".t" using WebSiphon. The suffix ".t" is not required, so you may choose any suffix of your liking on your server. Many users of WebSiphon actually serve all of their ".html" files with the WebSiphon action to process their entire site rather than configuring WebSiphon as a pre-processor.

1. Choose the Service you wish to configure
   
   
   Figure 1.1: Quid Pro Quo Services dialog.

   If your version of Quid Pro Quo supports only a single server...
   

   1. Choose "Server Settings..." from the Control menu.

   If your version of Quid Pro Quo supports multiple servers...
   

   1. Choose "Services..." from the Control menu.
   2. Hilite the server you wish to configure for use with WebSiphon.
   3. Click the "Edit Server..." button.

2. Create an Action for WebSiphon
   
   
   Figure 1.2: Quid Pro Quo Configure Actions dialog.
   1. Click the "Actions" icon in the Configuration dialog.
   2. Click the "New Action" button.
   3. Type "WebSiphon" in the Name field.
   4. Type "/cgi-bin/WebSiphon.acgi" in the Path field.

3. Assign the WebSiphon Action to a suffix mapping
   
   
   Figure 1.3: Quid Pro Quo Configure Suffix Mappings dialog.
   1. Click the "Suffix Mappings" icon in the Configuration dialog.
   2. Click the "New Mapping" button.
   3. Type ".t" in the Suffix field.
   4. Type "text" in the Type field.
   5. Type "*" in the Creator field.
   6. Type "text/html" in the MIME Type field.
   7. Select "WebSiphon" from the Action pop-up menu.
   8. Click the "OK" button to save and exit the dialog.

Quid Pro Quo is now properly configured for use and will process all files ending with the suffix ".t" using WebSiphon. If you wish to configure a different suffix mapping, simply follow the above guide replacing ".t" with the suffix mapping you want to use.

Installing WebSiphon as a pre-processor will configure Quid Pro Quo to process every single request using WebSiphon. This includes all requests for images and any other non-HTML objects available on your web site so some overhead will be introduced, since WebSiphon will simply pass all other requests back to Quid Pro Quo for processing. If you wish to process all files on your site, we highly recommend configuring WebSiphon as an Action for the ".html" suffix mapping.

1. Choose the Service you wish to configure
   

   
   Figure 1.4: Quid Pro Quo Services dialog.

   1. Choose "Services..." from the Control menu.
   2. Hilite the server you wish to configure for use with WebSiphon.
   3. Click the "Edit Server..." button.

2. Configuring WebSiphon as a Pre-processor
   

   
   Figure 1.5: Quid Pro Quo Configure Processors dialog.

   1. Click the "Processors" icon in the Configuration dialog.
   2. Click the "New Processor" button.
   3. Select the "Preprocessor" radio button.
   4. Type "/cgi-bin/WebSiphon.acgi" in the Path field.
   5. Click the "OK" button to save and exit the dialog.

Quid Pro Quo is now properly configured to use WebSiphon as a pre-processor.

contents