alfresco-ng2-components/docs/core/login.component.md

Added, Status

Added	Status
v2.0.0	Active

Login component

Authenticates to Alfresco Content Services and Alfresco Process Services.

Contents

• Basic usage

  • Properties
  • Events

• Details

  • Handling events
  • Change footer content
  • Change header content
  • Extra content
  • Custom logo and background
  • Customize Validation rules
  • Controlling form submit execution behaviour

Basic usage

<adf-login 
    providers="ECM"
    successRoute="/home">
</adf-login>

Properties

Name	Type	Default value	Description
showRememberMe	boolean	true	Should the Remember me checkbox be shown?
showLoginActions	boolean	true	Should the extra actions (Need Help, Register, etc) be shown?
needHelpLink	string	''	Sets the URL of the NEED HELP link in the footer.
registerLink	string	''	Sets the URL of the REGISTER link in the footer.
logoImageUrl	string	'./assets/images/alfresco-logo.svg'	Path to a custom logo image.
backgroundImageUrl	string	'./assets/images/background.svg'	Path to a custom background image.
copyrightText	string	'\u00A9 2016 Alfresco Software, Inc. All Rights Reserved.'	The copyright text below the login box.
providers	string		Possible valid values are ECM, BPM or ALL. By default, this component will log in only to ECM. If you want to log in in both systems then use ALL. There is also a way to call your Auth token API using the string "OAUTH" (supported only for BPM)
fieldsValidation	any		Custom validation rules for the login form.
disableCsrf	boolean		Prevents the CSRF Token from being submitted. Only valid for Alfresco Process Services.
successRoute	string	null	Route to redirect to on successful login.

Events

Name	Type	Description
success	EventEmitter<LoginSuccessEvent>	Emitted when the login is successful.
error	EventEmitter<LoginErrorEvent>	Emitted when the login fails.
executeSubmit	EventEmitter<LoginSubmitEvent>	Emitted when the login form is submitted.

Details

Handling events

app.component.html

<adf-login 
    providers="ALL"
    (success)="mySuccessMethod($event)"
    (error)="myErrorMethod($event)">
</adf-login>

app.component.ts

export class AppComponent {

    mySuccessMethod($event) {
        console.log('Success Login EventEmitt called with: ' + $event.value);
    }

    myErrorMethod($event) {
        console.log('Error Login EventEmitt called with: ' + $event.value);
    }
}

Change footer content

You can replace the entire content in the footer of the login component with your custom content.

<adf-login ...>
    <login-footer><ng-template>My custom HTML for the footer</ng-template></login-footer>
</adf-login>`

Change header content

You can replace the entire content in the header of the login component with your custom content.

<adf-login ...>
    <login-header><ng-template>My custom HTML for the header</ng-template></login-header>
</adf-login>`

Extra content

You can put additional html content between alfresco-login tags to get it rendered as part of the login dialog. This becomes handy in case you need to extend it with custom input fields handled by your application or parent component:

<adf-login ...>
    <div>
        <div>Your extra content</div>
    </div>
</adf-login>

Here's an example of custom content:

Custom logo and background

It is possible changing logo and background images to custom values.

<adf-login 
    [backgroundImageUrl]="'http://images.freeimages.com/images/previews/638/wood-wall-for-background-1634466.jpg'"
    [logoImageUrl]="'http://images.freeimages.com/images/previews/eac/honeybee-with-a-house-1633609.jpg'">
</adf-login>

Should give you something like the following:

Alternatively you can bind to your component properties and provide values dynamically if needed:

<adf-login
    [backgroundImageUrl]="myCustomBackground"
    [logoImageUrl]="myCustomLogo">
</adf-login>

Customize Validation rules

If needed it is possible to customise the validation rules of the login form. You can add/modify the default rules of the login form.

MyCustomLogin.component.html

<adf-login 
    [fieldsValidation]="customValidation"
    #alfrescologin>
</adf-login>

MyCustomLogin.component.ts

export class MyCustomLogin {
    
    @ViewChild('alfrescologin')
    alfrescologin: any;

    customValidation: any;

    constructor(public router: Router) {
        this.customValidation = {
            username: ['', Validators.compose([Validators.required, Validators.minLength(8), Validators.maxLength(10)])],
            password: ['', Validators.required]
        };
    }

    ngOnInit() {
        this.alfrescologin.addCustomValidationError('username', 'minlength', 'Username must be at least 8 characters.');
        this.alfrescologin.addCustomValidationError('username', 'maxlength', 'Username must not be longer than 11 characters.');
    }
}

Call an external identity provider to fetch the auth token

If needed it is possible to call an external provider to identify the user.

app.config.json

{
    "oauth2" : {
      "host": "http://myhost.com",
      "authPath": "/my-custom-auth/token",
      "clientId": "my-client-id",
      "secret": ""
    }
}

MyCustomLogin.component.html

<adf-login 
    [providers]="'OAUTH'"
    (success)="onMyAuthLogin($event)">
</adf-login>

MyCustomLogin.component.ts

export class MyCustomLogin {
 
    constructor(public router: Router) {
    }

    onMyAuthLogin($event) {
        console.log("My token " + $event.token.ticket)
        this.router.navigate(['/home']);
    }
}

Controlling form submit execution behaviour

If absolutely needed it is possible taking full control over form submit execution by means of executeSubmit event. This event is fired on form submit.

You can prevent default behaviour by calling event.preventDefault(). This allows for example having custom form validation scenarios and/or additional validation summary presentation.

Alternatively you may want just running additional code without suppressing default one.

MyCustomLogin.component.html

<adf-login 
    (executeSubmit)="validateForm($event)" 
    #alfrescologin>
</adf-login>

MyCustomLogin.component.ts

export class MyCustomLogin {

    validateForm(event: any) {
        let values = event.values;
        
        // check if the username is in the blacklist
        if (values.controls['username'].value === 'invalidUsername') {
            this.alfrescologin.addCustomFormError('username', 'the
            username is in blacklist');
            event.preventDefault();
        }
    }
    
}

Please note that if event.preventDefault() is not called then default behaviour will also be executed after your custom code.

See Also

• Logout directive