h1. Administrator {anchor:id=Answer_user_guide.AdministratorRoleNotInToc}
{note}
The administrators have the global role and take care of the entire management tasks.
{note}

h2. Set up the Answers portlet {anchor:id=KSuser.Answer_Administrator.Set_up_Answers_portlet}

When adding the *Answers* portlet to a page, you have to configure this portlet to make it work in your desired way.

{docbook}
<citetitle>
<para>
    <emphasis role="bold">Configure the Answers portlet</emphasis>
</para>
</citetitle>
{docbook}


*1.* Open the page edit mode via one of the following ways:

* *The first way*
{docbook}
<para>
            <emphasis role="bold">i.</emphasis> Click <menuchoice><guiicon><inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Setting_gear.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Setting_gear.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject></guiicon> <guisubmenu>Portal</guisubmenu><guimenuitem>Page</guimenuitem></menuchoice> on the <emphasis role="bold">Administration</emphasis> bar.</para>
{docbook}
!images/edit_pages1.png|align="center" width="50mm" fo:scalefit="1" html:scalefit="0"!

*ii.* Click !images/Edit_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that corresponds to the page containing the *Answers* portlet in the *Page Management* page.

!images/Page_manager_page.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!     {anchor:id="page_management_page}

* *The second way*

*i.* Select a portal that contains a page with the *Answers* portlet, then open the page.
{docbook}
<para>
<emphasis role="bold">ii.</emphasis> Hover your cursor over <menuchoice><guimenuitem>
  Edit</guimenuitem><guisubmenu>Page</guisubmenu><guimenuitem>Layout</guimenuitem></menuchoice>.</para>
{docbook}
!images/Answer_page_layout.png|align="center" width="50mm" fo:scalefit="1" html:scalefit="0"!

Now, you should be in the *Edit* mode of the page.

!images/Answer_portlet_edit_mode.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*3.* Hover your cursor over the *Answers* portlet, then click !images/edit_icon3.png|width="4mm" fo:scalefit="1" html:scalefit="0"! on the quick toolbar that appears.
{docbook}
<para>
<emphasis role="bold">4.</emphasis> Make changes in the <guilabel>Answer Portlet</guilabel> form.</para>
{docbook}
!images/Answer_porlet_edit_form.png|align="center" width="130mm" fo:scalefit="1" html:scalefit="0"!

In this form, you can:
* [Change the display mode|#KSuser.Answer_Moderator.Change_display_mode]
* [Customize the email notification template|#KSuser.Answer_Moderator.Customize_Email_template]
* [Enable the "Discuss in Forum" feature|#KSuser.Answer_Moderator.Enable_discuss_in_forum]
* [Define the default category for discussions|#KSuser.Answer_Moderator.Define_discuss_category]

h3. Change the display mode {anchor:id=KSuser.Answer_Moderator.Change_display_mode}
{docbook}
<para>In the <guilabel>Display Mode</guilabel> tab, you can set all the default display properties of the <emphasis role="bold">Answers</emphasis> application, including:</para>
{docbook}
{docbook}
<itemizedlist>
              <listitem>
                <para>
                  <guilabel>Display</guilabel>: Display all entries in the <emphasis role="bold">Answers</emphasis> application for administrators and moderators.</para>
                <itemizedlist>
                  <listitem>
                    <para>
                      <guilabel>All</guilabel>: All entries, including approved and unapproved entries/questions, are displayed in a list when administrators and moderators view.</para>
                  </listitem>
                  <listitem>
                    <para>
                      <guilabel>Approved</guilabel>: Only approved entries are displayed in the list when administrators and moderators view.</para>
                  </listitem>
                </itemizedlist>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Order by</guilabel>: The order to display all questions in the <emphasis role="bold">Answers</emphasis> application.</para>
                <itemizedlist>
                  <listitem>
                    <para>
                      <guilabel>Created Date</guilabel>: Entries in the list are displayed to the entries's created date order.</para>
                  </listitem>
                  <listitem>
                    <para>
                      <guilabel>Alphabet/Index</guilabel>: Entries in the list are displayed to the alphabet order.</para>
                  </listitem>
                </itemizedlist>
              </listitem>
 </itemizedlist>
{docbook}
{docbook}
<para>The type of sorting entries in the list may be: <guilabel>Ascending</guilabel> or <guilabel>Descending</guilabel>. </para>
{docbook}
{docbook}
 <itemizedlist>
              <listitem>
                <para>
                  <guilabel>Enable Votes and Comments</guilabel>: Enable votes and comments to be available in <emphasis role="bold">Answers</emphasis>. If this checkbox is selected, users can comment and vote in <emphasis role="bold">Answers</emphasis>. If not, these functions are disabled.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Anonymous users may submit questions</guilabel>: Enable anonymous users to submit questions in <emphasis role="bold">Answers</emphasis> or not. If this checkbox is selected, anonymous users are entitled to submit questions. If not, they cannot submit questions.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Enable Automatic RSS</guilabel>: Enable the RSS feeds function to be available in Answers or not. If this option is selected, users can get RSS information in <emphasis role="bold">Answers</emphasis>.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Display Avatars</guilabel>: Enable avatars to be viewed in <emphasis role="bold">Answers</emphasis> or not. If this checkbox is selected, the avatar of eXo members are shown in <emphasis role="bold">Answers</emphasis>.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Allow users to post questions in the root category:</guilabel> Enable users to post questions in the root category or not.</para>
              </listitem>
            </itemizedlist>
{docbook}
{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}


* [View details of Answers|#Answer_user_guide.View_details]
* [Customize the email notification template|#KSuser.Answer_Moderator.Customize_Email_template]
* [Enable the "Discuss in Forum" feature|#KSuser.Answer_Moderator.Enable_discuss_in_forum]
* [Define the default category for discussions|#KSuser.Answer_Moderator.Define_discuss_category]

h3. Customize the email notification template {anchor:id=KSuser.Answer_Moderator.Customize_Email_template}
When there are new questions or answers in the category or topic that a user has watched, the user will receive the email notification.
{docbook}
<para>In the <guilabel>Email Notifications</guilabel> tab, change the content of the email notification manually or edit the template for each email notification. </para>
{docbook}
!images/Answer_porlet_edit_form2.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!
{docbook}
<itemizedlist>
              <listitem>
                <para>
                  <guilabel>New Question</guilabel> tab: The content of the email notification.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Edit/Answer</guilabel> tab: The content of the email notification that has been answered or edited.</para>
              </listitem>
              <listitem>
                <para>
                  <guilabel>Move Question</guilabel> tab: The content of the email notification that notifies about the question that has been moved to another category.</para>
              </listitem>
            </itemizedlist>
{docbook}
The followings are variables that you can use in your template:
{docbook}
<para>
<guilabel>&amp;categoryName_</guilabel>: will be replaced with the watched category.</para>
{docbook}
{docbook}
<para>
<guilabel>&amp;questionContent_</guilabel>: will be replaced with the content of the new question.</para>
{docbook}
{docbook}
<para>
<guilabel>&amp;questionResponse_</guilabel>: will be replaced with the content of the new question's reply.</para>
{docbook}
{docbook}
<para>
<guilabel>&amp;questionLink_</guilabel>: will be replaced with the link for going to new questions.</para>
{docbook}
{docbook}
<para>
 <guilabel>&amp;answerNowLink_</guilabel>: will be replaced with the link for going to new questions and open a pop-up form which allows you to answer the question.</para>
{docbook}

These variables are used to load the content dynamically. Thus, you should not edit them. In case the template is changed unexpectedly, you can go back to the default template by clicking !images/Back_to_default_btn.png|width="4mm" fo:scalefit="1" html:scalefit="0"!.
You can use the text editor to format the template as you wish.

{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}


* [View details of Answers|#Answer_user_guide.View_details]
* [Change the display mode|#KSuser.Answer_Moderator.Change_display_mode]
* [Enable the "Discuss in Forum" feature|#KSuser.Answer_Moderator.Enable_discuss_in_forum]
* [Define the default category for discussions|#KSuser.Answer_Moderator.Define_discuss_category]

h3. Enable the "Discuss in Forum" feature {anchor:id=KSuser.Answer_Moderator.Enable_discuss_in_forum}
{docbook}
<para>In the <guilabel>Discussion</guilabel> tab, enable/disable the <emphasis role="bold">Discuss in Forum</emphasis> function in <emphasis role="bold">Answers</emphasis> and set the default forum for this function by selecting/deselecting the checkbox.</para>
{docbook}
!images/Answer_porlet_edit_form3.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}


* [View details of Answers|#Answer_user_guide.View_details]
* [Change the display mode|#KSuser.Answer_Moderator.Change_display_mode]
* [Customize the email notification template|#KSuser.Answer_Moderator.Customize_Email_template]
* [Define the default category for discussions|#KSuser.Answer_Moderator.Define_discuss_category]

h3. Define the default category for discussions {anchor:id=KSuser.Answer_Moderator.Define_discuss_category}
{docbook}
<para>
              <emphasis role="bold">1.</emphasis> Click <inlinemediaobject>
                <imageobject role="fo">
                  <imagedata fileref="images/Plus_icon.png" format="PNG" scalefit="1" width="4mm"/>
                </imageobject>
                <imageobject role="html">
                  <imagedata fileref="images/Plus_icon.png" format="PNG" scalefit="0" width="4mm"/>
                </imageobject>
              </inlinemediaobject> next to the <guilabel>Select a forum</guilabel> field to open the <guilabel>Select a forum</guilabel> form in the <guilabel>Discussion</guilabel> tab.</para>
{docbook}
!images/Select_forum_form.png|align="center" width="80mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click a specific category/forum title to select it.
{docbook}
<para>
<emphasis role="bold">3.</emphasis> Click <guibutton>Save</guibutton> to accept saving changes in the <guilabel>Discussion</guilabel> tab.</para>
{docbook}

{docbook}
<citetitle>
<para>
    <emphasis role="bold">Select the category scoping</emphasis>
</para>
</citetitle>
{docbook}

{docbook}
<para>In the <guilabel>Category Scoping</guilabel> tab, show/hide categories in <emphasis role="bold">Answers</emphasis>. The hidden category is not displayed in <emphasis role="bold">Answers</emphasis>.</para>
{docbook}
!images/Answer_porlet_edit_form4.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!
{docbook}
<para>To hide/show any category, simply deselect/select its checkbox and click <guibutton>Save</guibutton>.</para>
{docbook}
{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}


* [View details of Answers|#Answer_user_guide.View_details]
* [Change the display mode|#KSuser.Answer_Moderator.Change_display_mode]
* [Customize email notification template|#KSuser.Answer_Moderator.Customize_Email_template]
* [Enable the "Discuss in Forum" feature|#KSuser.Answer_Moderator.Enable_discuss_in_forum]

h2. Set up the FAQ portlet {anchor:id=KSuser.Answer_Moderator.Set_up_FAQ_portlet}

The *FAQ* portlet can be added to a page for users to view questions and answers quickly and easily.

!images/FAQ_screen.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

The *Edit Mode* of the *FAQ* portlet allows you to set the properties to display questions and answers in the View mode.

{docbook}
<citetitle>
<para>
    <emphasis role="bold">Configure the FAQ portlet</emphasis>
</para>
</citetitle>
{docbook}
{docbook}
<para>
            <emphasis role="bold">1.</emphasis> Click <menuchoice> <inlinemediaobject>
              <imageobject role="fo">
                <imagedata fileref="images/Setting_gear.png" format="PNG" scalefit="1" width="4mm"/>
              </imageobject>
              <imageobject role="html">
                <imagedata fileref="images/Setting_gear.png" format="PNG" scalefit="0" width="4mm"/>
              </imageobject>
            </inlinemediaobject><guisubmenu>Portal</guisubmenu><guimenuitem>Pages</guimenuitem></menuchoice>.</para>
{docbook}
!images/edit_pages1.png|align="center" width="50mm" fo:scalefit="1" html:scalefit="0"!

The *Page Manager* page will be displayed.

!images/Page_manager_page.png|align="center" width="150mm" fo:scalefit="1" html:scalefit="0"!

*2.* Click !images/edit_icon.png|width="4mm" fo:scalefit="1" html:scalefit="0"! that corresponds to the *FAQ* page in the page list. Now, you should be in the page edit mode.

*3.* Hover your cursor over the *FAQ* portlet and click !images/edit_icon3.png|width="4mm" fo:scalefit="1" html:scalefit="0"! in the quick edit toolbar that appears.

!images/FAQ_portlet_edit.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">i.</emphasis> In the <guilabel>Display Category</guilabel> tab, you can control what categories will be displayed.</para>
{docbook}

!images/FAQ_portlet_edit_form.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

{docbook}
<para>
<emphasis role="bold">ii.</emphasis> In the <guilabel>Edit Template</guilabel> tab, you can use CSS to customize the <emphasis role="bold">FAQ</emphasis> template.</para>
{docbook}
!images/FAQ_portlet_edit_form2.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

This is an example of the *FAQ* template after applying the new style.

!images/FAQ_template_edit.png|align="center" width="140mm" fo:scalefit="1" html:scalefit="0"!
{docbook}
<para>
<emphasis role="bold">iii.</emphasis> In the <guilabel>Preference</guilabel> tab, you can enable or disable the bookmarkable URLs in <emphasis role="bold">FAQ</emphasis>.</para>
{docbook}
!images/FAQ_portlet_edit_form3.png|align="center" width="120mm" fo:scalefit="1" html:scalefit="0"!

By not using Ajax, the *FAQ* will generate plain URLs in the links. The added benefit will be bookmarkability and better SEO as the links will be permalinks.
Using Ajax, the links will be JavaScript-based and generate Ajax calls. This should make browsing faster because the whole page is not reloaded.

{docbook}
<para>
<prompt>
    <emphasis role="bold">See also</emphasis>
</prompt>
</para>
{docbook}

* [View details of Answers|#Answer_user_guide.View_details]
* [Set up the Answers portlet|#KSuser.Answer_Administrator.Set_up_Answers_portlet]