$Revision: 1.3 $
Initial version
Table of Contents
Each $FB variable is explained below. There are two types: user-configurable ones and those that are automatically set and interesting only to people extending the FotoBilder code.
New installations will want to set these variables. Some are automatically set by fbdefaults.pl based on your other settings, but it wouldn't hurt to specify them all explicitly.
Domain Related
The title of the site.
"Some FotoBilder Installation"
The minimal domain of the site, excluding the "www." prefix if applicable.
"pp.com"
An optional variable that, if defined and different from $FB::DOMAIN, any GET requests to $FB::DOMAIN will be redirected to $FB::DOMAIN_WEB.
"www.$DOMAIN"
The URL prefix to construct canonical URLs. This can include the port number, if 80 is not in use.
"http://$DOMAIN_WEB:81"
The URL prefix of the image directory.
"$SITEROOT/img"
Cookie domains should simply be set to .$domain.com, based on the Netscape Cookie Spec, but some older browsers don't adhere to the specs too well. $FB::COOKIE_DOMAIN can be a single string value, or it can be a perl array ref like:
["", ".$DOMAIN"];
Unless you specify this value, cookies will by default be available to any pages in the same directory as the page that created it or in pages lower down in sub-directories.
"/"
If set true, new accounts can't be created automatically.
Regular expressions matching accounts that normal users can't create. Useful for naming system accounts uniformly. Ex:
("^ex_", "^fb_", "^pp_")
A hash of URLs that link to certain help files. If you define these, little help bubbles appear next to common widgets to the URL you define. Ex:
( "galsecurity" => "/help/#galsecurity",)
Email Address
Used in database and configuration error messages. This should be an address that can reach someone who can actually fix the error.
"webmaster\@$DOMAIN"
Used in user error messages. This should be an address that can reach someone who handles customer service.
"support\@$DOMAIN"
Notification emails should come from a generic address. Notification emails will contain instructions on how to contact someone if something should go wrong.
"pp_notify\@$DOMAIN"
Database Related
%FB::DBINFO is a hash that contains the necessary information to connect to your MySQL install.
User Capability Classes
Default capability class mask for new users: (16 bit unsigned int … each bit is capability class flag)
Default capability limits, used only when no other class-specific limit below matches.
This hash defines capability class limits. The keys are bit numbers, from 0 .. 15. The values are hashrefs with limit names and values.
You don't even need to have different capability classes! All users can be the same if you want, just delete all this. The important part then becomes %FB::CAP_DEF.
System Tools
The system path to the sendmail program, along with any necessary parameters.
"/usr/sbin/sendmail -t"
Optional. The system path to a spell checking binary, along with any necessary parameters.
"/usr/local/bin/aspell pipe --sug-mode=fast --ignore-case"
Ease of Use
If set true, it is not required to stop and start Apache to flush the cache.
Server Down
Set true while you do any maintenance to your installation.
The subject of the maintenance message shown to users while $FB::SERVER_DOWN is set true.
"Maintenance"
The body of the maintenance message shown to users while $FB::SERVER_DOWN is set true.
"$SITENAME is down temporarily for an upgrade."
These $FB settings are automatically set in ljdefaults.pl. They're only documented here for people interested in extending FotoBilder. Or, you can define them in fbconfig.pl ahead of time so you can use them in definitions of future variables.
Directories
Root directory of the FotoBilder install.
$ENV{'FBHOME'}
The directory to store pictures in.
"$HOME/var/picroot"
Directory to store temporary files.
"$HOME/tmp"