Repository navigation
Releases
0.7.3
Fix to Copy link: it no longer removes every parameter that starts with pk_ — a site's own pk_id stays; only Matomo's campaign names (pk_campaign, pk_kwd, pk_source and the rest) are removed. A removed parameter no longer leaves an empty & pair behind (?utm_source=x&&a=1 used to become ?&a=1).
Behind it: the copy button is now tested against the page's own rendered markup, and the CI's MariaDB leg runs on 12.3.3, the current LTS. When updating, replace the old xExtension-ClickHistory directory rather than unpacking next to it — two copies stop FreshRSS with a fatal error.
Full details in CHANGELOG.md.
0.7.2
New: a Copy link button on every row of the history page puts the article's address on the clipboard without its tracking parameters (utm_*, fbclid, gclid and other click ids) — the rest of the query and the fragment stay as the feed had them.
Fixes. A rating or deletion sent with an invalid id or state now says it was not saved instead of returning as if it had worked. A click that reaches the server late can no longer set an entry's "last opened" time back. Saving the settings writes the configuration once and reports a failure instead of saying "updated"; a settings request without the recording switch keeps the stored value. The history table is checked with one probe per request instead of two CREATE … IF NOT EXISTS statements and two probes, and two requests upgrading the same table at once no longer fail the slower one. On SQLite, a process serving several users no longer takes one user's table for another's. The action buttons follow core's 840px breakpoint exactly, and the page's navigation bars carry aria-labels.
Behind it: the CI database legs now run MariaDB 10.11.19 (10.6 is past its end of life) and PostgreSQL 16.15, both pinned. When updating, replace the old xExtension-ClickHistory directory rather than unpacking next to it — two copies stop FreshRSS with a fatal error.
Full details in CHANGELOG.md.
0.7.1
Fixes. Expanding a collapsed article by tapping its headline no longer lands in the history — on a phone almost every expand used to become an entry; Ctrl/Cmd- and middle-clicks, which do open the link, are still recorded. An export the database refused now says so on the list instead of downloading an empty file that looks like a complete backup. "Delete the whole history" stays visible under a status filter that matches nothing. On instances that allow anonymous reading, the click listener is no longer loaded for visitors who are not logged in, and a click whose request failed can be recorded again in the same page load.
Behind it: the extension now runs inside a real FreshRSS 1.29 in CI on PHP 8.1 and 8.4, driven over HTTP; the schema and DAO also run on MariaDB 10.6. When updating, replace the old xExtension-ClickHistory directory rather than unpacking next to it — two copies stop FreshRSS with a fatal error.
Full details in CHANGELOG.md.
0.7.0
Fixes and feedback. The CSV export now follows RFC 4180, so a headline containing \" no longer breaks its cell, and PHP 8.4 no longer logs a deprecation for every exported row. Deleting an entry keeps the status filter and the grouping, the Unrated filter lists exactly what its count says, and a rating, deletion or clear the database refused now says so instead of looking like it worked. The release archive holds only the extension, its licence, README and changelog.
Behind it: the DAO is now tested through FreshRSS core's own connection classes on SQLite, MySQL 8 and PostgreSQL 16, and the runtime tests also run on PHP 8.4. When updating, replace the old xExtension-ClickHistory directory rather than unpacking next to it — two copies stop FreshRSS with a fatal error.
Full details in CHANGELOG.md.
0.6.0
Adds the Feed figures page — the report the rating buttons existed for. Reached from the history page's toolbar: one row per feed with how often something from it was opened and how those clicks were judged (good, dropped, still unrated), plus the share of judged clicks that were worth it. A feed with no ratings shows a dash rather than 0%, unrated entries stay out of the denominator, and the aggregation is one portable SQL statement exercised by CI against SQLite, MySQL 8 and PostgreSQL 16.
Full details in CHANGELOG.md.
0.5.1
0.5.0
Removes the "State of a newly opened article" setting: a newly recorded click now always starts as unrated. Any other starting value would skew the good/dropped ratio the ratings exist to measure, by counting articles nobody has judged. Rating an entry on the history page is unchanged.
Full details in CHANGELOG.md.
0.4.0
A quality round ahead of submitting the extension for official FreshRSS listing.
Highlights:
- Security: the CSV export can no longer carry a spreadsheet formula — feed-controlled fields starting with
=,+,-,@, tab or CR are neutralised. - The JavaScript toolbar button is gone; the menu entry FreshRSS renders server-side was already the reliable way to the history page, and removing the button also removes a crash when the script ran before
document.bodyexisted. - Failed recording requests now show up in the browser console instead of being silently dropped; the page's assets load only where they do something.
- Exports stream row by row instead of materialising the whole history twice.
- Testing: the schema test now executes the DAO's real SQL, CI runs it against MySQL 8 and PostgreSQL 16 in addition to SQLite, and the selectors coupling the extension to FreshRSS's article markup are tested against fixtures taken verbatim from core 1.29.0.
- New: CHANGELOG.md, SECURITY.md, and a CI check that a release tag matches
metadata.json.
Full details in CHANGELOG.md.
0.3.1
Layout fix on top of 0.3.0.
The action buttons no longer stack on a wide window. The actions cell shrinks to fit its content, which in practice meant it shrank to the widest single button — so Good and Dropped wrapped onto separate lines and every row came out 125px tall for a one-line headline. They now share a line, which brings the row to 91px and the whole table from 3672px to 2672px.
This applies from 840px upward, the breakpoint FreshRSS' own theme uses. Below it the trade reverses: the column gains 60px at the title's expense, and a cramped title wraps more than the buttons ever did. Verified in the browser at 1400px and 760px, with no horizontal overflow in either.
No behaviour, data or endpoint changes. Upgrading is a file copy.
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.