inem0o/user-password-lost-bundle

A user password recovery bundle for Symfony3

Installation

NOTE: The bundle is compatible with Symfony 3.0 upwards., _(*1)

1 . Download this bundle to your project first. The preferred way to do it is to use Composer package manager:, _(*2)

``` json "require": { "inem0o/user-password-lost-bundle": "dev-master" }, <sub>(*3)</sub>

2 . Configure kernel:

``` php
// app/AppKernel.php
public function registerBundles()
{
    $bundles = array(
        // ...
        new inem0o\UserPasswordLostBundle\UserPasswordLostBundle(),
        // ...
    );
}

3 . Configure bundle :, <sub>(*4)</sub>

``` yaml, <sub>(*5)</sub>

app/config/config.yml

user_password_lost: user_repo_name: "AppBundle:User" user_email_column_name: "email", <sub>(*6)</sub>

  email_from: "contact@site.net"

  route_to_redirect_on_failure: "homepage"
  route_to_redirect_on_success: "login"

  display_success_flashbag: true

  forms:
        constraints:
                - {form_name: form_password_request, field: user_email, class: Symfony\Component\Validator\Constraints\NotBlank, params: {message: 'Email field cannot be blank'}}

4 . Configure routes :
``` yaml
# app/config/routing.yml
user_password_lost:
  resource: "@UserPasswordLostBundle/Resources/config/routing.yml"
  prefix:   /

4 . Override templates :, <sub>(*7)</sub>

Copy all templates from

./vendor/inem0o/user-password-lost-bundle/inem0o/UserPasswordLostBundle/Resources/views/*

into the folder

./app/Resources/UserPasswordLostBundle/views

5 . Override translations :, <sub>(*8)</sub>

Copy all translation files from

./vendor/inem0o/user-password-lost-bundle/inem0o/UserPasswordLostBundle/Resources/translations/userPasswordLostBundle.*.xliff

into the folder

./app/Resources/translations/userPasswordLostBundle.*.xliff

Events

The UserPasswordLostBundle dispatches an event when the reset has been successful : inem0o.userpasswordlostbundle.successful_reset The event contains the user who requested a new password, accessible with a $event->getUser() getter. You have to register a listener in order to catch it., <sub>(*9)</sub>

Example : (Considering you named your event PasswordResetSuccessListener and your callback method onSuccessfulReset) ``` yaml, <sub>(*10)</sub>

src/Acme/AppBundle/Resources/config/services.yml

acme.user.reset_password_success.listener: class: Acme\AppBundle\EventListener\PasswordResetSuccessListener tags: - { name: kernel.event_listener, event: inem0o.userpasswordlostbundle.successful_reset, method: onSuccessfulReset } ```, <sub>(*11)</sub>