Applications now send email notices on save

Liaisons should receive an email each time their board
receives a new application.

Fixes #196

Controllers/ApplicantsController.php

@@ -121,6 +121,7 @@ public function apply()
                 }
                 $zend_db->getDriver()->getConnection()->commit();
 
+                $this->notifyLiaisons($applicant);
                 $this->template->blocks[] = new Block('applicants/success.inc', ['applicant'=>$applicant]);
 
                 return;
@@ -163,4 +164,19 @@ public function delete()
             $this->template->blocks[] = new Block('404.inc');
         }
     }
+
+    private function notifyLiaisons(Applicant $applicant)
+    {
+        foreach ($applicant->getApplications() as $a) {
+            $people = $a->getPeopleToNotify();
+            if (count($people)) {
+                $b = new Block('liaisons/applicationNotification.inc', ['application'=>$a]);
+                $message = $b->render('txt', $this->template);
+                $subject = sprintf($this->template->_('board_application_subject', 'messages'), $a->getCommittee()->getName());
+                foreach ($people as $p) {
+                    $p->sendNotification($message, $subject);
+                }
+            }
+        }
+    }
 }

Models/Applicant.php

@@ -1,6 +1,6 @@
 <?php
 /**
- * @copyright 2016 City of Bloomington, Indiana
+ * @copyright 2016-2017 City of Bloomington, Indiana
  * @license http://www.gnu.org/licenses/agpl.txt GNU/AGPL, see LICENSE.txt
  */
 namespace Application\Models;
@@ -140,6 +140,11 @@ public function handleUpdate(array $post)
 	//----------------------------------------------------------------
 	// Custom Functions
 	//----------------------------------------------------------------
+	public function getFullname() : string
+	{
+        return "{$this->getFirstname()} {$this->getLastname()}";
+	}
+
 	/**
 	 * Applications for this applicant
 	 *
@@ -193,5 +198,4 @@ public function getFiles()
         }
         return $files;
 	}
-
 }

Models/Application.php

@@ -111,4 +111,20 @@ public function getExpires($format=null)
         $expires->add(new \DateInterval("P{$d}D"));
         return $expires->format($format);
 	}
-}
+
+	public function getPeopleToNotify() : array
+	{
+        $people = [];
+
+        $sql = "select p.*
+                from people       p
+                join liaisons     l on p.id=l.person_id
+                join applications a on l.committee_id=a.committee_id
+                where a.id=?";
+        $zend_db = Database::getConnection();
+        $result  = $zend_db->createStatement($sql)->execute([$this->getId()]);
+        foreach ($result as $p) { $people[] = new Person($p); }
+
+        return $people;
+	}
+}

Models/Person.php

@@ -411,4 +411,22 @@ public function isSafeToDelete()
         $result  = $zend_db->query($sql)->execute();
         return count($result) ? false : true;
 	}
+
+	public function sendNotification(string $message, string $subject=null, string $replyTo=null)
+	{
+        $to = $this->getEmail();
+        if ($to) {
+            if (!$subject) {
+                $subject = APPLICATION_NAME.' Notification';
+            }
+            $name = preg_replace('/[^a-zA-Z0-9]+/','_',APPLICATION_NAME);
+            $fromEmail    = "$name@".BASE_HOST;
+            $fromFullname = APPLICATION_NAME;
+
+            $message = mb_convert_encoding($message, 'ISO-8859-1', 'UTF-8');
+            $from    = "From: $fromFullname <$fromEmail>";
+            if ($replyTo) { $from.="\r\nReply-to: $replyTo"; }
+            mail($to, $subject, $message, $from, '-f'.ADMINISTRATOR_EMAIL);
+        }
+	}
 }

ansible/group_vars/all.yml

@@ -25,4 +25,5 @@ onboard_google:
 
 onboard_directory_service: ""
 onboard_cas_host: ""
+onboard_admin_email: ""
 ...

ansible/templates/site_config.j2

@@ -86,3 +86,4 @@ define('LOCALE', 'en_US');
 
 define('TERM_END_WARNING_DEFAULT', 60);
 define('APPLICATION_LIFETIME_DEFAULT', 90);
+define('ADMINISTRATOR_EMAIL', '{{ onboard_admin_email }}');

blocks/txt/liaisons/applicationNotification.inc

@@ -0,0 +1,19 @@
+<?php
+/**
+ * @copyright 2017 City of Bloomington, Indiana
+ * @license http://www.gnu.org/licenses/agpl.txt GNU/AGPL, see LICENSE.txt
+ * @param Application $this->application
+ */
+declare (strict_types=1);
+
+$committee    = $this->application->getCommittee()->getName();
+$committee_id = $this->application->getCommittee_id();
+$person       = $this->application->getApplicant()->getFullname();
+$message      = sprintf($this->template->_('board_application_message', 'messages'), $person, $committee);
+$url          = BASE_URL.'/committees/applications?committee_id='.$committee_id;
+
+echo "
+$message
+
+$url
+";

data/site_config.inc.example

@@ -103,3 +103,4 @@ define('LOCALE', 'en_US');
 
 define('TERM_END_WARNING_DEFAULT', 60);
 define('APPLICATION_LIFETIME_DEFAULT', 90);
+define('ADMINISTRATOR_EMAIL', 'someone@localhost');

language/en_US/LC_MESSAGES/messages.po

@@ -67,3 +67,9 @@ msgstr "Add %s"
 
 msgid "edit_something"
 msgstr "Edit %s"
+
+msgid "board_application_subject"
+msgstr "%s application received"
+
+msgid "board_application_message"
+msgstr "%s has applied for %s"