Send suggestions, comments, bug fixes, code improvments, etc to jake@jakes-mail.top
Provides a comment system with plain text files. Written in Perl.
Sign the guestbook!
Recent blog post: example, example2, example3-withdash
What if I want to glance at all comments? Without having to look through each blog post? Click me!
This relies on Server Side Includes (shtml) and CGI. Apache supports both, but it will have to be enabled.
The following line is required in shtml files
<!--#include virtual="../comment.cgi?blog=example" -->
Notice that 'blog=example' does not have an ending. That is because comment.cgi will append '.txt' on its own.
comment.cgi, post.cgi, and guest.cgi should reside in the root directory of the public http directory.
There should be a protected directory that contains the following directories: comments; html. These are self explainitory. Put the html files in the html directory. names.txt is present in protected directory.
Files in the comment directory should use 'word only' characters, eg: A-Za-z0-9 and some other characters, like '-' (dash), and end with '.txt'.
example: /path/to/http/ |--> public/ | |--> html/ (.html files go in here) | |--> blog/ | | |--> example.shtml (Server Side Include, calls comment.cgi) | | |--> example2.shtml (Server Side Include, calls comment.cgi) | | |--> example3-withdash.shtml (Server Side Include, calls comment.cgi) | | | |--> index.html | |--> comment.cgi | |--> post.cgi | |--> protected/ |--> comments/ (FILES MUST BE READABLE AND WRITEABLE) | |--> example.txt | |--> example2.txt | |--> example3-withdash.txt | |--> guest.txt | |--> all_comments.txt | |--> names.txt
Remember to check permissions, protected should be accessable by the http server's user/group and in particular, the files in the comment directory must be writeable and readable.
Why is there a protected directory? It exists because sometimes there are files relating to what you serve but want to keep 'under the hood' so to speak. You probably don't want people to navigate to lets say names.txt since the names you have put there are randomly selected and you want to keep them a nice surprise. Since this is free software you are, of course, free to do what you want with the code.
all_comments.txt
This file is appended everytime post.cgi is run successfully with a comment. It is meant as a way to quickly glance at recent comments. Since this is free software, you are free to comment out this ability. It is possible to submit a comment to this file; this is not a bug. You might want to change all_comments.txt to a different name, if that is desired.
guest_info
Says the username and the date of poster.
guest_info span
span surrounds username (eg: <span>example</span>)
guest_log
The entire guest entry, from username to comment.
guest_log p
I set it so that the comment will be more-or-less in the middle of the box.
Captcha system. At the moment it would be extremely trivial for someone to spam in the comments.