Options ManagerDISCUS Administration Instructions

The Options Manager is a collection of many Discus program options that do not fit well into other categories. It allows configuration of numerous aspects of the program from one central interface. The Options Manager is restricted to the superuser only, as it controls numerous aspects of the operation of the board.

Most Options Manager settings involve checking a box or filling in some text in the appropriate section. To save the change, you must scroll to the bottom of the form and click the "Save Options" button. This will save all of the options that are displayed on the form.

IMPORTANT! DiscusWare, LLC routinely adds choices to the Options Manager. If you have upgraded from a previous version of Discus, you may notice that you apparently cannot uncheck options. This occurs when an option has been added and is, by default, checked. To be able to uncheck that option, first click "Save Options" with that option checked. This action writes the parameter to the file. After saving in that way, uncheck the option as desired and save. The option will now be unchecked and this workaround will not again be necessary for any option appearing on the page at the time you perform this workaround.


PRO Some features in this section are available in the professional version of this discussion board software only. Those items are indicated with a notation as shown here.

Activation of scripts

This section allows you to enable/disable administration, e-mail notification, posting, and (in the pro version) user self-registration on a global basis. Each of these functions is described here.

Administration

If checked, moderators will be able to access the administration program normally and will be able to use all administrative tools that they are normally able to use. This is the default option. If unchecked, only the superuser will be able to log in to administration (moderators will get a "Denied" message). This is useful for shutting down a board.

E-mail notification

If checked, e-mail notification is enabled according to the settings you configure as described in subsequent paragraphs. If unchecked, e-mail notification messages will not be sent.

Maintenance Mode

If checked, the following services on the board are disabled:

This setting is intended to be invoked by the superuser during periods of temporary downtime (such as regeneration of the board, major administrative actions, reindexing, backing up, or moving the board from one server to another). It prevents users and moderators from altering the data structure of the board.

Posting

If checked, moderators, users, and the public will be able to post messages according to the posting privileges you have established in the Access Manager. This is the default option. If unchecked, no one will be able to post new messages to your board -- this transcends all settings from the Access Manager. This is useful for shutting down a board.

Server is capable of sending e-mail messages

If checked, the program will use its e-mail features as appropriate, such as for sending out e-mail notification (if enabled by the option above), and, in the professional version, for sending out initial passwords when users register for accounts. A checked box is the default option and is highly recommended if you have a command line server installed on your system (most unix systems do). If this box is not checked, you will not be able to check the "E-mail notification" box either, nor will you be able to use other e-mail based features of the software.

To configure e-mail notification for your server, click the "Configure" link next to the server e-mail option. This brings up the "E-mail Configurator" screen. If you have a unix server in a standard configuration, and a mail program can be located, the e-mail notification is automatically configured. Otherwise, you will need to configure it yourself. This requires some knowledge of the configuration of your server. Descriptions of the available e-mail options are provided on the configuration page. When you have specified your options, you can send a test message to yourself by entering your e-mail address and then clicking the "Test" button. When you know that e-mail notification is working properly, click the "Save Settings" button.

The reply-by-email feature is also configured through this interface. Documentation for this feature can be found at DiscusWare's site. Discus Pro also allows moderators to perform basic administrative tasks (delete message, delete conversation, approve or reject message in queue, close conversation, and move message to predetermined location) by replying to an e-mail notification message. Documentation for this feature is also contained on DiscusWare's site.

The Discus and Discus Pro programs support both the Net::SMTP and the Mail::Sendmail modules as alternatives to using command line mailers. These are especially useful on Windows servers which do not have command line mailers built in. To use these options, simply type the name of your SMTP server into the provided space (try "localhost" too). Note that for these options to be available, one or both of these modules must be installed in your server's Perl library. If your server does not have the appropriate module installed, download Net::SMTP or Mail::Sendmail from CPAN. The E-mail Configurator will not display these modules as options if your server does not support them.

DiscusWare does not provide technical support with regard to setting up your e-mail settings, because these settings are server-specific. If you do not know what mail program to use, ask your ISP. If you are on a Windows 95/98 or a Windows NT server, a mail program is probably not available on your machine. If you administer that server, we suggest that you download and install "Blat" mail. If you are on a Windows NT system that doesn't offer command-line mail services, you will need to switch to a unix-based provider -- a command line mail program is an absolute system requirement for the use of e-mail notification and other e-mail based features.

