Adding custom properties to the authentication container. Something you probably wish to do is to add more information about my your users. Maybe add a name, e-mail, shoe size, etc.

In the auth-containers array definition you can add custom properties by extending the table's field-array. For each field you add, you also need to add an alias for it and specify its type in the field-array. If you are using MDB2 you can find all supported types in the MDB2::Documentation[http://www.backendmedia.de/MDB2/docs/] (under Datatypes [http://www.backendmedia.de/MDB2/docs/datatypes.html]).

Here is a small example, taken from example1 in the LiveUser_Admin documentation:

<code type="php">
$conf =
    array(
        'debug' => true,
        'session'  => array(
            'name'     => 'PHPSESSION',
            'varname'  => 'ludata'
        ),
        'login' => array(
            'force'    => false,
        ),
        'logout' => array(
            'destroy'  => true,
        ),
        'authContainers' => array(
            'DB_Local' => array(
                'type' => $storage,
                'loginTimeout'  => 0,
                'expireTime'    => 3600,
                'idleTime'      => 1800,
                'allowDuplicateHandles' => false,
                'storage' => array(
                    'connection' => $db,
                    'dsn' => $dsn,
                    'prefix' => 'liveuser_',
                    'tables' => array(
                        'users' => array(
                            /**
                             * You can add custom properties by 
                             * extending the table's field-array.
                             */
                            'fields' => array(
                                'name' => false,
                                'email' => false,
                            ),
                        ),
                    ),
                    /**
                     * For each field you add, you also need 
                     * to add an alias for it...
                     */
                    'alias' => array(
                        'name' => 'name',
                        'email' => 'email',
                        'auth_user_id' => 'user_id',
                    ),
                    /**
                     * ...and specify its type in the field-array.
                     */
                    'fields' => array(
                        'name' => 'text',
                        'email' => 'text',
                    ),
                    // 'force_seq' => false
                ),
            )
        ),
        'permContainer' => array(
            'type'  => 'Complex',
            'alias' => array(),
            'storage' => array(
                    'connection' => $db,
                    'dsn' => $dsn,
                    'prefix' => 'liveuser_',
                    'tables' => array(),
                    'fields' => array(),
                    'alias' => array(),
                    // 'force_seq' => false
                ),
            ),
        ),
    );
</code>

Don't forget to synchronize your storage container too (eg. by running install.php again). You can now access the new property by using the method [http://pear.php.net/package/LiveUser/docs/latest/LiveUser/LiveUser.html#methodgetProperty getProperty()] found in LiveUser.