<?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-Contribute_Content">
  <title>Contribute Content</title>
  <section>
    <title>Edit Mode</title>
    <para>A site in eXo Content has two modes (Published mode and Edit mode) which is specific for editing site and viewing site. You can easily switch between these modes by selecting in the drop-down list at the top left corner.</para>
    <mediaobject>
      <imageobject>
        <imagedata width="444" align="center" fileref="images/twomodes.png" format="PNG"/>
      </imageobject>
    </mediaobject>
    <itemizedlist>
      <listitem>
        <para><emphasis role="bold">Edit mode</emphasis>: In this mode, you can edit all contents of the current site. When hovering the mouse over contents, you can see edit icons which enable you to quickly edit these contents. You can take advantage of this feature to submit contents to a page.</para>
      </listitem>
      <listitem>
        <para><emphasis role="bold">Published mode</emphasis>: In this mode, you only can view the current site without editing the contents of the site. </para>
      </listitem>
    </itemizedlist>
    <para>When you login to a site, by default, the page is in the published mode, you cannot see any quick edit icon and cannot edit site contents at this time:</para>
    <mediaobject>
      <imageobject>
        <imagedata width="444" align="center" fileref="images/publishedmode.png" format="PNG"/>
      </imageobject>
    </mediaobject>
    <para>When a page is switched to the Edit mode, you can see quick edit icons on the site contents when mousing over them.</para>
    <para>For single content viewer (SCV), you can see the current state of the content, the Edi Content icon and References icon.</para>
    <mediaobject>
      <imageobject>
        <imagedata width="444" align="center" fileref="images/singlecontentviewer1.png" format="PNG"/>
      </imageobject>
    </mediaobject>
    <para>For content list viewer (CLV), you can see the current state of the content, the Edit Content, References icon, the Add Content icon and the Management Content icon.</para>
    <mediaobject>
      <imageobject>
        <imagedata width="444" align="center" fileref="images/lcv.png" format="PNG"/>
      </imageobject>
    </mediaobject>
  </section>
  <section id="sect-User_Guide-Contribute_Content-Incontext_Editing">
    <title>InContext Editing</title>
    <para>
   <emphasis role="bold">InContext Editing</emphasis> allows you to edit content &quot;in context&quot; rather than having a WYSIWYG editor pop-up over the top of the page. This feature makes page editing a much more user intuitive process, with the new content automatically taking on the previous contents.</para>
    <para>To use <emphasis role="bold">InContext Editing</emphasis>, turn on the <emphasis role="bold">Edit Mode</emphasis>.</para>
    <section id="sect-User_Guide-Incontext_Editing-Add_Content">
      <title>Add Content</title>
      <para>Adding  a  new content by InContext Editing is enabled for the content list viewer.</para>
      <para> Do the following:</para>
      <procedure>
        <title>Add a new content</title>
        <step>
          <para>Turn on the <emphasis role="bold">Edit Mode &gt;</emphasis> hover the mouse to the CLV that you want to add a new content in.</para>
        </step>
        <step>
          <para>Click the <emphasis role="bold">Add Content</emphasis> icon on the CLV.</para>
          <para>You will be  redirected to the <emphasis role="bold">Content Explorer </emphasis>with a new document form for you to write a document.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/documentform.png" format="PNG"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>Click<inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/icon1.png" format="PNG"/>
              </imageobject>
            </inlinemediaobject> to open the template list and select one .</para>
        </step>
        <step>
          <para>Fulfill all the fields in the form.  See the part <xref linkend="sect-User_Guide-Actions-Add_a_document"/> to know how to add types of document.</para>
        </step>
        <step>
          <para>Click <emphasis role="bold">Save as Draft</emphasis> to save the document in a folder of the Collaboration drive  or <emphasis role="bold">Close</emphasis> to quit the form without creating the document.</para>
        </step>
      </procedure>
      <note>
        <para>Saving a document in which folder of the Collaboration drive depends on the path you choose in <xref linkend="sect-User_Guide-Incontext_Editing-Preferences"/>.</para>
      </note>
    </section>
    <section id="sect-User_Guide-Incontext_Editing-Edit_Content">
      <title>Edit Content</title>
      <para>

   You can edit any contents on the homepage for SCV and CLV with InContext Editing. For CLV, you only can edit each content in it.</para>
      <para>Do the following:</para>
      <procedure>
        <title>Edit a content</title>
        <step>
          <para>Turn on the <emphasis role="bold">Edit Mode</emphasis> &gt; Hover the mouse to the content you want to edit.</para>
        </step>
        <step>
          <para>Click  <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/editicon4.png" format="PNG"/>
              </imageobject>
            </inlinemediaobject> on the right conner of the content you want to edit. You will be  redirected to the <emphasis role="bold">Content Explorer </emphasis>with the  document form form for you to edit.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/editform.png" format="PNG"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>Edit the content &gt; Click <emphasis role="bold">Save as Draft</emphasis> to save the content or<emphasis role="bold"> Close</emphasis> to quit the form.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/modification.png" format="PNG"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>Click <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/backicon.png" format="PNG"/>
              </imageobject>
            </inlinemediaobject> to return to the site and in the <emphasis role="bold">Edit Mode</emphasis>, the content in the state &quot;draft&quot; with its modification is visible.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/draftcontent.png" format="PNG"/>
            </imageobject>
          </mediaobject>
        </step>
      </procedure>
      <note>
        <para>When you turn on the Published Mode, you cannot the edited content. To see it in the Published Mode, you must publish it. See <xref linkend="sect-User_Guide-Contribute_Content-Publication_Process"/> to know how to publish a content.</para>
      </note>
    </section>
    <section id="sect-User_Guide-Incontext_Editing-Manage_Content">
      <title>Manage Content</title>
      <para>

   With InContext Editing, you can easily manage a content list on the homepage. You can add a new content in the list.</para>
      <para>Do the following:</para>
      <procedure>
        <title>Manage Content</title>
        <step>
          <para>Turn on the <emphasis role="bold">Edit Mode &gt;</emphasis> the <emphasis role="bold">Manage Conten</emphasis>t icon of the content list viewer that you want to manage on the homepage.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/managecontent.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          <para>The browser will redirect to <emphasis role="bold">Content Explorer</emphasis>:</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/managecontent1.png" format="PNG"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>Click <emphasis role="bold">Add Document</emphasis> on the action bar to add a new content to the folder containing all the contents in the content list viewer.</para>
        </step>
        <step>
          <para>The form to add a new content appears. Do the same steps as the part <xref linkend="sect-User_Guide-Incontext_Editing-Add_Content"/>.</para>
        </step>
      </procedure>
    </section>
    <section id="sect-User_Guide-Incontext_Editing-Preferences">
      <title>Preferences</title>
      <para>

   Preferences enable you to edit contents in the single content viewer (SCV)  and the content list viewer (CLV),  reset the display of the contents in SCV and CLV and publish contents.</para>
      <formalpara>
        <title>Content Detail Preferences</title>
        <para>To edit the single content viewer do the following:</para>
      </formalpara>
      <procedure>
        <title> Edit Content Detail Viewer</title>
        <step>
          <para>Turn on the <emphasis role="bold">Edit Mode &gt;</emphasis> Select the <emphasis role="bold">Preferences</emphasis> icon of a single content viewer.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/scvpreferences.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          <para>The Content Detail Preferences dialog appears:</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/scvpreferences1.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          <para>Details:</para>
          <para><emphasis role="bold">Content Selection</emphasis>:  Select the path of the content that you want to show  by clicking <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/plusicon.png" format="PNG"/>
              </imageobject>
            </inlinemediaobject>.</para>
          <para><emphasis role="bold">Display Settings:</emphasis> Allow configuring Title, Date and OptionBar visibility.</para>
          <para><itemizedlist>
              <listitem><emphasis role="bold">Show Title</emphasis>: Specify whether the title of the content is displayed or not.</listitem>
              <listitem><emphasis role="bold">Show Date</emphasis>: Specify whether the date of the content publication is displayed or not. </listitem>
              <listitem><emphasis role="bold">Show Option Bar:</emphasis>Show or hide the Option bar used to show the print link.</listitem>
            </itemizedlist>
 </para>
          <para><emphasis role="bold">Print Setting:</emphasis><itemizedlist>
              <listitem><emphasis role="bold">Show in page</emphasis>: The content is shown the page.</listitem>
              <listitem><emphasis role="bold">with</emphasis>: Parameters contains the content path.</listitem>
            </itemizedlist></para>
          <para><emphasis role="bold">Advanced</emphasis> panel: When clicking on this link, the Advanced panel will be shown. If <emphasis role="bold">Contextual Content</emphasis> property is &quot;Disable&quot;, the Advanced panel is closed by default .The content should enable “dynamic navigation” that interprets the URL and shows a content.</para>
          <note>
            <para>Click<inlinemediaobject>
                <imageobject>
                  <imagedata fileref="images/questionicon.png" format="PNG"/>
                </imageobject>
              </inlinemediaobject> to see a quick help panel for each section.</para>
          </note>
        </step>
        <step>
          <para>Click the plus icon next to the <emphasis role="bold">Content Path</emphasis> to  re-select another content. The Select Content dialog appears: selectcontent</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/selectcontent.png" format="PNG"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>Choose a folder on the left panel and a content in the folder on the right panel. The content chosen will be displayed in the  <emphasis role="bold">Content Path</emphasis> field.</para>
        </step>
        <step>
          <para>Tick in the <emphasis role="bold">Show Title</emphasis> box, the <emphasis role="bold">Show Date</emphasis> and the <emphasis role="bold">Show Option bar</emphasis> box if you want to display the title of the content, the date of the content publication and the print button  like the illustration below:</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/editedscv.png" format="PNG"/>
            </imageobject>
          </mediaobject>
        </step>
        <step>
          <para>In the <emphasis role="bold">Print Setting</emphasis> part, click <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/viewresultcontent.png" format="PNG"/>
              </imageobject>
            </inlinemediaobject> and the <emphasis role="bold">UIPageselector</emphasis> dialog appears, you will see <emphasis role="bold">Printviewer.</emphasis></para>
          <para>Click the <emphasis role="bold">Print</emphasis> button, the content is opened in the print viewer page.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/printreview.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          <para><emphasis role="bold">URL</emphasis>: http://localhost:8080/ecmdemo/private/acme/<emphasis role="bold">printviewer?content-id</emphasis>=/repository/collaboration/sites%20content/live/acme/web%20contents/site%20artifacts/Introduce&amp;isPrint=true</para>
          <para>In which: </para>
          <itemizedlist>
            <listitem>
              <para><emphasis role="bold">printviewer?</emphasis>: the print viewer page of the content.</para>
            </listitem>
            <listitem>
              <para><emphasis role="bold">content-id</emphasis>: the parameter containing the content path.</para>
            </listitem>
          </itemizedlist>
        </step>
        <step>
          <para>Click <emphasis role="bold">Save </emphasis>        to save all the changes or <emphasis role="bold">Cancel</emphasis> to quit the dialog without any changes.</para>
        </step>
      </procedure>
      <formalpara>
        <title>Content List Preferences.</title>
        <para>To edit the single content viewer do the following</para>
      </formalpara>
      <procedure>
        <title>Edit Content List Viewer</title>
        <step>
          <para>Turn on the <emphasis role="bold">Edit Mode &gt;</emphasis> Select the <emphasis role="bold">Preferences</emphasis> icon of a content list viewer.</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/clvpreferences.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          <para>The Content List Preferences dialog appears:</para>
          <mediaobject>
            <imageobject>
              <imagedata width="444" align="center" fileref="images/clvpreferences1.png" format="PNG"/>
            </imageobject>
          </mediaobject>
          <para>Details:</para>
          <para><table frame="all">
              <title/>
              <tgroup cols="2">
                <colspec colname="c1"/>
                <colspec colname="c2"/>
                <tbody>
                  <row>
                    <entry>
                      <emphasis role="bold">Mode</emphasis>
                    </entry>
                    <entry>This mode is to select web content for list viewer. There are two modes:<para>By Folder: This mode allows you to select a content folder in the Folder path field.</para><para>By Content: This mode allows you to select  by  the content in a specific folder in Folder path field.</para></entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Folder path</emphasis>
                    </entry>
                    <entry>The path to a location of a folder that contains the content. </entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Order by</emphasis>
                    </entry>
                    <entry>The field is selected to sort content in the list viewer. You can sort content by Title, Date created or Date modified in ascending or descending order. </entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Header</emphasis>
                    </entry>
                    <entry>The title for all content that are listed in List Viewer.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Viewer template</emphasis>
                    </entry>
                    <entry>The template is used to view content list.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Paginator template</emphasis>
                    </entry>
                    <entry>The template is used to view each content in list.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Items per page</emphasis>
                    </entry>
                    <entry>The number of items will be displayed per page. </entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Show image</emphasis>
                    </entry>
                    <entry>The option is to show or hide the illustration of each published web content/document.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Show summary</emphasis>
                    </entry>
                    <entry>The option is to show or hide the summary of each web content/document.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Show header</emphasis>
                    </entry>
                    <entry>The option is whether to show a header or not.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Show refresh button</emphasis>
                    </entry>
                    <entry>The option is whether to show the refresh button at the left bottom of this page or not.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Show title</emphasis>
                    </entry>
                    <entry>The option is to show or hide title of each published web content and/or document. </entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Show date created</emphasis>
                    </entry>
                    <entry>The option is to show or hide the created date of each published web content/document.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Show link</emphasis>
                    </entry>
                    <entry>The option is to show or hide the link of web content and/or document.</entry>
                  </row>
                  <row>
                    <entry>
                      <emphasis role="bold">Read more</emphasis>
                    </entry>
                    <entry>The option is to show or hide the Read more to read all the content of a web content and/or document.</entry>
                  </row>
                </tbody>
              </tgroup>
            </table></para>
        </step>
        <step>
          <para>Browse the documents/ web content of an available site by clicking <inlinemediaobject>
              <imageobject>
                <imagedata fileref="images/plusicon.png" format="PNG"/>
              </imageobject>
            </inlinemediaobject>next to the<emphasis role="bold"> folder path</emphasis> field.</para>
        </step>
        <step>
          <para>If you select the <emphasis role="bold">By folder</emphasis> mode, select an available site on the left, then select a folder that contains contents (documents and/or web content) on the right by clicking the folder.</para>
          <para>If you select the <emphasis role="bold">By content </emphasis>mode, select an available folder from the left panel, all content in this folder will be listed on the right panel.   Click a  content on the right that you want to add to the content list. A message informs that you have successfully added it in List Content. The selected content is listed in List Content.</para>
        </step>
        <step>
          <para>Enter a header for the content list in the Header field if you want. </para>
        </step>
        <step>
          <para>Select a template to display the content list in the template list. </para>
        </step>
        <step>
          <para>Tick/untick some options that you want.</para>
        </step>
        <step>Click <emphasis role="bold">Save</emphasis>to save all the changes or <emphasis role="bold">Cancel</emphasis>to quit the dialog without any changes.</step>
      </procedure>
    </section>
  </section>
  <section id="sect-User_Guide-Contribute_Content-Publication_Process">
    <title>Publication Process</title>
    <para>

  After a new content is created, it is saved as draft and you can easily to publish it on your site.  The publication process consists of four steps: <para><emphasis role="bold">
          <para>Request approval &gt; Approval &gt; Stage &gt; Publish</para>
        </emphasis></para> <para>If you do not have the right to approve or publish a content, so when you want to publish your content, you must send your approval request first.</para><para>If you have the right to approve or publish a content, you do not need to send a request approval. You can yourself  publish it with the <emphasis role="bold">Stage</emphasis> step immediately.</para></para>
    <itemizedlist>
      <listitem>
        <para><emphasis role="bold">Request approva</emphasis>l: When a new content is created, it must be approved before publishing by clicking <emphasis role="bold">Request Approval</emphasis> on the action bar of  the Content Explorer or clicking <emphasis role="bold">Pending</emphasis> in the Manage Publication form:</para>
        <mediaobject>
          <imageobject>
            <imagedata width="444" align="center" fileref="images/managepublication.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </listitem>
      <listitem>
        <para><emphasis role="bold">Approve</emphasis>: To approve a content, click <emphasis role="bold">Approve </emphasis>on the action bar of  the Content Explorer or click <emphasis role="bold">Approved</emphasis> in the Manage Publication.</para>
      </listitem>
      <listitem>
        <para><emphasis role="bold">Stage</emphasis>: Stage enables you to publish a content in a period.  After selecting the publication schedule for the content, it will be automatically published as the schedule. </para>
        <para>To publish content for a stage, click<emphasis role="bold"> Stage &gt;</emphasis> Click <emphasis role="bold">From/ To</emphasis> to open a mini calendar <emphasis role="bold">&gt;</emphasis> Select the date to publish.</para>
        <para>To  publish your content forever, you should not to set time in the <emphasis role="bold">To</emphasis> field.</para>
        <mediaobject>
          <imageobject>
            <imagedata width="444" align="center" fileref="images/stage.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </listitem>
      <listitem>
        <para><emphasis role="bold">Publish</emphasis>:  A content will be published when you have completed the <emphasis role="bold">Stage</emphasis> step.</para>
        <note>
          <para>You will see a  list of draft contents,  pending  contents (that are waiting to be your approval if you have the approval right)  and contents that will be published at the bottom of the Content Explorer. Click them to review, approve or publish.</para>
        </note>
        <mediaobject>
          <imageobject>
            <imagedata width="444" align="center" fileref="images/bottombar.png" format="PNG"/>
          </imageobject>
        </mediaobject>
      </listitem>
    </itemizedlist>
  </section>
</section>
