To see how the commands on this page are used, open the "ssi_demo.ssi" 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. More information on the syntax and command set used by the WebSTAR SSI Plug-In is available in the WebSTAR Server Suite manual.
NOTE: To see the demonstrations of the #exec and #include commands, turn on the "Allow unrestricted use of the #exec and #include commands" option in the Server Settings - Web Settings - SSI screen of the WebSTAR Admin application. See the WebSTAR Server Suite manual for more information.
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):
Any of the WebSTAR API parameters can also be used to display information, for example:(Not Implemented):
AUTH_TYPE =
Content Length as sent in HTTP Header:
CONTENT_LENGTH = 0
Content Type as sent in HTTP Header (usually specified only when sent from an HTML form):
CONTENT_TYPE =
GMT Date and Time:
DATE_GMT = 2022/08/15:02:50:09
Local Date and Time:
DATE_LOCAL = 2022/08/14:19:50:09
Path and Name of this file:
DOCUMENT_NAME =
URI of this file (on disk, not relative to server):
DOCUMENT_URI = /Tools%20&%20Examples/SSI%20Demo/ssi_demo.ssi
Interface of this SSI plug-in:
GATEWAY_INTERFACE = W*API (version 1)
MIME-types accepted by browser:
HTTP_ACCEPT = text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Hostname of HTTP server:
HTTP_HOST = ahgi.com
Referring URL (empty if loaded directly):
HTTP_REFERER =
WWW Client Software identification presented:
HTTP_USER_AGENT = CCBot/2.0 (https://commoncrawl.org/faq/)
Date this file was last modified:
LAST_MODIFIED = 2016/11/02:14:53:32
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 =
Client's IP address or hostname (depending on the "Use DNS" setting in WebSTAR):
REMOTE_ADDR = 3.238.204.167
Server's hostname:
REMOT_HOST = 3.238.204.167
(Not Implemented):
REMOTE_IDENT* =
Username passed by client (an obsolete value used only by very old browsers):
REMOTE_USER =
HTTP Request method:
REQUEST_METHOD = CONDITIONAL_GET
Name and URL path of the requested file:
SCRIPT_NAME = /Tools%20&%20Examples/SSI%20Demo/ssi_demo.ssi
Server's domain name:
SERVER_NAME = 67.199.169.178
Server's port number:
SERVER_PORT = 80
HTTP Protocol used by server:
SERVER_PROTOCOL = HTTP/1.1
Server Software:
SERVER_SOFTWARE = WebSTAR/4.5(SSL) ID/74075
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):Server's domain name:
piServerName = 67.199.169.178
MIME type of requested URL in Suffix Mappings:
piFileMIMEType = application/x-SSI
Local file system name for the requested file:
piURLPhysicalPath = :Tools & Examples:SSI Demo:ssi_demo.ssi
Current amount of free memory available to the server:
piCurrentFreeMemory = 197881440
Total bytes sent by the server since it was last started:
piTotalBytesSent = 10511606
Show current random number: 2
File Size of the sample file included below: 781 bytes
File Modified: 1999/03/21:18:26:10
Counter 1 is: 112642
Display the current value of Counter 1: 112642
Counter 2 is: 337924
Counter 2 incremented again without displaying it:
Counter 2 incremented once again: 337926
Show only to Netscape and compatibles:
(based on http_user_agent = "CCBot/2.0 (https://commoncrawl.org/faq/)")Show after February 1998: Hello!
(based on date_local = "2022/08/14:19:50:09")Show 40 percent of the time: Hello!
(based on random = "2")Change random numbers and show either a green, yellow, or red square:
![]()
(Based on random = "2")
Show if the time is after noon: Hello!
(Based on date_local = "2022/08/14:19:50:09")Don't show if this page is accessed directly, only when reached from a hyperlink (try reloading) :
(Based on http_referer = "")Hide only if the QUERY_STRING is "Frans Hals" (follow this reload link): Hello!
(Based on query_string_unescaped = "")Show only if the browser's IP address is 192.168.0.2:
(Based on remote_addr = "3.238.204.167" -- change the "ssi_demo.ssi" file to reflect your own IP address)
Store the value "tangerine" in a persistent variable named "fruit" (view the ssi_demo.ssi file in a text editor to see the actual command used):
Display the current contents of the variable named "fruit":
fruit: tangerine
Main Switch:You can store these results in named variables with the #store command, then use #show and #hide commands to display something like the following when the form is filled out (open the ssi_demo.ssi file in a text editor to see the actual commands):
Name:
Flavor:
Hidden Field:
Set a custom error message (default error messages are normally contained in HTML comments):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:
HEY!! AN ERROR OCCURRED IN ONE OF YOUR SSI COMMANDS!Change the file size value:
Change the time format (a list of options can be found in the manual):
- File Size of the sample file included above: 0 K
- File Size of the sample file included above: 781 bytes
Generate a new random number:
- Date and Time: 19:50:09:08/14/2022
- Date and Time: 2022/08/14:19:50:09
- Date and Time: Sunday, 14 August, 2022
- Between 0 and 99: 42
- Between 0 and 4999: 4556
- Between 0 and 4: 1
ISO Latin-1 conversion:Français Español Português
Unconverted 8-bit characters:
Franais Espaol Portugus
ASCII character set:
Fran ais Espaol Portugus