<?xml version='1.0' encoding='utf-8' ?>
<!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-Manage_Content_In_Content_Explorer">
  <title>Manage content in Sites Explorer</title>
  <para>
   Web content is a key resource which is used for a site. Other resources make a site more dynamic and animated by using
    layout, color, font, and more. This section focuses on how to manage a web content in a specific site.
  </para>
  <note>
    <para>
      Only users who have the right to access the 
      <emphasis role="bold">Sites Management</emphasis>
      drive can do it.
    </para>
  </note>
  <section id="sect-User_Guide-Manage_Content_In_Content_Explorer-Create_a_new_web_content">
    <title>Create a new web content</title>
    <para>
      This function is used to add a new web content to a specific site.
    </para>
    <procedure>
      <step>
        <para>
          Go to the 
          <emphasis role="bold">Sites Management</emphasis>
          drive, then select a site to which you want to add a web content.
        </para>
      </step>
      <step>
        <para>
          Select the
          <emphasis role="bold">web contents</emphasis>
          folder on the left.
        </para>
        <note>
          <para>
            In this step, you also can add a new web content into another folders (documents and media folders) of a
            site but you are recommended to select the
            <emphasis role="bold">web contents</emphasis>
            folder because:
          </para>
              <para>
                Managing web content of a site becomes more easily.
              </para>
              <para>
                You only may add a new web content in this folder so that you do not need to select a web content
                document in the list of document types. It makes adding a new web content more flexibly.
              </para>
        </note>
      </step>
      <step>
        <para>
          Click 
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/adddocumenticon.png" format="PNG" width="20mm" scalefit="1"/>
            </imageobject>
            <textobject>
              <phrase>[ Add Document ]</phrase>
            </textobject>
          </inlinemediaobject>
          on the <emphasis role="bold">Action</emphasis> bar to open a list of content templates.
        </para>
        <mediaobject>
          <imageobject role="html">
            <imagedata align="center" fileref="images/template_list.png" format="PNG"/>
          </imageobject>
          <imageobject role="fo">
            <imagedata align="center" fileref="images/template_list.png" format="PNG" width="150mm"/>
          </imageobject>
        </mediaobject>
      </step>
      <step>
        <para>
          Select a template to present the web content by clicking one.
        </para>
      <!--  <itemizedlist>
          <listitem>
            <para>
              <emphasis role="bold">Free layout webcontent:</emphasis> This template is a free layout.
            </para>
          </listitem>
          <listitem>
            <para>
              <emphasis role="bold">Picture on head layout webcontent:</emphasis> The site's content is
              presented in two spaces. One is for inserting an image and the other for editing the site's content.
              The image will be put at the head of a site.
            </para>
          </listitem>
        </itemizedlist>  -->
        <!--  Doc Note: The content from this point until the next comment 'END' should probably be moved to a breakout explanation. Having it in the middle of a procedure breaks the flow of the steps.                          -->
      </step>
      <step>
        <para>
          Enter values in the fields of the <emphasis role="bold">Add New Document</emphasis> form.
        </para>
      </step>
      <step>
        <para>
          Click
          <emphasis role="bold">Save</emphasis>
          or
          <emphasis role="bold">Save &amp; Close</emphasis>
          to save the content or
          <emphasis role="bold">Close</emphasis>
          to quit the <emphasis role="bold">Add New Document</emphasis> form.
        </para>
      </step>
    </procedure>
     <citetitle>
     <para>
     <emphasis role="bold"> Tabs in the Add New Document form</emphasis>
        </para>
      </citetitle>
      <para>
        The
        <emphasis role="bold">Main Content</emphasis>
        tab
      </para>
      <table>
        <tgroup cols="2">
          <thead>
            <row>
              <entry>
                Field
              </entry>
              <entry>
                Description
              </entry>
            </row>
          </thead>
          <tbody>
           <row>
              <entry>
                <emphasis role="bold">Title</emphasis>
              </entry>
              <entry>
                The title of a webcontent.
              </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">Name</emphasis>
              </entry>
              <entry>
                The name of the webcontent that you want to add new.
              </entry>
            </row>
             <row>
              <entry>
                <emphasis role="bold">Language</emphasis>
              </entry>
              <entry>
                The language of the webcontent. At present, eXo Platform 3.5 supports two languages: English and French.
              </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">Main Content</emphasis>
              </entry>
              <entry>
                The main content that you want to display when publishing this webcontent.
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <para>
        The <emphasis role="bold">Illustration</emphasis> tab allows you to upload an illustration that makes the site's content more attractive.
      </para>
      <mediaobject>
        <imageobject role="html">
          <imagedata align="center" fileref="images/illustrationtab.png" format="PNG"/>
        </imageobject>
        <imageobject role="fo">
          <imagedata align="center" fileref="images/illustrationtab.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">Illustration Image</emphasis>
              </entry>
              <entry>
                The path to an image that you want to upload into a site. This image will be used like an illustration of that site.
              </entry>
            </row>
            <row>
              <entry>
               <emphasis role="bold">Summary</emphasis>
              </entry>
              <entry>
                You can give a short description about the webcontent because it will be displayed with the illustration image when the webcontent is listed. The main content will be shown when it is selected to be viewed.
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
      <citetitle>
      <para xml:id="proc-User_Guide-Add_new_content-_Upload_an_image">
	  <emphasis role="bold">
        Upload an image
	   </emphasis>
      </para>
      </citetitle>
      <procedure>
        <step>
          <para>
            Browse a list of images on your local device by clicking the <emphasis role="bold">Browse...</emphasis> button, then select a specific location.
          </para>
        </step>
        <step>
          <para>
            Select an image in the list to upload.
          </para>
        </step>
      </procedure>
      <para>
        The <emphasis role="bold">Advanced</emphasis> tab includes two parts: CSS Data and JS Data.
      </para>
      <mediaobject>
        <imageobject role="html">
          <imagedata align="center" fileref="images/advancedtab.png" format="PNG"/>
        </imageobject>
        <imageobject role="fo">
          <imagedata align="center" fileref="images/advancedtab.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">CSS Data</emphasis>
              </entry>
              <entry>
                Contain the CSS definition to present data in a webcontent. You can optionally enter CSS data into this
                field to specify the style.
              </entry>
            </row>
            <row>
              <entry>
                <emphasis role="bold">JS Data</emphasis>
              </entry>
              <entry>
                Contain the JS content to make the webcontent more dynamic after being published. You can optionally enter
                the JS content in this field.
              </entry>
            </row>
          </tbody>
        </tgroup>
      </table>
  </section>

  <section id="sect-User_Guide-Manage_Content_In_Content_Explorer-Edit_a_web_content">
    <title>Edit a webcontent</title>
    <para>
      This function is used to edit a webcontent in a specific drive of an existing site.
    </para>
    <procedure>
      <step>
        <para>
          Go into the folder of a site which contains the webcontent that you want to edit.
        </para>
      </step>
      <step>
        <para>
          Select the webcontent by double-clicking it on the left tree or on the right pane. The detailed information
          of webcontent will be viewed on the right pane.
        </para>

      </step>
      <step>
        <para>
          Click 
          <inlinemediaobject>
            <imageobject>
              <imagedata fileref="images/editdocumenticon.png" format="PNG" width="25mm" scalefit="1"/>
            </imageobject>
            <textobject>
              <phrase>[ Edit Document ]</phrase>
            </textobject>
          </inlinemediaobject>
          on the <emphasis role="bold">Action</emphasis> bar to show the form to edit the selected webcontent. This form is similar to that of creating
          a new document.
        </para>
      </step>
      <step>
        <para>
          Make changes on current values in the fields of this form.
        </para>
      </step>
      <step>
        <para>
          Complete editing the selected webcontent by clicking
          <emphasis role="bold">Save</emphasis>
          or <emphasis role="bold">Save &amp; Close.</emphasis>
        </para>
      </step>
    </procedure>
    <note>
      <para>
        When you click <emphasis role="bold">Edit Document,</emphasis> the webcontent will be auto-locked for your
        editing. After finishing, the content is back to the unlock status. You can manage "Locks" in the <link linkend="proc-User_Guide-Manage_Unlocks-Unlock_Nodes">Unlock a node</link> section.
      </para>
    </note>
  </section>

  <section id="sect-User_Guide-Manage_Content_In_Content_Explorer-Delete_a_web_content">
    <title>Delete a webcontent</title>
    <para>
      This function is used to remove a webcontent from the webcontent folder in a specific site's drive.
    </para>
    <procedure>
      <step>
        <para>
          Right-click the name of the webcontent that you want to delete, then select
          <emphasis role="bold">Delete</emphasis>
          from the drop-down menu.
        </para>
      </step>
      <step>
        <para>
          Click
          <emphasis role="bold">OK</emphasis>
          to accept your deletion in the confirmation message.
        </para>
      </step>
    </procedure>
  </section>

  <section id="sect-User_Guide-Manage_Content_In_Content_Explorer-Publish_a_web_content">
    <title>Publish a webcontent</title>
    <para>
      This function helps you publish a webcontent that you have added to webcontent folder in <emphasis role="bold">Sites Explorer</emphasis>.
    </para>
    <para>
      See the
      <link linkend="sect-User_Guide-Contribute_Content-Publication_Process">Publication process</link>
      section to know how to publish a webcontent.
    </para>
    <para>
      After the content is published, all users who have the right to access that position can view the published web
      content as a page on the <emphasis role="bold">Navigation</emphasis> bar.
    </para>
  </section>
  <xi:include href="Preferences.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
  <xi:include href="Search.xml" xmlns:xi="http://www.w3.org/2001/XInclude"/>
</section>