External Handlers

You can configure TeleFinder to hand-off specific page requests to external Common Gateway Interface (CGI) programs. Rather than sending the page data directly, TeleFinder sends the CGI AppleEvent to the CGI program. The CGI processes the request. TeleFinder then sends the results from the CGI to the browser. This method is necessary to serve scripts from UserLand's Frontier(tm) object database. 

There are two parts to setting up an external handler:

Create a CGI to Handler Name Association

Using the External Handlers pane to create an association between the CGI program ( in the following example we'll use Frontier ), and a Handler Name. You can use any Handler Name you'd like, as long as it does not conflict with one of TeleFinder's built-in methods.

Select the "Server Settings" command from the Web menu to open the Web Settings dialog. The click on the "External Handlers" icon to display the External Handlers pane.

Note that Plug-ins register themselves as an external handler when they are loaded.

Click in the "Add" button to open the "External Handler" dialog.

Enter the Handler name "FRONTIER" and set the path to the Frontier application using the browse button to the right of the path text field. Click in OK to save the new handler entry.

Mapping the Handler Name to a File Type

Once you have created an association between the CGI and Handler Name, you need to map the Handler Name to one or more file types. Use the Request Handlers pane to do this.

Pre and Post Processors

Plug-ins may be selected to perform their "Pre" and "Post" processing actions. Only specific plug-ins need to function in this mode, consult the Plug-in documentation to see if this option should be selected for it.


Web Docs Index

May 14, 1997 -- ©Copyright 1997, Spider Island Software