Views are classes that implement
ViewInterface. The main view class Piwik\View will use a Twig template that is specified upon construction to generate output. There is also another class called ViewDataTable that is used specifically to visualize analytics data.
Using a view is straightforward. First, it is configured. The meaning of this is different based on the View type. For Piwik\View instances, it simply means setting properties. For example:
$view = new View("@MyPlugin/myTemplate.twig"); // set properties $view->property1 = 'property1'; $view->property2 = 'here is another property';
Once a view is configured, it is rendered via the View::render method:
This is the same for all view types.
The preferred way to generate anything text-based (like HTML) using data is to define Twig templates and use a View. Plugin developers should not accomplish this task with new view types unless they need to output something that is not text-based (such as an image).
If you don't know how to create Twig templates, read Twig's documentation.
Templates are stored in the
templates/ subdirectory of a plugin's root directory. When you create a View instance you must tell it what template it should use using a string with the following format:
"@PluginName/TemplateFileName". Piwik will look for a file named
TemplateFileName.twig in the PluginName plugin's
Template files in Piwik have a very specific naming convention. If the file contains the output for a specific controller method, the file should be named after the method. For example,
myControllerMethod.twig. In all other cases, the file should be named after what it contains and be prefixed with an underscore. For example,
Piwik has a UI demo page available. This page is intended to show all the UI components and styles available to use in Piwik. To view the demo page:
Note: The Development menu section will only appear if the development mode is enabled.