GoalioForgotPassword

Version 1.0.0 Created by the goalio UG (haftungsbeschränkt), _(*1)

Introduction

A Zend Framework 2 (ZF2) Module offering forgot password via e-mail functionality to ZfcUser, _(*2)

Information

I developed this module to use in our goalio application. There are currently no tests and support can be a little slow because we are a small company with only two developers. I appreciate any feedback, pull requests are even better., _(*3)

Requirements

Zend Framework 2 (latest master).
ZfcBase (latest master).
ZfcUser (latest master).
GoalioMailService (latest master).

Features / Goals

Add pluggable behaviour to request a password reset [COMPLETE]
Provide updated login view [COMPLETE]

Installation

Main Setup

With composer

Add this project and the requirements in your composer.json:, _(*4)
```
"require": {
    "goalio/goalio-forgotpassword": "1.*"
}
```
Now tell composer to download GoalioForgotPassword by running the command:, _(*5)
```
$ php composer.phar update
```

Post installation

Enabling it in your application.config.phpfile., _(*6)

<?php
return array(
    'modules' => array(
        // ...
        'ZfcBase',
        'ZfcUser',
        'GoalioMailService',
        'GoalioForgotPassword'
    ),
    // ...
);

Then Import the SQL schema located in ./vendor/goalio/goalio-forgotpassword/data/schema.sql., _(*7)
Make sure that the MailService is configured correctly., _(*8)

Post-Install: Zend\Db

If you do not already have a valid Zend\Db\Adapter\Adapter in your service manager configuration, put the following in ./config/autoload/database.local.php:, _(*9)

<?php

$dbParams = array(
    'database'  => 'changeme',
    'username'  => 'changeme',
    'password'  => 'changeme',
    'hostname'  => 'changeme',
);

return array(
    'service_manager' => array(
        'factories' => array(
            'Zend\Db\Adapter\Adapter' => function ($sm) use ($dbParams) {
                return new Zend\Db\Adapter\Adapter(array(
                    'driver'    => 'pdo',
                    'dsn'       => 'mysql:dbname='.$dbParams['database'].';host='.$dbParams['hostname'],
                    'database'  => $dbParams['database'],
                    'username'  => $dbParams['username'],
                    'password'  => $dbParams['password'],
                    'hostname'  => $dbParams['hostname'],
                ));
            },
        ),
    ),
);

Post-Install: Doctrine2 ORM

There is an additional module for Doctrine integration GoalioForgotPasswordORM, _(*10)

Usage

Navigate to http://yourproject/user and you should land on a login page., _(*11)

Options

The ForgotPassword module has some options to allow you to quickly customize the basic functionality. After installing, copy ./vendor/goalio/goalio-forgotpassword/config/goalioforgotpassword.global.php.dist to ./config/autoload/goalioforgotpassword.global.php and change the values as desired., _(*12)

The following options are available:, _(*13)

password_entity_class - Name of Entity class to use. Useful for using your own entity class instead of the default one provided. Default is GoalioRememberMe\Entity\RememberMe.
reset_expire - Integer value in seconds when the login cookie should expire. Default is 86400 (24 hours).
email_transport - String value which transport class to use. Default is Zend\Mail\Transport\Sendmail.
reset_email_subject_line - String value which transport class to use. Default is You requested to reset your password.
email_from_address - Array Default is array( 'email' => 'your_email_address@here.com', 'name' => 'Your name', ).