<?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>
  <highlights>
      <itemizedlist>
           <listitem>
               <para>
                   <link linkend="sect-User_Guide-Newsletters-Newsletter_Viewer">Newsletter viewer</link>
				</para>
				<para>
				Step-by-step instructions on how to subscribe your email to get newsletters from eXo Service.
                </para>
           </listitem>
           <listitem>
               <para>
                   <link linkend="sect-User_Guide-Newsletters-Manage_Newsletters">Newsletter Manager</link>
				</para>
				<para>
				The ways to add the <emphasis role="bold">Newsletter Manager</emphasis> portlet to a specific page, actions to manage categories in <emphasis role="bold">Newsletter</emphasis>, ways to add a new subscription, steps to view/edit/delete/create a newsletter or to convert a newsletter as template.
                </para>
           </listitem>
      </itemizedlist>
  </highlights>
  <para>
  &PRODUCT; provides the <emphasis role="bold">Newsletters</emphasis> service, aiming at helping users quickly get the updated newsletters from a website.
 </para>
 <para>
    <prompt>
        <emphasis role="bold">See also</emphasis>
    </prompt>
</para>
<itemizedlist>
        <listitem>
			<para><link linkend="Platform_User_Guide.Organize_Content.Structure_Content">Structure content</link></para>
		</listitem>
		<listitem>
			<para><link linkend="Platform_User_Guide.Organize_Content.Manage_Content">Manage content</link></para>
		</listitem>
		<listitem>
			<para><link linkend="Platform_User_Guide.Organize_Content.Manage_Workflows">Manage workflows</link></para>
		</listitem>
