DEPRECATION WARNING

This documentation is not using the current rendering mechanism and is probably outdated. The extension maintainer should switch to the new system. Details on how to use the rendering mechanism can be found here.

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
    )
)