.. include:: ../../Includes.txt

.. _tutorial7_installationAndConfiguration:

==============================
Installation and Configuration
==============================

Installation
============

#. Download the extension `sav_library_example7 
   <https://extensions.typo3.org/extension/sav_library_example7>`_ 
   from the TER and install it.

#. Download the extension `sav_filters 
   <https://extensions.typo3.org/extension/sav_filters>`_ from the TER and
   install it.

#. Download the extension `sr_freecap 
   <https://extensions.typo3.org/extension/sr_freecap>`_ 
   from the TER and install it.

Guest Input
===========

-  Create a page for the guest input.

-  In this page, insert a plugin content. Select **SAV Example7 – Guest
   book**, select **FORM** in the **General** folder, then in the **Input
   Controls** folder, uncheck **Allow authenticated FE users to input data**.

.. figure:: ../../Images/Tutorial7FormFlexformGeneralFolder.png

.. figure:: ../../Images/Tutorial7FormFlexformInputControlsFolder.png 

-  In the same page,  **before the previous plugin** , add a
   new plugin content. Select **SAV Filters**. Fill the fields as shown
   below. Replace **your_email@example.com** by a  valid email. The value in
   **Uid for the field cruser_id** will be the default value for the
   **cruser_id** field of each record in the table
   **tx_savlibrary_example7_guests**. For example, put your frontend user uid.
   Provide a key which will be used to crypt the link. Finally provide a
   redirection page for errors ( **this field is required** ). When using
   captcha, you can set this field with the current page.

.. figure:: ../../Images/Tutorial7PageContent.png

.. figure:: ../../Images/Tutorial7SavFilterPageAccessFlexform.png

-  Save and go to the page in the frontend. Answer to the captcha and
   submit.

.. figure:: ../../Images/Tutorial7Captcha.png

-  Fill the field with your email and submit.

.. figure:: ../../Images/Tutorial7EmailInputForm.png

-  An information message is displayed and you should received an email
   with a personal link.

::

   Click on the following link to access to the service
   Guest input
   This link is valid only for one request. 

The link is **Your_page_title** (**Guest input** is the page title used
for the tutorial). Click on the link to access to the input form, fill
the form and submit it.

.. figure:: ../../Images/Tutorial7GuestEditView.png
 
Guest Input Validation
======================

-  Create a frontend group, for example **savlibrary_test**. It will be use to
   protect the page and define the **Admin** group. Apply this group to
   you, that is to your frontend user record.

-  Create a page for the guest input validation. Protect the page with
   the frontend group.

-  Insert a plugin content. Select **SAV Example7 – Guest book**, select
   **FORM** in the **General** folder. In the **Input Controls** folder,
   uncheck **input on form** and add the frontend Group to the **Allowed groups**
   field.

.. figure:: ../../Images/Tutorial7GuestInputFlexform.png

-  Save and go to the page in the frontend and click on the email
   associated with your last input.

.. figure:: ../../Images/Tutorial7GuestValidationListView.png 

.. figure:: ../../Images/Tutorial7GuestValidationEditView.png 

List View
=========

-  Insert a plugin content. Select **SAV Example7 – Guest book**, select
   **LIST** in the **General** folder. Set the field **Max number of items** to
   the number of items you want in the list (10 is the default). Uncheck
   **Allow authenticated FE users to input data** in the 
   **Input Controls** folder. Save and go to the
   page in the frontend.


Teaser View
===========

-  Insert a plugin content. Select **SAV Example7 – Guest book**, select
   **TEASER** in the **General** folder. Set the field **Max number of items**
   to the number of items you want in the teaser. Uncheck **Allow authenticated 
   FE users to input data** in the **Input Controls** folder.

-  If you have not changed the value of **setUidRight**, edit the page property. 
   In the page TSConfig add:
   
   ::
   
      tx_savlibraryexample7.TEASER.listView.fields.message.setUidRight
      =  *uid_of_the_page_containing_the_list_form*

-  Go to the page in the frontend.