Custom processing for mapping

A hook lets you create custom mapping markers:

name = {hookName|myCustomHook;param1|value1;param2|<cn>}

Syntax

• Your custom marker should be surrounded by opening and closing curly braces {...}.
• Parameters are delimited by semi-colons (;).
• A parameter is a pair of parameter name and parameter value delimited by a pipe (|).
• First parameter should always be hookName.
• Parameter value may contain references to LDAP attributes using the standard syntax with <>.

Registration

In your extension (in the ext_localconf.php file), register the hook using a code like:

$GLOBALS['TYPO3_CONF_VARS']['EXTCONF']['ig_ldap_sso_auth']['extraMergeField']['myCustomHook']
        = 'EXT:extension/Path/To/Class/ClassName.php:VendorName\\ClassName';

where myCustomHook corresponds to one of the hookName parameters you use in your mapping.

Your class has to implement a method extraMerge which will receive the following arguments:

$field

The name of the corresponding field in the mapping.

$typo3Record

An array containing the current user/group record from TYPO3.

$ldapRecord

An array containing the current user/group record from LDAP.

$ldapAttributes

An array containing LDAP attributes found in your mapping definition.

$hookParameters

An associative array with all hook parameters found in your mapping definition (thus including hookName).

Your method should simply return a string for the value to be given to $field.