Tetra WebBBS Documentation

Main configuration scripts

Tetra-WebBBS main configuration for *all* forums is located in several configuration scripts, which each serve for a special purpose.
Unfortunately there is no consistent naming and no seperated location for the configuration scripts yet. The naming convention is mostly inherited from the original version of WebBBS. In future the naming or location of configuration scripts may change.

Tetra-WebBBS' main configuration scripts are located in folder /cgi-bin/bbs..x/lib/.

webbbs_settings.pl

This is the "master" configuration file.
In this file, you define the bulk of your configuration settings.
Whatever you chose to use as settings make sure it applies to the majority of forums on your site. You may later overwrite each of the settings you define in this file in section (3) of the entry scripts if a certain forum needs different settings.

Most of the variables in this file should use intuitive names. To learn about their meaning and the options you have for configuration, you should look up the variable on the variable board.
All changes to this file will take immediate effect. Make sure you always use a perlish way for the syntax, otherwise you may get a 500 script error in case of typos.

smtp_settings.pl

This is a very special config script. Most users won't ever need to touch it.

However, if you want the forums to send emails using SMTP then you will need to add SMTP related configuration to this script. For security reason the SMTP configs are moved into a separate script

webbbs_text.pl

The language file for Tetra-WebBBS.

If you plan to run your forum in a language other than English you'll need to edit this file.

In case you want to change only a few texts you might be better off not to change in this file but copy the appropriate variables over to section 3 of the corresponding entry script or copy over to custom.pl and change the copied variable. This way will save you work on the next upgrade.

webbbs_custom.pl

This is a special configuration script which allows you to add whatever HTML into various places on almost all pages of the forum.

To see it in action simply rename the file to webbbs_custom.pl, to disable rename back to webbbs_custom_stopped.pl.

The most convenient way to use the features provided make a copy of this script. In this copy delete everything but the variable-placeholders you want to keep and edit according to your needs. Then name the edited copy to webbbs_custom.pl