Add suggest menu for user mentions in text editor

app/Formatter/BaseFormatter.php

@@ -4,7 +4,6 @@ namespace Kanboard\Formatter;
 
 use Kanboard\Core\Base;
 use PicoDb\Table;
-use Pimple\Container;
 
 /**
  * Class BaseFormatter
@@ -22,19 +21,6 @@ abstract class BaseFormatter extends Base
      */
     protected $query;
 
-    /**
-     * Get object instance
-     *
-     * @static
-     * @access public
-     * @param  Container $container
-     * @return static
-     */
-    public static function getInstance(Container $container)
-    {
-        return new static($container);
-    }
-
     /**
      * Set query
      *

app/Formatter/BaseTaskCalendarFormatter.php

@@ -2,8 +2,6 @@
 
 namespace Kanboard\Formatter;
 
-use Kanboard\Core\Filter\FormatterInterface;
-
 /**
  * Common class to handle calendar events
  *
@@ -34,7 +32,7 @@ abstract class BaseTaskCalendarFormatter extends BaseFormatter
      * @access public
      * @param  string  $start_column    Column name for the start date
      * @param  string  $end_column      Column name for the end date
-     * @return FormatterInterface
+     * @return $this
      */
     public function setColumns($start_column, $end_column = '')
     {

app/Formatter/UserMentionFormatter.php

@@ -0,0 +1,60 @@
+<?php
+
+namespace Kanboard\Formatter;
+
+/**
+ * Class UserMentionFormatter
+ *
+ * @package Kanboard\Formatter
+ * @author  Frederic Guillot
+ */
+class UserMentionFormatter extends BaseFormatter
+{
+    protected $users = array();
+
+    /**
+     * Set users
+     *
+     * @param array $users
+     * @return $this
+     */
+    public function withUsers(array $users) {
+        $this->users = $users;
+        return $this;
+    }
+
+    /**
+     * Apply formatter
+     *
+     * @access public
+     * @return array
+     */
+    public function format()
+    {
+        $result = array();
+
+        foreach ($this->users as $user) {
+            $html = $this->helper->avatar->small(
+                $user['id'],
+                $user['username'],
+                $user['name'],
+                $user['email'],
+                $user['avatar_path'],
+                'avatar-inline'
+            );
+
+            $html .= ' '.$this->helper->text->e($user['username']);
+
+            if (! empty($user['name'])) {
+                $html .= ' <small>'.$this->helper->text->e($user['name']).'</small>';
+            }
+
+            $result[] = array(
+                'value' => $user['username'],
+                'html' => $html,
+            );
+        }
+
+        return $result;
+    }
+}