From cb0916d10e4a42a62f0ac8c69ecb4b7a15f398b4 Mon Sep 17 00:00:00 2001
From: Frederic Guillot <fred@kanboard.net>
Date: Sat, 20 Jun 2015 10:48:47 -0400
Subject: Add automatic action to send a task by email

---
 app/Action/TaskEmail.php | 97 ++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 97 insertions(+)
 create mode 100644 app/Action/TaskEmail.php

(limited to 'app/Action/TaskEmail.php')

diff --git a/app/Action/TaskEmail.php b/app/Action/TaskEmail.php
new file mode 100644
index 00000000..363a01c6
--- /dev/null
+++ b/app/Action/TaskEmail.php
@@ -0,0 +1,97 @@
+<?php
+
+namespace Action;
+
+use Model\Task;
+
+/**
+ * Email a task to someone
+ *
+ * @package action
+ * @author  Frederic Guillot
+ */
+class TaskEmail extends Base
+{
+    /**
+     * Get the list of compatible events
+     *
+     * @access public
+     * @return array
+     */
+    public function getCompatibleEvents()
+    {
+        return array(
+            Task::EVENT_MOVE_COLUMN,
+            Task::EVENT_CLOSE,
+        );
+    }
+
+    /**
+     * Get the required parameter for the action (defined by the user)
+     *
+     * @access public
+     * @return array
+     */
+    public function getActionRequiredParameters()
+    {
+        return array(
+            'column_id' => t('Column'),
+            'user_id' => t('User that will receive the email'),
+            'subject' => t('Email subject'),
+        );
+    }
+
+    /**
+     * Get the required parameter for the event
+     *
+     * @access public
+     * @return string[]
+     */
+    public function getEventRequiredParameters()
+    {
+        return array(
+            'task_id',
+            'column_id',
+        );
+    }
+
+    /**
+     * Execute the action (move the task to another column)
+     *
+     * @access public
+     * @param  array   $data   Event data dictionary
+     * @return bool            True if the action was executed or false when not executed
+     */
+    public function doAction(array $data)
+    {
+        $user = $this->user->getById($this->getParam('user_id'));
+
+        if (! empty($user['email'])) {
+
+            $task = $this->taskFinder->getDetails($data['task_id']);
+
+            $this->emailClient->send(
+                $user['email'],
+                $user['name'] ?: $user['username'],
+                $this->getParam('subject'),
+                $this->template->render('notification/task_create', array('task' => $task, 'application_url' => $this->config->get('application_url')))
+            );
+
+            return true;
+        }
+
+        return false;
+    }
+
+    /**
+     * Check if the event data meet the action condition
+     *
+     * @access public
+     * @param  array   $data   Event data dictionary
+     * @return bool
+     */
+    public function hasRequiredCondition(array $data)
+    {
+        return $data['column_id'] == $this->getParam('column_id');
+    }
+}
-- 
cgit v1.2.3