Typical Configuration of "sendmail"
Mail Program Location: /usr/lib/sendmail or /usr/sbin/sendmail (varies).

Mail Program Settings: Send input directly into the mail program (no temporary file)

Necessary Command Line Options: -t

TO: TO: in the input stream

FROM: FROM: in the input stream

USER: Do not use this parameter

BCC: BCC: in the input stream

SUBJECT: SUBJECT: in the input stream

REPLY-TO: REPLY-TO: in the input stream


Typical Configuration of "mail"
Mail Program Location: /bin/mail or /usr/bin/mail (varies).

Mail Program Settings: Send input directly into the mail program (no temporary file)

Necessary Command Line Options: leave blank

TO: leave blank on the command line

FROM: Do not use this parameter

USER: Do not use this parameter

BCC: -b on the command line

SUBJECT: -s on the command line

REPLY-TO: Do not use this parameter


Typical Configuration of "BLAT" (More Information)
Mail Program Location: C:/WINDOWS/SYSTEM/BLAT.EXE (varies).

Mail Program Settings: Send input into a temporary file

From Name: leave blank

From Address: Name <your_email@your.domain.com>

Necessary Command Line Options: -q (leave blank on some systems)

TO: -t on the command line

FROM: Do not use this parameter

USER: -f on the command line

BCC: -b on the command line

SUBJECT: -s on the command line

REPLY-TO: Do not use this parameter


Typical Configuration of SMTP server
SMTP server: mail.yourdomain.com (varies).

The other parameters are not used if you have checked the "SMTP server" option.

PROUser self-registration

If checked, using the User Manager, user self-registration can be enabled for specific groups. The registration form is then provided on the "Edit Profile" screen with full instructions. If unchecked, user self-registration is denied for all groups and is not ever displayed, regardless of any User Manager settings. This is the default option.

Clicking the "Configure" link brings up three options that can be set affecting user self-registration on your board.

Contact Information

When error messages are presented to your users, they always list a general contact person. This contact person was set up when you initially installed Discus. To change the contact name or e-mail address, enter this new information in these provided boxes.

Conversation/message options

This section allows you to set several options with respect to the appearance and function of conversations (subtopics) and messages on your board. Descriptions of these options follow.

Activate URLs and e-mail addresses in posts

If checked, this will convert any URL of the form http://www.server.com/dir/page.html and any e-mail address of the form username@domain.com to an "active link." This is the default option, although automatic conversion is invoked only if the user has not used other formatting in the post (since it is assumed that if other formatting is used, the user would also know how to use the \link{} and \mail{} formatting tags). If unchecked, this automatic activation does not occur.

Allow posts as "Anonymous"

If checked, users, moderators, and the public can post as "Anonymous" by checking the box on the "Add a Message" form. This is the default option, although the identity of the poster can always be determined through the Page Manager by clicking on the "Info" button. If unchecked, the box for anonymous posting is removed from all forms and anonymous posting is disabled.

Allow URLs to be entered in e-mail address box

If checked, when a visitor posts a message in a public area, and that visitor is not registered or did not type in a username or password, Discus will allow the e-mail field to contain a URL rather than an e-mail address. Clicking the link under the poster's name will bring up the requested URL. If this box is not checked, Discus will not permit URLs in the e-mail address at all.

Allow arbitrary HTML in posts (strongly discouraged)

If checked, posts made to the board will not be scanned for Discus formatting tags or have HTML tags removed. The entries to the board will be posted just as the user entered them, allowing any HTML directives that are desired. This is strongly discouraged due to the potential for abuse, as there is nothing that will stop users from entering JavaScript, META tags, or unclosed HTML tags that will ruin the display of pages. If you check this option, you will be making your board the security risks noted in CERT advisory 2000-02 (Malicious HTML tags embedded in client web requests). Additionally, if your server recognizes server-parsed code (such as PHP, SSIs, or DHTML), you may also be exposing yourself to security risks. This option should be considered for use only if the board is being accessed only by highly trusted users, and we don't even recommend enabling it then. This is dangerous, and we don't recommend enabling it unless you know exactly what you are doing.

