An annotation is a Text note set a specific date. Add the ability in Piwik to annotate reports, e.g., a spike in traffic attributed to a slashdot story.
These annotation would appear with a marker on the Graph, and would be listed below the graph on click on "Annotations" button, and could also be created/queried via the API.
I think the emphasis of this ticket should be on the creation of a Piwik Calendar - as per PeterB's original suggestion. The ability to annotate the calendar with known events is an addon feature.
Can I suggest that the name of ticket (Summary field) be changed to reflect this?
This feature would be really handy. A good starting point for the UI component might be Adam Shaw's fullcalendar jQuery plugin. It is a pretty nice calendaring interface with good documentation and a flexible api.
I second Adam Shaw's plugin. It's amazing, we have worked with it forever. This is a really great potential feature. I constantly run into cases where this would be worth it's digital weight in gold.
capedfuzz, what would be your take on this one?
This would be a good feature for me.
This specification is very similr to the google analytics implementation of annotations, simply because -- once more -- Google has done a great job at the UI and integration into the graph. I'm sure they havent invented it neither, but we shall copy their idea and extend it with Piwik features in mind! Here are the specifications for the actually-very-useful Annotations feature.
Data structure & features:
Ability for View & Admin (non anonymous) users to view, create, edit, delete Annotations.
"Admin" users for a site, can edit & delete annotations of any users to this website.
Annotations can be added, updated, deleted via a New Annotations API.
Annotations availability in the UI:
(In ) Fixes #1253, added annotations plugin that allows attaching notes to different days.
(In ) Refs #1253 Change API call because format=php is broken (temporarily)
(In ) Refs #1253, fix regression in PHP DataTable renderer.
(In ) Refs #1253, add integration test for PHP renderer w/ array value.
(In ) Refs #1253, if provider determined via GeoIP plugin, display link to startpage in reports and visitor log.
-> It is not possible to add annotations in the recent days as the marker will not display on the right part of the axis.
(In ) Fixes #1253, fix bug where resizing element does not reposition evolution icons and tweak translation keys.
(In ) Refs #1253, display annotation text in tooltip when hovering over evolution icon if only one annotation for date range, and when hovering over an annotation, make the corresponding evolution icon bounce.