8 June 2003
|Revision v0.0.10||8 June 2003||cat|
|Prepared documentation for RC1 with installation and user instructions.|
|Revision v0.0.20||27 Dec 2003||cat|
|Prepared documentation for RC2.|
|Revision v0.0.30||20 April 2004||cat|
|Updated for new features in RC3.|
Table of Contents
User Guide is an online guide for using using mvnForum successfully. If you do not see what you are looking for here, take a look at the FAQ section, carefully compiled for your edification.
Account management involves creating accounts, managing your profile, and watching threads
To actively participate in a forum, users will want to establish accounts with the forum so that they can be notified of updates to a forum or a thread; so that they can customize their profile; and so that they can be credited with their participation. To create a new user account, click on the New User link in the navigation bar near the top of the forum page. Once you have clicked on this link, the forum loads a template for creating a new user account.
Complete the fields on this form and click the Register button at the bottom. The fields with the star icon (*) are required for successfully creating a new user account. See the the section called “Profile Settings” for further explanation of the fields on this form.
Users have access to forums based on the group they belong to. The following permission-based forum groups are provided by mvnForum as a framework for enabling certain users as moderators and forum administrators
Normal user - can use avatar; send messages; add and read posts/threads; get attachments
Forum Moderator - adds to Normal user - can edit Forum/Category; delete post; manage polls (to be added); and use attachments
Forum Admin - adds to Moderator - can delete Forum/Category
User accounts can be customized by changing the user profile settings. The settings are stored by the forum and tied to each user account. Following are the profile settings available and an explanation for each
User Profile Settings
Member ID - Shows this profile user's member id. The member ID is a unique identifier used to create posts, participate in watches and moderate forums.
First Name - Shows this profile user's first name
Last Name - Shows this profile user's last name
Email - Shows the email this profile is associated with. To receive watch notifications and allow other users to contact you offline, enter a valid email account address you have access to.
Show Email - Shows whether this profile's email will be shown on posts and in the user lists. To disable the display of your email address, uncheck this option.
Name Visible - Shows whether this profile's name is visible in posts. To post anonymously using your profile, uncheck this option.
Address - Shows this user's address
City - Shows this user's city
State - Shows this user's state
Country - Shows this user's country
Gender - Shows this user's gender
Birthday - Shows this user's date of birth
Career - Shows this user's profession or avocation
Home page - Shows this user's home page or a link this user considers to be particularly intersting
Cool Link 1 - Shows a link this user considers to be particularly cool
Cool Link 2 - Shows a second link this user considers to be particularly cool
Yahoo ID - Shows the Yahoo ID for this profile. mvnForum shows this icon and a link to access the user's messenger ID on each post.
AOL ID - Shows the AOL ID for this profile. mvnForum shows this icon and a link to access the user's messenger ID on each post.
ICQ ID - Shows the ICQ ('I seek you') or client for IRC ('Internet Relay Chat') ID for this profile. mvnForum shows this icon and a link to access the user's messenger ID on each post.
MSN ID - Shows the Microsoft Messenger ID for this profile. mvnForum shows this icon and a link to access the user's messenger ID on each post.
Signature - Shows the signature this profile uses. Signatures are statements that are appended to the end of each profile.
Join Date - Shows the date this user created this profile
Last Login - Shows the date the user logged in last
Last profile update - Shows the last time this profile was updated
Posts - Shows the number of posts this user has made
Views - Shows the number of times this profile has been viewed
Once an account has been created, you can change your profile settings. The changes might reflect a new email address, a changed name, or an update to a signature.
To make a change, log in to the forum site and click on thelink in the forum navigation bar (usually located near to top of the page). Click on the link to access the profile editing form.
Make changes to your profile settings and click on thebutton at the bottom of the form.
The email address is an important part of your profile. mvnForum uses the email address to notify you of changes to forums and threads you are watching. Make sure to keep this address up to date.
To make a change, log in to the forum site and click on thelink in the forum navigation bar (usually located near to top of the page). Click on the link to access the email editing form.
Update your email address, confirm the change, and click on thebutton at the bottom of the form.
Your password is how you protect your account from being used by others to create and change forum posts under your member ID.
mvnForum stores the passwords in a database, encrypted through a common algorithm that can be comprimised by anyone with access to the database, therefor, it is advised to use a password that you are confortable with at least the administrator of the forum having access to (don't use your bank account password).
To make a change, log in to the forum site and click on thelink in the forum navigation bar (usually located near to top of the page). Click on the link to access the password editing form.
Enter your original password, enter a new password, confirm the change, and click on thebutton at the bottom of the form.
Avatars are the icons that will be displayed along with your posts, a nice way to customize your posts. You can either use an avatar provided by the forum, or provide your own avatar icon. Currently, mvnForum supports avatar images of the following formats: Jpg, Gif, and Png with heights and widths no more than 150 pixels and a total compressed size of no more than 60,000 bytes.
To change you avatar, either select from the list of predefined avatars or load you own avatar to the forum.
To use a predefined avatar image, select from the list of avatars in the list provided in section1. Click thebutton below the list
To use a your own avatar image, either click thebotton or enter the path and file name in the text box in section 2. With the name of the file in the text box, click the button to load the image onto the forum site.
The signature is a statement, quote, or disclaimer the forum will attach to the bottom of each post you make.
To make a change, log in to the forum site and click on thelink in the forum navigation bar (usually located near to top of the page). Click on the link to access the signature editing form.
Update your signature and click thebutton at the bottom of the form.
To confirm that you have entered a valid email address, you must activate your account. An activated account can participate in the forum; see Assign Member to Forum.
To activate your account, click on thelink on the login page or on the link on the My Profile page once you have logged in.
Enter your member ID and your email address and click on thebutton at the bottom of the form.
mvnForum will attempt to send this email account activation instructions. Once you receive the activation code, return to mvnforum and use the link in your activation email to activate your account.
mvnForum provides a common means to track updates to threads in a forum you have a particular interest or responses to posts you make. This means is called a watch. A watch is the request to receive notifications (currently by email) of updates to posts or threads in a forum that you are interested in following. Watches, also known as alerts, notifications and subscriptions, come in two common flavors: immediate notification and digested or summary reports; mvnForum currently supports the digested format. There are two ways to create watches; either in the Change Watches form or when replying to posts Following Posts (watches). To request watches, you must activate your account which ensure a valid email to send the watch notifications to.
To request a watch, log in to the forum site and click on thelink in the forum navigation bar (usually located near to top of the page). Click on the link to access the watch management form.
In this form, review your currently active threads. The types of watches available are global watches, category watches, forum watches, and thread watches.
Description of Watch Types
Global watch - watch all the posts in all the forums in all the categories - this could get quite busy
Category watch - watch all the posts in all the forums in in a particular category
Forum watch - watch all the posts in a particular forum
Thread watch - watch all the updates to a particular thread
To create a watch, click on thelink in the My Watch header. Select your watch type by clicking on one of the bullets in the list.
Creating Watches by Type
Global watch - the form will inform you that you will be watching the whole system
Category watch - the form will load the list of categories currently available to watch. To watch more than 1 category you must create one watch for each category.
Forum watch - the form will load the list of forums currently available to watch. The list is grouped by category with the forum names under the dashed lines. To watch more than 1 forum you must create one watch for each forum; to watch all the forums in a category, create a category watch.
Thread watch - the form will prompt you for a thread ID. Thread IDs can be seen in the URL of the page displaying the thread. Alternatively, if the URL is not available (ie, if the forum is embedded in frames), then the thread ID can be found my holding you mouse over many of the icon links on a post page.
Either select the category/forum or enter the thread id and click on thebutton at the bottom of the form.
To delete a watch, navigate to the watch summary page and click on thelink to the right of the watch you wish to terminate.
A post is a comment or question to post to a forum that should have some relationship to the topics represented in the forum. Posts that do not adhere to the theme of the forum are considered 'off topic' and quite often posting off topic is considered taboo (and can be moderated, and may even result in being banned from the forum).
To start a discussion about a topic of interest or to respond to comments or questions posed in another thread, you create a post. The first post in a thread defines the name of the thread. Therefore, the topic of the first post in a thread should be descriptive enough to give participants in a forum enough of an idea what the question is or what your opinion is that they can decide whether to participate without having to access the post's body.
A post has the following basic elements
Topic - the title of the post, which is also the title of the thread if this is the first post in the thread. Should be a concise declaration of your question or observation
Body - the full text of the post, including links to images and content on external web sites.
Post icon - an optional icon to associate with this post/thread
Signature - your signature to append to the end of the post.
Formatting - html formatting options for text and smilies icons in the post.
To access the post editing form to create a new post, either
click on thelink in the forum navigation menu to access the Category/Forum list. Click on the name of the forum to access the thread link. Click on the link near the top right corner of the list of threads in the forum.
(with a post active) click on thelink near the top right corner of the list of threads in the forum or the bottom right corner of the list of threads.
(with a post active) click on thelink in the top right corner of a particular post to reply to the post in question.
With the post editing form loaded, enter the Topic, body, post icon and click thebutton or the button at the bottom of the form.
By default, a new post will present the text the user typed into the body section as plain text without any formatting. The one exception to this is that carraige returns will be preserved and presented to readers as new lines. To edit the format of posts, use the basic formatting tools provided in the 'normal' mode or the enchanged mode which adds the ability to nest formatting tags.
To format a section of text, such as to emphasis it with bold lettering, or to include a link to an external image such as an image on a website you wish to refer to in your post, use the buttons in the Format section of the post edit page. Using the normal mode to use the formatting buttons to insert a formatting instruction, click on the button and enter the text you want to format in the given manner. In other words, to format a section of text to be bold, click on thebutton, enter the text to be made bold, and click the OK button on the dialog.
mvnForum supports at several ways to attach files to a thread or post. The first is the ability to embed an image within the body of a post; the second is to attach a file, such as supporting documentation, to a post. The process is slightly different for each method: including images make a reference to an image that must already be on the internet and accessible via a URL; attached files are uploaded to the forum server which then relates the file(s) to the post. Users can then access the files from within the post context.
n.b. To attach files, you must have file attachment permissions; members of the Power User group and above have this permission and it can be set by selecting the Add Attach permission.
To follow the action in a thread, you create a watch for the thread. Check the Change Watches section.box below the post in the Attach Options section. More on watches is found in the
mvnForum users are able to perform activities in the forum environment based on the group(s) they belong to. In addition to being able to manage forums and create threads, mvnForum will support limiting read and/or edit individual forums based on inclusion in a group. Only site administrators can currently manage group membership. See the administrator group management documentation for further information.
To search the entire site's forum content for a phrase or collection or words, enter the search phrase in the search entry and click the search button. The forum will search post topics and content for the phrase. The results of the search are returned as links to the posts. If more than one word is entered, the search will match on posts containing one or more of the words.
To search for more specific content or within a narrower frame, use the advanced search. Access the advanced search by clicking on the Search link in the main forum menu header.
In the Search Form, enter the text to search, member name, and/or select a category/forum to limit the search further. See Basic Search for more on the results to be expected by entering text in the search form.
Moderation is the process of auditing, sensoring, or guiding the direction of a conversation. Some forums have a very narrow purpose and want to make sure that all participants adhere to the principals of the forum. Other forums are intended for a young audience or want to keep their language clean. These types of forums are good candidates for moderation.
The following basic things are necessary to know about moderating forums
Users participating in a moderated forum make their posts just as they would in an unmoderated forum. The difference being that in a moderated forum, they they will not see their posts presented on the site until they have been accepted by a moderator.
The basic process for a moderated forum is: