SSI can save you a lot of time and code.
SSI (Server Side Includes) is an affective way to include dynamic content thoughout a web site. This is accomplished by putting one line of code on various web pages which references and outputs code from one location. SSI can is often used for web site headers, footers, and for elements like news scripts. SSI is makes us of CGI which it a feature provided by almost all hosting providers nowadays. Similar results can also be had by uses PHP, ASP, or other server languages. But, anywho, let's get started.
The basic syntax for SSI is:
| <!--#command="file that is being included"--> |
The most widely used SSI's are CGI execution, Include File, and Time and Date inclusion. Here is the syntax, for example, if you execute a cgi script called file.cgi:
| <!--#exec cgi="file.cgi"--> |
If you wanted to include an HTML fragment saved as the file, "file.html," you would use the following code:
| <!--#include file="file.html"--> |
Lastly, to include the date, you would use:
| <!--#echo var="DATE_LOCAL"--> |
In the first version of Spoono, we once included a footer using SSI at the bottom of every page which looked like this:
| <!--#exec cgi="footer.cgi"--> |
This linked to the footer.cgi file which contained the following:
|
#!/usr/bin/perl
print "Content-type: text/htmlnn"; print <<EOF ; <BR><DIV ALIGN=CENTER CLASS="footer"><A HREF="/">Home</A> | <A<BR> HREF="/desktop">Desktop</A> | <A HREF="/tutorials"> Tutorials</A> | <A<BR> HREF="/webmaster"gt;Webmaster</A> | <A HREF="/links">Links</A> | <A<BR> HREF="/theboard">Forum</A> | <A HREF="/info">Information</A></DIV><BR><DIV ALIGN=CENTER CLASS="copy">Copyright ©2001, Spoono. All Rights Reserved.<BR><BR> Please view our <A HREF="/tos.shtml">Terms of Service</A>.</DIV><BR> EOF exit; |
You might not understand the CGI portion, but you get the idea that the HTML is what is inserted. Similarly, I could use the include file command and create a footer.html file (note: use include file with HTML files and exec cgi for CGI files). For example, here is what footer.html would look like:
|
<BR><DIV ALIGN=CENTER CLASS="footer"><A HREF="/">Home</A> | <A
HREF="/desktop">Desktop</A> | <A HREF="/tutorials">Tutorials</A> | <A HREF="/webmaster">Webmaster</A> | <A HREF="/links">Links</A> | <A HREF="/theboard">Forum</A> | <A HREF="/info">Information</A></DIV><BR><DIV ALIGN=CENTER CLASS="copy">Copyright ©2001, Spoono. All Rights Reserved.<BR> |
Please view our <A HREF="/tos.shtml">Terms of Service</A>.</DIV><BR>
And to insert this HTML using the include file command, input this code:
| <!--#include file="footer.html"--> |
For a quick review, the general form for making an a exec cgi file like our footer example is like the following:
|
#!/usr/bin/perl
print "Content-type: text/htmlnn"; print <<EOF ; YOUR HTML GOES HERE EOF exit; |
Remember #!/usr/bin/perl is the path to PERL for Spoono, contact your server administrator for your PERL path. Also, save this as a cgi file, and upload it to your server (CHMOD: 755), and call it, as described, in the file where you want to include the HTML.
