[[PageOutline(2-5,Contents,Pullout)]]

= Show unread tickets

== Description

This plugin tracks ticket page views and provides "last unread" link '''on ticket pages''', ie those pages that end with `/ticket/XYZ`. This is similar to a feature you have probably seen on most forums:

[[Image(last_metanav.png, border=1)]]

The only difference is that this plugin does not just use your last login time, but actually tracks time when you requested each ticket. This is also the reason that a Trac environment upgrade is required.

Of course, it does not work for anonymous users:

[[Image(no_unread_metanav.png, border=1)]]

Tested on Trac 0.10 and current trunk of Trac 0.11.

This plugin can be used in reports and a [source:tracunreadplugin/0.11/trac7_with_unread.sql sample SQL report for PostgreSQL] is included in its distribution:

[[Image(trac_unread_report.png, border=1)]]

Known limitations:
 1. This plugin works with PostgreSQL: SQLite lacks string functions required to extract comment number from "parent.reply" pair in the database. Nor has it been tested with MySQL.
 2. Also, you must dump all `_description`, `description_` and `_description_` fields from your report (they are hidden in default reports). The reason is that these fields provide the link to "unread comment". The only way to include another link to report row is generating wiki markup in `description` field. This could be improved however, and patches welcome.

== Bugs/Feature Requests

Existing bugs and feature requests for TracUnreadPlugin are 
[report:9?COMPONENT=TracUnreadPlugin here].

If you have any issues, create a 
[/newticket?component=TracUnreadPlugin new ticket].

[[TicketQuery(component=TracUnreadPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:tracunreadplugin here].

== Source

You can check out TracUnreadPlugin from [/svn/tracunreadplugin here] using Subversion, or [source:tracunreadplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(tracunreadplugin, 3)]]

== Author/Contributors

'''Author:''' [wiki:vnaum] [[BR]]
'''Maintainer:''' [[Maintainer]] [[BR]]
'''Contributors:'''