@everymatrix/general-player-login-register-page NP

Login/Register widget Documentation

About the Login/Register widget

Intro to the Login/Register widget

The Login/Register widget is a collection of web components designed and developed to offer easy installation for a standard login process. The widget is agnostic about the framework, library or programming language your current product is built on, while at the same time offering ease of integration for developers, and a sleek gateway to your site for your users.

Scalability

The Login widget scales with you. Although the scalability is mainly accomplished by your main product (the one you integrate this widget into) and by your architecture we took all the necessary steps and precautions to ensure the uninterrupted functionality of this product.

Stateless

In the development of this widget we considered that the widget should not care about any kind of state a container product (the product this widget is integrated into) might have nor that the widget itself should have any kind of state management.

We took this decision in order to ensure maximum integration compatibility as well as infinite scalability. By not sharing or having a state our widgets can be used as a main widget (like the Casino Lobby) or as singular components (such as the Login) wherever you want to place them.

The Login makes use of the following sub-widgets:

Login/Register page component
Login/Register modal component
Forgot Password Form component (not yet implemented)
Login Form component
Register Form component (not yet implemented)

These components can also be used on their own, and they still can communicate to each other even if they are structurally placed in separate parts of your application (they still need to be on the same page).

Pre-requisites needed

For the Login/Register Widget to be able to work, the parent website needs to integrated with the EM platform.

Supported integrations:

NorWAy Integration
CE Integration

For further information on how to proceed with your current integration please contact your assigned Integration Manager.

Setup the widget on your website.

To install the latest version released for the widget, which will be automatically updated once a new release is made, add the following script tags, in the root page of your application.

The scripts can be added either in the or in the . We recommend adding them in the footer of the page for better performance of the entire website.

<script src="https://unpkg.com/@everymatrix/general-player-login-register-modal/dist/general-player-login-register-modal.js"></script>
<script src="https://unpkg.com/@everymatrix/general-player-login-register-page/dist/general-player-login-register-page.js"></script>

For a specific version, the script tag looks like this:

<script src="https://unpkg.com/@everymatrix/general-player-login-register-modal@1.0.0/dist/general-player-login-register-modal.js"></script>
<script src="https://unpkg.com/@everymatrix/general-player-login-register-page@1.0.0/dist/general-player-login-register-page.js"></script>

Usage

Adding the Login Widget is straight forward - it uses the general-player-login-register-modal component and slots inside the general-player-login-register-page, which acts as the controller of the widget - with the mention that there are a multitude of options and configurations available. Then, the controller accesses either one of the three form components: Forgot Password, Login or Register.

Inside your page you need to add the webcomponent tags for the Login/Register Widget.

<general-player-login-register-modal
  endpoint="https://demo-api.stage.norway.everymatrix.com/v1"
  language="en"
  show="false">
  <general-player-login-register-page
    endpoint="https://demo-api.stage.norway.everymatrix.com/v1"
    language="en">
  </general-player-login-register-page>
</general-player-login-register-modal>

Once the user presses the log in button, the login form component emits a postMessage with the credentials (SubmitLoginForm) which is captured and handled by the controller, validating or invalidating upon check the attempt. If valid, it will further send a postMessage (under the type UserSessionID) with them which is then used by the other components to adapt to the new state.

In the case of Change Password, the event which submits the validated data with the new password is captured by the controller under the type ChangePassword, and then emits a confirmation postMessage under the type PasswordChangedSuccessfully.

Full example below:

<!doctype html>
<html lang="en">
  <head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, user-scalable=no, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0">
    <meta http-equiv="X-UA-Compatible" content="ie=edge">
    <title>EM Widgets | Login/Register Widget Demo</title>

    <script src="https://unpkg.com/@everymatrix/general-player-login-register-modal/dist/general-player-login-register-modal.js"></script>
    <script src="https://unpkg.com/@everymatrix/general-player-login-register-page/dist/general-player-login-register-page.js"></script>
    
  </head>
  <body>
    <div class="container">
        <general-player-login-register-modal
          endpoint="https://demo-api.stage.norway.everymatrix.com/v1"
          language="en"
          show="false">
          <general-player-login-register-page
            endpoint="https://demo-api.stage.norway.everymatrix.com/v1"
            language="en">
          </general-player-login-register-page>
        </general-player-login-register-modal>
    </div>
  </body>
</html>

PLEASE NOTE: The given example is a fully working HTML page and demo credentials are used for endpoint field. For development and productions purposes you will need to use your own provided credentials.

Communication between widgets

Type	Message data	Comment
UserSessionID	playerID, sessionID	after validating the login info, it sends a postmessage to the widgets that require it
HasError	error	sends the error message to the `General Player Login Form`
NavForgotPassword	no extra data received	switches content for the `Forgot Password Form`
ToRegister / ToLogin	no extra data received	switches content between `General Player Login Form` and `General Player Register Form`
SubmitLoginForm	loginData	`General Player Login Register Page`receives the login data, which is then validated via api call

API Reference

Parameter	Mandatory	Comment
endpoint	yes	NorWAy endpoint
lang	yes	Language of the website
show	yes	Show/hide login/register modal

Releases

Release Version	Value	Scope	Status	Completed Date
`0.0.42`	Initial release	-	DONE	`04 Aug 2021`

cross-env sirv-cli svelte

@infinitebrahmanuniverse/nolb-_eve @everything-registry/sub-chunk-302 @zalastax/nolb-_eve

2 days ago

13 days ago

18 days ago

24 days ago

26 days ago

1 month ago

1 month ago

1 month ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

2 months ago

3 months ago

2 months ago

3 months ago

3 months ago

3 months ago

3 months ago

3 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

4 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

5 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

6 months ago

6 months ago

7 months ago

7 months ago

7 months ago

6 months ago

6 months ago

7 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

6 months ago

5 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

8 months ago

8 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

9 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

8 months ago

7 months ago

7 months ago

7 months ago

7 months ago

7 months ago

10 months ago

7 months ago

10 months ago

9 months ago

9 months ago

9 months ago

9 months ago

10 months ago

10 months ago

10 months ago

10 months ago

11 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

12 months ago

12 months ago

1 year ago

12 months ago

12 months ago

1 year ago

1 year ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

11 months ago

12 months ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

1 year ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

2 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago

3 years ago