<?xml version="1.0" encoding="iso-8859-1"?>

<!DOCTYPE article
  PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "file:/c:/docbook/dtd/docbookx.dtd"
  [
    <!ENTITY % global.entities SYSTEM "file:/c:/docbook/include/global.xml">
    %global.entities;

    <!ENTITY % entities SYSTEM "entities.xml">
    %entities;
  ]
>
<article class="faq" id="index">

 <articleinfo>
  <title>mvnForum FAQ

  <author>
     <firstname>Cord
     <surname>Thomas
     <affiliation>
        <jobtitle>Software Architect
        <orgname>Lupine Information Systems
        <address>cord_sw (at) lupinex.com
     </affiliation>
  </author>

  <revhistory>
   <revision>
    <revnumber>v0.0.10
    <date>5 June 2003
    <authorinitials>cat
    <revremark>
     Prepared forum FAQ for RC1 - first round</revremark>
   </revision>
  </revhistory>
  
  <abstract>
    <para>This is a FAQ for the mvnForum developed by 
    MyVietnam.net</ulink>.  The latest version of mvnForum can be found at 
    www.mvnforum.com</ulink>.  It is intended as a supplement to the existing
    mvnForum documenation, to cover questions that keep occurring on the
    mailing list.  PLEASE read this document before your post to the
    list.</para>
  </abstract>

 </articleinfo>

 <qandaset>

   <qandadiv>
    <title>General

    <qandaentry>
      <question>
        <para>What is mvnForum?
      </question>
      <answer>
        <para>mvnForum is an open source, powerful, easy to use, easy to
         setup bulletin board (forum) developed following Java J2EE standards
         and technologies (Jsp/Servlet).</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>What license is mvnForum released under?
      </question>
      <answer>
        <para>mvnForum is a free, open-source project released under
         the terms of the GNU General Public License. </para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Where can I see the update-to-date version of this FAQ?
      </question>
      <answer>
        <para>The lastest version of this FAQ are 
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Where can I see a list of forum features?
      </question>
      <answer>
        <para>The lastest information about forum features are 
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Who has developed mvnForum?
      </question>
      <answer>
        <para>The core mvnForum framework is being developed by a group of
         dedicated Vietnamese developers at <ulink url="http://www.MyVietnam.net">
         MyVietnam.net</ulink>
      </answer>
    </qandaentry>
  </qandadiv>

     <qandadiv>
    <title>Installation
    <qandaentry>
      <question>
        <para>Where do I get the latest binary installation of the mvnForum?
      </question>
      <answer>
        <para>The latest mvnForum release can be found 
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Where do I get the latest source code for development?
      </question>
      <answer>
        <para>See these notes for accessing the source via CVS 
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>What databases are currently supported?
      </question>
      <answer>
        <para>The goal is to support ALL major database vendors that supply JDBC drivers that support JDBC 2.0 standards 
      </answer>
      <answer>
        <para>The following databases are supported and have been tested: MySQL 3.23.51, postgreSQL 7.3, Oracle 8i 8.1.7, Microsoft SQL Server 2000, and hsqldb 1.7.1
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>What Application Servers are supported?
      </question>
      <answer>
        <para>mvnForum can be installed on any Servlet Container which supports Jsp 1.2 and Servlet 2.3.
      </answer>
      <answer>
        <para>mvnForum has been tested on the following Application Servers: Apache Tomcat 4.1.7, 4.1.10, 4.1.12, 4.1.18,
         and Resin 2.1.4 </para>
      </answer>
    </qandaentry>

         <qandaentry>
       <question>
         <para>What user authentication protocols are supported?
       </question>
       <answer>
         <para>mvnForum supports a realm authentication model, customized authentication model and the
           typical user name/password authentication.</para>
       </answer>
       <answer>
         <para>Here are some links on people's efforts to implement realm authentication in mvnForum
           <itemizedlist>
             <listitem>LDAP
             <listitem>Tomcat JDBC Realm
             <listitem>WebLogic
             <listitem>Websphere
           </itemizedlist>
         </para>
       </answer>
     </qandaentry>

 </qandadiv>

  <qandadiv>
    <title>Administration

    <qandaentry>
      <question>
        <para>How do I add a new Forum to a Category?
      </question>
      <answer>
        <para>Forum categories are top-level groups of forums.  An administrator can create categories, add and remove
             forums from a category and remove categories.</para>
        <para>To add a category, from the Administrator's control panel, access the Forum Management
              page and click on the Add new Category link near the top of the page to load the
              category creation screen.  A category simply has a name and a description.  Use a short enough
              description to give forum users a concise understanding of the types of forums they will expect to find
              in the category.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Should I associate the Admin section of the forum with an easy to identify URL?
      </question>
      <answer>
        <para>It is up to you, but by default, we suggest not doing this so as to minimize users
         attempts to access the administration site.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Can I restrict certain users to specific Forums?
      </question>
      <answer>
        <para>That feature is not currently supported. See the  list for the
          intended inclusion of this capability</para>
      </answer>
    </qandaentry>

        <qandaentry>
      <question>
        <para>Can a forum be moderated?
      </question>
      <answer>
        <para>Yes, beginning with RC1, a moderator can moderate all the forums at a site.  The plan is
        to all moderators to be given permission to moderate indiviual forums.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>What do I have to do to localize mvnForum?
      </question>
      <answer>
        <para>Support a new language in mvnForum is very easy, just translate the file
         mvnForum_i18n.properties, then change the file name to
         mvnForum_i18n_.properties. Update the build.xml to support your new
         locale and/or change the file build.properties to make your new locale
         as the default displayed language.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>How do I change the default displayed language in mvnForum?
      </question>
      <answer>
        <para>If you are building mvnForum, just change the file build.properties to the appropriate values.
      </answer>
      <answer>
        <para>If you want to change the default displayed language in the
          binary distribution package, just copy all the files from the
          subfolder of webapp\mvnplugin\mvnforum\user that contains
          your preferred language to the webapp\mvnplugin\mvnforum\user.
          For example, if you want to change the default language to
          Vietnamese, just copy all files from folder webapp\mvnplugin\mvnforum\user\vi to
          folder webapp\mvnplugin\mvnforum\user </para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Does mvnForum support Internationalization (i18n)?
      </question>
      <answer>
        <para>Yes. mvnForum uses unicode in the backend, so it supports (in theory) ALL languages.
      </answer>
    </qandaentry>
  </qandadiv>

    <qandadiv>
    <title>User

    <qandaentry>
      <question>
        <para>Can I delete a post I made?
      </question>
      <answer>
        <para>You cannot delete your post unless you are a moderator. However, you can edit your
        post in a limited amount of time (1 week). If you do want to
        delete your post, please contact your forum moderators/administrators and tell them to delete it.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Can I follow a thread?
      </question>
      <answer>
        <para>At RC1, you are able to follow progress on a thread by creating a Watch for the thread.
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>What sort of files can I attach to a forum post?
      </question>
      <answer>
        <para>At RC1, you are able to attach files, image files are automaticaly displayed in the web post.
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>What HTML tags are supported? How can I add new tags to the list of supported tags? 
      </question>
      <answer>
        <para>For the list of supported tags, review the features 
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>What do the icons to the left of each post in the recent thread and forum index pages indicate?
      </question>
      <answer>
        <para>I am sure glad you asked; the icons come in 4 colors and mean this
           <itemizedlist>
             <listitem>Blue - light - thread
             <listitem>Blue - dark  - thread with new posts added since your last login
             <listitem>Red  - light - a hot thread (has had many posts)
             <listitem>Red  - dark -  a hot thread (has had many posts) with new posts since your last visit
           </itemizedlist>
         </para>
      </answer>
    </qandaentry>

        <qandaentry>
      <question>
        <para>How does Who's Online work?
      </question>
      <answer>
        <para>mvnForum tracks users who are online in the OnlineUserManager class, implemented as
          a TreeMap of logged in and anonymous users.</para>
        <para>the net.myvietnam.mvnplugin.mvnforum.auth is responsible for managing user sessions which
        includes removing them from the OnlineUserManager TreeMap when they have changed from anonymous
        to authenticated (or vice-versa) or timed out their session.</para>
        <para>source: mvnForum
      </answer>
    </qandaentry>

  </qandadiv>

  <qandadiv>
    <title>Development

    <qandaentry>
      <question>
        <para>Can i help with development?
      </question>
      <answer>
        <para>This is an open source project initiated by and managed by the talented developers
          at <ulink url="http://www.myVietnam.net">MyVietnam.net.  To inquire about opportunities
          to help with development efforts, contact <email>minhnn_at_MyVietnam.net
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>How do I change the colors and fonts?
      </question>
      <answer>
        <para>The majority of the styles in mvnForum are defined by a single
          point of entry for cascading style sheets. Copy the existing
          style.css file and make the changes you want to.</para>
      </answer>
    </qandaentry>

    <qandaentry>
      <question>
        <para>Can I incorporate the mvnForum site in my site?
      </question>
      <answer>
        <para>The easiest way to merge the mvnForum into your existing site is to modify the header.jsp to match your site template.
      </answer>
      <answer>
        <para>Examples of existing integrated forums are
        <itemizedlist>
         <listitem>CG Channel
         <listitem>Desiest.com
         <listitem>Lupinex.com
        </itemizedlist>
        </para>
      </answer>
    </qandaentry>
   </qandadiv>

  <qandadiv>
    <title>Suggest new FAQs

    <qandaentry>
      <question>
        <para>How can i contribute a FAQ?
      </question>
      <answer>
        <para>If you have thought of a question that is not answered above, email the FAQ Keeper cord_sw_at_lupinex.com
           </email> or post a request at 
      </answer>
    </qandaentry>
  </qandadiv>

 </qandaset>

</article>