mamuz/mamuz-contact

Provides simple contact form rendered by twitter-bootstrap view helper for ZF2 with Doctrine

MamuzContact

, _(*1)

, _(*2)

Features

• This module provides a contact form based on ZF2 and Doctrine2.
• Submitted contact forms will persist in repository.
• Captcha support is provided to force submitting by humans.
• Views are twitter-Bootstrap compatible.

Installation

The recommended way to install mamuz/mamuz-contact is through composer by adding dependency to your composer.json:, _(*3)

{
    "require": {
        "mamuz/mamuz-contact": "*"
    }
}

After that run composer update and enable this module for ZF2 by adding MamuzContact to modules in ./config/application.config.php:, _(*4)

// ...
    'modules' => array(
        'MamuzContact',
    ),

This module is based on DoctrineORMModule and be sure that you have already configured database connection., _(*5)

Create database tables with command line tool provided by DoctrineORMModule:, _(*6)

./vendor/bin/doctrine-module orm:schema-tool:update

Configuration

This module is usable out of the box, but you can overwrite default configuration by adding a config file in ./config/autoload directory. For default configuration see module.config.php, _(*7)

Captcha Support

Create a new config file and place it to ./config/autoload directory and insert configuration array for Zend Captcha form element factory. Array must be indexed by key captcha, for e.g.:, _(*8)

return array(
    'captcha' => array(
        'type'       => 'Zend\Form\Element\Captcha',
        'name'       => 'captcha',
        'options'    => array(
            'label'   => 'Please verify you are human',
            'captcha' => array(
                'class'   => 'recaptcha',
                'options' => array(
                    'pubkey'  => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
                    'privkey' => 'xxxxxxxxxxxxxxxxxxxxxxxxxxxxx',
                ),
            ),
        ),
        'attributes' => array(
            'required' => 'required'
        ),
    ),
);

Requirement for Google ReCaptcha WebService

Register your domain to Google ReCaptcha WebService to create a private key and a public key. Be sure that private key will not commit to VCS., _(*9)

Workflow

After filtering and validation of user input a new contact entity will persist in repository MamuzContact., _(*10)

Events

For the sake of simplicity Event is used for FQN MamuzContact\EventManager\Event., _(*11)

The following events are triggered by Event::IDENTIFIER mamuz-contact:, _(*12)