If you were looking for the cPanel Guestbook script, you have been re-directed to this page because the current program is no longer operational with the current releases of cPanel. The following tutorial covers another free guestbook solution available to you through cPanel.

The following article uses a program called BellaBook Guestbook and will walk you through obtaining the software, installing it, and running it on your hosting account.

What is BellaBook Guestbook?

BellaBook is a simple PHP-based guest book program that you can run on your website. A guest book is simply a book that allows people to sign in and allow visitors to see who's come and visited your site. The BellaBook program allows this and also provides for comments, an email address and spam protection without using a database. The advantage to this is that the program is not dependent on the database server in order to run. The disadvantage would be that the program can only display a certain number of entries and would not have the search capabilities that a relative database can provide. There are many other guestbook programs that you can obtain if that is your primary need, but bear in mind that with added functionality you get more complexity. The BellaBook program is simple and meets the basic needs of a guestbook.

Obtaining BellaBook

In order to install BellaBook, you will need to go to the website: BellaBook home page. The download link is directly accessible by going here: Download BellaBook.

NOTE: BellaBook is available through Softaculous, but at this time the installation will not work in the latest version of cPanel (11.38 build 15). The installation instructions that follow will explain how to install it manually.

Installing and Configuring BellaBook

  1. Upload the BellaBook zip file.
  2. You can either extract the file locally on your computer, or you can upload the zip file and uncompress/extract the file within the cPanel File Manager. Doing this in the cPanel file manager would be much easier. If you extract it locally, then you will need to use an FTP client in order to move the extracted files and folders without any complications.
  3. Once you have the extracted BellaBook folder extracted, you will notice that by default a folder called "BellaBook" is created with all of the files in it. You can use this folder, or move all of the files into a different one. Note that the instructions from BellaBook's author can be found in the README.TXT file.
  4. Look through the list of files that you uploaded (or extracted) and then look for the prefs.php. The text below is a copy of the contents of the prefs.php.

    //-----------------------------------------------------------------------------
    // BellaBook Copyright © Jem Turner 2004-2007,2008 unless otherwise noted
    // http://www.jemjabella.co.uk/
    //
    // This program is free software; you can redistribute it and/or modify
    // it under the terms of the GNU General Public License. See README.txt
    // or LICENSE.txt for more information.
    //-----------------------------------------------------------------------------
    
    
    $title = "My BellaBook Guestbook"; // set your guestbook title here
    
    $admin_name  = "admin";   // admin username
    $admin_pass  = "password";   // admin password
    $admin_email = "you@your-domain.com";   // admin e-mail address
    $admin_url = "http://your-website.com";   // your website url - used in guestbook footer
    $admin_gburl = "http://your-website.com/bellabook";   // your guestbook url - used in the sign notification emails
    $admin_sitename = "my site";   // your website name - used in guestbook footer
    $secret = "pleasechangeme";    // this is like a second password. you won't have to remember it, so make it long and random
    
    $dateformat  = "d M y h:ia";   // date format, more details: php.net/date
    $stylecolor  = "bigblue";   // bellabook theme (download more from jemjabella.co.uk/scripts)
    
    $showemail = "yes";   // show email addresses in guestbook - write yes or no
    $emailentries = "no";   // email new entries - write yes or no ($admin_email must be filled in, above)
    
    $emailrequired = "yes";   // make email field required - write yes or no
    $perpage = "5";   // Pagination - amount of entries per page. 
    $smilies = "yes";   // convert text smilies like :) to images? - write yes or no
    
    // spam protection options
    $captcha = "no";   // captcha on? - write yes or no
    $moderate = "no";   // new entries have to be approved first - write yes or no
    $floodcontrol = "no";   // allow flood control? - write yes or no
    $allowlinks = "no";   // allow urls in comment; choosing no cuts down on spam
    
    

  5. You will need to set the following values (in the table below) by editing replacing each of the default values. You will need edit the file by using text editor like Notepad in Windows or the code editor available in cPanel under the File Manager. Replace the values by simply replacing the existing text within the quotation marks. For example, replace $admin_name="admin" with $admin_name="marktheadmin".
    Admin nameAdministrator User name
    Passwordadministrator password
    Admin_emailemail of the administrator
    Admin_urlURL used for the website. This URL is displayed in the guestbook footer
    Guestbook URLGuestbook URL. This URL is used in the notification emails
    Website nameNon-URL name of the website used in the guestbook footer
    SecretSecond password used for security (per their documentation you don't need to remember it)
    Optional - dateformatDate format in PHP format. For more information go to php.net/date
    Optional - StylecolorThis is a color scheme for the application. You can get more from BellaBook website
  6. After your changes are complete, save the file

Securing BellaBook

The next step in setting up BellaBook is to change the permissions on four of the text files files that were uploaded in the BellaBook directory:

  • entries.txt
  • tempentries.txt
  • spamwords.txt
  • iplist.txt

Change the permissions from 755 to 666. You can easily accomplish this by using the cPanel File manager.

Using the Advanced options to help manage Guestbook entries

Bellabook controls entries by using the following options:

  • Captcha - allows you to force a user to enter a code before they can place an entry in the guestbook
  • Moderate - allows you set that all entries be approved by an administrator before they can be seen
  • Floodcontrol - helps to provide a flood of entries into the guestbook
  • Allow links - Allows URLs in the comment (defaults to NO in order to help cut down on spam)
  • These entries are found at the bottom of the prefs.php file. Simply change "no" to "yes" in order to activate the feature.

Summary

This completes the instructional tutorial on using the BellaBook Guestbook program. For more information on BellaBook, go to the their main website. This is a very basic program, but when running you will see that it looks something like this:

BellaBook
Did you find this article helpful?

We value your feedback!

Why was this article not helpful? (Check all that apply)
The article is too difficult or too technical to follow.
There is a step or detail missing from the instructions.
The information is incorrect or out-of-date.
It does not resolve the question/problem I have.
How did you find this article?
Please tell us how we can improve this article:
Email Address
Name

new! - Enter your name and email address above and we will post your feedback in the comments on this page!

Like this Article?

Related Questions

Here are a few questions related to this article that our customers have asked:
Ooops! It looks like there are no questions about this page.
Would you like to ask a question about this page? If so, click the button below!
Ask a Question
n/a Points
2014-05-28 6:46 pm

Please note that the download link included in this article is not necessarily always the most up to date version of BellaBook. If in doubt I recommend sourcing from the github repository:

https://github.com/jemjabella/BellaBook/archive/master.zip

Staff
9,965 Points
2014-05-28 8:11 pm
Hello Jem, and thanks for the comment!

Thanks a lot for pointing that out! I've gone ahead and updated the article to reflect that GitHub URL for the download link.

Also thanks for creating this awesome guestbook software so we have something to write about!

- Jacob

Post a Comment

Name:
Email Address:
Phone Number:
Comment:
Submit

Please note: Your name and comment will be displayed, but we will not show your email address.

2 Questions & Comments

Post a comment

Back to first comment | top

Need more Help?

Search

Ask the Community!

Get help with your questions from our community of like-minded hosting users and InMotion Hosting Staff.

Current Customers

Chat: Click to Chat Now E-mail: support@InMotionHosting.com
Call: 888-321-HOST (4678) Ticket: Submit a Support Ticket

Not a Customer?

Get web hosting from a company that is here to help. Sign up today!