Widgets
Dashboard widgets are Stream entries that are associated with an extension
. The extensions along with configuration using the Configuration module.
Widget Fields
Below is a list of fields
in the widgets
stream. Fields are accessed as attributes:
$widget->title;
Same goes for decorated instances in Twig:
{{ widget.title }}
Fields
Key | Type | Description |
---|---|---|
title |
text |
The title. |
description |
textarea |
The description. |
extension |
addon |
The widget extension. |
column |
integer |
The column placement. |
pinned |
boolean |
The pinned state. |
dashboard |
relationship |
The related dashboard. |
allowed_roles |
multiple |
The roles allowed to view the widget. |
Widget Interface
This section will go over the \Anomaly\DashboardModule\Widget\Contract\WidgetInterface
class.
WidgetInterface::output()
The output
method returns the complete widget output.
Returns: string
Example
$widget->output();
Twig
{{ widget.output()|raw }}
WidgetInterface::addData()
The addData
method adds data to the widget's data for access later in processing and output.
Returns: \Anomaly\Streams\Platform\Entry\Contract\EntryInterface
Arguments
Key | Required | Type | Default | Description |
---|---|---|---|---|
$key |
true |
string |
none |
The data key. |
$data |
true |
mixed |
none |
The data. |
Example
$widget->addData('example', 'http://pyrocms.com');
WidgetInterface::getData()
The getData
method returns the widget's data collection.
Returns: \Anomaly\DashboardModule\Widget\WidgetData
Example
$widget->getData()->get('example');
Twig
{{ widget.getData().get('example') }}
WidgetInterface::setContent()
The setContent
method sets the interior content for the widget wrapper view.
Returns: \Anomaly\DashboardModule\Widget\Contract\WidgetInterface
Arguments
Key | Required | Type | Default | Description |
---|---|---|---|---|
$content |
true |
string |
none |
The rendered content. |
Example
$widget->setContent($html);
WidgetInterface::getContent()
The getContent
method gets the interior content for the widget wrapper view.
Returns: string
Example
$widget->getContent();
Twig
{{ widget.getContent()|raw }}