Upgrade to 3.6.0

kirby/src/Cms/Plugin.php

@@ -5,6 +5,7 @@ namespace Kirby\Cms;
 use Exception;
 use Kirby\Data\Data;
 use Kirby\Exception\InvalidArgumentException;
+use Kirby\Toolkit\V;
 
 /**
  * Represents a Plugin and handles parsing of
@@ -45,8 +46,36 @@ class Plugin extends Model
         $this->setName($name);
         $this->extends = $extends;
         $this->root    = $extends['root'] ?? dirname(debug_backtrace()[0]['file']);
+        $this->info    = empty($extends['info']) === false && is_array($extends['info']) ? $extends['info'] : null;
 
-        unset($this->extends['root']);
+        unset($this->extends['root'], $this->extends['info']);
+    }
+
+    /**
+     * Returns the array with author information
+     * from the composer file
+     *
+     * @return array
+     */
+    public function authors(): array
+    {
+        return $this->info()['authors'] ?? [];
+    }
+
+    /**
+     * Returns a comma-separated list with all author names
+     *
+     * @return string
+     */
+    public function authorsNames(): string
+    {
+        $names = [];
+
+        foreach ($this->authors() as $author) {
+            $names[] = $author['name'] ?? null;
+        }
+
+        return implode(', ', array_filter($names));
     }
 
     /**
@@ -57,6 +86,16 @@ class Plugin extends Model
         return $this->extends;
     }
 
+    /**
+     * Returns the unique id for the plugin
+     *
+     * @return string
+     */
+    public function id(): string
+    {
+        return $this->name();
+    }
+
     /**
      * @return array
      */
@@ -76,6 +115,22 @@ class Plugin extends Model
         return $this->info = $info;
     }
 
+    /**
+     * Returns the link to the plugin homepage
+     *
+     * @return string|null
+     */
+    public function link(): ?string
+    {
+        $homepage = $this->info['homepage'] ?? null;
+        $docs     = $this->info['support']['docs'] ?? null;
+        $source   = $this->info['support']['source'] ?? null;
+
+        $link = $homepage ?? $docs ?? $source;
+
+        return V::url($link) ? $link : null;
+    }
+
     /**
      * @return string
      */
@@ -153,6 +208,14 @@ class Plugin extends Model
      */
     public function toArray(): array
     {
-        return $this->propertiesToArray();
+        return [
+            'authors'     => $this->authors(),
+            'description' => $this->description(),
+            'name'        => $this->name(),
+            'license'     => $this->license(),
+            'link'        => $this->link(),
+            'root'        => $this->root(),
+            'version'     => $this->version()
+        ];
     }
 }