Extension Author: Wim Bekkers
Download Location: WZUP - PivotX Extensions
Extension Description:
- The WZUP extension tracks and displays the number of times individual weblog entries (articles) have been viewed.
Installation:
- Step 1: Unpack the zip file in the pivotx/extensions/ directory on your server
Step 2: in the PivotX admin menu go to the Extensions section and enable the wzup snippet extension
After you have completed step 1 and 2 the wzup engine starts to count each time an entry page is requested by a reader of your weblog. Complete the next steps to show the view counts and overview of most popular articles on your weblog:
Step 3: add the [[wzupshow]] tag in your template where you want to show the count for the entry being displayed
Step 4: add the [[wzuptop]] tag in your template where you want to show a listing of the articles with the most views, or enable the wzuptop widget (Extensions -> Widgets) by dragging it from the Available widgets section to the Active widgets area.
Image is worth a 1000 words, so here is a screendump that explains the difference between [[wzupshow]] and [[wzuptop]]
Customization:
- If you are happy with the way it looks now, then you're done! But you can tweak the output of wzup to your likings. You can do this for your entire weblog from the PivotX dashboard, look for the Configure Extensions option and select the wzup screen. Alternatively, you can override these settings also by specifying parameters to the [[wzupshow]] and [[wzuptop]] tags in your template (use this only if you want different output for a specific part of your weblog).
This is how it looks like on your PivotX dashboard:
Advanced example of using the parameter options for the wzup tags:
[[wzupshow format="Already %num% readers for this article"]]
[[wzuptop count=100 cutoff=80 format="Rank %num%, Views %views%, <a href='%link%'>%title%</a>" categories="fun,lol"]]
Changelog
Version 0.9X (beta) works with PivotX 2.0 Final. The wzuptop widget has been added.
Version 0.8X (beta) now counts multiple reads by the same user within 24 hours as only a single one (by using a cookie).
There is also a fix for the fact that the wzupshow is one behind on the entrypage for the current article. Most common issue with this is that the first reader will see a wzup counter of 0 views for the article he is reading. This fix is still inadequate in some respect, I will need to review this further.
That's it. Please try this out if you're interested and provide feedback in this forum.
