Users registration and login

Registration

User can be registered in Publisher with REST API /{version}/users/register/ POST request.

1
curl -X POST 'http://webpublisher.dev/api/v1/users/' -H 'Origin: http://webpublisher.dev' -H 'Content-Type: application/x-www-form-urlencoded' -H 'Accept: */*' -H 'Connection: keep-alive' -H 'DNT: 1' --data '_format=json&user_registration%5Bemail%5D=pawel.mikolajczuk%40sourcefabric.org&user_registration%5Busername%5D=pawel.mikolajczuk&user_registration%5BplainPassword%5D%5Bfirst%5D=superStronP%40SSword&user_registration%5BplainPassword%5D%5Bsecond%5D=superStronP%40SSword' --compressed

After that user will get email message with link for account confirmation. Link will redirect him to /register/confirmed page.

Customize sender email address:

By default email will be sent from 'contact@{tenant domain} - example: contact@example.com. You can override it by customizing registration_from_email.confirmation setting.

Customize confirmation email template:

Default template used for confirmation is @FOSUser/Registration/email.txt.twig You can override it by customizing registration_from_email.confirmation setting.

Customize account confirmation page template:

After clicking on conformation link (from email) user will be redirected to /register/confirmed url. To render this page publisher by default use '@FOSUser/Registration/confirmed.html.twig.

You can override it in Your theme (with creating FOSUser/Registration/confirmed.html.twig file in your theme.

Note

Read more about settings in SettingsBundle.

Login

Publisher don’t provide single page for login action, instead that we made sure that login can be placed in any template (or even widget) of You choice. Only hardcoded url’s for security are /security/login_check (used for user authentication - you need to send your login form data there) and /security/logout (used for logging out user).

Example login form:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
{% if app.session.has('_security.last_error') %}
    {# show error message after unsuccessful login attempt #}
    {% set error = app.session.get('_security.last_error') %}
    <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
{% endif %}
<form action="{{ path('security_login_check') }}" method="POST">
    <input type="text" name="_username" value="{{ app.session.get('_security.last_username') }}" />
    <input type="password" name="_password" value="" />
    <input type="hidden" name="_login_success_path" value="{{ url('homepage') }}">
    <input type="hidden" name="_login_failure_path" value="{{ url('homepage') }}">
    <input type="submit" value="Login" />
</form>

Parameters explanation:

  • _username - User username parameter (You can use {{ app.session.get('_security.last_username') }} as a default value - it will be filled with previously entered username when login will fail and user will be redirected to login form again).
  • _password - User password
  • _login_success_path - url used for redirection after successful login
  • _login_failure_path - url used for redirection after unsuccessful login (use {{ url(gimme.page) }} to generate url for current page)

Check if users is logged in:

1
2
3
4
5
{% if app.user %}
    Hey {{ app.user.username }}. <a href="{{ url('security_logout') }}">Logout</a>.
{% else %}
    {# Show login form #}
{% endif %}

Password Reset

By default, there are a few routes exposed for password reset functionality (provided by FOSUserBundle).

When going to route /resetting/request (route name is fos_user_resetting_request) the default password reset form will be rendered.

You can override this template in your theme by creating FOSUserBundle/views/Resetting/request.html.twig file in your theme.

All templates related to password reset functionality which can be overridden can be found here.