From 9ca4b43a97ae92fad57b00ac0217d5b7078272fb Mon Sep 17 00:00:00 2001
From: Frederic Guillot <fred@kanboard.net>
Date: Sat, 26 Sep 2015 15:57:39 -0400
Subject: Add page to show the list of plugins

---
 app/Core/Base.php          |  1 +
 app/Core/Plugin/Base.php   | 52 ++++++++++++++++++++++++++++++++++++++++++++++
 app/Core/Plugin/Loader.php |  9 ++++++++
 3 files changed, 62 insertions(+)

(limited to 'app/Core')

diff --git a/app/Core/Base.php b/app/Core/Base.php
index fe42ba09..b919d551 100644
--- a/app/Core/Base.php
+++ b/app/Core/Base.php
@@ -23,6 +23,7 @@ use Pimple\Container;
  * @property \Core\ObjectStorage\ObjectStorageInterface        $objectStorage
  * @property \Core\Cache\Cache                                 $memoryCache
  * @property \Core\Plugin\Hook                                 $hook
+ * @property \Core\Plugin\Loader                               $pluginLoader
  * @property \Integration\BitbucketWebhook                     $bitbucketWebhook
  * @property \Integration\GithubWebhook                        $githubWebhook
  * @property \Integration\GitlabWebhook                        $gitlabWebhook
diff --git a/app/Core/Plugin/Base.php b/app/Core/Plugin/Base.php
index 580d41ad..1f61ab33 100644
--- a/app/Core/Plugin/Base.php
+++ b/app/Core/Plugin/Base.php
@@ -44,4 +44,56 @@ abstract class Base extends \Core\Base
             call_user_func($callback, $container);
         });
     }
+
+    /**
+     * Get plugin name
+     *
+     * This method should be overrided by your Plugin class
+     *
+     * @access public
+     * @return string
+     */
+    public function getPluginName()
+    {
+        return ucfirst(substr(get_called_class(), 7, -7));
+    }
+
+    /**
+     * Get plugin description
+     *
+     * This method should be overrided by your Plugin class
+     *
+     * @access public
+     * @return string
+     */
+    public function getPluginDescription()
+    {
+        return '';
+    }
+
+    /**
+     * Get plugin author
+     *
+     * This method should be overrided by your Plugin class
+     *
+     * @access public
+     * @return string
+     */
+    public function getPluginAuthor()
+    {
+        return '?';
+    }
+
+    /**
+     * Get plugin version
+     *
+     * This method should be overrided by your Plugin class
+     *
+     * @access public
+     * @return string
+     */
+    public function getPluginVersion()
+    {
+        return '?';
+    }
 }
diff --git a/app/Core/Plugin/Loader.php b/app/Core/Plugin/Loader.php
index 04b2bfff..9a884dae 100644
--- a/app/Core/Plugin/Loader.php
+++ b/app/Core/Plugin/Loader.php
@@ -21,6 +21,14 @@ class Loader extends \Core\Base
      */
     const TABLE_SCHEMA = 'plugin_schema_versions';
 
+    /**
+     * Plugin instances
+     *
+     * @access public
+     * @var array
+     */
+    public $plugins = array();
+
     /**
      * Scan plugin folder and load plugins
      *
@@ -55,6 +63,7 @@ class Loader extends \Core\Base
         Tool::buildDic($this->container, $instance->getClasses());
 
         $instance->initialize();
+        $this->plugins[] = $instance;
     }
 
     /**
-- 
cgit v1.2.3


From 1fca5e721ab63d4d49e068331aee90abb111dbc2 Mon Sep 17 00:00:00 2001
From: Frederic Guillot <fred@kanboard.net>
Date: Sat, 26 Sep 2015 16:05:06 -0400
Subject: Add getPluginHomepage()

---
 app/Core/Plugin/Base.php        | 13 +++++++++++++
 app/Template/config/plugins.php |  8 +++++++-
 doc/plugins.markdown            |  9 +++++----
 3 files changed, 25 insertions(+), 5 deletions(-)

(limited to 'app/Core')

diff --git a/app/Core/Plugin/Base.php b/app/Core/Plugin/Base.php
index 1f61ab33..a72a0cd6 100644
--- a/app/Core/Plugin/Base.php
+++ b/app/Core/Plugin/Base.php
@@ -96,4 +96,17 @@ abstract class Base extends \Core\Base
     {
         return '?';
     }
+
+    /**
+     * Get plugin homepage
+     *
+     * This method should be overrided by your Plugin class
+     *
+     * @access public
+     * @return string
+     */
+    public function getPluginHomepage()
+    {
+        return '';
+    }
 }
diff --git a/app/Template/config/plugins.php b/app/Template/config/plugins.php
index 8501bda9..fea48d58 100644
--- a/app/Template/config/plugins.php
+++ b/app/Template/config/plugins.php
@@ -15,7 +15,13 @@
 
     <?php foreach($plugins as $plugin): ?>
     <tr>
-        <td><?= $this->e($plugin->getPluginName()) ?></td>
+        <td>
+            <?php if ($plugin->getPluginHomepage()): ?>
+                <a href="<?= $plugin->getPluginHomepage() ?>" target="_blank" rel="noreferrer"><?= $this->e($plugin->getPluginName()) ?></a>
+            <?php else: ?>
+                <?= $this->e($plugin->getPluginName()) ?>
+            <?php endif ?>
+        </td>
         <td><?= $this->e($plugin->getPluginAuthor()) ?></td>
         <td><?= $this->e($plugin->getPluginVersion()) ?></td>
         <td><?= $this->e($plugin->getPluginDescription()) ?></td>
diff --git a/doc/plugins.markdown b/doc/plugins.markdown
index a17f1af4..031bf963 100644
--- a/doc/plugins.markdown
+++ b/doc/plugins.markdown
@@ -70,10 +70,11 @@ Available methods from `Core\Plugin\Base`:
 - `initialize()`: Executed when the plugin is loaded
 - `getClasses()`: Return all classes that should be stored in the dependency injection container
 - `on($event, $callback)`: Listen on internal events
-- `getPluginName()`: Get plugin name
-- `getPluginAuthor()`: Get plugin author
-- `getPluginVersion()`: Get plugin version
-- `getPluginDescription()`: Get plugin description
+- `getPluginName()`: Should return plugin name
+- `getPluginAuthor()`: Should return plugin author
+- `getPluginVersion()`: Should return plugin version
+- `getPluginDescription()`: Should return plugin description
+- `getPluginHomepage()`: Should return plugin Homepage (link)
 
 Your plugin registration class also inherit from `Core\Base`, that means you can access to all classes and methods of Kanboard easily.
 
-- 
cgit v1.2.3