Repository navigation
0.3.0
A FreshRSS extension that keeps a history of the article links you actually opened, with title and feed, on a page of its own.
Why
"Read" in FreshRSS only means an article scrolled past. Which ones you actually opened leaves no trace: the browser history has the URLs but not the feed or the headline.
What it does
- Records an opened article — headline click, link icon, middle click, or the
go_websiteshortcut. - Shows them on a page of its own, reachable from the toolbar and the header menu, newest first or grouped by category.
- Lets an entry be judged good or dropped, or left unrated, with a per-state filter and counts.
- Downloads the whole history as JSON or CSV, carrying whatever filter is on screen.
Surviving the article
The history lives in a table of its own with no foreign key to the articles, and every value is denormalised at click time. An entry therefore outlives its article, its feed and its category. This release is the first where that is checked end to end against a running instance rather than argued from the schema: articles deleted through FreshRSS, history rows still present with title, feed name and category intact.
Security
The client posts an entry id and nothing else — url, title, feed and category are looked up server-side, so a hand-made request cannot put its own strings into the table. Ids are checked with ctype_digit, the lookup runs in the logged-in user's own database context, and FreshRSS rejects any POST without a valid CSRF token before the controller is reached. Disabling the extension does not drop the table; deleting the history is a button of its own.
Requirements
FreshRSS 1.29.0 or newer. Place the xExtension-ClickHistory directory into your FreshRSS extensions/ directory and enable it under Configuration - Extensions. Works on SQLite, MySQL and PostgreSQL.