Reblogger	Features	Login/Sign up	Download	Templates
t9	Contribute	Tech. Support	Documentation	t10

Reblogger

Installation The Easy Way(that's the plan in any case)

If you are using Linux/Unix or Windows/DOS installation should be pretty easy(assuming I haven't screwed up). Once you've extracted the archive run the file called "install"(or install.bat if you're using Windows). Now the installer will ask you some questions to get an idea about where on your server reblogger will reside. Follow the instructions carefully(the installer is not very smart).

Website Address:	This one's a no brainer, just enter the URL of the website where you are installing reblogger. Just don't forget to start with http://
Path to cgi-bin:	In most cases cgi scripts can only be run from the cgi-bin directory. Here you must specify the path to your cgi-bin. In most cases this will be /cgi-bin/ meaning you can enter nothing since /cgi-bin/ is the default. In some cases all of your website might be placed in a directory like /public_html/, in which case the path cgi-bin will most likely be /public_html/cgi-bin/. If on your server, scripts can be executed in any directory(no cgi-bin) then just leave this blank.
Reblogger install directory:	If you are one of those people who doesn't have a cgi-bin you need to change this to something other than the default(try /reblogger/). Otherwise you probably won't need to change this.
Password directory:	This allows you to specify where you want to store important things like your password. Again, unless you want to use something else you should just go with the default(just leave it blank)
Path to sendmail:	Reblogger uses sendmail to send any of the emails it needs to send(email notification, login information). The default will probably work. If it doesn't you should find out from your web host where sendmail is stored and if they allow cgi scripts to use sendmail. Reblogger will still work without sendmail, but it won't be able to send you any email.
Reblogger's URL:	Once you've entered all of this information the installer will try to figure out what the web address of the the reblogger directory is. It should get it right, unless your website is stored in a directory like public_html. If that is the case /public_html will appear in the url when it shouldn't. Just type in the correct url. In most cases this will be http://your-web-address/cgi-bin/reblogger/
Time to Upload:	The installer will show you a list of the things you just entered. If everything is right enter "y". The installer will now ftp reblogger to your website. Once it's done reblogger should be ready to use

Installer Command Line Options

The installer has three command line options.(if you're using windows you'll have to open a dos window to use these commands)

install absolute	Relative paths might not work on some servers. This will install reblogger using absolute paths. This is covered in more detail later on under "$&%#@% It's Not Working!!".
install time_correct	If, after setting your time zone in the comment manager, comments still don't appear with the correct time or date posted you can use this option to adjust reblogger's time settings so that the time and date appear correctly.
install clean	This option will remove the saved settings from your last install and will ask you to enter the settings again. It will also overwrite all of the reblogger files on your web server, this means you will lose any of your already existing user accounts.

Installation The Hard Way

Sorry to all you MAC users, I don't have a mac version of the install script. The unix shell script might work in MacOS X, but I haven't tried it so I don't know. So you'll have to do some editing before you put reblogger on your web server.

Open the file called "settings". It will look like this:

$path = "./";
$pw_path = "./rb-pwd/";
$url = "http://your-web-address/cgi-bin/reblogger/";
$sendmail = "/usr/sbin/sendmail";
1;

$path specifies where on your server reblogger will be stored. If your webserver supports relative paths, which in all likelyhood it does, you don't need to change this. Otherwise you need to put in the full path to reblogger's directory(like /home/your-website/cgi-bin/reblogger/)

$pw_path specifies where your password file and list of logged in users will be stored. Again, like $path, you probably won't need to change this

$url. You will need to change this to the url where you have installed reblogger. (for instance I had to change it to $url = "http://jsoft.ca/cgi-bin/reblogger/")

$sendmail is the path to sendmail on your web server. You probably won't need to change this. If you find that reblogger's email features are not working you might have to find out from your web host where sendmail is, and then change this value.

Now you need to upload reblogger to your web server. Get out your favourite ftp client and login to your web server. First create the directory where you want to install reblogger. If you have a cgi-bin, reblogger's directory should be in your cgi-bin directory. If you specified the full path to reblogger in the "settings" file, make sure that the directory you create for reblogger is exactly what you entered in "settings". Now upload all of the reblogger files into this directory.

If your web server is running a unix like operating system you will need to set the permissions(use chmod) of all the reblogger files.

Reblogger's directory should be 777(rwxrwxrwx). All of the .pl files should be 755(rwxr-xr-x). The files "settings" and "time_correct" should be 744(rwxr--r--), and all of the files in your password directory(rb-pwd) should be 766(rwxrw-rw-).

It's installed, now what?

Now that reblogger is installed you should create a user account for yourself. To do this go to http://your-web-address/wherever-you-installed-reblogger/adduser.pl and follow the instructions. Once your account is created you will be taken to the comment manager ( http://your-web-address/wherever-you-installed-reblogger/comment_manager.pl ), where you can tinker with reblogger's settings. Everything is very straight forward, and anything that needs explaining is explained online, so in the interest of avoiding redundency I won't put it all here.

Creating multiple accounts

Reblogger can be used by just one person for one blog, or one person for a few blogs, or by many people for many blogs. You can allow as many(or as few) people as you want to use reblogger on your server. The idea behind this is that you can host comments for yourself, and people you know. If, however, you somehow have more bandwidth and storage than you know what to do with you could host comments for anyone who wants them(if this is you, tell me who you are, I will put up a link to you).

Enough talk...here's how you do it. Open adduser.pl in a text editor and look for the big box with the text $max_users = 1; in it. just change the 1 to whatever number of users you want to allow. Let's say you have another blog that you want comments for. Change this number to 2. Run the install program to upload the changed file, and then run adduser.pl to create your second account.

$&%#@% It's Not Working!!

A lot of problems can occur if the file permissions are not correct(you only have to worry about this if you did a manual install). Make sure the file permissions are correct.

If your web server is apache it might have suEXEC enabled, in which case you should change the permissions on reblogger's directory to 755(rwxr-xr-x).

If the program just won't run(you keep getting internal server errors), and you've already made sure the file permissions are correct, check with your web host what the path to perl is. If it is not /usr/bin/perl, you will have to edit the three .pl files and change /usr/bin/perl(on the first line) to whatever your web host's path to perl is and then run install to upload the modified files.

If adduser.pl runs, but you get an error when you try to create a user you might try using the absolute install option(type "install absolute"). You will have to find out from your web host what your home path is.