From e0f925d298968c4d2304d5b563d0b9eabaf0ce1b Mon Sep 17 00:00:00 2001
From: Frederic Guillot <fred@kanboard.net>
Date: Fri, 5 Feb 2016 20:51:19 -0500
Subject: Update plugin hooks doc

---
 app/Template/task/dropdown.php | 60 ++++++++++++++++++++++++++++++++++++++++++
 app/Template/task/sidebar.php  |  2 +-
 doc/plugin-hooks.markdown      | 56 +++++++++++++++++++++------------------
 3 files changed, 91 insertions(+), 27 deletions(-)
 create mode 100644 app/Template/task/dropdown.php

diff --git a/app/Template/task/dropdown.php b/app/Template/task/dropdown.php
new file mode 100644
index 00000000..3300ccf0
--- /dev/null
+++ b/app/Template/task/dropdown.php
@@ -0,0 +1,60 @@
+<div class="dropdown">
+    <a href="#" class="dropdown-menu">#<?= $task['id'] ?></a>
+    <ul>
+        <?php if (isset($task['date_started']) && empty($task['date_started'])): ?>
+        <li>
+            <i class="fa fa-play fa-fw"></i>
+            <?= $this->url->link(t('Set automatically the start date'), 'taskmodification', 'start', array('task_id' => $task['id'], 'project_id' => $task['project_id'])) ?>
+        </li>
+        <?php endif ?>
+        <li>
+            <i class="fa fa-pencil-square-o fa-fw"></i>
+            <?= $this->url->link(t('Edit the task'), 'taskmodification', 'edit', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-align-left fa-fw"></i>
+            <?= $this->url->link(t('Edit the description'), 'taskmodification', 'description', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-plus fa-fw"></i>
+            <?= $this->url->link(t('Add a sub-task'), 'subtask', 'create', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-code-fork fa-fw"></i>
+            <?= $this->url->link(t('Add internal link'), 'tasklink', 'create', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-external-link fa-fw"></i>
+            <?= $this->url->link(t('Add external link'), 'TaskExternalLink', 'find', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-comment-o fa-fw"></i>
+            <?= $this->url->link(t('Add a comment'), 'comment', 'create', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-files-o fa-fw"></i>
+            <?= $this->url->link(t('Duplicate'), 'taskduplication', 'duplicate', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-clipboard fa-fw"></i>
+            <?= $this->url->link(t('Duplicate to another project'), 'taskduplication', 'copy', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <li>
+            <i class="fa fa-clone fa-fw"></i>
+            <?= $this->url->link(t('Move to another project'), 'taskduplication', 'move', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+        </li>
+        <?php if (isset($task['is_active'])): ?>
+        <li>
+            <?php if ($task['is_active'] == 1): ?>
+                <i class="fa fa-times fa-fw"></i>
+                <?= $this->url->link(t('Close this task'), 'taskstatus', 'close', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+            <?php else: ?>
+                <i class="fa fa-check-square-o fa-fw"></i>
+                <?= $this->url->link(t('Open this task'), 'taskstatus', 'open', array('task_id' => $task['id'], 'project_id' => $task['project_id']), false, 'popover') ?>
+            <?php endif ?>
+        </li>
+        <?php endif ?>
+
+        <?= $this->hook->render('template:task:dropdown') ?>
+    </ul>
+</div>
diff --git a/app/Template/task/sidebar.php b/app/Template/task/sidebar.php
index c60a1810..d1fab13e 100644
--- a/app/Template/task/sidebar.php
+++ b/app/Template/task/sidebar.php
@@ -28,6 +28,6 @@
             <?= $this->url->link(t('External links'), 'TaskExternalLink', 'show', array('task_id' => $task['id'], 'project_id' => $task['project_id'])) ?>
         </li>
 
-        <?= $this->hook->render('template:task:sidebar:information') ?>
+        <?= $this->hook->render('template:task:sidebar') ?>
     </ul>
 </div>
diff --git a/doc/plugin-hooks.markdown b/doc/plugin-hooks.markdown
index 6e15e858..2eb8aadd 100644
--- a/doc/plugin-hooks.markdown
+++ b/doc/plugin-hooks.markdown
@@ -151,31 +151,35 @@ Template names without prefix are core templates.
 
 List of template hooks:
 
-- `template:analytic:sidebar`
-- `template:app:filters-helper:before`
-- `template:app:filters-helper:after`
-- `template:auth:login-form:before`
-- `template:auth:login-form:after`
-- `template:config:sidebar`
-- `template:config:integrations`
-- `template:dashboard:sidebar`
-- `template:export:sidebar`
-- `template:layout:head`
-- `template:layout:top`
-- `template:layout:bottom`
-- `template:project:dropdown`: "Actions" menu on left in different project views
-- `template:project:header:before`
-- `template:project:header:after`
-- `template:project:integrations`
-- `template:project:sidebar`
-- `template:project-user:sidebar`
-- `template:task:sidebar:information`
-- `template:task:sidebar:actions`
-- `template:user:authentication:form`
-- `template:user:create-remote:form`
-- `template:user:external`
-- `template:user:integrations`
-- `template:user:sidebar:actions`
-- `template:user:sidebar:information`
+| Hook                                 | Description                                        |
+|--------------------------------------|----------------------------------------------------|
+| `template:analytic:sidebar`          | Sidebar on analytic pages                          |
+| `template:app:filters-helper:before` | Filter helper dropdown (top)                       |
+| `template:app:filters-helper:after`  | Filter helper dropdown (bottom)                    |
+| `template:auth:login-form:before`    | Login page (top)                                   |
+| `template:auth:login-form:after`     | Login page (bottom)                                |
+| `template:config:sidebar`            | Sidebar on settings page                           |
+| `template:config:integrations`       | Integration page in global settings                |
+| `template:dashboard:sidebar`         | Sidebar on dashboard page                          |
+| `template:export:sidebar`            | Sidebar on export pages                            |
+| `template:layout:head`               | Page layout `<head/>` tag                          |
+| `template:layout:top`                | Page layout top header                             |
+| `template:layout:bottom`             | Page layout footer                                 |
+| `template:project:dropdown`          | "Actions" menu on left in different project views  |
+| `template:project:header:before`     | Project filters (before)                           |
+| `template:project:header:after`      | Project filters (after)                            |
+| `template:project:integrations`      | Integration page in projects settings              |
+| `template:project:sidebar`           | Sidebar in project settings                        |
+| `template:project-user:sidebar`      | Sidebar on project user overview page              |
+| `template:task:menu`                 | "Actions" menu on left in different task views     |
+| `template:task:dropdown`             | Task dropdown menu in listing pages                |
+| `template:task:sidebar`              | Sidebar on task page                               |
+| `template:user:authentication:form`  | "Edit authentication" form in user profile         |
+| `template:user:create-remote:form`   | "Create remote user" form                          |
+| `template:user:external`             | "External authentication" page in user profile     |
+| `template:user:integrations`         | Integration page in user profile                   |
+| `template:user:sidebar:actions`      | Sidebar in user profile (section actions)          |
+| `template:user:sidebar:information`  | Sidebar in user profile (section information)      |
+
 
 Another template hooks can be added if necessary, just ask on the issue tracker.
-- 
cgit v1.2.3