AnGo Scroll Analytics records how far visitors scroll through your content and displays the results on a dedicated \"Readability\" screen in wp-admin. It answers the question a pageview count cannot: did anyone actually read past the first screen?<\/p>\n\n
Unlike heavy external analytics suites or heatmap SaaS tools, AnGo Scroll Analytics runs 100% natively on your server. There are no external scripts, no cookies, no third-party data sharing, and no complex event setups.<\/p>\n\n
The tracking script loads on the single page of every public post type and measures depth through the scrollable height of the document \u2014 not the share of the article visible on screen, so a page that fits on one screen records 100%.<\/p>\n\n
Designed for small-to-medium blogs and content sites: the statistics are computed on the fly with direct SQL queries, and the REST endpoint is rate-limited to 60 requests per minute per IP hash (changeable via the ango_rate_limit filter). Without a persistent object cache each beacon costs two lightweight options-table queries \u2014 a spam brake, not a firewall. At hundreds of thousands of visits, transient caching or cron-based aggregation is worth adding; a typical blog does not need it.<\/p>\n\n\n
Yes. Every arrival is a row, including the ones with 0% scroll: the percentiles describe all arrivals, not only those who read to the end. That is a deliberate decision, not lost data.<\/p>\n\n
The dashboard does distinguish two kinds of zero-scroll visits. A visit that sent nothing after the initial page-load beacon (max_scroll 0 and time on page 0) is \"load-and-die\" \u2014 on a live site those are usually bots, crawlers and link previews, not people. They are excluded from the statistics by default (the Visits card shows how many were left out), while a person who loaded the page and stayed without scrolling \u2014 time on page above zero \u2014 always counts. The checkbox in the filter bar turns the exclusion off.<\/p><\/dd>\n
Yes \u2014 it has to be, because visitors are not logged in. POST \/wp-json\/ango\/v1\/depth is limited to 60 requests per minute per IP; the limit is changed through the ango_rate_limit filter, and a value below 1 disables the check. The IP itself is not stored, only a hash of it, for the duration of the window. Behind a proxy (Cloudflare and similar) REMOTE_ADDR is the proxy address, so the limit is shared by all visitors \u2014 raise it in that setup.<\/p><\/dd>\n
This plugin measures depth through the scrollable height of the page, not the share of the article that was on screen: a short page that fits on one screen records 100%. And it counts visits, not unique readers \u2014 a new tab or a new session is a new visit.<\/p><\/dd>\n
Timestamps in the table (created_at) are stored in UTC, while the dashboard computes day boundaries in the site timezone. Keep that in mind when writing manual SQL against {prefix}_ango_visits.<\/p><\/dd>\n
They are tracked by default: the script loads on the single page of every public post type, so a WooCommerce product, a forum thread or a knowledge-base entry all get measured the moment they exist. Media attachments are the one exception \u2014 they are public but are media-library artifacts, not pages a reader scrolls. If a plugin registers a public type you do not want counted (a page-builder's template library, a popup type), remove it with the ango_trackable_post_types filter:<\/p>\n\n
add_filter( 'ango_trackable_post_types', function ( $types ) {\n unset( $types['my_popup'] );\n return $types;\n} );\n<\/code><\/pre><\/dd>\nDoes the admin screen load anything from outside my site?<\/h3><\/dt>\nNo. The chart is drawn by Chart.js 4.5.1, bundled with the plugin (assets\/vendor\/chart.umd.min.js, MIT license), so wp-admin makes no external request and the chart works offline and behind a filtering proxy.<\/p><\/dd>\n
Why does the bundled Chart.js ship minified?<\/h3><\/dt>\nChart.js 4.5.1 (MIT) ships here as the minified UMD build that upstream publishes \u2014 assets\/vendor\/chart.umd.min.js, licence banner intact. Upstream has no unminified UMD to use instead: dist\/chart.umd.js and dist\/chart.umd.min.js in its package are both minified. The readable code is published, just in another build: the unminified ESM bundle is dist\/chart.js (https:\/\/unpkg.com\/chart.js@4.5.1\/dist\/chart.js), and the sources it is built from are at https:\/\/github.com\/chartjs\/Chart.js\/tree\/v4.5.1\/src.<\/p><\/dd>\n
Why are the file names so plain?<\/h3><\/dt>\nThey are deliberately neutral: the tracking script is assets\/js\/scroll-depth.js and the public endpoint is \/wp-json\/ango\/v1\/depth, with no tracker\/track in either. Those words are a common target for filter lists, and a blocked script or beacon loses data silently. Neither EasyList\/EasyPrivacy nor the uBlock Origin and AdGuard filters matched these URLs (checked 2026-09-16 under the plugin's previous name; the endpoint paths did not change in the rename), but the lists update daily \u2014 so do not rename them back \"for clarity\".<\/p><\/dd>\n
What happens to my data when I uninstall the plugin?<\/h3><\/dt>\nDeleting the plugin removes everything it stored: the {prefix}_ango_visits table, the ango_db_version option and the throttle transients. Deactivating does not \u2014 the data survives a deactivate and reactivate cycle, so an upgrade or a temporary switch-off costs nothing. Clicking Delete on the Plugins screen shows a confirmation naming the statistics that will be lost. If you need the numbers after the plugin is gone, export them before deleting, or hold the cleanup back from a must-use plugin with add_filter( 'ango_remove_data_on_uninstall', '__return_false' ).<\/p><\/dd>\n\n<\/dl>\n\n\n
1.14.0<\/h4>\n\n\n- New: a Device filter (All devices \/ Mobile \/ Tablet \/ Desktop) in the dashboard's filter bar. Every visit now carries a coarse device class \u2014 mobile, tablet or desktop, computed in the visitor's browser from the pointer type and the viewport width; no user-agent string or anything more specific is collected. The filter narrows the whole dashboard \u2014 summary, percentiles, trend, article table \u2014 to one class, because a phone flick reaches 100% far cheaper than a desktop scroll. Visits recorded before this version appear under All devices only.<\/li>\n<\/ul>\n\n
1.13.0<\/h4>\n\n\n- New: a row-number column (#) at the head of the By article table. The number is the row's place in the current view: it renumbers when you sort or search, so the top of whatever you are looking at is always row 1. The column itself is not sortable \u2014 it always mirrors the active order.<\/li>\n<\/ul>\n\n
1.12.0<\/h4>\n\n\n- New: a \"Percentile mode\" switch on the dashboard (Reach \/ Classical). Reach percentiles answer \"how far did readers get\" \u2014 at least X% of visitors reached this depth. Classical percentiles are the textbook statistical view, computed exactly like Excel's PERCENTILE.INC \u2014 X% of visitors reached this depth or less. The switch changes the summary list, the table columns and their tooltips at once, needs no reload and is remembered per browser. Reach stays the default.<\/li>\n<\/ul>\n\n
1.11.0<\/h4>\n\n\n- New: a \"Search articles\" box above the \"By article\" table. It filters the rows live as you type \u2014 case-insensitive title matching, no Apply click, no extra requests \u2014 composes with any active sort, and survives a re-render. When nothing matches, the table says so instead of showing a stale row set.<\/li>\n<\/ul>\n\n
1.10.0<\/h4>\n\n\n- New: the \"By article\" table replaces the single \"90% scrolled at least to\" column with a full \"Percentiles\" group \u2014 seven sortable sub-columns (5\/10\/25\/50\/75\/90\/100) showing the depth each share of that article's visitors reached. The separate Median column is gone; the 50% sub-column IS the median, computed the same way from the same rows. Wide screens scroll the table horizontally instead of squeezing it.<\/li>\n<\/ul>\n\n
1.9.0<\/h4>\n\n\n- New: the tracker covers every public post type, not only posts and pages \u2014 WooCommerce products and any plugin's custom post types are now measured and appear in the \"By article\" table. Media attachments stay untracked, and the new ango_trackable_post_types filter removes a type a site does not want counted.<\/li>\n
- New: the \"By article\" table names each row's content type \u2014 a product reads \"Product\", not \"Post\".<\/li>\n<\/ul>\n\n
1.8.1<\/h4>\n\n\n- New: article titles in the \"By article\" table are clickable links to the article itself, opening in a new tab. Posts that no longer exist stay plain text.<\/li>\n
- Fix: the sortable column headers no longer show their label twice (\"ArticleArticle\"). The 1.8.0 headers printed the column name both outside and inside the sort button; it now appears once.<\/li>\n<\/ul>\n\n
1.8.0<\/h4>\n\n\n- New: the \"By article\" table is sortable. Click a column header to sort by it \u2014 first click ascending, second descending, with a direction arrow on the active column. Numbers sort numerically, titles and types alphabetically; finding the most visited or worst-median article no longer means eyeballing the rows.<\/li>\n<\/ul>\n\n
1.7.0<\/h4>\n\n\n- New: a \"Readability brief\" widget on the admin Dashboard home screen. Visits, average scroll, median and the \"90% scrolled at least to X%\" line for the last 7 days, plus a link to the full report. Server-rendered \u2014 no extra scripts on the Dashboard \u2014 and counts visits exactly like the Readability page, load-and-die exclusion included.<\/li>\n<\/ul>\n\n
1.6.0<\/h4>\n\n\n- New: the dashboard percentile list gains the low percentiles 5\/10\/25 alongside 50\/75\/90\/100. On a bounce-heavy audience the classic lines read 0 and say nothing, while \"25% of visitors scrolled at least to X%\" stays informative.<\/li>\n<\/ul>\n\n
1.5.0<\/h4>\n\n\n- New: logged-in visitors are not tracked \u2014 the site owner's own views no longer pollute the percentiles. The tracking script is not loaded for logged-in users, and the endpoint refuses their beacons. Multi-author sites that want member visits counted can turn the exclusion off with the ango_track_logged_in filter.<\/li>\n<\/ul>\n\n
1.4.0<\/h4>\n\n\n- Fix: the tracker no longer records 100% depth when the page layout is still unsettled at load time (scrollable height not yet known) \u2014 such loads were miscounted as full-depth reads.<\/li>\n<\/ul>\n\n
1.3.0<\/h4>\n\n\n- New \"Exclude load-and-die visits\" filter (on by default): page loads whose only beacon fired at page load \u2014 mostly bots and link previews \u2014 are excluded from all dashboard statistics. The Visits card shows how many were excluded, and a checkbox in the filter bar turns it off.<\/li>\n<\/ul>\n\n
1.2.1<\/h4>\n\n\n- Fix: the author is shown as Andrew Golubev, the Details link points to the WordPress.org page, and \"Details\" is translated in Russian.<\/li>\n<\/ul>\n\n
1.2.0<\/h4>\n\n\n- Renamed to AnGo Scroll Analytics per the WordPress.org review; all code symbols, options and the REST namespace moved to the ango_ prefix.<\/li>\n
- Translation files no longer ship in the package \u2014 translations come from translate.wordpress.org.<\/li>\n<\/ul>\n\n
1.1.8<\/h4>\n\n\n- Fix: cleared all Plugin Check errors (inline prepare() calls, %i identifier placeholder, sanitized REMOTE_ADDR).<\/li>\n<\/ul>\n\n
1.1.7<\/h4>\n\n\n- Readme discloses the bundled Chart.js 4.5.1 build (MIT).<\/li>\n<\/ul>\n\n
1.1.6<\/h4>\n\n\n- Uninstall cleanup: deleting the plugin removes its table, options and transients, with a warning on the Plugins screen naming what is lost.<\/li>\n
- Added the WordPress.org readme metadata block and plugin header fields.<\/li>\n<\/ul>\n\n
1.1.5<\/h4>\n\n\n- Fix: rebuilt the Russian translation file with a parseable header (the previous build shipped a malformed one).<\/li>\n<\/ul>\n\n
1.1.4<\/h4>\n\n\n- Fix: removed a doubled percent sign in the percentile lines (50%% -> 50%).<\/li>\n<\/ul>\n\n
1.1.3<\/h4>\n\n\n- Plugin attributed to Adviko Inc.<\/li>\n<\/ul>\n\n
1.1.2<\/h4>\n\n\n- Neutral asset and endpoint names (scroll-depth.js, \/wp-json\/...\/depth) so ad-blocker filter lists don't silently break tracking.<\/li>\n<\/ul>\n\n
1.1.1<\/h4>\n\n\n- Fix: the Apply button sits on the controls' line in the filter row.<\/li>\n<\/ul>\n\n
1.1.0<\/h4>\n\n\n- The admin interface is translatable (English source, Russian catalogue).<\/li>\n<\/ul>\n\n
1.0.1<\/h4>\n\n\n- Fix: Chart.js is bundled with the plugin instead of loaded from a CDN URL that returned 404.<\/li>\n<\/ul>\n\n
1.0.0<\/h4>\n\n\n- Initial release: scroll-depth tracking on posts and pages, the Readability dashboard (visits, averages, percentiles, trend chart, per-item table), UTC storage with site-timezone day grouping.<\/li>\n<\/ul>","raw_excerpt":"Self-hosted, cookie-free scroll depth tracking. See how far visitors actually read your content right inside wp-admin.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/371100","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=371100"}],"author":[{"embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/andrewgolubev"}],"wp:attachment":[{"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=371100"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=371100"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=371100"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=371100"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=371100"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/zul.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=371100"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}