.. php:namespace:: DanielSiepmann\Tracking\Dashboard\Provider
.. program:: DanielSiepmann\Tracking\Dashboard\Provider\NewestPageviews

.. _newestpageviews:

===============
NewestPageviews
===============

Provides a list of the newest pageview entries.

Example
=======

.. figure:: /Images/Widgets/NewestPageviews.png
    :align: center

Default widget configuration.

:file:`Configuration/Services.yaml`::

   services:
     DanielSiepmann\Tracking\Dashboard\Provider\NewestPageviews:
       arguments:
         $queryBuilder: '@querybuilder.tx_tracking_pageview'
         $blackListedPages: [1, 11, 38]

     dashboard.widget.danielsiepmann.tracking.newestPageviews:
       class: 'TYPO3\CMS\Dashboard\Widgets\ListWidget'
       arguments:
         $view: '@dashboard.views.widget'
         $dataProvider: '@DanielSiepmann\Tracking\Dashboard\Provider\NewestPageviews'
       tags:
         - name: 'dashboard.widget'
           identifier: 'newestPageviewsList'
           groupNames: 'tracking'
           iconIdentifier: 'content-widget-list'
           title: 'LLL:EXT:tracking/Resources/Private/Language/locallang.xlf:dashboard.widgets.newestPageviewsList.title'
           description: 'LLL:EXT:tracking/Resources/Private/Language/locallang.xlf:dashboard.widgets.newestPageviewsList.description'
           height: 'medium'
           width: 'small'

Options
=======

.. option:: $maxResults

   Integer defining how many results should be displayed.
   Defaults to 6.

.. option:: $blackListedPages

   Array of page uids that should not be collected.
   Defaults to empty array, all pages are shown.

   This becomes handy if certain pages are called in order to show specific records.
   In those cases the pages will be called very often but don't provide much benefit and can be excluded.
   Use this in combination with :ref:`recordview` to show the records instead.