Alternating colors defined

Alternating colors can be used in your template files. Instructions on implementing these alternating colors can be found in documentation on editing the templates. The colors are to be entered in hex codes (e.g., #FFFFFF for white or #FF0000 for red) and correspond to identifiers placed in the template files. This is given as an option in this location for historical reasons, and the checkbox cannot be saved in an unchecked state.

Capitalize first letter in user-created subject lines

If checked, when a user creates a conversation through the user interface, the first letter in the name of the conversation is automatically capitalized. This is the default option, and in most instances, the desired behavior to make the list of subtopics more attractive. If unchecked, the subtopic is created exactly as typed.

Capitalize first letter in usernames

If checked, when a user posts a message and the username is to be displayed (in parentheses or as the name of the poster), the first letter is automatically capitalized. If this is unchecked, the username is displayed in all lower-case letters.

Create pages in user interface with "Add a Message" box

If checked, the program will create pages in the user interface with an "Add a Message" box whenever someone uses the "Create New Conversation" button to make a new discussion. This is the default and throughout the history of Discus has been how the program works. However, if for some reason, you don't want user-created pages to have an "Add a Message" box in them, then uncheck this box.

Create pages in user interface with "Create New Conversation" button

This option essentially lets you make your board threaded. If you check it and someone uses the "Create New Conversation" button to make a new discussion, that new discussion will have a "Create New Conversation" button of its own. Essentially you're inviting your board to get out of hand if you use this option, although in some cases it is useful, which is why it is an option in the first place.

Double post protection (prevents duplicate postings)

If checked, the program verifies that the same user did not post exactly that same message within the last two minutes, preventing annoying double posts. This is the default option. If unchecked, double post protection is not used, but we can't think of a single instance why you would not want double post protection to be enabled.

E-mail addresses/links to profile on posts

If checked, the user's e-mail address from that user's profile is created as a mailto link under the user's full name and username, or if you are the pro version and the user has a profile defined, a link to the user's profile is created. This is the default option, although it can be turned off on a per-topic basis through the Access Manager. If unchecked, the link is not created, which is useful if you are concerned about "spambots" going through your discussion board.

Full name on posts

If checked, the user's full name from that user's profile is displayed on the post. This is the default option, although it can be turned off on a per-topic basis through the Access Manager. If unchecked, the link is not created, which is useful if your users are abusing this function.

Icons by posts

If checked, navigational icons are placed next to each post that allows the user to quickly jump to the top, the previous message, the next message, or the bottom, or to copy a hyperlink to the message. If unchecked, these icons are not displayed. This can be checked or unchecked as you wish, and all pages on your board will be automatically updated. For historical reasons, this option is unchecked by default. If you have this option checked, you can change the icon associations to any file that resides in your Discus icons directory by entering a new file name in the text box. The script automatically sizes the icons to 12x12 in the display, so if you change the icon file names, be sure your new icons have this size.

IP addresses on posts

If checked, the IP address (host and numeric address) are placed next to the user's name when a message is posted. If unchecked, this does not occur, which is the default option. This is useful for preventing abuse on large public boards, because potential abusers are identified and discouraged from posting. Remember that the IP information is always available from within the Page Manager by clicking on the "Info" button, regardless of whether the IP information is placed on the post.

Issue warning JavaScript box if post preview page didn't load entirely

If checked, Discus will use the onLoad JavaScript capabilities of the browser to make sure that the post preview page has loaded entirely before the form can be resubmitted. If the page wasn't properly loaded, data such as the username field and the end of the text may not properly be transmitted to the server. If you use this option and someone tries to submit the form before the page is done loading, an error message will be issued in a JavaScript box. If you or your users will find this safeguard annoying, then don't enable this option.

Moderators can disable e-mail notification for a given post

If checked, Discus will allow moderators to disable e-mail notification for a post made by that moderator. This option is available as a checkbox when posting through Page Manager and can be selectively implemented by adding a form field named no_email when posting a message. If the poster is not an authenticated moderator, this field is ignored. The superuser has the ability to do this automatically, regardless of whether this box is checked.

Perform HTML to formatting tag conversion

If checked, basic HTML tags, such as bold, italics, links, and colors, are converted into Discus formatting tags, ensuring valid HTML in the post and protecting against malicious JavaScript, SSIs, META tags, etc. This is the default option, and is useful for large public boards with users who will be visiting infrequently and thus do not wish to learn the Discus formatting tags. If unchecked, the HTML code will be rendered as "escaped" HTML code in the post. Conversion is invoked only if the user has not used other formatting in the post (since it is assumed that if other formatting is used, the user knows the formatting language and does not need to use HTML).

PRO Perform RTF to formatting tag conversion

If checked, an RTF file pasted directly into an "Add a Message" box is converted to Discus formatting tags. This feature is experimental and usually requires some manual editing of the resulting output. DiscusWare does not support this function.

Profanity checker

If checked, certain words that are defined by the administrator are replaced by red dots in the resulting post. This is the default option. If unchecked, profanity filtering does not occur. To create or modify a word list, click "Edit word list" and enter the "naughty" words, one per line. DiscusWare does not distribute a profanity list -- you'll have to make it up yourself. You have the option of how to handle profanity, either by rejecting the post outright or by replacing the bad word with red dots.

Send e-mail notification only to moderators

If checked, only moderators will be permitted to register for e-mail notification. If unchecked, both registered users as well as moderators can register for e-mail notification.

Username in (parentheses) on posts

If checked, posts by registered users and moderators are placed after the full name on the post to indicate that the post was made by a registered user or moderator. If unchecked, this is not performed (this allows forgery by public users if you have public posting enabled).

PRO Users may edit their own posts within (X) minutes

If checked, users will be able to edit their own posts within the number of minutes that you specify. The default is that this option is checked and allows editing within 30 minutes, which is a sufficient "grace period" to make minor changes to the message, but does not allow users to come back many days later and alter the conversation. If unchecked, user post editing is disabled. If you want to allow users to edit their posts any time, check the box and set the time limit to a large number like 999999.

General, Miscellaneous Options

Administration: Display moderator login history

If enabled, the administration program will display a message to each moderator when logging in about the last time they accessed administration (date, time, and IP host), as well as any failed logins on their account. This is a great security feature, as a moderator can tell instantly if someone is attempting to gain unauthorized access to administration. The change will take effect when you (or another moderator) next logs in; it does not take place instantly after saving the options.

Administration: Display version message in main menu

If enabled, the Discus version number is displayed at the bottom of the main menu in addition to the copyright message. Note that the copyright message is required to be left in place under the terms of the Discus license agreement. If this is disabled, only the copyright notice will be displayed. The change will take effect when you (or another moderator) next logs in; it does not take place instantly after saving the options.

Administration: Log actions of board moderators

If enabled, Discus will log all actions of board moderators who have logged in to the administration program. The log is created as the file "admin-actionlog.txt" in the msg_index directory. The file is tab-delimited and lists the username, remote address, time, script name, and form parameters that are sent. This log is updated every time a moderator performs an administrative action through a web browser. Passwords are not recorded in this log file. You are cautioned that currently this file is not automatically rotated and it can grow to be very large if you or other moderators regularly access administration. The log analysis tools in future versions of Discus may be able to analyze this log and allow you to search by moderator, action, or time.

Board Regeneration: Use faster indexing (no gauge)

When the board is regenerated, a graphical gauge is displayed on the page to indicate the progress. Checking this box turns off the graphical gauge but substantially speeds up the reindexing process. This is a choice between aesthetic value for the superuser during regeneration and performance. We suspect that most will check this box at some point.

Dates: Place a "0" in front of months and days less than 10

If this option is checked and either the month or the day (or both) is less than 10, Discus will place a "0" before the number. For example, June 26 would be written as "6/26" with this option unchecked and "06/26" with this option checked. April 3 would be written as "4/3" with this option unchecked and "04/03" with this option checked. December 25 is written as "12/25" regardless of whether you have checked this option or not.

Disk quota checking: Disable board immediately if quota problem detected

If the program detects that there is a disk quota issue (files are being written with the wrong size or files cannot be written at all), Discus can disable your board immediately to prevent data loss or corruption. Although this will temporarily shut out your users until you come back to reactivate your board, it is highly recommended. If there is indeed a disk quota problem, all of your important data files will be wiped out, overwritten with zero-length files. Enabling this option will prevent or limit this massive data loss. Disable at your own risk...

Disk quota checking: Disable file size verifications (not recommended)

If unchecked, Discus will verify the integrity of important data files (users database, password database, etc.) against possible disk quota problems. Detected problems will result in a "quota problem" and will disable the board to prevent corruption if the above option is checked. If you check this option, it may result in the loss of your entire user database and moderator database in addition to corruption of many files on your board. This disk quota checking is an important feature of Discus and it is for this reason that DiscusWare strongly discourages you from checking this box. Do so at your own risk...

E-mail notification: Put link to discussion prior to reply form

If checked, Discus will put the clickable link (to the show.cgi script) prior to the e-mail reply form. If unchecked, the reply form will go before the link. This option is relevant only if e-mail reply has been enabled under the e-mail configuration section. Whether or not the link is clickable depends on the end-user's e-mail client, although most modern clients support clickable links.

File Locking: Disable board if file locking does not work properly

The Discus file locking system creates a "lock" file when a process attempts to write a file so as not to let other processes interfere. However, there are some platforms (notably some Windows NT platforms) where removing a "lock" file sometimes does not work properly due to a permissions issue. If this box is checked, Discus will disable the board if the file locking is not working properly (lock files are not being removed). This is similar to a disk quota event. If unchecked, Discus won't disable the board; it will simply log the error and proceed. DiscusWare strongly urges you to leave this box checked and resolve the problem by properly setting permissions. Uncheck at your own risk.

File Locking: Use file-based locking instead of directory-based locking

The Discus file locking system most efficiently locks files by creating special files in a "locks" directory for each file being locked and then removing the file lock by deleting the file when it is finished. This works much faster than previous versions of Discus, which recorded locked files in a special text file. However, there are some platforms where this does not work properly due to a permissions issue (notably some Windows NT platforms). Checking this box will cause Discus to lock files using a file that records all file locks. Note that this message is less foolproof than the directory-based locking, and DiscusWare strongly discourages the use of this setting. Consequences of file locking failures are corrupted board files. This setting also makes it more likely that a user will experience a file locking error message.

Image Upload: Check message source for validity

When a user uploads an image, Discus sends the source of the message in a hidden field in the upload form and uses this source to regenerate the message. If checked, this option will compare the source sent by the browser to the source on the message page to ensure that they match. However, this option slows down processing and, in cases where customizations have been made, may present faulty error messages. If unchecked, a crafty user could, in theory, create a custom form to edit a message that has been posted using the image upload form. However, this would be difficult in practice, especially if the referring page check (next item) is turned on. In addition, since uploads and edits are not accepted after 10 minutes from the time of the post, this procedure would not be effective for long-term editing. To summarize, by leaving this option unchecked, you improve performance and eliminate any errors that may be introduced by customization, at the risk of letting a crafty user edit his or her own post within 10 minutes of posting it. We recommend leaving this box unchecked.

Image Upload: Check referring page for validity

If checked, Discus will check the HTTP_REFERER environment variable to ensure that the image upload script is being accessed from an acceptable referring page (such as the image uplaod script or posting script). This can cause problems on misconfigured servers or for users who operate through a proxy that disrupts this variable. If you regularly get an error message about an invalid referring page when you upload images, disable this option.

Message Source: Do not store message source

In previous versions of Discus, the source code for a posted message (which contains all formatting tags and the other exact formatting entered by the user) was stored in comments on the page itself. In version 3.10, this was moved to separate files under the "msg_index" directory to reduce data transfer to the visitor. However, it is possible with almost absolute reliability to translate the HTML code produced by the Discus formatting engine back into source code, and the input is generally identical to that entered by the user. There is room for subtle differences with this approach which may confuse new users. If you check this option, Discus will no longer store the message source in separate files, which reduces the amount of disk space used by the program considerably. Also, operations dealing with messages (such as posting, editing, moving messages and subtopics, etc.) will be faster as there is no message source file operation to perform. There is a tradeoff for better performance in terms of ensuring that the message source in "edit" boxes will always be the exact text typed in by a user, which is why we leave this as an option to you, the board administrator, to select for your board. Note that you cannot really "undo" this later, as message source for messages posted when this option was selected will not have been stored. That message source will always be inverse-converted to Discus formatting codes.

Navigation Bar: Use alternate URL for topics page

If checked, Discus, instead of linking to the main Discus topics page in navigation bars, will link to the URL that you type in the box that follows on the next line. Note that this change will affect navigation bars in the user interface only. It will not make Discus do any special writing to the file you have selected. There is no checking within Discus of the validity of the page you enter here, so if you do something wrong, it could create a 404 (Not Found) error when your users click the link. It is recommended that you use a full URL (starting with http://) in the box when specifying this option. Note that your changes are not automatically applied to all pages when you check or un-check this option. To apply your changes to all pages, after saving your options, you must go to Board Manager and click the "Regenerate Pages" button. Finally, if you leave the URL blank but you leave the box checked, Discus will not link to the topics page at all (there will be nothing displayed at all for your topics page).

Profiles: Limit length of full name to ### characters

If checked, Discus will limit the number of characters in a user's "Full Name" to the number of characters that you specify in this box. This is designed to prevent abuse of profile names.

Search Engine: Do not verify IP address upon searches

If checked, Discus will disable the check performed in keyword searching that ensures when an individual clicks "Next" or one of the similar links in a keyword search, that the requesting IP address matches the IP address with which the search was originally performed. Certain proxy software packages result in the IP address being altered from time to time and thus produce an error message when someone attempts to view the next page in search results. Check this box if you are having a problem with this.

Search Engine: Use "Stop Words" to create smaller index files

If checked, Discus will use the "stopwords.conf" file to remove commonly used words from the search index that is created. Unchecking this may be necessary for some non-English languages, especially those which are not based on alphanumeric characters. After changing this setting, it is recommended to go to Board Manager and click the button to regenerate the search index.

PRO Skip archives in "New Messages" searches

If checked, archive conversations will not be displayed in the New Message search. Archive conversations for the purposes of this feature are those conversations created by Discus Pro automatic or manual archiving procedures. Choosing this option may improve the speed with which New Message results are displayed.

PRO Skip archives in "Tree View"

If checked, archive conversations will not be displayed in the Tree View display. Archive conversations for the purposes of this feature are those conversations created by Discus Pro automatic or manual archiving procedures. Choosing this option may improve the speed with which Tree View results are displayed.

PRO Spell Checker: Dictionary files not in alphabetical order

The Discus Pro spell checker assumes that the dictionary file is in alphabetical order. If you get a large number of flagged misspelled words even though those words are in the dictionary, your dictionary is probably not in alphabetical order. Checking this box will make messages with spell check take slightly longer (this depends on the words in the message) but will allow Discus to compensate for dictionaries that are not properly sorted.

Topics Page: Do not print CSS style definitions of <P class=desc> tag

For backward compatibility, Discus prints a definition of the <P class=desc> tag in the header section of the topics page each time the page is regenerated. However, in some cases this definition may interfere with other style tag definitions that are being inserted into the templates or skins by people who are customizing the look of the pages. Checking this option will cause Discus not to print the definition of the tag onto the topics page. If the classic or updated classic skin is being used, or any template set that defines descriptions on the topics page with this tag, the definition will be needed to be added appropriately to the template file.

Topics Page: Do not update when posting messages, etc.

If checked, Discus will never attempt to update the board topics page. Generally, the topics page needs to be updated each time a message is posted or other activity occurs so that dates, message counts, etc., are all updated. This option should be checked only if you know exactly what you're doing! This is a good idea only if you know that your users will not be visiting your topics page and you don't care if it looks bad.

User Manager: Show * for users who have never logged in

If checked, Discus will display * next to any users who have never logged in (like in version 3.01). Note that if you also display the "Last Logged In" data, this display is redundant, which is why it is now an option.

User Manager: Show "Last Logged In" to moderators

If enabled, the User Manager will display the date when the user last accessed his or her account. This display is similar to the display in the Moderator Manager which shows when a moderator last accessed his or her account.

PRO User Profiles: Picture upload enabled

If checked, users will be able to upload pictures of themselves in their user profiles. The file size is limited by the limits specified in the "Image and Attachment Uploading Options" section.

Users can change their passwords

If checked, users will be able to change their passwords. Moderators will always be able to change their passwords, and the superuser or moderators will always be able to change the passwords of users for them.

PRO User Self-Registration: Allow self-registered users to change their e-mail address

If checked, all users will be able to change their e-mail addresses. If unchecked, those individuals who register via the instant registration method will not be able to change their e-mail addresses (this prevents them from registering under a real e-mail address and then changing their e-mail address to something else after receiving their password).

PRO User Self-Registration: Require an e-mail address to be entered upon registration

If checked, when registering for an account, users will need to input an e-mail address that is of valid form (including an @ sign, etc). Note that this does not guarantee that the e-mail address will be valid (use the user queue or e-mail verified options to achieve this). If unchecked, prospective users will be able to leave the e-mail address blank upon registration (note, however, that they won't ever be notified of their new account if this box is unchecked and you're using either the user queue or the e-mail verified mechanism).

Reindexing factor

This number is used internally by the program to control how often the progress gauge refreshes when you are doing operations such as reindexing the board or regenerating subtopic and message lists from templates. The larger you make this number, the less often the program will refresh the screen. The default is 15 which does not let any process take more than 2-3 seconds to complete. If you know that your server does not have time limits on processes, you can increase this number. This will let the server work for a longer time uninterrupted and will not depend as much on the speed of your internet connection. Change this option only if you understand what this does and what you are doing!

Template Manager box size

This option controls the size of the text box in the editor portion of the Template Manager interface. You can specify the number of rows and the number of columns that will be present in the text box. The default is 20 rows and 75 columns for a good fit on most displays.

Image and Attachment Uploading Options

One of the most unique features to Discus is image upload (and in-line display). Discus Pro also allows upload of attachments (non-image files, such as documents). Although incredibly useful, this feature has the potential to be misused, by uploading inappropriate images or very large files.

If the "Image uploading and attachment uploading enabled" box is checked, image uploading and attachment uploading are permitted. This is the default option. If unchecked, image uploading and attachment uploading will not be allowed at all on the discussion board.

You can also set file size limits for the uploaded images or attachments, distinguished by the privileges of the poster (public vs. registered user). The file size limit is entered in kilobytes, and a value of "0" indicates no limit. Setting a file size restriction of -1 effectively disables uploading, as there are no files that are less than -1000 bytes in length! File size limits also apply to pictures uploaded with registered user profiles in Discus Pro.

International Character Set

If your language requires that an international character set META tag to be placed onto each page in order to have the characters display properly, you can enter the international character set in the blank. This will be automatically placed on all pages in the Discus user interface (messages and utilities). If you change this, you should regenerate your board by going to Board Manager and clicking the button to regenerate pages.

PRO IP banning

IP banning is offered in Discus Pro to deny all access to all scripts from the domains you specify. This is useful in two contexts: to ban abusive users or those who repeatedly attempt to break into your system, or to completely shut down a board that is no longer used.

To add a host name, IP number, or wildcard pattern to the list, type that information into the empty text box in the IP banning session, and save your settings. To remove a host name, IP number, or wildcard pattern from the list, uncheck the box next to the existing entry and save your settings.

Because the message files are ordinary HTML files, your IP banning settings will not affect whether or not a person can read messages on your board. However, IP banning will prevent someone from posting messages, registering for an account, accessing private topics, or accessing administration.

Warning: It is possible to lock yourself out if you enter your own host name into the blank, or you enter a wildcard pattern that your host name will match. This can be repaired only by using FTP or telnet access to remove that configuration setting from the Discus system. Thus, use caution when specifying your settings! If you type just "*" into the blank, all hosts (including yourself) will be banned from accessing the scripts.

PRO Log analysis configuration

The Log Analysis utility allows you to analyze a server's access log (in NCSA or NCSA extended format) to determine the number of accesses to your pages (i.e., "reads"). This requires that a log is kept somewhere and that your server has access to that log. If you know where the log is, enter the full filename of the access log in the blank. If you don't know where the log is, ask your server administrator or ISP. You are permitted to specify up to 5 access logs for your system, if older rotated logs are maintained. You should list the access logs from the most recent (at the top) to the oldest (at the bottom).

Analyzing the posting log will work properly regardless of whether the setting described here is properly configured, as posting log analysis uses a log file maintained by the Discus program.

PRO Mailing list generation

You can generate a mailing list of all registered users on your system, all moderators on your system, or a combination list of all registered users and all moderators on your system, if the need arises to send out a mass-mailing. The list that is generated lists each unique e-mail address only once, regardless of how many user accounts or moderator accounts have that e-mail address. To generate a list, click the appropriate link for the mailing list you wish to generate. You can then select the list of e-mail addresses that is produced and copy/paste it to another program.

Message size limits

With this option, you can put a maximum limit on the number of characters that a poster can use in their message. This option is intended to be used to prevent abuse. Note that most browsers have a size limit of about 32,000 characters in the text box. Message size limits can be distinguished by the privileges of the poster (public vs. registered user). The message size limit is entered in kilobytes, and a value of "0" indicates no limit. Note that 1,000 characters = 1 kilobyte.

New Messages Search Options

This section allows you to configure the look and feel of the "New Messages" page. Your changes, once saved, become immediately viewable on the "New Messages" screen. The choices are self-explanatory as to what they do. Unchecking the "Show date and time of last post on search screen" will speed up the initial display of the screen slightly, as Discus will not have to examine the log files to determine the last time. This speed improvement will be less than a second even for very large boards; however, if this page is hit frequently and this information is not needed, it will result in slight conservation of resources.

Order of items

With this option, you can configure the order of items (subtopics and messages) that users add or post through the user interface. The "normal" order, applied when all boxes are unchecked, is that new subtopics are added to the bottom of the list, and new messages are added to the bottom of the list. You can reverse this order, meaning that new subtopics will be added to the top of the list, and new messages will be added to the top of the list. You can also choose to alphabetize the subtopics. (Choosing both to alphabetize and to reverse the subtopic order will result in the subtopic order being sorted from Z to A.)

Add new subtopics to top: New subtopics added by users via the "Create New Conversation" button are added to the top of the list, rather than the bottom of the list. Adding to the bottom of the list is the default.

Alphabetize subtopics upon addition: When new subtopics are added by users via the "Create New Conversation" button, all subtopics on the list are alphabetized if this option is checked. This option has precedence over the "Add new subtopics to top" option.

Move active subtopic to top of list: When any post is made to a subtopic and this option is checked, that subtopic is moved to the top of the subtopic list. In this way, active discussions are promoted to the top of the list.

Move active subtopic's parents to top of list: When any post is made to a subtopic and this option is checked, all of the subtopics above that message are moved to the top of their respective lists. Note that topics are not reordered. This can be selected only in conjunction with the "move active subtopic to top of list" option.

Add new messages to top: We have observed only a very few instances where reversing message order is desirable. Adding prayer requests to a list was one such instance. However, this is not a good choice for conversational flow, since your users will not find it intuitive to start reading at the bottom, scroll up to read a discussion, and then scroll all the way back down to the bottom to post their message. Thus, we discourage reversing message order unless you really know what you're doing. You can always reorder existing messages using the Page Manager.

PRO Profile fields

The superuser controls the information that is requested from a user for that user's profile, as well as some options related to those information fields. To access the profile field editor, click the "Define profile fields" link.

Profile fields have five main attributes, described here.

To add a new field, type a field description into the blank text box at the bottom of the list, and set the attributes of that text box. Then click the "Save Profile Fields" button. To delete a field, highlight and delete all text in that field's description box, and then click the "Save Profile Fields" button.

Time Zone

This option is useful if your server is located in a different part of the world from a majority of your users. Entering a number, positive or negative, will offset the time displayed by the program for all operations (message time stamps, utilities) by the number of hours you select. For example, if your site is hosted in California but your users are all in New York (3 hours ahead), you could type "3" for the time zone offset, which would add 3 hours to California time to give New York time.

By default, Discus uses the server's local time in determination of the time that an operation is being posted. For the example above, if your server is in California and your users are in New York, the time in New York is always three hours ahead of that in California, and this automatically takes time changes into effect, since the offset is always the same. For others, it may be more convenient to reference the time to GMT (also known as UTC or Zulu). If you wish to do this, check the "Use GMT time in computations rather than local time" box. This option is of use when your time does not change with the seasons. This option affects the display of the time only, not the method in which Discus stores the time internally.

Copyright © 2000, DiscusWare, LLC, all rights reserved