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

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

ReconfigureIf
^^^^^^^^^^^^^

This allows you to reconfigure all the settings within the current configuration, _if_ certain circumstances apply.

aIf
---

Array. Holds all circumstances that might (sIfConnect = OR) or have have to (sIfConnect = AND) apply in order to reconfigure the settings. Firstly, they key in this case does not matter; nevertheless every key represents one condition. Every condition has to hold a first value and -- optionally -- might hold an operator and a second value. Consider the following example: ::

    'aIf' => array(
        '###fe_user:uid###',
        '###GP:language###==en',
        '###fe_user:username###==###owner###'
    )

All three entries represent different conditions. The first (without operator and second value) just checks if the current user's ID is set (thus, if a user is logged in). The second one check whether there's a \_GET/\_POST parameter named *language* and if it's equal to *en*. The third finally checks whether the currently logged in user's username equals the column/field *owner* (thus, this is only available as callback interceptor).

You might use other operators as well:

========    ========================
Operator    Description
========    ========================
==          equals
!=          equals not
>=          larger or equal to
<=          smaller or equal to
\>          only larger
\<          only smaller
========    ========================

sIfConnect
----------

String (one of AND or OR). If not set or set to **AND**, all conditions in *aIf* have to apply in order to reset the configuration. If set to **OR**, only one has to apply.

aSet
----

Associative array. Now this is the configuration to be re-written. It's easy: You need the configurative path to the setting you want to reset and the new value and you set that here. The path is the same you would use for JSON configruation. Here are a few often-needed examples: ::

    'aSet' => array(
        'data/bEdit' => FALSE,
        'dbal/bOnlyEntriesBasedOnCurrentUser' => FALSE,
        'data/sTemplateDir' => 'fileadmin/template/tx_mhomsqlio/user_template/',
        'data/aJsConfig' => array(
            'autoHeight' => FALSE,
            'height' => 640
        )
    )