Table of content

Requirements

License

Before you do anything, remember to read license.txt. Note that this blog script is not under GPL license but is under BSD license.

Who is the author?

The author is a person whom everyone calls "Vic" short for "Victor". He is an unknown coder that tends to prefer low level coding. Something must have happened to him to cost him to code this blog. Any trouble or any donations contact him at blah blah. He is also a guy that does not believe in comments in codes, so do not bother complaining about the lack of comments because there will never be comments.

How to install?

  1. Unzip all the files into one folder.
  2. Create a mysql database and add a user to it.
  3. Edit Settings.php (by opening it in a texteditor) and fill in the database name, database user, database password and path to the stylesheet (PS look into the section "How to customise?").
  4. Upload all the files except password.php onto your web host.
  5. Go to Admin.php and type in your desired username and password.
  6. Follow the instructions and create password.php.
  7. PS: This blog supports more than one person sharing the same blog. Just make sure that password.php has more than one entry. An example of password.php with more than 1 users would be like the following:

<?php
guest::720f965438db4ee3ec038300762a6d3b
admin::5f4dcc3b5aa765d61d8327deb882cf99
?>

The .htaccess file will restrict viewing of password.php and Settings.php, which are 2 cruical files.

After that you can just go to Admin.php and Add entry/Edit Entry/View Notes/View Entries. There are 2 files that are for public eyes, name index.php and Archive.php. It is possible to change the files names for both, you just need to read the section "Further Customisations".

Place your layout into index.php and at the place where you want to add entry, add the following:

<?php
require "blog.php";
?>

Place your layout into Archive.php and at the place where you want to add the search option and the "Entries sort by month", add the following:

<?php
require "blog.archive.php";
?>

A sample index.php and Archive.php is attached. Take a look into it. If you do not like the naming of the files, go to Further Customisation. There are some notes on it.

How come I cannot login?

If you are using IE, blame microsoft. This is because IE does not handle cookies properly (login information is stored in cookie). The way to solve it is to use better browsers like Mozilla Firebird (Formerly known as phoneix).

Recovery of password

If you lost your password, you cannot recover it from the blog except for using BF. Anyway the only way is to change password. First delete password.php and login in as per normal using your new password. Then follow the instructions.

How to customise?

The author made this blog with the intention of making it highly customisable. The following are the things that you can define in css to change the look of entrytitle, entry, author, addcomment, comments and commentform and so on.

Entry related

Comment related

Add comment related

Search field related

If you want, you can wrap it up in <div> containers and play with css. Of course it is up to you.

If you want to edit the emoticons (Add emoticon or delete them), you would have to edit Settings.php.

Further Customisations

It is possible for you to have the entries displayed elsewhere other than index.php. All you need to do is open up Settings.php and change $indexurl to the path of your php file. The same thing applies to Archive.php. You can change $archiveurl to the path of another php file. For example:

$indexurl = "blog_.php";
$archiveurl = "blog_archive.php";

Other Notes

In an entry,
1 CRLF = <br>
2 CRLF = <p>

In a note,
1 CRLF = <br>

Final Notes

Any problems, any bugs, any complains, any comments, any suggestion, anything please email to the author at roticvhol@yahoo.com. Remember to add a subject that does not look like spam, so as not to be deleted as spam mails.

Copyright (c) 2003, Victor Loh (aka roticv)
All rights reserved.