Kerio WebSTAR SSI Demo

The WebSTAR SSI Plug-In allows you to use a wide range of "server-side include" commands in your HTML pages. It can show and hide information based on various conditions, display and increment counters, display file information, include other text or HTML files, execute CGI applications and include their output, and display a wide variety of information about the server, the client, and the data transferred between them. Most of these commands follow the SSI specification established by the NCSA; the WebSTAR SSI Plug-In extends this set by adding a few extras, like the show and hide commands, counter commands, access to the WebSTAR API parameters, and automatic conversion of special characters.

To see how the commands on this page are used, open the "ssi_demo.shtml" file in a text editor. Select "View Source" in your browser to see how this file is modified by the WebSTAR SSI plug-in before being sent to the browser.

ECHO VALUES

You can display a wide variety of information using the #echo command - Click on this link to display some of these parameters:
Load this page again

Most of the standard NCSA SSI parameters can be used (those not implemented are noted):

  • (Not Implemented):
    AUTH_TYPE =
  • Content Length as sent in HTTP Header:
    CONTENT_LENGTH =
  • Content Type as sent in HTTP Header (usually specified only when sent from an HTML form):
    CONTENT_TYPE =
  • GMT Date and Time:
    DATE_GMT =
  • Local Date and Time:
    DATE_LOCAL =
  • Path and Name of this file:
    DOCUMENT_NAME =
  • URI of this file (on disk, not relative to server):
    DOCUMENT_URI =
  • Interface of this SSI plug-in:
    GATEWAY_INTERFACE =
  • MIME-types accepted by browser:
    HTTP_ACCEPT =
  • WWW Client Software identification presented:
    HTTP_USER_AGENT =
  • Date this file was last modified:
    LAST_MODIFIED =
  • Path arguments (the part of the URL after the "$" symbol):
    PATH_INFO =
  • URL decoded path arguments:
    PATH_TRANSLATED =
  • Query arguments (the part of the URL after the "?" symbol):
    QUERY_STRING =
  • URL decoded query arguments:
    QUERY_STRING_UNESCAPED =
  • Username passed by client (an obsolete value used only by very old browsers):
    REMOTE_USER =
  • HTTP Request method:
    REQUEST_METHOD =
  • Name and URL path of the requested file:
    SCRIPT_NAME =
  • Server's port number:
    SERVER_PORT =
  • HTTP Protocol used by server:
    SERVER_PROTOCOL =
  • Server Software:
    SERVER_SOFTWARE =

    • The #echo command can also be used to display special values, such as the current random number, the current value of any counter variables created by the #counter command, or any named variables created by the #store command (see the sections on "COUNTERS" and "STORED VARIABLES" for examples of how to display these values):

    Show current random number:

    INCLUDE FILE

    With the #include command, you can display the contents of a text or HTML file:

    FILE INFORMATION

    The #fsize and #flastmod commands will display size and date last modified for any file:

    File Size of the sample file included below:
    File Modified:

    COUNTERS

    Using the #counter and #echo commands, you can increment and display the values of various counters:

    Counter 1 is:
    Display the current value of Counter 1:

    Counter 2 is:
    Counter 2 incremented again without displaying it:
    Counter 2 incremented once again:

    SHOW AND HIDE

    The SSI plug-in's #show and #hide commands can be used with a number of criteria:

    Show only to Netscape and compatibles: Hello!
    (based on http_user_agent = "")

    Show after February 1998: Hello!
    (based on date_local = "")

    Show 40 percent of the time: Hello!
    (based on random = "")

    Change random numbers and show either a green, yellow, or red square:
    (Based on random = "")

    More sample #show and #hide commands:

    Show if the time is after noon: Hello!
    (Based on date_local = "")

    Don't show if this page is accessed directly, only when reached from a hyperlink (try reloading) : Hello!

    Hide only if the QUERY_STRING is "Frans Hals" (follow this reload link): Hello!
    (Based on query_string_unescaped = "")

    STORED VARIABLES

    Display the current contents of the variable named "fruit":
    The WebSTAR SSI plug-in also performs conversion of special characters in your HTML pages. You can set the default character translation option in the Server Settings - Web Settings - SSI screen of the WebSTAR Admin application, but you can also control the character translation for individual pages with a #config command. WebSTAR SSI allows you to translate special characters to the equivalent ISO Latin-1 entities, leave characters untranslated, or to restrict the character set to 7-bit ASCII:

    ISO Latin-1 conversion:

    Franais Espa–ol Portugus

    Unconverted 8-bit characters:

    Franais Espa–ol Portugus

    ASCII character set:

    Franais Espa–ol Portugus