# ToolbarPanelProviderInterface

> Defines an extension panel that can contribute captured metrics to the debug toolbar.

[API reference](/docs/api/index.md) › [Yii3 Debug](/docs/extensions/yii3-debug/reference/index.md) › [Panel](/docs/extensions/yii3-debug/reference/panel/index.md) › ToolbarPanelProviderInterface

| interface | `Yii3\Debug\Panel\ToolbarPanelProviderInterface` |
| --- | --- |
| Extends | [`ExtensionPanelInterface`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md) |
| Source | [`src/Panel/ToolbarPanelProviderInterface.php`](https://github.com/yii3/debug/blob/main/src/Panel/ToolbarPanelProviderInterface.php#L12) |

Implemented by 8 types:

- [`DbPanel`](/docs/extensions/yii3-debug/reference/panel/dbpanel/index.md)
- [`DumpPanel`](/docs/extensions/yii3-debug/reference/panel/dumppanel/index.md)
- [`EventPanel`](/docs/extensions/yii3-debug/reference/panel/eventpanel/index.md)
- [`LogPanel`](/docs/extensions/yii3-debug/reference/panel/logpanel/index.md)
- [`ProfilingPanel`](/docs/extensions/yii3-debug/reference/panel/profilingpanel/index.md)
- [`ProviderPanel`](/docs/extensions/yii3-debug/reference/panel/providerpanel/index.md)
- [`RequestPanel`](/docs/extensions/yii3-debug/reference/panel/requestpanel/index.md)
- [`CaptureToolbarProviderInterface`](/docs/extensions/yii3-debug/reference/panel/capturetoolbarproviderinterface/index.md)

Defines an extension panel that can contribute captured metrics to the debug toolbar.

## Methods

| Method | Description | Defined by |
| --- | --- | --- |
| <span id="method-hasContent"></span>[`hasContent()`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md#method-hasContent) abstract | Returns whether a captured payload contains activity worth exposing in the sidebar. | [`ExtensionPanelInterface`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md) |
| <span id="method-icon"></span>[`icon()`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md#method-icon) abstract | Returns the shared Debug Core icon key. | [`ExtensionPanelInterface`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md) |
| <span id="method-id"></span>[`id()`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md#method-id) abstract | Returns the stable panel identifier used in captured payloads and debug URLs. | [`ExtensionPanelInterface`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md) |
| <span id="method-name"></span>[`name()`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md#method-name) abstract | Returns the human-readable panel name. | [`ExtensionPanelInterface`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md) |
| <span id="method-render"></span>[`render()`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md#method-render) abstract | Renders the detail content for a captured payload. | [`ExtensionPanelInterface`](/docs/extensions/yii3-debug/reference/panel/extensionpanelinterface/index.md) |
| [`toolbarItems()`](#method-toolbarItems) abstract | Returns the toolbar metrics for a captured payload. | `ToolbarPanelProviderInterface` |

## Method details

### toolbarItems() <span id="method-toolbarItems"></span>

```php
abstract public function toolbarItems(array<string, mixed> $payload): list<PHPForge\Debug\Toolbar\ToolbarItem>
```

Returns the toolbar metrics for a captured payload.

**Parameters**

| Parameter | Type | Description |
| --- | --- | --- |
| `$payload` | `array<string, mixed>` | Serialized panel payload. |

**Returns**

`list<PHPForge\Debug\Toolbar\ToolbarItem>`: Toolbar metrics, or an empty list when the panel should stay hidden.