/**
  * @docs-name  Email forgot password token
  *
  * json should be passed in in the following form
  * ~~~
  * {
  *     "email": string
  * }
  * ~~~
  *
  * @docs-param email string body required json object containing a user's email
  */
 public function postForgotPassword()
 {
     if ($this->getEmailProvider() == null) {
         $this->getApp()->returnError(Errors::$PASSWORD_EMAIL_PROVIDER);
     }
     if ($this->forgotEmailTemplate == null) {
         $this->getApp()->returnError(Errors::$PASSWORD_EMAIL_TEMPLATE);
     }
     /**
      * @var $user User
      */
     $data = json_decode($this->getApp()->getRequest()->getBody());
     try {
         $email = $data->email;
     } catch (\Exception $e) {
         $this->getApp()->returnError(Errors::$PASSWORD_EMAIL_REQUIRED);
     }
     $user = User::init($this->getApp());
     if (!$user->findByField('email', $email)) {
         $this->getApp()->returnError(Errors::$PASSWORD_NO_USER_EMAIL);
     }
     $user->lastAccessed = new \DateTime('now');
     $user->save();
     $authToken = Identity::passHash($user->passHash, $user->lastAccessed->getTimestamp());
     $this->forgotEmailTemplate->mergeData(array('!authToken' => $authToken));
     $resp = $this->getEmailProvider()->sendEmail($user->email, $this->forgotEmailTemplate);
     echo json_encode($resp);
 }