.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. ==================================================
.. DEFINE SOME TEXTROLES
.. --------------------------------------------------
.. role::   underline
.. role::   typoscript(code)
.. role::   ts(typoscript)
   :class:  typoscript
.. role::   php(code)


Adding parameters to links
--------------------------

It may occur that additional parameters are required with an extension
generated by the SAV Library Kickstarter. There are several ways of
adding parameters.


At the library level
^^^^^^^^^^^^^^^^^^^^

Parameters are added in TypoScript and will be applied to all
extensions using the SAV Library Plus. The syntax is the following:

::

   plugin.tx_savlibraryplus.link.additionalParams = &param1=1&param2=3

It may happen that you want to add parameters for one type of view:

::

   plugin.tx_savlibraryplus.viewType.link.additionalParams = &param1=1&param2=3


At the extension level
^^^^^^^^^^^^^^^^^^^^^^

Parameters are added in TypoScript and will be applied to one specific
extension. The syntax is the following:

::

   plugin.tx_yourExtensionNameWithoutUnderscores_pi1.link.additionalParams = &param1=1&param2=3

You may also want to apply the parameters only for one form in one
specific extension. The syntax becomes:

::

   plugin.tx_yourExtensionNameWithoutUnderscores_pi1.formName.link.additionalParams = &param1=1&param2=3

To add parameters to a specific view type, please use:

::

   plugin.tx_yourExtensionNameWithoutUnderscores_pi1.viewType.link.additionalParams = &param1=1&param2=3
   plugin.tx_yourExtensionNameWithoutUnderscores_pi1.formName.viewType.link.additionalParams = &param1=1&param2=3


At the page level
^^^^^^^^^^^^^^^^^

Parameters are added by means of the Page TS Config. The syntax is the
following:

::

   tx_yourExtensionNameWithoutUnderscores_pi1.formName.link.additionalParams = &param1=1&param2=3


To add parameters to a specific view type, please use:

::

   tx_yourExtensionNameWithoutUnderscores_pi1.formName.viewType.link.additionalParams = &param1=1&param2=3


At the filter level
^^^^^^^^^^^^^^^^^^^

Filters are extensions available in the TER which have been designed
to be easily used with extensions generated by the SAV Library
Kickstarter. They are named “sav\_filter\_xxxx”.

For example, parameters can be added to the filter
“sav\_library\_selectors” using the following TypoScript syntax:

::

   plugin.tx_savfilterselectors_pi1.link.additionalParams = &param1=1&param2=3