<?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-Search_portlet" role="NotInToc">
    <title>Search content in a site</title>
    <para>The
        <emphasis role="bold">Search</emphasis>
        function allows you to quickly search for any content in the system with a keyword from the front page, even if you
        do not log in. However, the number of the search results displayed depends on your role.
    </para>
    <para>For example, if you do not log in, you only see the search results that are published.</para>
    <section id="sect-User_Guide-Search_portlet-Search_content">
        <title>Search for content</title>
        <procedure>
            <step>
                <para>
                    Enter a keyword into the search box and press <emphasis role="bold">Enter</emphasis>.
                </para>
                <para>
                    The search results
                    matching with your keyword are displayed in the search page:
                </para>
                <mediaobject>
                    <imageobject role="html">
                        <imagedata align="center" fileref="images/searchpage.png" format="PNG"/>
                    </imageobject>
                    <imageobject role="fo">
                        <imagedata align="center" fileref="images/searchpage.png" format="PNG" width="150mm"/>
                    </imageobject>
                </mediaobject>
                <para>In case of no search results matching the keyword, the search page is displayed as below:
                </para>
                <mediaobject>
                    <imageobject role="html">
                        <imagedata align="center" fileref="images/nosearchresult.png" format="PNG"/>
                    </imageobject>
                    <imageobject role="fo">
                        <imagedata align="center" fileref="images/nosearchresult.png" format="PNG" width="150mm"/>
                    </imageobject>
                </mediaobject>
                <para><emphasis role="bold">Details:</emphasis></para>
                <table frame="all">
                    <tgroup cols="2">
                        <colspec colname="c1"/>
                        <colspec colname="c2"/>
                        <thead>
                            <row>
                                <entry>
                                    Field
                                </entry>
                                <entry>
                                    Details
                                </entry>
                            </row>
                        </thead>
                        <tbody>
                            <row>
                                <entry>
                                    <guilabel>in Content</guilabel>
                                </entry>
                                <entry>
                                    <para>
                                        Search all <emphasis role="bold">published content</emphasis> of search index areas that contain the keyword. 
                                    </para>
                                </entry>
                            </row>
                            <row>
                                <entry>
                                    <guilabel>in Pages</guilabel>
                                </entry>
                                <entry>
                                    Search all <link linkend="SEO_data_page">SEO data</link> (description, keyword) and pages that have <guilabel>titles</guilabel> or <guilabel>names</guilabel> matching the keyword.
                                </entry>
                            </row>
                        </tbody>
                    </tgroup>
                </table>
            </step>
            <step>
                <para>In the Search form, you can enter another keyword and set the search scale.
                </para>
            </step>
            <step>
                <para>Press <emphasis role="bold">Enter</emphasis>, or click
                    <guilabel>Search</guilabel>
                   to start searching.
                </para>
            </step>
        </procedure>
    </section>
    <section id="sect-User_Guide-Search_portlet_Edit-search-portlet">
        <title>Edit the Search portlet</title>
        <para>Editing the Search portlet allows you to change the display of search results.</para>
        <procedure>
            <step>
                <para>Open the Search page as in <xref linkend="sect-User_Guide-Search_portlet-Search_content"/>.</para>
            </step>
            <step>
                <para>Open the <guilabel>Edit Mode</guilabel> of the <emphasis role="bold">Search</emphasis> portlet by following one of two ways:</para>
                <itemizedlist>
                    <listitem>
                        <para><emphasis role="bold">The first way</emphasis></para>
							<para>Hover your cursor over <menuchoice><guimenu>Edit</guimenu><guimenuitem>Content</guimenuitem> </menuchoice> on the <guilabel>Administration</guilabel> bar, and then click
                            <inlinemediaobject>
                                <imageobject>
                                    <imagedata fileref="images/editicon5.png" format="PNG" width="6mm"/>
                                </imageobject>
                                <textobject>
                                    <phrase>pencil</phrase>
                                </textobject>
                            </inlinemediaobject>.
                        </para>
                        <mediaobject>
                            <imageobject role="html">
                                <imagedata align="center" fileref="images/search-editmode.png" format="PNG"/>
                            </imageobject>
                            <imageobject role="fo">
                                <imagedata align="center" fileref="images/search-editmode.png" format="PNG"
                                           width="150mm"/>
                            </imageobject>
                        </mediaobject>
                    </listitem>
                    <listitem>
                        <para><emphasis role="bold">The second way</emphasis></para>
							<para>Hover your cursor over <menuchoice><guimenu>Edit</guimenu><guisubmenu>Page</guisubmenu> <guimenuitem>Layout</guimenuitem> </menuchoice>
                            on the <guilabel>Administration</guilabel> bar. The
                            <guilabel>Page Editor</guilabel>
                            will be displayed.
                        </para>
                        <itemizedlist>
                            <listitem>
                                <para>Hover your cursor over the
                                    <emphasis role="bold">SearchResult</emphasis>
                                    portlet and click
                                    <inlinemediaobject>
                                        <imageobject>
                                            <imagedata fileref="images/editicon5.png" format="PNG" width="6mm"/>
                                        </imageobject>
                                        <textobject>
                                            <phrase>pencil</phrase>
                                        </textobject>
                                    </inlinemediaobject>
                                    to edit the portlet.
                                </para>
                                <mediaobject>
                                    <imageobject role="html">
                                        <imagedata align="center" fileref="images/edit_searchresult.png" format="PNG"/>
                                    </imageobject>
                                    <imageobject role="fo">
                                        <imagedata align="center" fileref="images/edit_searchresult.png" format="PNG"
                                                   width="150mm"/>
                                    </imageobject>
                                </mediaobject>
                            </listitem>
                        </itemizedlist>
                    </listitem>
                </itemizedlist>

                <para>The <guilabel>Edit Mode</guilabel> of the <emphasis role="bold">Search</emphasis> portlet appears.</para>
                <mediaobject>
                    <imageobject role="html">
                        <imagedata align="center" fileref="images/editsearchportlet.png" format="PNG"/>
                    </imageobject>
                    <imageobject role="fo">
                        <imagedata align="center" fileref="images/editsearchportlet.png" format="PNG" width="100mm"/>
                    </imageobject>
                </mediaobject>
                <para><emphasis role="bold">Details:</emphasis></para>
                <table frame="all">
                        <tgroup cols="2">
                            <colspec colname="c1"/>
                            <colspec colname="c2"/>
                            <thead>
                                <row>
                                    <entry>
                                        Field
                                    </entry>
                                    <entry>
                                        Details
                                    </entry>
                                </row>
                            </thead>
                            <tbody>
                                <row>
                                    <entry>
                                        <guilabel>Items per Page</guilabel>
                                    </entry>
                                    <entry>
                                        <para>
                                            The number of search results displayed in each page.
                                        </para>
                                    </entry>
                                </row>
                                <row>
                                    <entry>
                                        <guilabel>Page Mode</guilabel>
                                    </entry>
                                    <entry>
                                        The way to display the search results. There are 3 options:
                                        <itemizedlist>
                                            <listitem>
                                                <para><guilabel>None</guilabel>: Only the first page of search results is
                                                    displayed in the search page.</para>
                                            </listitem>
                                            <listitem>
                                                <para><guilabel>More</guilabel>: When you click the
                                                    <guibutton>Search</guibutton>
                                                    button, the
                                                    first page of search result is displayed. The difference from the <guilabel>None</guilabel>
                                                    mode
                                                    is that, there is a <guilabel>More</guilabel> button allowing you to see more search results.
                                                    When clicking this button, new search results are appended to
                                                    the
                                                    current search result page like Twitter or Facebook behavior.
                                                </para>
                                            </listitem>
                                            <listitem>
                                                <para><guilabel>Pagination</guilabel>: In this mode, the search results are divided into many pages (for example, 1, 2, 3 and Next). You can navigate to another page by clicking the page number or <guilabel>Next</guilabel> in the bottom of the Search portlet to view more results.</para>
                                            </listitem>
                                        </itemizedlist>
                                    </entry>
                                </row>
                                <row>
                                    <entry>
                                        <guilabel>Search Form Template</guilabel>
                                    </entry>
                                    <entry>
                                        The template of the Search form.
                                    </entry>
                                </row>
                                <row>
                                    <entry>
                                        <guilabel>Search Result Template</guilabel>
                                    </entry>
                                    <entry>
                                        The template for displaying the search results.
                                    </entry>
                                </row>
                                <row>
                                    <entry>
                                        <guilabel>Search Page Layout Template</guilabel>
                                    </entry>
                                    <entry>
                                        The layout of the Search portlet.
                                    </entry>
                                </row>
                                <row>
                                    <entry>
                                        <guilabel>Base Path</guilabel>
                                    </entry>
                                    <entry>
                                        The page where you can see the content of a search result.
                                    </entry>
                                </row>
                            </tbody>
                        </tgroup>
                    </table>
            </step>
            <step>
                <para>Edit your desired portlet and click <guibutton>Save</guibutton> to accept your changes.</para>
            </step>
        </procedure>
    </section>
</section>
