The following explains briefly how to download and use the
- Download the comments tar file to
your hard disk.
- Using a secure copy or secure ftp program, copy
it to your public_html directory on www.math.dartmouth.edu.
This can be the public_html of your personal account or a
- Now ssh to that account on www.math.dartmouth.edu, and change to
the public_html directory.
- Type the command:
tar zxpf comments.tar.gz (and hit
- You should now have a directory called comments in your public_html
The comments page can immediately be accessed via:
- Before using the comments page, you must edit the file
index.phtml and make some choices about access.
Near the top of the file you will find the following self-documenting code:
If this comments page should only be posted to by people with
Dartmouth IP addresses, leave this variable set equal to yes. This
is probably appropriate for course accounts. If you want anybody
to be able to post to this account, answer no
$restrict_access_to_dartmouth = "yes"; /* or no */
If you want to receive a mail message when someone posts to your
page, answer yes here. Otherwise answer no. For pages which get
few posts, the yes option is the best since you don't have to check
your comments pages regularly. If this is for a class account, you
will have to decide how many messages it is likely to generate.
$mail_to_maintainer = "yes"; /* or no */
if ( $mail_to_maintainer == "yes" )
$mail_to_address = "email@example.com";
$mail_to_subject = "New comment posted";
- By default, the variable $restrict_access_to_dartmouth = "yes";
If you want or need users with IP addresses outside of Dartmouth to
access your pages, set this to "no".
- Next choose whether you want to receive mail when somebody posts
to your comments page, and if so, ehter your correct email address.
- Another file to be aware of is comments-made.html. This file
contains all of the comments which actually appear on the main page.
You can edit this file as you see fit, choosing to archive or simply
remove (any inappropriate) comments. Note, this file either needs
global read/write permissions (rw-rw-rw-) or needs the webserver
(www-data for us) to be the group with (rw-rw----) permissions.
- The last file to be aware of is
comments-template.html. This is another HTML document which
governs the format in which the comments appear on your page. Feel
free to modify it as well.
A final note on security
Generally the file comments-made.html is globally writable.
In the past there have been instances of spammers writing to these
files, so you should make sure, you monitor it.
If this comments page is for a course account, make sure that at the
end of the term you change the permissions to be rw-r--r-- via
chmod 644 comments-made.html