h1. Overview

FAQ is configured mainly in two files:

- Portlet preferences:


* /webapps/faq/WEB-INF/portlet.xml


- Services configuration: 


* WEB-INF/conf/ks-plugins-configuration.xml 


{info}
For general KS configuration information, please refer to [KS Configuration| KS:KS Manual#Configuration] section.
{info}


h1. Portlet Preferences

FAQ portlet has preferences that you can configure to alter the behavior.

At the runtime, you can use the portlet EDIT mode to set the preferences: 

!images/DisplayMode.png!

Alternatively, you can configure the portlet in the _portet-preferences.xml_ file.

|| Preference name || Possible value || Default value || Description ||
| *display* | {{approved}}, {{both}} | {{both}} | To indicate if only unapproved questions are hidden to normal users. |
| *orderBy* | {{alphabet}}, {{created}} | {{alphabet}} | To specify the default sort order for questions. |
| *orderType* | {{asc}}, {{desc}} | {{asc}} | To specify the default sort direction which is ascending or descending. |
| *SendMailAddNewQuestion* | {{email notification template}} | {{blank}} | The template for email notifications when a new FAQ entry is added. A blank value will use the default template. |
| *SendMailEditResponseQuestion* | {{email notification template}} | {{blank}} | The template for email notifications when a new FAQ entry is added. A blank value will use the default template. |
| *enableVotesAndComments* | {{true}}, {{false}} | {{true}} | To enable or disable votes and comments. |
| *enableAutomaticRSS* | {{true}}, {{false}} | {{true}} | To enable or disable the RSS feature. |
| *isDiscussForum* | {{true}}, {{false}} | {{false}} | To enable or disable the discussion in forums. |
| *pathNameCategoryForum* | {{any value}} | {{blank}} | To define the forum path which is used for discussion. A blank value means the forum path will be defined later in the FAQ portlet settings. |
| *enableViewAvatar* |{{true}}, {{false}} | {{true}} | To enable or disable the avatar to be viewed. |


* Default Portlet Preferences

As a reference, the  default _portlet.xml_ for the FAQ application is: 

{code:xml}
<portlet-preferences>
  <preference>
    <name>display</name>
    <value>both</value> <!-approved/both ->
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>SendMailAddNewQuestion</name>
    <value> </value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>SendMailEditResponseQuestion</name>
    <value> </value>
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>orderBy</name>
    <value>alphabet</value> <!-alphabet/created ->
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>orderType</name>
    <value>asc</value>      <!- asc/desc ->
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>enableAutomaticRSS</name>
    <value>true</value> <!- true/false ->
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>enableVotesAndComments</name>
    <value>true</value> <!- true/false ->
    <read-only>false</read-only>
  </preference>
  <preference>
    <name>isDiscussForum</name>
    <value>false</value>
    <read-only>false</read-only>
  </preference>
  <preference>
     <name>pathNameCategoryForum</name>
     <value> </value>
     <read-only>false</read-only>
   </preference>
  <preference>
      <name>enableViewAvatar</name>
      <value>true</value> <!- true/false ->
      <read-only>false</read-only>
  </preference>
</portlet-preferences>    
{code}
