看板初始化提交

2026-06-01 21:23:12 -07:00
commit 54a842f4ab
2104 changed files with 241695 additions and 0 deletions
@@ -0,0 +1,94 @@
+<?php
+
+namespace Kanboard\Core\ExternalTask;
+
+/**
+ * Interface ExternalTaskProviderInterface
+ *
+ * @package Kanboard\Core\ExternalTask
+ * @author  Frederic Guillot
+ */
+interface ExternalTaskProviderInterface
+{
+    /**
+     * Get provider name (visible in the user interface)
+     *
+     * @access public
+     * @return string
+     */
+    public function getName();
+
+    /**
+     * Get provider icon
+     *
+     * @access public
+     * @return string
+     */
+    public function getIcon();
+
+    /**
+     * Get label for adding a new task
+     *
+     * @access public
+     * @return string
+     */
+    public function getMenuAddLabel();
+
+    /**
+     * Retrieve task from external system or cache
+     *
+     * @access public
+     * @throws \Kanboard\Core\ExternalTask\ExternalTaskException
+     * @param  string $uri
+     * @param  int    $projectID
+     * @return ExternalTaskInterface
+     */
+    public function fetch($uri, $projectID);
+
+    /**
+     * Save external task to another system
+     *
+     * @throws \Kanboard\Core\ExternalTask\ExternalTaskException
+     * @param  string $uri
+     * @param  array  $formValues
+     * @param  array  $formErrors
+     * @return bool
+     */
+    public function save($uri, array $formValues, array &$formErrors);
+
+    /**
+     * Get task import template name
+     *
+     * @return string
+     */
+    public function getImportFormTemplate();
+
+    /**
+     * Get creation form template
+     *
+     * @return string
+     */
+    public function getCreationFormTemplate();
+
+    /**
+     * Get modification form template
+     *
+     * @return string
+     */
+    public function getModificationFormTemplate();
+
+    /**
+     * Get task view template name
+     *
+     * @return string
+     */
+    public function getViewTemplate();
+
+    /**
+     * Build external task URI based on import form values
+     *
+     * @param  array $formValues
+     * @return string
+     */
+    public function buildTaskUri(array $formValues);
+}