- Gzipped Tar format: addrbook.tar.gz
- Zip format: addrbook.zip
- addrbook.cgi
- the actual program that generates the address book entries, and so forth.
- addrbook.txt:
- This is a plain text file which will contain the address book
entries. It should start out as a plain text file with a line
that says:
# This file will store all your address book entries.
- passwordfile:
- This is just a file that will be used to contain the encrypted password for this system. It should start out as a plain text file with the word "password" in it.
- README.addrbook
- contains information on how to get started using the program. READ THIS before you get started!
[Demo] [Who's using?] [System Requirements] [Download!] [Bug Fix Announcements] [Changelog] [License]
Program Summary
[Version 1.0.10 Released 09/28/2006]AddrBook v1.0 is a simple, yet flexible web-based address book system. It lets people search the address book, look up entries alphabetically, or add themselves to the directory. (You may also disallow users from adding entries.) The admin user may delete entries, and change the admin password. In addition, when setting it up, you may choose to disable access to any of the search or lookup features and keep those password-protected.
In the setup, you may choose what fields you'd like to have in your address book. By default, the fields are Last Name, First Name, Address, City, State, Zip, Phone, Email, and Website. You may add or subtract fields for your own purposes. For example, to make a sort of Gradebook, you might have Last Name, First Name, Student ID, Class, Quiz 1 Grade, Quiz 2 Grade, Exam 1 Grade, etc. NOTE: Remember to be aware of privacy issues -- if you do use this for a gradebook, you might want to consider NOT using the students' names. :) To use this for, say, a list of book ratings, you might make the fields Title, Author, Publisher, Date, Rating.
Working Demo
For an example of AddrBook set up to display in "vertical" mode, Click here.For an example of AddrBook set up to display in "horizontal" mode, Click here.
For a demo of the administrative interface, Click here
The password is "password"
. WARNING: These are public demos, folks. Some people enjoy adding entries with language which may not be appropriate for all viewers, and since the demo is used to demonstrate functionality, is not censored for this type of thing.
If you've gotten AddrBook to work, send me the address of your
website and I'll post a link to it.
OneMoreTimeUSA.com has it set up on their site.
Personality Profile at MillerArts.com: Okay, this is the COOLEST thing EVER! (Well, maybe not the coolest thing ever, but it
may be the coolest-ever use of AddrBook!) These folks have modified AddrBook to do a
personality profile thing that you can look up online. Just shows what people can do with some
creativity.
Camp Barbee (Look for the "Find your friends again" link.)
This Google Search sometimes comes up with some people using the script. Also, here are a few more I've found.
PromisedMehdi.com Email Directory
Daniel J. Gross Catholic High School Staff Directory
NSA-Iowa Membership Directory
LocalShows.Info Venue Search This is a really creative use of the script. They've set it up so that you don't search A, B, C, but state abbreviations. Nice job!
Crayon Box Supporters List
The web server where this script will be installed must have Perl 5.000 or higher. Scripts that send email require that "Sendmail" or "qmail-inject" be available on Unix/Linux-type systems. Scripts that send email under Windows-based systems require use of the Socket Perl module (Socket.pm). All scripts may require the Perl CGI module, CGI.pm .
This script is NOT supported on the following web hosting providers:
Tripod.com
Angelfire.com
Lycos.com
Also, sorry, but the scripts are not supported under mod_perl, PerlEx, or speedy_cgi as I don't have any way to test them in that environment. :-(
You must be able to execute cgi programs on your web server. If
you're not sure whether you have permission to do this, or are not sure
how to configure the files, please ask your system administrator, or
check the web pages of your web hosting provider for Help or Support
information. For a free web hosting provider who supports CGI scripts, or
low-cost web hosting providers, you can try looking at
the "Some Places to Host
your Website" page I've put together.
The web server must support both the GET and POST request methods. (Ask your
hosting provider about this if you're not sure.)
Please remember: you get what you pay for, and free web hosting
services are often worth what you pay for them.
But first, the obligatory plea for funding. :-)
All the files you need are contained in these packages. Download it
in the format you wish. If you have MS Windows, there is a program called WinZip (available
at TuCows) which will
uncompress and de-archive tar/gz files as well as Zip files. The package contains the following files: After a major release, you may get one or two messages a week.
Mostly, though, I'm afraid it's less than once a month.
You may also sign up for announcements about other scripts on
the
main Scripts for Educators Mailing List page.
This list is ONLY for announcements specifically about AddrBook:
(Scroll down if you don't want to read this part. You
do NOT have to give money to download these scripts!)
Like
the scripts? Give me a dollar, or say thanks!
If you like the scripts, you can send
me cash through PayPal, Amazon, or through snail mail
or you can show
your support in other ways. Remember: only about one
out of 100 people who download the scripts even says
"Thanks." :-)
On a Unix-type system, if you have console or command prompt access, you
may unzip the tar.gz file by typing 'gunzip < addrbook.tar.gz | tar -xvf
-'. If you're not very familiar with Unix, you may want to ask someone
who is to help you. The latest version of Stuffit for the Mac will also
handle tar.gz files.
I strongly recommend that you sign up here for update and bug fix
announcements about this script. I will not spam you with advertising: I
just want to make sure you have the latest fixes. :-)
The program will send a confirmation message to your email address when
you sign up. In order to get on the announcement list, you MUST click on
the confirmation link contained in that email message. This is to
protect you from someone signing you up as a joke, and to protect me
from being accused of spamming. Since update announcements are sometimes
few and far between, sometimes people forget that they've subscribed and
report me for sending junk mail. Luckily, the system logs the address,
time, and date of everyone who signs up so that I can prove I'm only
sending to people who asked for it. :-)