in_form.php File Reference

Go to the source code of this file.

Functions
	in_form ()
	Example of how to process passwords. More...

Function Documentation

in_form()

in_form

(

)

Example of how to process passwords.

Note that the value of Password is a Data\Password, not a string-primitive.

Definition at line 6 of file in_form.php.

{
    //Step 0: Declare dependencies
    global $DIC;
    $ui = $DIC->ui()->factory();
    $renderer = $DIC->ui()->renderer();
    $request = $DIC->http()->request();
 
    //Step 1: Define the input field.
    $pwd_input = $ui->input()->field()->password("Password", "! value will be displayed...")
        ->withRevelation(true);
 
    //Step 2: Define the form and attach the field.
    $DIC->ctrl()->setParameterByClass(
        'ilsystemstyledocumentationgui',
        'example',
        'password'
    );
    $form_action = $DIC->ctrl()->getFormActionByClass('ilsystemstyledocumentationgui');
    $form = $ui->input()->container()->form()->standard($form_action, ['password' => $pwd_input]);
 
    //Step 3: Define some data processing.
    $result = '';
    if ($request->getMethod() == "POST"
            && $request->getQueryParams()['example'] == 'password') {
        $form = $form->withRequest($request);
        $result = $form->getData();
    }
 
    //Step 4: Render the form/result.
    return
        "<pre>" . print_r($result, true) . "</pre><br/>" .
        $renderer->render($form);
}

References $DIC, $form, $request, and $result.