THIS IS A ONE TIME ONLY PROCESS. ONCE YOU'VE FOLLOWED THESE STEPS AND INSTALLED
YOUR NEW SIMPLE HEADLINE SOFTWARE, YOU WILL BE ABLE TO USE AND UPDATE YOUR
HEADLINES ANYTIME YOU WANT USING A SIMPLE FORM.
1. Download the Software from SNG' Download Store (http://www.sngchicago.com/dlstore)
or from one of SNG's On-Line Resellers. For a list of places to buy the
product, visit http://www.sngchicago.com/products/simple/wheretobuy.html
2. The software will arrive to you as a zip (condensed) file. The name will have .zip at the end and will begin with the letters SNG, for example, SNGsimpson.zip
3. We recommend that you place this file in a directory of its own.
For example: a) In DOS : c:\sng\simpson\
b) In UNIX : ~/sng/simpson/
c) In Mac : create a "Simpson" folder
4. Extract the zip file. For example:
a) In DOS : pkunzip <filename>.zip
b) In UNIX : gunzip <filename>.zip or unzip <filename>.zip
c) In MS-Windows : use WinZip.
5. Once you have extracted the files from the zipped file (which actually
contains 12 separate files), you will be able to see the following files
in your simpson directory:
6. Once you've extracted the files, the first thing you should do is read the licensing agreement (LICENSE.html, also at: http://www.sngchicago.com/products/simple/download/LICENSE.html ).
7. Now you're ready for action! You will now need to UPLOAD all the files on your "simpson" directory/folder that begin with the capital letters UP (for example, UPsimpson.class) to your server.
A. Upload the files using FTP (File Transfer Protocol)
B. Very Important: You must decide now in which directory
on your Web Site you want to store these files. Again, we recommend that
you create a directory called 'simpson' on your Web site for your simpson
files. Make a note of the name you choose for that directory (for example,
.../simpson).
C. FTP the UP files to the directory.
D. If you don't have experience with FTP, are having difficulties, or if
your Web site is maintained by an outside company, send the UP files to
your Web masters as an email attachment and ask them to upload the files.
8. In the two Perl scripts (the two files ending with .pl) change the path in the "open" command to suit the path to the UPsimpsonIn.txt file (to find the "open" command just do a search for "open" with a text editor). Your webmaster should tell you the name of the absolute-path from the location of the Perl script (usually called "cgi-bin directory") to the location of your UPsimpsonIn.txt file. When you change the path in the "open" command of these two .pl files, this "absolute path" is what you will type in.
In addition, in the UPsimpsonRead.pl file, do a search for "Action". You should see an example of a possible path to UPsimpsonIn.pl (e.g. http://host1207.homecom.com/cgi-local/UPsimpsonIn.pl). You need to change this "example path to UPsimpsonIn.pl" to the correct path to the location of your UPsimpsonIn.pl file. If you're not sure where your UPsimpsonIn.pl file is located, or what the path is to it, ask your webmaster.
When you're done, upload the two .pl files to the cgi-bin directory, or email the files to your webmasters and ask your webmasters to upload the Perl scripts into the cgi-bin directory. Also, ask your Webmasters to activate the two Perl scripts (UPsimpsonIn.pl and UPsimpsonRead.pl). NOTE: We have created a special file with instructions for the Webmaster (readwebmaster.html - also located at http://www.sngchicago.com/products/simple/download/readwebmaster.html for your convenience.
9. Your UP files should now be in a directory on your Web site. They're just waiting there to help you make beautiful headers...
10. Now, you should copy and paste one of the tags to the Web-page where you want Simpson to appear. Choose an M-C-M tag from one of the locations listed below. "Copy" and and "Paste" it onto the Web page where you want the headline to appear. You can find a copy of the tag in several places:
A) Go to the "tagishere.html" file (located on the directory to which you've extracted the SNG*.zip file - see numbers 3 & 4 above). Open the file from your HTML Author or from your Browser.
B) The same "tagishere.html" file is also located at on SNG's Web site at http://www.sngchicago.com/products/simple/download/tagishere.html. You can copy the tag directly from the screen.
C) Below please find two examples of the tag file. You can "copy" one of these tags exactly as it appears below.
TAG EXAMPLES:
1) The first example is called "simpson620one" and it contains
:
<APPLET codebase="/simple" code="UPsimpson.class" width=620 height=20 align=center > <PARAM name="CyclesTillRead" value="1"> </APPLET>
Or:
<APPLET codebase="http://www.snglam.com/simple" code="UPsimpson.class" width=620 height=20 align=center > <PARAM name="CyclesTillRead" value="1"> </APPLET>
This means that the width of your header will be 620 points and that the software will check your server for new messages every cycle (see number 17 for explanation of "cycles").
2) The second example tag file is called "simpson700thousand"
and it contains:
<APPLET codebase=/pub/myprogs/ code=UPsimpson.class width=700 height=20> <PARAM name="CyclesTillRead" value="1000"> </APPLET>
This means that the width of your header will be 700 points and that the software will check your server for new messages every 1,000 (one thousand) cycles.
11. Copy and paste one of the sample tag on the Web-pages where you want your headlines to appear. Change the UPsimpsonRead.html file so that the path in "Form tag" (where it says "Update It") points to the place where your webmaster has put the UPsimpsonRead.pl file. e.g. If it's in "/cgi-bin/UPsimpsonIn.pl" then the "Form tag" should look like:
<FORM Method="POST" Action="/cgi-bin/UPsimpsonIn.pl">
It may also look like:
<FORM Method="POST" Action="/cgi-local/UPsimpsonIn.pl">
12. In the M-C-M tag, update the right path where the UP files are. For
example:
a) If the UP files are on http://www.barry.com/simple then: the M-C-M tag should look like:
<APPLET codebase="/simple" code="UPsimpson.class" width=620 height=20 align=center > <PARAM name="CyclesTillRead" value="1"> </APPLET>
Or:
<APPLET codebase="http://www.barry.com/simple" code="UPsimpson.class" width=620 height=20 align=center > <PARAM name="CyclesTillRead" value="1"> </APPLET>
b) If the Simple Directory is at www.schicago.com/chic/nice/simple/ then the 'tag' will be:
<APPLET codebase=/chic/nice/simple/
code=UPsimpson.class width=700 height=20>
<PARAM name="CyclesTillRead" value="10">
</APPLET>
c) If the Simple Directory is at www.schicago.com/mandarin/simple/ then:
<APPLET codebase=/mandarin/simple/
code=UPsimpson.class width=700 height=20>
<PARAM name="CyclesTillRead" value="10">
</APPLET>
You can make as many copies of the tag as you want and place it wherever
you want in your site (but remember, once you activate the header, the
same messages will appear in all of these places). NOTE: If you are still
not clear on how to update your web pages, go to SNG's home page and see
how we did it (http://www.sngchicago.com).
13. All you need to do now is upload/ftp the updated URL to its proper place on your Web site and you will see your sample header there. For example, if you want it on your homepage and its address is www.lily.com/index.htm, then paste the "tag" on that page.
14. Now, to make the headline your own... (that is, to update and change the messages) Plug into the Internet using your favorite browser and go to the directory on your Web site where you placed the file UPsimpleIn.html (See 7B).
15. You will see a simple form that will allow you to imput the messages you to imput the messages you want for your headlines. Fill out the form, type in your messages. Click on the "Update It" button, and you should see the "Saved messages sucessfully" message, which indicates that your messages were... Saved.
16. Now comes a very important step: the third line of the form allows you to choose how often you want the software to contact your server to check for updates/changes to your headlines. If you type in "1", the software will contact your server and re-download your headlines after one cycle, that is, each time your header runs through all of the headlines you have entered. Fill in a number.
NOTE: Choosing "1" would be a good option if you plan to change your headlines very frequently (i.e. every couple of minutes). If you plan to change your headlines only once a day or so, choose a higher number, such as 5, 100, or 1,000. This way the software will re-download the headers only after the headlines have run through 5, 100, or 1,000 cycles. Choosing a higher number will cut down in the number of bytes the software downloads from your server. The best way to decide on the number of cycles that is best for you is to experiment with different cycle numbers and check the number of bytes downloaded per day with your Web master. This way you can find a number that fits your needs and you traffic capacities.
17. That's it! Once you've filled in the three lines of the form, POST your changes to your serve(by clicking 'Update It' , and your headlines will be automatically updated on your Web site!
NOTE: If you are a beginner, you may want to familiarize yourself with using The M-C-M Family before finally posting on your site. Update 'the M-C-M tag' in UPsimpsonRead.html so that you can make some tests and then, if you like what you see on your screen, you can move 'the tag' from the UPsimpsonRead.html to any URL where you want the headlines to appear.
18. In the future, every time you want to change your messages, you just have to go to the UPsimpsonRead.html file and make the changes you want!
19. IMPORTANT: Your headline software is now fully operational. However, it may expire in less than two months if we do not receive certain information from you so that we can customize your software. To ensure optimum, long-term functioning, you MUST send us an email after your successful installation with the following details:
A. Name of vendor from which you purchased software
B. Purchase order number
C. Your Domain name (for example, http://www.sngchicago.com)
D. The path where you have installed the software (for example, http://www.sngchicago.com/simple)