Thanks for choosing MJGUEST!
Here it is a quick guide to get started with your brand new guestbook.
For further info or support to any issue occurring while installing or using the guestbook, visit official web site.
In order to improve our service, we'll be glad to receive any feedback from you.

Table of Contents

§ 1.0 - INSTALLATION

1.2) Delete unnecessary files (jump this step if you are RE-installing)

If you are a new customer, delete:

FOLDER interface/emoticons6.0/
FOLDER interface/emoticons6.1/


Also, if you don't have a fast internet connection to upload the script (see next step) and you are not interested in automatic guests' country recognition, you can delete:

FILE resources/ip-to-country.db (about 1.6 MegaBytes)

You can restore this feature by uploading this file at a later time (see § 2.4).


Then, if you already know which database you'll be using, you may delete other database folders, all located inside:

FOLDER database/

Example: if you are going to use MySQL3, you can delete folders "mysql4", "pgsql8", "sqlite2", etc...

1.2) Upload the Script (jump this step if you are RE-installing)

Upload the whole script to your web server using your FTP client software (eg. CuteFTP).

NOTE:
Language files must be all uploaded, because the language is set according to the location of your guests!

1.3) Use "Setup Utility"

Jump to § 5.0 to learn how to start the "Setup Utility", then go on reading.

Push button "Install" and follow instructions on screen.

If installation succeds, using button "Usage Tutorials" of the "Setup Utility" will let you get the most suitable code to open the guestbook from your web site. Put this code inside your web page (more info given in "Setup Utility")

Close "Setup Utility".

1.4) Enter the Guestbook for the first time

You can enter your guestbook from the link you have just created (see above).
To log-in as guestbook Administrator for the first time, use "password" as default password.

§ 2.0 - SCRIPT ADMINISTRATION

2.1) Overview and special abilities

To administrate the script, you have to log-in, first. Go to page "Admin" and type your password, then confirm.
If you have lost your password, you will get it via email by clicking on button " ? " in login page.

When you are logged as Administrator:

How to edit configuration:

Go to administration control panel and easily tweak settings. From this page you can also delete all messages at a time and restore original configuration.

How to read private entries:

When you are logged as Administrator, private entries will be visible among the others at the reading page, titled as "Private".

How to manage single entries:

When you are logged as Administrator and you are reading guests' entries, special icons will show up at each entry. These icons let you easiliy perform administration tasks on that entry:

2.2) Graphic Themes

A) Official Themes

Download the graphic theme package from the official web site, among those compatible with the version of your guestbook.

Unzip it and you will find:

FOLDER themeName.pak

Upload the whole folder to you remote server, inside:

FOLDER interface/

The graphic theme will be immediately available inside administrator control panel of the guestbook.

NOTE FOR WEB DESIGNERS:
At the official website you can download a special package file called "themeName.SDK" containing all the PNG vector files for web designers who want to customize the grahics of the corresponding theme. This folder is NOT meant to be uploaded.

B) Custom Themes

If you are familiar to CSS and graphics, you can create a custom theme.
I suggest you to create a different folder from the default one and renaming it (e.g. "custom.pak"), because in case of problems, you can always restore the original default theme.
To customize the layout edit ONLY the files inside themes folder!

2.3) Emoticons Management

Adding and removing emoticons is very easy!
Go to folder:

FOLDER interface/emoticons/

Simply add, delete, rename the files inside. Changes will be effective immediately.

2.4) Other Add-ons

At official web site, you can find a few other components to keep your guestbook up-to-date.

Swearing Filter:

FILE resources/swearwords.db
You should upgrade this file often, so your guestbook can intercept and filter more and more bad words and profanities.

IP-to-Country Database:

FILE resources/ip-to-country.db
This big file lets the guestbook recognize users' country from their IP address. If you care about this feature, keep this file updated (get a new one at MJGUEST web site).

§ 3.0 - UPGRADE

3.1) Upload the Script

Overwrite the old script with the new one via FTP software.

TEMPORARY NOTE 1:
In version 6.2 default names of smileys have changed. To keep compatibility with default smileys of your previous guestbook version, do as follows:

1) Move your custom smileys (if you have any)
from:
FOLDER _interface/_emoticons/
to:
FOLDER interface/emoticons_6.0/ (or 6.1)

2) Rename:
FOLDER interface/emoticons_6.0/ (or 6.1) --> interface/emoticons/

TEMPORARY NOTE 2:
Starting from version 6.3, every folder having names preceded by underscore (" _ ") are no longer needed and may be erased.

TEMPORARY NOTE 3:
Starting from version 6.3, all interface templates filenames inside are changed:

TEMPLATE.tpl.php --> TEMPLATE.htm.php

Delete unnecessary files inside:
FOLDER interface/

3.2) Use "Setup Utility"

Jump to § 5.0 to learn how to start the "Setup Utility", then go on reading.

Select the version of the script you currently own and push button "Upgrade".

If upgrade succeds, using button "Web integration" of the "Setup Utility" will let you get the most suitable code to open the guestbook from your web site. Put this code inside your web page (more info given in "Setup Utility")

§ 4.0 - REMOVAL

4.1) Use "Setup Utility"

Jump to § 5.0 to learn how to start the "Setup Utility", then go on reading.

To delete the script, push button "Remove". This option will delete all your data!

Now, if you want to RE-install, jump to § 1.0.

4.2) Delete Files

After you have cleaned up the database, use your FTP client to remove all files and folders.

§ 5.0 - APPENDIX: How to use "Setup Utility"

1) Open your browser to the page:

www.YourSite.com/MjguestDirectory/install/index.htm

2) Click on the link "Open Setup Utility", it will open in a popup window.

3) Follow the easy step-by-step instructions.

NOTE:
If your guestbook is already installed, for safety reasons you will be asked to type your Administrator password. If you have just installed the script, default password is "password".
Safety password is required to: Install, Upgrade, Remove but not for Usage Tutorials.

§ 6.0 - APPENDIX 2: Removing title-bar proprietary label (upon request)

Why?

Although this guestbook is 100% free for any kind of use, if you would like to hide at the eyes your visitors where your guestbook comes from, without breaching the contract, you may buy the right to remove the copyright label that appears on title-bar, by paying a symbolic one-time fee.

How?

Simply go to the dedicated section of mdsjack web site and read carefully all terms of service.

§ 7.0 - APPENDIX 3: Troubleshooting

Before asking for tech support at official forums it would help a lot if you proceeded as explained:

Now the guestbook is in debug mode, it's not suitable for use, but it reveals useful information for us to find out any bugs.

END OF USER GUIDE