README

A Fingerprint bundle to send data to the fingerprint api

Installation

Install through composer:

php -d memory_limit=-1 composer.phar require atm/fingerprintbundle

In your AppKernel

public function registerbundles()
{
    return [
    	...
    	...
    	new ATM\FingerprintBundle\ATMFingerprintBundle(),
    ];
}

Configuration sample

Default values are shown below:

# app/config/config.yml
  
atm_fingerprint:
    fingerprint_error_redirect_route_name: 'route to redirect the user when the fingerprint is not found'
    site_name: 'sitename'
    error_message: 'a message to show to the user when the fingerprint is not found'
    use_assetic: false

If you application uses assetic remember to include de ATMFingerprintBundle in the assetic array bundles in your config.yml file:

 assetic:
     bundles: ['ATMFingerprintBundle']

Include to the main page

{% include 'ATMFingerprintBundle:Fingerprint:store_fingerprint.html.twig' %}

Events

There are 2 events that you can use when the response from the API:

error:

class StatusError extends Event{

 const NAME = 'atm_fingerprint_error.event';

 protected $user;
 protected $response;

 public function __construct($user,$response)
 {
     $this->user = $user;
     $this->response = $response;
 }

 public function getUser()
 {
     return $this->user;
 }

 public function getResponse(){
     return $this->response;
 }
}

success:

class StatusSuccess extends Event{

  const NAME = 'atm_fingerprint_success.event';

  protected $user;
  protected $response;

  public function __construct($user,$response)
  {
      $this->user = $user;
      $this->response = $response;
  }

  public function getUser()
  {
      return $this->user;
  }

  public function getResponse(){
      return $this->response;
  }
}

Event Listener

There is an Event Listener that listens for kernel requests with a priority of 3 and sets a session variable called 'atm_fingerprint_custom_redirect'.

ATM\FingerprintBundle\EventListener\FingerprintRedirect:
    autowire: true
    public: true
    tags:
        - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest, priority: 3 }
    arguments:
        $atm_fingerprint_config: '%atm_fingerprint_config%'

You can set a custom request listener with a low priority to redirect to another place or to put some custom code. Remember to remove the session variable 'atm_fingerprint_custom_redirect'

AppBundle\EventListener\CustomRequestListener:
    autowire: true
    public: true
    tags:
        - { name: kernel.event_listener, event: kernel.request, method: onKernelRequest, priority: 2 }

namespace AppBundle\EventListener;

use Symfony\Component\HttpKernel\Event\GetResponseEvent;
use Symfony\Component\HttpFoundation\Session\SessionInterface;

class CustomRequestListener{

    private $session;

    public function __construct(SessionInterface $session){
        $this->session = $session;
    }
    
    public function onKernelRequest(GetResponseEvent $event){

        if($this->session->has('atm_fingerprint_custom_redirect')){
            $this->session->remove('atm_fingerprint_custom_redirect');
            
            // YOUR CODE GOES HERE
            
            $event->setResponse(new Response());
        }
    }
}

xlabs / fingerprintbundle

Maintainers

Details