Added an ability to add custom items to panel header menu (Close #7)

Author: fps01

CHANGELOG.md

@@ -4,12 +4,13 @@ Yii2 Gentelella Change Log
 1.2.0 under development
 -----------------------
 
+- Enh #7: Add a an ability to add custom items to dropdown list of `yiister\gentelella\widgets\Panel` (fps01)
 - New #8: Added a `yiister\gentelella\widgets\Timeline` widget (fps01)
 - New #5: Added an ability to keep a sidebar state (fps01)
 - Fix #6: using a PHP 5.4 instead of 5.5
 
 1.1.0 June 26, 2016
------------------------
+-------------------
 
 - New #3: Added a `yiister\gentelella\widgets\StatsTile` widget (fps01)
 - New #2: Added a `yiister\gentelella\widgets\grid\GridView` widget (fps01)

widgets/Panel.php

@@ -9,12 +9,13 @@
 
 use rmrevin\yii\fontawesome\component\Icon;
 use yii\base\Widget;
+use yii\bootstrap\Nav;
 use yii\helpers\Html;
 
 class Panel extends Widget
 {
     /**
-     * @var string[]
+     * @var array the configuration array for creating a [[Dropdown]] widget
      */
     protected $tools = [];
 
@@ -49,23 +50,38 @@ class Panel extends Widget
     public $removable = false;
 
     /**
-     * Inits tool buttons
+     * @var array|string, optional, the configuration array for creating a [[Dropdown]] widget,
+     *   or a string representing the dropdown menu.
+     */
+    public $headerMenu = [];
+
+    /**
+     * Init tool buttons
      */
     protected function initTools()
     {
         if ($this->expandable === true || $this->collapsable === true) {
-            $this->tools[] = Html::tag(
-                'a',
-                new Icon('chevron-' . ($this->expandable === true ? 'down' : 'up')),
-                ['class' => 'collapse-link']
-            );
+            $this->tools[] = [
+                'encode' => false,
+                'label' => new Icon('chevron-' . ($this->expandable === true ? 'down' : 'up')),
+                'linkOptions' => ['class' => 'collapse-link'],
+                'url' => null,
+            ];
+        }
+        if (empty($this->headerMenu) === false) {
+            $this->tools[] = [
+                'encode' => false,
+                'items' => $this->headerMenu,
+                'label' => new Icon('wrench'),
+            ];
         }
         if ($this->removable === true) {
-            $this->tools[] = Html::tag(
-                'a',
-                new Icon('close'),
-                ['class' => 'close-link']
-            );
+            $this->tools[] = [
+                'encode' => false,
+                'label' => new Icon('close'),
+                'linkOptions' => ['class' => 'close-link'],
+                'url' => null,
+            ];
         }
     }
 
@@ -82,10 +98,14 @@ public function init()
             echo Html::beginTag('div', ['class' => 'x_title']);
             echo Html::tag('h2', ($this->icon !== null ? new Icon($this->icon) . ' ' : '') . $this->header);
             if (empty($this->tools) === false) {
-                echo Html::tag(
-                    'ul',
-                    '<li>' . implode("</li>\n<li>", $this->tools) . '</li>',
-                    ['class' => 'nav navbar-right panel_toolbox']
+                echo Nav::widget(
+                    [
+                        'dropDownCaret' => '',
+                        'items' => $this->tools,
+                        'options' => [
+                            'class' => 'nav navbar-right panel_toolbox',
+                        ],
+                    ]
                 );
             }
             echo Html::tag('div', null, ['class' => 'clearfix']);