README

With this extension you are able, to count views/clicks of ext:news or pages-records. Additionally it integrates a new option in the plugin of ext:news to show records ordered by views. A new plugin to show pages ordered by clicks is shipped as well.

Requirements

• TYPO3 12.4 || 13.4
• ext:news >= 11.0

Installation

• Install the extension by using the extension manager or use composer (composer req mediadreams/md_news_pages_clickcount)
• Include the static TypoScript of the extension

Usage

Count views

• In the news detail view template add the following code:
  {md:getCountImg(recordUid: '{newsItem.uid}', recordType: 'news')}
• In the pages template add the following code:
  {md:getCountImg(recordUid: '{data.uid}', recordType: 'pages')}

Make sure, that you import the namespace to the ViewHelper by adding the following line at the top of the template: {namespace md=Mediadreams\MdNewsPagesClickcount\ViewHelpers}

Note:

• All hits to a news preview have the speciel parameter tx_news_pi1%5Bnews_preview%5D. When this is set, no tracking happens.
• By default, all hits of logged in backend users will be ignored. Enable visits of logged in backend users in the extension settings, if needed.

Show most read news

• Insert the plugin News system of ext:news on a page
• In Settings-tab select List view (without overloading detail view) in the What to display dropdown
• Select Views in the Sort by dropdown
• Select a Sort direction (Descending will show the most viewed articles first)
• Save and close

Show most read pages

• Insert the element Pages by views on a page
• Plugin-tab
  • Select the type of pages in Page type which you want to show
  • In Startingpoint select the starting point
  • In Recursive set the levels, how deep you want to dive down the page tree
• Save and close

Spam prevention (works for news entries only!)

In the extension settings, you are able to set daysForNextCount, which adds an IP check. So multiple views of the same IP address in the given timespan (days) will be counted just once.

By default this functionality is disabled (daysForNextCount = 0)

ATTENTION:

If you have set daysForNextCount to something higher than 0, please make sure, that you activate the scheduler task mdNewsClickcount:cleanupLogCommand of type Execute console commands in order to meet the GDPR requirements! This will clean up the log.

Clear views

• Add a scheduler task of type Execute console commands
• Select mdNewsPagesClickcount:clearViewsCommand in Schedulable Command dropdown

Bugs and Known Issues

If you find a bug, it would be nice if you add an issue on Github.

THANKS

Thanks a lot to all who make this outstanding TYPO3 project possible!

Credits

The icons in this extension where kindly taken from Font Awesome.

The TYPO3 project - inspiring people to share!