Appendix: Using WebSiphon with WebSTAR 4.x

1. Installing as an Action

Note: this documentation assumes that the WebSiphon.acgi is located in the cgi-bin directory WebSTAR application.

Configuring WebSiphon as an action (or suffix mapping) will instruct WebSTAR 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.

If you are using the plugin version of WebSiphon, you can skip the first step and go directly to setting up your suffix mappings.

1. Launch WebSTAR Admin
   First, launch the WebSTAR Admin application and connect to your server. If you need help with this step reference the documentation included with WebSTAR.

2. Create an Action for WebSiphon (ACGI)
   

   
   Figure 1.1: WebSTAR Actions dialog.

   1. Choose "Actions" from the Web Settings options in the right side of the WebSTAR Admin settings window.
   2. Click the "New" button to create a new action.
   3. Type ":cgi-bin:WebSiphon.acgi" in the Path field.
   4. Type "WEBSIPHON" in the Action field.
   5. Click the "Save" button.
3. Assign the WEBSIPHON Action to a suffix mapping
   

   
   Figure 1.2: WebSTAR Suffix Mapping dialog.

   1. Choose "Suffix Mapping" from the Web Settings options in the right side of the WebSTAR Admin settings window.
   2. Click the "New" button to create a new suffix mapping.
   3. Select "WEBSIPHON" from the Action pop-up menu.
   4. Type ".t" in the Suffix field.
   5. Type "*" in the File Type field.
   6. Type "*" in the Creator field.
   7. Type "text/html" in the MIME Type field.
   8. Click the "Save" button.

   To change an existing suffix mapping, like ".html"

   1. Choose "Suffix Mapping" from the Web Settings options in the right side of the WebSTAR Admin settings window.
   2. Click on the suffix mapping you wish to change.
   3. Change the Action to "WEBSIPHON".
   4. Click the "Save" button.

To configure suffix mappings for the WebSiphon Plugin, simply select the WEBSIPHON_PLUGIN action instead of the WEBSIPHON action.

After saving your changes to the WebSTAR settings, WebSiphon will process any files with the suffix mappings you have defined.

contents