.. include:: /Includes.rst.txt

.. _quickstart:

===========
Quick start
===========

Follow the steps below to set up a simple fulltext search for your pages.
In order to use the faceting feature see "Faceting".

.. contents::
   :depth: 1
   :local:

Download and installation
=========================

Install the extension ke_search via extension manager or via composer (recommended):

.. code-block:: shell

   composer require tpwd/ke_search

You can find the current version (and older ones) at

https://extensions.typo3.org/extension/ke_search

Include static template
=======================

In your main template include the "static template" of the extension ke_search.

Create pages
============

Create a new page called "Search" (or similar) and a sysfolder called "Search data" (or similar).

.. figure:: /Images/QuickStart/page-structure.png
   :alt: Page tree with search page
   :class: with-border

Configure Plugins
=================

You need to create two plugins: The searchbox and the resultlist.

.. figure:: /Images/QuickStart/plugins-1.png
   :alt: Faceted Search plugin in new content element wizard
   :class: with-border

.. rst-class:: bignums-xxl

   #. Create a plugin :guilabel:`Faceted Search: Show searchbox and filters` on the page `Search`

      Fill in the field :guilabel:`Record Storage Page` in the Tab :guilabel:`Plugin` > :guilabel:`General` with
      the folder that you created in step 2 (our example: `Search data`).

      .. figure:: /Images/QuickStart/plugins-3.png
         :alt: Plugin tab on "searchbox and filters" plugin
         :class: with-border

      .. hint::
         It is useful to give the plugin :guilabel:`Searchbox and Filters` a header (our example:
         `Searchbox`, can also set to `hidden`):

         .. figure:: /Images/QuickStart/plugins-2.png
            :alt: Headlines palette in plugin
            :class: with-border

         That makes it easier to identify the correct content element in the next step.

   #. Create a plugin :guilabel:`Faceted Search: Show resultlist` on the page `Search`

      In the field "load flexform config from this search box" fill in the Search-Plug-In that you created in Step 3 (our example: "Searchbox").

      .. figure:: /Images/QuickStart/plugins-5.png
         :alt: Plugin tab
         :class: with-border

      After this steps, you should have two plugins on your search page.

      .. figure:: /Images/QuickStart/plugins-4.png
         :alt: Page module view with two Faceted Search plugins
         :class: with-border


Create the indexer configuration
================================

Use the :guilabel:`List` module to create an indexer configuration on the page `Search data`.

.. figure:: /Images/QuickStart/indexer-configuration-1.png
   :alt: New record view
   :class: with-border


* Choose a title.
* Set the :guilabel:`Type` to `Pages`.
* Set the :guilabel:`Storage` to your folder `Search data`.
* Choose the pages you wish to index. You can decide whether the indexing process runs on all pages recursively or
  if only one page will be indexed. You can combine both fields.

.. figure:: /Images/QuickStart/indexer-configuration-2.png
   :alt: Example for an indexer configuration
   :class: with-border

Start Indexer
=============

Open the backend module :guilabel:`Web` > :guilabel:`Faceted Search` and start the indexing process.

.. figure:: /Images/QuickStart/start.png
   :alt: Backend module view
   :class: with-border

You're done!

Open the `Search` page in the frontend and start finding ...