Board ManagerDISCUS Administration Instructions

The Board Manager allows the superuser to add, remove, and configure topics as well as to change several options that directly affect the front page (such as the message displayed on the bottom of the page, the appearance of the board logo section, and the color scheme of the board). The Board Manager is restricted to the superuser -- ordinary moderators cannot access the Board Manager. To access the Board Manager, click on "Board Manager" from the administration program main menu.

Title message

The appearance of the top of the screen, where the board logo normally appears by default, can be customized by the superuser by editing the "Title Message" through the Board Manager.

To change the title message, enter the desired message in the text entry box under "Title Message." You may use all formatting tags except image upload in your message. Then click on "Preview/Save Message." If you wish to change your entry, modify the contents of the text entry box and then click on "Refresh Preview." When your message is correct, click on "Save Message."

The default for the title message is the board logo centered on the screen, which can be achieved by entering \c{\clipart{board_logo}} as your title message. If you wish to use your own logo, upload a file called board_logo.gif to the "clipart" directory, and use the formatting code stated here to include your new logo.

You have your choice if you would like to display a horizontal rule (HTML: <HR>) below the title message you've entered in the box. Whether or not you will do this depends on the title message you're using and the template for the topics on your page. To display a horizontal rule, check the box next to "Display horizontal rule (<HR>) below Title Message" and then preview and save the title message.

Topics

The superuser has several options dealing with topics. The superuser can delete, rename, reorder, change the group of, or add subtopics from the administration interface.

Main Message

The "main message" allows a message to be placed on the top screen of the board. This is usually some sort of welcome message or very basic instructions for new users, but can also be used for important system announcements.

To change the main message, enter the desired message in the text entry box under "Main Message." You may use all formatting tags except image upload in your message. Then click on "Preview/Save Message." If you wish to change your entry, modify the contents of the text entry box and then click on "Refresh Preview." When your message is correct, click on "Save Message."

You have your choice if you would like to display a horizontal rule (HTML: <HR>) above the main message you've entered in the box. Whether or not you will do this depends on the main message you're using and the template for the topics on your page. To display a horizontal rule, check the box next to "Display horizontal rule (<HR>) above Main Message" and then preview and save the main message.

Board Appearance

The color scheme, font, and background image of each page on the discussion board can be modified using the "Board Appearance" option. Changes are made on the top page and all subtopic pages. Settings can be changed at any time.

The board colors (for background, text, link, visited link, and active link) are set in traditional HTML hex codes or by typing in the name of a recognized color. The font face can be a comma delimited list of fonts (such as "Verdana,Arial,Helvetica") and the browser will choose the first available font on the system to display. The font size is a number between 1 (small) and 7 (large) -- "12 point" fonts correspond to size 3 and are generally the most readable, although for Verdana, size 2 is most readable. The background image is a URL (such as "http://your.server.com/images/background.jpg") and must be a valid URL to an existing image.

To change the board appearance, enter or modify any of the settings using the text entry boxes provided. Click on "Preview/Save Appearance" for a preview of your settings. To revise your settings, change any of the text entry boxes on the preview screen and then click on "Refresh Preview" to preview again your settings. To save your settings, click on "Save Appearance." The program will apply your new settings to all pages on the board recursively.

WARNING! The program performs no error checking of your colors, fonts, or background URLs. The program will not warn you if the colors will not go well together or if you have entered invalid fonts. It is strongly recommended that you consider carefully the colors, fonts, and background image for maximum readability by your users. It is important to check your new color scheme in both Netscape and Internet Explorer, as these programs sometimes display colors differently.

META tags

To use META tags for the description, key words, and robots directives, enter the desired META tags into the blanks and click the "Save META Tags" button. This applies the selected META tags to the top page only. If you want to apply those META tags to all topics on the board, check the "Apply to all pages on board" box before saving the META tags (this overwrites any of the individual settings chosen when configuring topic properties). Consult one of the many available WWW pages describing META tags for more information.

Templates and Structure

The Discus program allows board administrators to use a variety of templates to create a custom look for their boards. The "Templates and Structure" box allows administrators to regenerate the board based on these new templates. In addition, regeneration of certain important data structures used by the program can be accomplished using this interface.

Topic Selection: This allows you to select which topic will be regenerated or reindexed. If you know there is a specific problem with one topic on the board and you do not need to regenerate or reindex the entire board, selecting a topic will save you time. If you need to regenerate more than one topic, or you are not sure which topic needs to be regenerated, you should leave this set to "All Topics." Note that there is never a reason why you should need to select every topic on your board individually with this box.

Index Board: Discus maintains a file which contains information about the structure of the board. This file allows pages to be rendered more quickly in searches and administration, and allows for fast searches of subtopic and topic names. If the server crashes in the middle of writing this file, it may be corrupted and you may see messages such as * ##/## Not in tree file * on your board. Clicking "Index Board" will rebuild this index from the pages on your board. It is possible that if in the past your board crashed due to a disk quota problem or a reset of the file name counter that your board may not index properly. If Discus detects such a problem, it will present you with the opportunity to fix the problem. Discus fixes the problem (two files with the same name) by renaming each of those files with its own unique name. All links within the Discus program are updated to point to this new file name. It is suggested that after you index your board that you subsequently run the option to update the subtopic/message lists by clicking the "Regenerate Subtopic/Message Lists" button. This ensures that the most information written from the tree file appears on the board.

Search Index: Discus maintains index files for your message pages which contains the key words from each message. This allows the search engine to search all of your pages rapidly without needing to open up each page. If the server crashes in the middle of writing this file, it may be corrupted and results from one topic may not show up properly in your search results. Clicking "Regenerate Search Index" will rebuild all of these indices from the pages on your board.

Subtopic/Message Templates: Discus 3.10 (and higher) controls the look of the subtopic lists and message lists on your pages through these templates. Editing these templates is recommended only for advanced users. More information on customization of templates is available from the Discus Support Center. Clicking "Regenerate Subtopic/Message Lists" will rebuild these aspects of your pages from your templates, and is necessary only if you have modified these templates.

Topic Template: Discus 3.10 (and higher) controls the look of the topic list (on the top page of the board) through this template. Editing this templates is recommended only for advanced users. More information on customization of templates is available from the Discus Support Center. Clicking "Regenerate Topic List" will rebuild the topics page on your board based on your template, and is necessary only if you have modified this template.

Page Templates: All recent versions of Discus generate message pages from the "newpage.conf" template file. If you have modified this file or if you are moving from one server to another, click "Regenerate Pages" to rebuild all of your Discus pages from these template files.

Copyright © 2000, DiscusWare, LLC, all rights reserved