</itemizedlist>
  <section id="sect-User_Guide-Newsletters-Newsletter_Viewer" role="NotInToc">
    <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 <guilabel>Newsletters</guilabel> on the <guilabel>Navigation</guilabel> 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 <guilabel>Your Email</guilabel> field.
    </para>
      </step>
      <step>
        <para>
     Select the checkbox corresponding to the subscription that you want to get newsletters.
    </para>
      </step>
      <step>
        <para>
     Click <guibutton>Subscribe.</guibutton> A message informing that you have just subscribed to the selected newsletter will appear.
    </para>
      </step>
      <step>
        <para>
     Click <guibutton>OK</guibutton> 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 <guilabel>Change your subscriptions</guilabel> to update your changes.
    </para>
      </step>
      <step>
        <para>
     Click <guilabel>Forget this email</guilabel> if you want to unsubscribe from newsletters.
    </para>
      </step>
    </procedure>
  </section>
  <section id="sect-User_Guide-Newsletters-Manage_Newsletters" role="NotInToc">
    <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 <guilabel>Newsletter Manager</guilabel> from
      <guilabel>Page Editor</guilabel> 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 <menuchoice><guimenu>Page Editor</guimenu> <guisubmenu>Applications</guisubmenu> <guimenuitem>Newsletter</guimenuitem> </menuchoice>.
  </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>
	<section id="sect-User_Guide-Category_Management-Add_a_new_category">
        <title>Add a new category</title>
        <procedure>
          <step>
            <para>
       Click <guilabel>New Category</guilabel> on the <guilabel>Action</guilabel> bar of the <emphasis role="bold">Newsletter</emphasis> page. The  <guilabel>Create New Category</guilabel> 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><guilabel>Asterisk (*) </guilabel> </entry>
                    <entry>This mark next to each field means that it is required to enter values into that field. </entry>
                  </row>
                  <row>
                    <entry><guilabel>Name</guilabel> </entry>
                    <entry> The name of a category. </entry>
                  </row>
                  <row>
                    <entry><guilabel>Title</guilabel> </entry>
                    <entry> The title of a category. </entry>
                  </row>
                  <row>
                    <entry><guilabel>Description</guilabel> </entry>
                    <entry> A brief description of the category. </entry>
                  </row>
                  <row>
                    <entry><guilabel>Moderator</guilabel> </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
                      <guilabel>Moderator</guilabel>
                      field to open the 
                      <guilabel>User Selector</guilabel>
                      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
                      <guilabel>Group selector</guilabel>
                      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
                              <guilabel>Moderator</guilabel>
                              field.
                          </para>
                      </listitem>
                  </itemizedlist>
              </step>
              <step>
                  <para>Click <guibutton>Save</guibutton> 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 <guilabel>Administration</guilabel> 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
              <menuchoice><guimenu>Administration</guimenu><guimenuitem>Edit Category</guimenuitem></menuchoice> 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
              <guilabel>Create New Category</guilabel>
              form appears.
            </para>
          </step>
          <step>
            <para>
       Change the values in the <guilabel>Title</guilabel> and <guilabel>Description</guilabel> fields as required.
      </para>
	  <note>
	  <para>
	  The category name cannot be changed.
	  </para>
	  </note>
          </step>
          <step>
            <para>
       Click <guibutton>Save </guibutton>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
              <guilabel>Administration</guilabel>, then select <guilabel>Delete Category</guilabel> from the drop-down menu.
            </para>
          </step>
          <step>
            <para>
       Click <guibutton>OK</guibutton> 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
              <menuchoice><guimenu>Administration</guimenu><guimenuitem>Manage Users</guimenuitem></menuchoice>
              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
              <guilabel>Users</guilabel>
              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><guilabel> Email</guilabel> </entry>
                    <entry> The email address of user who has subscribed this subscription. </entry>
                  </row>
                  <row>
                    <entry><guilabel>Banned</guilabel> </entry>
                    <entry>
                      <para>
            This field has two values:
           </para>
                      <variablelist>
                        <varlistentry>
                          <term><guilabel>False</guilabel></term>
                          <listitem>
                            <para>
               The user is allowed to get email.
              </para>
                          </listitem>
                        </varlistentry>
                        <varlistentry>
                          <term><guilabel>True</guilabel></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 <guibutton>Close</guibutton> 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 <guilabel>New Subscription</guilabel> on the <guilabel>Action</guilabel> 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 <guilabel>Create New Subscription</guilabel> 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="80mm"/>
            </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><guilabel> Asterisk (*) </guilabel></entry>
                  <entry> This mark next to each field means that it is required to enter values into that field. </entry>
                </row>
                <row>
                  <entry><guilabel>Category</guilabel> </entry>
                  <entry> The category which contains this subscription. </entry>
                </row>
                <row>
                  <entry><guilabel> Name</guilabel> </entry>
                  <entry> The name of the subscription. </entry>
                </row>
                <row>
                  <entry><guilabel>Title</guilabel> </entry>
                  <entry> The title of the subscription. </entry>
                </row>
                <row>
                  <entry><guilabel> Description</guilabel> </entry>
                  <entry> The brief description about the subscription. </entry>
                </row>
                <row>
                  <entry><guilabel>Redactor</guilabel> </entry>
                  <entry> Select users/groups who have rights to manage this subscription. </entry>
                </row>
              </tbody>
            </tgroup>
          </table>
        </step>
        <step>
          <para>
            Click the
            <guilabel>Category</guilabel>
            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 <guibutton>Save</guibutton> 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 <guilabel>New Subscription</guilabel> on the <guilabel>Action</guilabel> bar.
     </para>
          <para>
      The <guilabel>Create New Subscription</guilabel> 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>
                <guilabel>Shoes</guilabel>
              </entry>
              <entry> The name of the subscription. </entry>
            </row>
            <row>
              <entry>
                <guilabel>Fashion Shoes</guilabel>
              </entry>
              <entry> The brief description about the subscription. </entry>
            </row>
            <row>
              <entry>
                <guilabel>Letter</guilabel>
              </entry>
              <entry> The list of all letters of this subscription. </entry>
            </row>
            <row>
              <entry>
                <guilabel>Date</guilabel>
              </entry>
              <entry> The date and time when creating this newsletter. </entry>
            </row>
            <row>
              <entry>
                <guilabel>Status</guilabel>
              </entry>
              <entry> There are three types of status: draft, awaiting and sent. </entry>
            </row>
            <row>
              <entry>
                <guilabel>Moderation</guilabel>
              </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 <guilabel>subscription</guilabel> containing the letter you want to open by clicking it or ticking the corresponding checkbox, then select <menuchoice><guimenu>Administration</guimenu><guimenuitem>Open</guimenuitem></menuchoice>.
     </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 <menuchoice><guimenu>Moderation</guimenu><guimenuitem>Open</guimenuitem></menuchoice>.
     </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 <guilabel>View Newsletter&apos;s Content</guilabel> 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 <guibutton>Close</guibutton> 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 <guilabel>Edit</guilabel> 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 <guilabel>Newsletter Entry</guilabel> 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: <guilabel>Template, Send Date, Category, Subscription.</guilabel>
     </para>
        </step>
        <step>
          <para>
      Click the <guilabel>a Newsletter&apos;s info</guilabel> button.
     </para>
        </step>
        <step>
          <para>
      Change values in the <guilabel>Title</guilabel> and <guilabel>Main Content</guilabel> fields.
     </para>
        </step>
        <step>
          <para>
      Click <guibutton>Save</guibutton> to save as draft, or click <guibutton>Send.</guibutton>
     </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 <guilabel>Delete</guilabel> 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 <guibutton>OK</guibutton> 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 <guilabel>Convert As Template</guilabel> 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 <guilabel>Action</guilabel> bar to open the <guilabel>Newsletter Entry</guilabel> 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><guilabel>Template</guilabel> </entry>
                  <entry> The template for your newsletter form. <guilabel>Basic Template</guilabel> is set by default. </entry>
                </row>
                <row>
                  <entry><guilabel>Send Date</guilabel> </entry>
                  <entry> The date and time to send the newsletter.</entry>
                </row>
                <row>
                  <entry><guilabel>Category</guilabel> </entry>
                  <entry> The category contains this newsletter. </entry>
                </row>
                <row>
                  <entry><guilabel>Subscription</guilabel> </entry>
                  <entry> The subscription contains this newsletter. </entry>
                </row>
                <row>
                  <entry><guilabel>Update Sending Parameters</guilabel> </entry>
                  <entry> This button allows you to update information about this newsletter. </entry>
                </row>
              </tbody>
            </tgroup>
          </table>
        </step>
        <step>
          <para>
            Click the
            <guilabel>Template</guilabel>
            field
            to select the template for the newsletter.
          </para>
        </step>
        <step>
          <para>
      Click the <guilabel>Send Date</guilabel> 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 <guilabel>Category</guilabel> and <guilabel>Subscription</guilabel> to
      select the category and the subscription in the list.
     </para>
        </step>
        <step>
          <para>
      Click the <guilabel>Update Sending Parameters</guilabel> 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 <guilabel>Title</guilabel> field.
     </para>
        </step>
        <step>
          <para>
      Create content for a newsletter by inputting information into the <guilabel>Main Content</guilabel> textbox.
     </para>
        </step>
        <step>
          <para>
      Click <guibutton>Save</guibutton> to save this newsletter as draft, or click <guibutton>Send</guibutton> 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>
