***********************************************************
     Mambook
     Guestbook Component for Joomla! / Mambo CMS
     Dynamic portal server and Content management engine

     Copyright (C) Emir Sakic, 2003.
     One site license

     Developer: Emir Sakic - http://www.sakic.net
     Date: 15/09/2003
     Version #: 2.5 Pro
***********************************************************

What is Mambook?
----------------
Mambook is a Guestbook script for Joomla! / Mambo Content Management System.
Designed as custom component Mambook is installed and fully integrated in the CMS.

Mambook features:
- Fully integrated Guestbook engine
- MySQL based (table in Joomla! / Mambo database)
- Translation support (language file)
- IP, Agent, Homepage, Email, ICQ, time, rate and message logging.
- Easy administration integrated to Mambo admin
  (delete, new, edit, comment, publish, search)
- Editor front-end administration
- Powerful admin configuration of functionality and look & feel
- Language editing in admin
- Clickable smilies
- Function buttons (URL, Email, Image, Bold insert)
- UBB Code support
- Paged view with configurable number of entries per page
- Moderation and notification options
- Time zone offset
- IP based ban
- Word censor
- New entry notification
- Search engine friendly URL support
- Visual confirmation against spam (GD library required)

Installation
------------
Even though Mambook is much customizable it is very easy to install it and get going.
You don't have to edit anything, just upload the package and that's about it.

Follow these easy steps to install Mambook:

1. Upload zip file to Mambo using component installer.
2. Once you installed it you may want to add it to your menu.
   (Site/Menu Manager/Main Levels -> New)

Administration
--------------
To administrate Mambook just log in to Joomla! / Mambo administrator back-end.
You will find Mambook options under components menu.
Managing entries and editing configurations is easy and native for Joomla! / Mambo.

Customization
-------------
Mambook is highly customizable through Mambook control panel in administration.
You can change its fields, CSS colors and footers.
You can also configure various functions such as messages per page, UBB Code support, HTML support, max. pages.
IP ban list, censor words, time zone, moderation and notification options, language file in use can also be configured here.

Translation
-----------
To translate the Mambook to your language you just need to edit a single file.
Open mambook.english.php and translate the dialog defines.
Name your file i.e. mambook.spanish.php and save it in the same directory.
Now change the language name in Mambook configurations and your Guestbook is translated.

Managing entries
----------------
Managing Mambook entries is not different than managing any other mambo content.
On Mambook list entries are sorted in descending time order.
You can check the items, delete, publish/unpublish and edit them.
When you edit an entry you can change all data that guest entered, see his IP, host and browser info and add your comments.
You can save, cancel and unpublish the entry from here.

Configuration options
---------------------
Configuration is divided in three sections: settings, look & feel and footers.
Moderate: You can choose whether you want your guestbook to be moderated.
If Yes is chosen new entries will appear first after an administrator has reviewed and published them.
Notifications: If it's On all superadministrators and administrators will receive an e-mail when new entry has been submitted.
This is useful if you choose to moderate the guestbook.
Time zone: This is the time zone text showed after every post date.
Time offset: If your server is in different time zone you can set the time offset here so all entry dates are showed in your local time.
Language: Make sure you uploaded your language file and then you can change the language name here.
Word censor: If set to On the words in your censor list will be masked.
Censor list: Separate the words with comma. Be careful with spaces as they count as part of the banned word.
Banned IP's: All IP addresses on this list will be denied signing your guestbook. Separate IP's with comma.
Entries per page: This is the number of entries showed on each page of the guestbook.
Num. of pages: This is to prevent link list grow without limits when you have many guestbook entries.
If set to 5 navigation links will be like: Page: 1, 2, 3, 4, 5 > >>.
Fields: You can change field labels here. If you leave any field except name and message empty it will be unpublished.
Smilies: If set to Off smiley map will not be displayed.
UBB/HTML allowed: Choose whether you want to allow guests using UBB and HTML code in their entries.
If UBB is not allowed function buttons will not be showed either.
For example if you don't want your guests to enter their ICQ just leave ICQ fields empty here and it will disappear.
CSS style: Mambook generally uses common Mambo CSS styles to fit to your current design.
But if template you use don't have them you can set CSS styles used in Mambook here.
Footers: You can change footer and copyright message here or leave them empty.

Language editing
----------------
You can edit actual language file directly from admin.
Note that your language file has to be writable (CHMOD 777) in order to save changes.


Visit http://www.sakic.net for more exciting Components and Modules for Joomla ! / Mambo.