<?xml version='1.0' encoding='UTF-8'?>
<!-- This document was created with Syntext Serna Free. --><!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN" "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!ENTITY % BOOK_ENTITIES SYSTEM "../../User_Guide.ent">
%BOOK_ENTITIES;
]>
<section id="sect-User_Guide-Newsletters">
<title>Manage newsletters</title>
  <para>
  &PRODUCT; provides the <emphasis role="bold">Newsletters</emphasis> service, aiming at helping users quickly get the updated newsletters from a website.
 </para>
  <section id="sect-User_Guide-Newsletters-Newsletter_Viewer">
    <title>Newsletter viewer</title>
	<note>
   <para>
    The <emphasis role="bold">Newsletter</emphasis> portlet is deprecated in eXo Platform. It remains fully supported for eXo customers, however it will not receive any enhancement and will be removed from the product scope in the future.
   </para>
   </note>
    <para>With <emphasis role="bold">Newsletters,</emphasis> you can instantly get newsletters from your email to update the last information about categories and subscriptions.</para>
    <citetitle>
	<para><emphasis role="bold">
   Subscribe your email to get newsletters from eXo Service
   </emphasis>
  </para>
  </citetitle>
    <procedure>
      <step>
        <para>
     Go to <emphasis role="bold">Newsletters</emphasis> on the <emphasis role="bold">Navigation</emphasis> bar. The <emphasis role="bold">Newsletters</emphasis> page will appear.
    </para>
        <mediaobject>
           <imageobject role="html">
              <imagedata fileref="images/newsletters-newsletter_viewer.png" format="PNG" align="center"/>
           </imageobject>
           <imageobject role="fo">
              <imagedata fileref="images/newsletters-newsletter_viewer.png" format="PNG" align="center" width="150mm" />
           </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
     Enter your email address in the <emphasis role="bold">Your Email</emphasis> field.
    </para>
      </step>
      <step>
        <para>
     Select the checkbox corresponding to the subscription that you want to get newsletters.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Subscribe.</emphasis> A message informing that you have just subscribed to the selected newsletter will appear.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">OK</emphasis> in the confirmation message. You can reselect the subscription that you want or do not want to receive newsletters by re-selecting the checkbox in the <emphasis role="bold">Check to subscribe</emphasis> column.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Change your subscriptions</emphasis> to update your changes.
    </para>
      </step>
      <step>
        <para>
     Click <emphasis role="bold">Forget this email</emphasis> if you want to unsubscribe from newsletters.
    </para>
      </step>
    </procedure>
  </section>
  <section id="sect-User_Guide-Newsletters-Manage_Newsletters">
    <title>Newsletter Manager</title>
	<note>
   <para>
    The <emphasis role="bold">Newsletter Manager</emphasis> portlet is deprecated in eXo Platform. It remains fully supported for eXo customers, however it will not receive any enhancement and will be removed from the product scope in the future.
   </para>
   </note>
    <para>
   &PRODUCT; facilitates administrators to easily and quickly manage newsletters.
  </para>
    <para>To use this portlet, you first need to add it to a specific page by dragging and dropping <emphasis role="bold">Newsletter Manager</emphasis> from
      <emphasis role="bold">Page Editor</emphasis> to the main pane. This can be done when
      <link linkend="sect-User_Guide-Page_Creation_Wizard">creating a new page</link>
      or <link linkend="sect-User_Guide-Manage_Pages-Edit_a_Page">editing an existing page</link>
      or <link linkend="proc-User_Guide-Manage_Portals-Edit_Layout">editing the layout of a portal</link>.
  </para>
  <mediaobject>
    <imageobject role="html">
      <imagedata align="center" fileref="images/NewsletterManagementPortlet.png" format="PNG"/>
    </imageobject>
    <imageobject role="fo">
      <imagedata align="center" fileref="images/NewsletterManagementPortlet.png" format="PNG" width="150mm"/>
    </imageobject>
  </mediaobject>
  <note>
  <para>
  In eXo Platform, the <emphasis role="bold">Newsletter Manager</emphasis> portlet is put in <emphasis role="bold">Page Editor --> Applications --> Newsletter.</emphasis>
  </para>
  </note>
    <para>Access the page with the <emphasis role="bold">Newsletter Manager</emphasis> portlet to open the <emphasis role="bold">newsletter</emphasis> page.</para>
    <mediaobject>
       <imageobject role="html">
          <imagedata fileref="images/newsletters-newsletter_manager.png" format="PNG" align="center"/>
       </imageobject>
       <imageobject role="fo">
          <imagedata fileref="images/newsletters-newsletter_manager.png" format="PNG" align="center" width="150mm" />
       </imageobject>
    </mediaobject>
    <section id="sect-User_Guide-Manage_Newsletters-Category_Management">
      <title>Manage categories in Newsletter</title>
		<para>Managing categories in <emphasis role="bold">Newsletter</emphasis> includes the following actions:</para>
		<itemizedlist>
		<listitem>
		<para>
		<link linkend='sect-User_Guide-Category_Management-Add_a_new_category'>Add a new category</link>
		</para>
		</listitem>
		<listitem>
		<para>
		<link linkend='sect-User_Guide-Category_Management-Edit_a_category'>Edit a category</link>
		</para>
		</listitem>
		<listitem>
		<para>
		<link linkend='sect-User_Guide-Category_Management-Delete_a_category'>Delete a category</link>
		</para>
		</listitem>
		<listitem>
		<para>
		<link linkend='sect-User_Guide-Category_Management-Manage_Users'>Manage users</link>
		</para>
		</listitem>
		</itemizedlist>
	<section id="sect-User_Guide-Category_Management-Add_a_new_category">
        <title>Add a new category</title>
        <procedure>
          <step>
            <para>
       Click <emphasis role="bold">New Category</emphasis> on the <emphasis role="bold">Action</emphasis> bar of the <emphasis role="bold">Newsletter</emphasis> page. The  <emphasis role="bold">Create New Category</emphasis> form will appear.
      </para>
            <mediaobject>
               <imageobject role="html">
                  <imagedata fileref="images/newsletters-category_form.png" format="PNG" align="center"/>
               </imageobject>
               <imageobject role="fo">
                  <imagedata fileref="images/newsletters-category_form.png" format="PNG" align="center" width="116mm" />
               </imageobject>
            </mediaobject>
              <para><emphasis role="bold">Details:</emphasis></para>
            <table id="tabl-User_Guide-Add_a_new_category-Category_Form_Field_Details">
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry> Field </entry>
                    <entry> Description </entry>
                  </row>
                </thead>
                <tbody>
                    <row>
                    <entry><emphasis role="bold">Asterisk (*) </emphasis> </entry>
                    <entry>This mark next to each field means that it is required to enter values into that field. </entry>
                  </row>
                  <row>
                    <entry><emphasis role="bold">Name</emphasis> </entry>
                    <entry> The name of a category. </entry>
                  </row>
                  <row>
                    <entry><emphasis role="bold">Title</emphasis> </entry>
                    <entry> The title of a category. </entry>
                  </row>
                  <row>
                    <entry><emphasis role="bold">Description</emphasis> </entry>
                    <entry> A brief description of the category. </entry>
                  </row>
                  <row>
                    <entry><emphasis role="bold">Moderator</emphasis> </entry>
                    <entry> Select users/groups who have rights to manage this category. </entry>
                  </row>
                </tbody>
              </tgroup>
            </table>
          </step>
          <step>
            <para xml:id="step-User_Guide-Add_a_new_category-Input_values_for_fields">Input values into fields.</para>
                 <para>
                      <emphasis role="bold">i.</emphasis>
                      Select a moderator for a category by clicking
                      <inlinemediaobject>
                          <imageobject>
                              <imagedata fileref="images/usericon.png" format="PNG" width="3mm" scalefit="1"/>
                          </imageobject>
                          <textobject>
                              <phrase>"Select user"</phrase>
                          </textobject>
                      </inlinemediaobject>
                      next to the
                      <emphasis role="bold">Moderator</emphasis>
                      field to open the 
                      <emphasis role="bold">User Selector</emphasis>
                      form.
                  </para>
                <mediaobject>
               <imageobject role="html">
                  <imagedata fileref="images/newsletters-user_selector_form.png" format="PNG" align="center"/>
               </imageobject>
               <imageobject role="fo">
                  <imagedata fileref="images/newsletters-user_selector_form.png" format="PNG" align="center" width="150mm"/>
               </imageobject>
                </mediaobject>
                  <itemizedlist>
                      <listitem>
                              <para>
                                  Click
                                  <inlinemediaobject>
                                      <imageobject>
                                          <imagedata fileref="images/greentick.png" format="PNG" width="4mm" scalefit="1"/>
                                      </imageobject>
                                      <textobject>
                                          <phrase>green tick</phrase>
                                      </textobject>
                                  </inlinemediaobject>
                                  corresponding to a user in the list that you want to select.
                              </para>
                      </listitem>
                  </itemizedlist>

                  <para>
                      <emphasis role="bold">ii.</emphasis>
                      Click
                      <inlinemediaobject>
                          <imageobject>
                              <imagedata fileref="images/grouppermission.png" format="PNG" width="4mm" scalefit="1"/>
                          </imageobject>
                          <textobject>
                              <phrase>"Select membership"</phrase>
                          </textobject>
                      </inlinemediaobject>
                      to select users in a specific group. The
                      <emphasis role="bold">Group selector</emphasis>
                      window will appear.
                  </para>
                  <mediaobject>
                      <imageobject role="html">
                          <imagedata fileref="images/newsletters-group_selector_form.png" format="PNG" align="center"/>
                      </imageobject>
                      <imageobject role="fo">
                          <imagedata fileref="images/newsletters-group_selector_form.png" format="PNG" align="center"
                                     width="120mm" scalefit="1"/>
                      </imageobject>
                  </mediaobject>
                  <itemizedlist>
                      <listitem>
                          <para>
                              Select a group from the left pane and a membership type from the right pane.</para>
                          <para>The
                              membership and group selected will be displayed in the
                              <emphasis role="bold">Moderator</emphasis>
                              field.
                          </para>
                      </listitem>
                  </itemizedlist>
              </step>
              <step>
                  <para>Click <emphasis role="bold">Save</emphasis> to accept creating a new category.</para>

                 <para>You will see your added category in the list of categories.
					  </para>
			<itemizedlist>
			<listitem>
            <para>After creating a category, you can create new subscriptions or newsletters for this category.</para>
			</listitem>
			<listitem>
            <para>When clicking the <emphasis role="bold">Administration</emphasis> button, you will see a drop-down menu consisting of all actions on this category.</para>
			</listitem>
			</itemizedlist>
          </step>
        </procedure>
      </section>
      <section id="sect-User_Guide-Category_Management-Edit_a_category">
        <title>Edit a category</title>
        <procedure>
          <step>
            <para>
              Select a category that you want to edit.
             </para>
             </step>
             <step>
             <para>
              Click
              <emphasis role="bold">Administration --> Edit Category</emphasis> from the drop-down menu.
            </para>
            <mediaobject>
              <imageobject role="html">
                <imagedata fileref="images/EditCategory1.png" format="PNG" align="center"/>
              </imageobject>
              <imageobject role="fo">
                <imagedata fileref="images/EditCategory1.png" format="PNG" align="center" width="150mm"/>
              </imageobject>
            </mediaobject>
            <para>The
              <emphasis role="bold">Create New Category</emphasis>
              form appears.
            </para>
          </step>
          <step>
            <para>
       Change the values in the <emphasis role="bold">Title</emphasis> and <emphasis role="bold">Description</emphasis> fields as required.
      </para>
	  <note>
	  <para>
	  The category name cannot be changed.
	  </para>
	  </note>
          </step>
          <step>
            <para>
       Click <emphasis role="bold">Save </emphasis>to save all changes.
      </para>
          </step>
        </procedure>
      </section>
      <section id="sect-User_Guide-Category_Management-Delete_a_category">
        <title>Delete a category</title>
        <procedure>
          <step>
            <para>
              Select a category that you want to edit.
              </para>
              </step>
              <step>
              <para>
              Click
              <emphasis role="bold">Administration</emphasis>, then select <emphasis role="bold">Delete Category</emphasis> from the drop-down menu.
            </para>
          </step>
          <step>
            <para>
       Click <emphasis role="bold">OK</emphasis> in the confirmation message to delete the category.
      </para>
          </step>
        </procedure>
      </section>
      <section id="sect-User_Guide-Category_Management-Manage_Users">
        <title>Manage users</title>
        <para>
     Administrators can manage users accounts and activities with actions, such as <emphasis>editing, banning, removing bans,</emphasis> or <emphasis>deleting.</emphasis>
    </para>
        <procedure>
          <step>
            <para>
             Select a category that you want to edit.
            </para>
          </step>
          <step>
          <para>
              Select
              <emphasis role="bold">Administration --> Manage Users</emphasis>
              from the drop-down menu.
            </para>
            <mediaobject>
              <imageobject role="html">
                <imagedata align="center" fileref="images/ManageUsers-Cat.png" format="PNG"/>
              </imageobject>
              <imageobject role="fo">
                <imagedata align="center" fileref="images/ManageUsers-Cat.png" format="PNG" width="142mm"/>
              </imageobject>
            </mediaobject>
            <para>The
              <emphasis role="bold">Manage Users</emphasis>
              form will appear.
            </para>
            <mediaobject>
              <imageobject role="html">
                <imagedata  align="center"  fileref="images/newsletters_manage_users_form.png" format="PNG"/>
              </imageobject>
              <imageobject role="fo">
                <imagedata   align="center" fileref="images/newsletters_manage_users_form.png" format="PNG" width="120mm" scalefit="1"/>
              </imageobject>
            </mediaobject>
            <para><emphasis role="bold">Details:</emphasis></para>
            <table>
              <tgroup cols="2">
                <thead>
                  <row>
                    <entry> Field </entry>
                    <entry> Description </entry>
                  </row>
                </thead>
                <tbody>
                  <row>
                    <entry><emphasis role="bold"> Email</emphasis> </entry>
                    <entry> The email address of user who has subscribed this subscription. </entry>
                  </row>
                  <row>
                    <entry><emphasis role="bold">Banned</emphasis> </entry>
                    <entry>
                      <para>
            This field has two values:
           </para>
                      <variablelist>
                        <varlistentry>
                          <term><emphasis role="bold">False</emphasis></term>
                          <listitem>
                            <para>
               The user is allowed to get email.
              </para>
                          </listitem>
                        </varlistentry>
                        <varlistentry>
                          <term><emphasis role="bold">True</emphasis></term>
                          <listitem>
                            <para>
               The user is not allowed to get email.
              </para>
                          </listitem>
                        </varlistentry>
                      </variablelist>
                    </entry>
                  </row>
                  <row>
                    <entry>
                      <inlinemediaobject>
                        <imageobject>
                          <imagedata fileref="images/newsletters_ban_icon.png" format="PNG" width="5mm" scalefit="1"/>
                        </imageobject>
                      </inlinemediaobject>
                    </entry>
                    <entry> Ban this user from receiving emails. </entry>
                  </row>
                  <row>
                    <entry>
                      <inlinemediaobject>
                        <imageobject>
                          <imagedata fileref="images/newsletters_unban_icon.png" format="PNG" width="5mm" scalefit="1"/>
                        </imageobject>
                      </inlinemediaobject>
                    </entry>
                    <entry> Remove a ban on a user. </entry>
                  </row>
                  <row>
                    <entry>
                      <inlinemediaobject>
                        <imageobject>
                          <imagedata fileref="images/trashicon.png" format="PNG" width="5mm" scalefit="1"/>
                        </imageobject>
                      </inlinemediaobject>
                    </entry>
                    <entry> Delete the user. </entry>
                  </row>
                </tbody>
              </tgroup>
            </table>
          </step>
          <step>
            <para>
       Click <emphasis role="bold">Close</emphasis> to close the form.
      </para>
          </step>
        </procedure>
      </section>
    </section>
    <section id="sect-User_Guide-Manage_Newsletters-Subscriptions">
      <title>Subscriptions</title>
      <para>
    Administrators can add more subscriptions to any category via two ways as follows:
   </para>
   <para xml:id="proc-User_Guide-Subscriptions-Method_One"><emphasis role="bold">The first way</emphasis></para>
      <procedure>
        <step>
          <para>
      Click <emphasis role="bold">New Subscription</emphasis> on the <emphasis role="bold">Action</emphasis> bar.
       <mediaobject>
            <imageobject role="html">
              <imagedata  align="center"  fileref="images/NewSubscription.png" format="PNG"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata   align="center" fileref="images/NewSubscription.png" format="PNG" width="128mm"/>
            </imageobject>
          </mediaobject>
     </para>
          <para>
      The <emphasis role="bold">Create New Subscription</emphasis> form will appear.
     </para>
          <mediaobject>
            <imageobject role="html">
              <imagedata  align="center"  fileref="images/newsletters_subscription_form.png" format="PNG"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata   align="center" fileref="images/newsletters_subscription_form.png" format="PNG" width="100mm"/>
            </imageobject>
          </mediaobject>
          <para><emphasis role="bold">Details:</emphasis></para>
          <table>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry> Field </entry>
                  <entry> Description </entry>
                </row>
              </thead>
              <tbody>
               <row>
                  <entry><emphasis role="bold"> Asterisk (*) </emphasis></entry>
                  <entry> This mark next to each field means that it is required to enter values into that field. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold">Category</emphasis> </entry>
                  <entry> The category which contains this subscription. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold"> Name</emphasis> </entry>
                  <entry> The name of the subscription. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold">Title</emphasis> </entry>
                  <entry> The title of the subscription. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold"> Description</emphasis> </entry>
                  <entry> The brief description about the subscription. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold">Redactor</emphasis> </entry>
                  <entry> Select users/groups who have rights to manage this subscription. </entry>
                </row>
              </tbody>
            </tgroup>
          </table>
        </step>
        <step>
          <para>
            Click the
            <emphasis role="bold">Category</emphasis>
            field
            and select a category from the drop-down menu.
          </para>
        </step>
        <step>
          <para>
      Enter the rest of their values in the form.
     </para>
        </step>
        <step>
          <para>
      Click <emphasis role="bold">Save</emphasis> to create the new subscription.
     </para>
        </step>
      </procedure>
	  <para xml:id="proc-User_Guide-Subscriptions-Method_Two"><emphasis role="bold">The second way</emphasis></para>
      <procedure>
        <step>
          <para>
      Click directly the category to which you want to add a new subscription.
     </para>
          <mediaobject>
            <imageobject role="html">
              <imagedata  align="center"  fileref="images/newsletters_direct_category_subscription.png" format="PNG"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata   align="center" fileref="images/newsletters_direct_category_subscription.png" format="PNG" width="150mm"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
      Click <emphasis role="bold">New Subscription</emphasis> on the <emphasis role="bold">Action</emphasis> bar.
     </para>
          <para>
      The <emphasis role="bold">Create New Subscription</emphasis> form pops up.
     </para>
          <mediaobject>
            <imageobject role="html">
              <imagedata  align="center"  fileref="images/newsletters_category_prepopulated.png" format="PNG"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata   align="center" fileref="images/newsletters_category_prepopulated.png" format="PNG" width="128mm"/>
            </imageobject>
          </mediaobject>
        </step>
      <step>
      <para>
    Do the same steps (3, 4) as stated in the <link linkend="proc-User_Guide-Subscriptions-Method_One">first way</link>.
	  </para>
	  </step>
	  </procedure>
	  <itemizedlist>
	  <listitem>
      <para>Administrators can create newsletters for each subscription.
   </para>
   </listitem>
   <listitem>
      <para>
    These newsletters can be opened, edited, deleted or converted to a template for reuse.
   </para>
   </listitem>
   </itemizedlist>
      <mediaobject>
        <imageobject role="html">
          <imagedata  align="center"  fileref="images/newsletters_manage_subscriptions.png" format="PNG"/>
        </imageobject>
        <imageobject role="fo">
          <imagedata   align="center" fileref="images/newsletters_manage_subscriptions.png" format="PNG" width="150mm"/>
        </imageobject>
      </mediaobject>
      <para><emphasis role="bold">Details:</emphasis></para>
      <table>
        <tgroup cols="2">
          <thead>
            <row>
              <entry> Element </entry>
              <entry> Description </entry>
            </row>
          </thead>
          <tbody>
            <row>
              <entry>
                <emphasis role="bold">Shoes</emphasis>
              </entry>
              <entry> The name of the subscription. </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">Fashion Shoes</emphasis>
              </entry>
              <entry> The brief description about the subscription. </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">Letter</emphasis>
              </entry>
              <entry> The list of all letters of this subscription. </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">Date</emphasis>
              </entry>
              <entry> The date and time when creating this newsletter. </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">Status</emphasis>
              </entry>
              <entry> There are three types of status: draft, awaiting and sent. </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">Moderation</emphasis>
              </entry>
              <entry> This button allows you to take actions on your selected newsletter. </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
    </section>
    <section id="sect-User_Guide-Manage_Newsletters-Open_a_Newsletter">
      <title>Open a newsletter</title>
      <para>
    Administrators can easily view the content of a newsletter as follows:
   </para>
      <procedure>
        <step>
          <para>
      Open the <emphasis role="bold">subscription</emphasis> containing the letter you want to open by clicking it or ticking the corresponding checkbox, then select <emphasis role="bold">Administration --> Open</emphasis>.
     </para>
          <mediaobject>
            <imageobject role="html">
              <imagedata  align="center"  fileref="images/newsletters_newsletter_administration.png" format="PNG"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata   align="center" fileref="images/newsletters_newsletter_administration.png" format="PNG" width="150mm"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
      Directly click the newsletter;
		</para>
		<para> Or, select the checkbox corresponding to your desired newsletter, then click <emphasis role="bold">Administration --> Open.</emphasis>
     </para>
          <mediaobject>
            <imageobject role="html">
              <imagedata  align="center"  fileref="images/newsletters_newsletter_administration2.png" format="PNG"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata   align="center" fileref="images/newsletters_newsletter_administration2.png" format="PNG" width="150mm"/>
            </imageobject>
          </mediaobject>
          <para>
      The <emphasis role="bold">View Newsletter&apos;s Content</emphasis> form pops up.
     </para>
          <mediaobject>
            <imageobject role="html">
              <imagedata  align="center"  fileref="images/newsletters_newsletters_content.png" format="PNG"/>
            </imageobject>
            <imageobject role="fo">
              <imagedata   align="center" fileref="images/newsletters_newsletters_content.png" format="PNG" width="150mm"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
      Click <emphasis role="bold">Close</emphasis> to exit.
     </para>
        </step>
      </procedure>
    </section>
    <section id="sect-User_Guide-Manage_Newsletters-Edit_a_newsletter">
      <title>Edit a newsletter</title>
      <procedure>
        <step>
          <para>
      Select the newsletter you want to edit by ticking the relevant checkbox in a specific subscription. 
     </para>
        </step>
        <step>
          <para>
      Click 
      <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/moderationbutton.png" format="PNG" width="15mm" scalefit="1"/>
              </imageobject>
              <textobject>
                 <phrase>[ Moderation ]</phrase>
              </textobject>
            </inlinemediaobject>, then select <emphasis role="bold">Edit</emphasis> from the drop-down menu.
     </para>
         <mediaobject>
            <imageobject role="html">
               <imagedata fileref="images/newsletter-editmenu.png" format="PNG" align="center"/>
            </imageobject>
            <imageobject role="fo">
               <imagedata fileref="images/newsletter-editmenu.png" format="PNG" align="center" width="41mm" />
            </imageobject>
         </mediaobject>
          <para>
      The <emphasis role="bold">Newsletter Entry</emphasis> pops up.
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/newsletterentryform.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/newsletterentryform.png" format="PNG" align="center" width="150mm" />
             </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
      Change the values in the fields that you want to edit: <emphasis role="bold">Template, Send Date, Category, Subscription.</emphasis>
     </para>
        </step>
        <step>
          <para>
      Click the <emphasis role="bold">Update a Newsletter&apos;s info</emphasis> button.
     </para>
        </step>
        <step>
          <para>
      Change values in the <emphasis role="bold">Title</emphasis> and <emphasis role="bold">Main Content</emphasis> fields.
     </para>
        </step>
        <step>
          <para>
      Click <emphasis role="bold">Save</emphasis> to save as draft, or click <emphasis role="bold">Send.</emphasis>
     </para>
        </step>
      </procedure>
    </section>
    <section id="sect-User_Guide-Manage_Newsletters-Delete_a_newsletter">
      <title>Delete a newsletter</title>
      <para>
    Administrator can delete obsolete newsletters in a specific subscription.
   </para>
      <procedure>
        <step>
          <para>
      Select the newsletter you want to delete by ticking the corresponding checkbox.
     </para>
        </step>
        <step>
          <para>
      Click 
      <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/moderationbutton.png" format="PNG" width="15mm" scalefit="1"/>
              </imageobject>
              <textobject>
                 <phrase>[ Moderation ]</phrase>
              </textobject>
            </inlinemediaobject>, then select <emphasis role="bold">Delete</emphasis> from the drop-down menu.
     </para>
          <mediaobject>
            <imageobject role="html">
               <imagedata fileref="images/newsletter-deletebutton.png" format="PNG" align="center"/>
            </imageobject>
            <imageobject role="fo">
               <imagedata fileref="images/newsletter-deletebutton.png" format="PNG" align="center" width="41mm" />
            </imageobject>
         </mediaobject>
        </step>
        <step>
          <para>
      Click <emphasis role="bold">OK</emphasis> in the confirmation message to accept your deletion.
     </para>
        </step>
      </procedure>
    </section>
    <section id="sect-User_Guide-Manage_Newsletters-Convert_as_Template">
      <title>Convert as template</title>
      <para>
    The administrator can reuse the template of the frequently used newsletter template.
   </para>
      <procedure>
        <step>
          <para>
      Select the newsletter that you want to create as a template.
     </para>
        </step>
        <step>
          <para>
      Click 
      <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/moderationbutton.png" format="PNG" width="15mm" scalefit="1"/>
              </imageobject>
              <textobject>
                 <phrase>[ Moderation ]</phrase>
              </textobject>
            </inlinemediaobject>, then select <emphasis role="bold">Convert As Template</emphasis> from the drop-down menu. For the next time when you create a newsletter, this template will be listed in the <emphasis role="bold">Template</emphasis> field in the <emphasis role="bold">Newsletter Entry</emphasis> form.
     </para>
        </step>
      </procedure>
    </section>
    <section id="sect-User_Guide-Manage_Newsletters-Newsletters">
      <title>Create a newsletter</title>
      <para xml:id="proc-User_Guide-Newsletters-Creating_Newsletters">
    Each subscription consists of many newsletters. In eXo Platform, you can easily create newsletters by following these steps.
   </para>
      <procedure>
        <step>
          <para>
      Select a subscription where you want to create a newsletter.
     </para>
        </step>
        <step>
          <para>
      Click 
      <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/newletterbutton.png" format="PNG" width="15mm" scalefit="1"/>
              </imageobject>
              <textobject>
                 <phrase>[ New Letter ]</phrase>
              </textobject>
            </inlinemediaobject> on the <emphasis role="bold">Action</emphasis> bar to open the <emphasis role="bold">Newsletter Entry</emphasis> form.
     </para>
          <mediaobject>
            <imageobject>
              <imagedata  align="center" fileref="images/newsletterentryform.png" format="PNG" width="150mm"/>
            </imageobject>
          </mediaobject>
          <para>
	<emphasis role="bold">
      Details:
	</emphasis>
     </para>
          <table>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry> Field </entry>
                  <entry> Description </entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry><emphasis role="bold">Template</emphasis> </entry>
                  <entry> The template for your newsletter form. <emphasis role="bold">Basic Template</emphasis> is set by default. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold">Send Date</emphasis> </entry>
                  <entry> The date and time to send the newsletter.</entry>
                </row>
                <row>
                  <entry><emphasis role="bold">Category</emphasis> </entry>
                  <entry> The category contains this newsletter. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold">Subscription</emphasis> </entry>
                  <entry> The subscription contains this newsletter. </entry>
                </row>
                <row>
                  <entry><emphasis role="bold">Update Sending Parameters</emphasis> </entry>
                  <entry> This button allows you to update information about this newsletter. </entry>
                </row>
              </tbody>
            </tgroup>
          </table>
        </step>
        <step>
          <para>
            Click the
            <emphasis role="bold">Template</emphasis>
            field
            to select the template for the newsletter.
          </para>
        </step>
        <step>
          <para>
      Click the <emphasis role="bold">Send Date</emphasis> field. The calendar will appear, allowing you to select the date and time when you want to send the newsletter.
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/newslettercalendar.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/newslettercalendar.png" format="PNG" align="center" width="49mm" scalefit="1" />
             </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>
      Click the <emphasis role="bold">Category</emphasis> and <emphasis role="bold">Subscription</emphasis> to
      select the category and the subscription in the list.
     </para>
        </step>
        <step>
          <para>
      Click the <emphasis role="bold">Update Sending Parameters</emphasis> button to update information about this newsletter. A message pops up and informs you that you have updated information successfully.
     </para>
        </step>
        <step>
          <para>
      Input a title of a newsletter into the <emphasis role="bold">Title</emphasis> field.
     </para>
        </step>
        <step>
          <para>
      Create content for a newsletter by inputting information into the <emphasis role="bold">Main Content</emphasis> textbox.
     </para>
        </step>
        <step>
          <para>
      Click <emphasis role="bold">Save</emphasis> to save this newsletter as draft, or click <emphasis role="bold">Send</emphasis> to send this newsletter.
     </para>
        </step>
    <!--    <step>
          <para>
      Select <emphasis role="bold">Contact Us</emphasis> on the navigation bar, or go to <emphasis role="bold">Site &gt; Acme &gt; Contact Us</emphasis>.
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/contactus.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/contactus.png" format="PNG" align="center" width="150mm" />
             </imageobject>
          </mediaobject>
          <para>
      The <emphasis role="bold">Contact Us</emphasis> page  appears:
     </para>
          <mediaobject>
             <imageobject role="html">
                <imagedata fileref="images/contactuspage.png" format="PNG" align="center"/>
             </imageobject>
             <imageobject role="fo">
                <imagedata fileref="images/contactuspage.png" format="PNG" align="center" width="150mm" />
             </imageobject>
          </mediaobject>
          <table>
            <tgroup cols="2">
              <thead>
                <row>
                  <entry> Field </entry>
                  <entry> Details </entry>
                </row>
              </thead>
              <tbody>
                <row>
                  <entry> Select a recipient </entry>
                  <entry> The recipient who will receive a message </entry>
                </row>
                <row>
                  <entry> Your name </entry>
                  <entry> The name of a person who leaves a message </entry>
                </row>
                <row>
                  <entry> Your address </entry>
                  <entry> The address of a person who leaves a message </entry>
                </row>
                <row>
                  <entry> Your Email Address </entry>
                  <entry> The email address of a person who leaves a message </entry>
                </row>
                <row>
                  <entry> Your Phone Number </entry>
                  <entry> The phone number of a person who leaves a message </entry>
                </row>
                <row>
                  <entry> Your message </entry>
                  <entry> Write a message that you want to leave </entry>
                </row>
              </tbody>
            </tgroup>
          </table>
        </step>
        <step>
          <para>
      Select a recipient and enter values in this form.
     </para>
        </step>
        <step>
          <para>
      Click <emphasis role="bold">Save</emphasis> to save a message.
     </para>
        </step>  -->
      </procedure>
    </section>
  </section>
</section>
