WebMail Announcement Area Description
This page describes the facility on the
login page that allows a dynamic message to be added to the page.
This lets us conveniently add announcements of maintenance, downtime, etc.
to the page.
The first step is to find the files.
If you are using Unix, the files are stored in
Windows users would most conveniently use
samba to map a new drive to
and then navigate to the \projects\webmail\ directory on that drive.
The files in this directory are text files, so be sure to use a text editor such as
Notepad or KEDIT to edit them.
There are four important files in this directory.
- This file of instructions.
- This is the main, production file.
Messages in this file appear on the main WebMail login page at
- This is a test version of message.js.
Instead of appearing on the WebMail login page, the message in this
file appear on
- This is a blank template that is most conveniently used to
remove a message.
Adding a Message
- Edit /projects/webmail/message-test.js.
Follow the comments in the file and the example to add the message.
- View the new message by loading https://webmail.ksu.edu/msgtest.htm.
If it doesn't look right, go back to step 1. Note that you can
edit message-test.js all you want -- no one will see it
unless they load msgtest.htm.
- When you are satisfied with the message and ready to move it
to production, copy message-test.js to message.js.
On Unix, use the cp command:
cp message-test.js message.js
On Windows, you can use drag and drop and the Windows Explorer.
However, there is a complication.
You can't rename a file and replace another file in one step.
However, you can copy message-test.js to your local hard drive,
rename it to message.js, and the copy it back to
/projects/webmail/ and allow it to overwrite the existing message.js.
(You could simply erase message.js and then rename message-test.js
to message.js. However, for the few seconds between, no message.js
would exist, and anyone loading the WebMail login page would receive an error.)
Removing a Messsage
- After the message has outlived its usefulness, get rid of it
by copying message-none.js to message.js. This overwrites the existing message
with a blank one.
Kansas State University
| Computing and Network Services
June 9, 2000