Readrank

Counting views on the server does not work behind a full-page cache or a CDN. Readrank takes page views from your Google Analytics 4 property through Site Kit by Google and stores them in post meta every few hours.

• Weekly top: views for the last N days (7 by default) for posts published within them — use the meta field to sort theme blocks («Order by: custom meta key»).
• Views since publishing for posts of the last M days (60) — a sortable «Views» column in the posts list and the widget.
• Widget «Readrank: Most read»: a slider with full titles (never cut), numbers, category label, autoplay, keyboard and swipe; categories chosen with checkboxes.
• Status page with the last update, the top 3 of the week and errors, plus «Refresh now».
• Clears the cached front page (WP Rocket) when the weekly top 3 changes.
• No save_post on updates, so social-sharing or push plugins are not triggered.

Requires Site Kit by Google with Google Analytics 4 connected.

External services

Readrank requests reports from Google Analytics 4 through the Site Kit by Google plugin you already use (page paths and their view counts for the selected period). No visitor data is sent anywhere. Google Analytics terms: https://marketingplatform.google.com/about/analytics/terms/us/ · Privacy: https://policies.google.com/privacy

Reports API

Site reports for any period over the WordPress REST API, for external dashboards (Basic auth with an Application Password). Access: users who can edit_posts, or any role given the capability readrank_api. Dates are site dates (YYYY-MM-DD); every answer has data_until — the last day with complete data (GA4 is 1–2 days late, Search Console 2–3) — and cached.

• GET /wp-json/readrank/v1/report/pages?start=&end=&page=1&per_page=500&orderby=views|clicks&path_prefix= — every page with GA4 views, users, average session duration (s), bounce rate (0–1) and Search Console clicks, impressions, CTR (0–1), position; merged by path (no query string or fragment, the site's trailing slash); pages found in only one source come with the other block null; post_id when the path is a post.
• GET /wp-json/readrank/v1/report/totals?start=&end=&group=day|week|month — views, users, clicks, impressions per day, ISO week (from Monday) or month, plus sum (users deduplicated over the whole period).
• GET /wp-json/readrank/v1/report/queries?url=|post_id=&start=&end=&limit=100 — Search Console queries of one page.

Each call asks Google at most once per source; a period's page list is fetched whole (Site Kit has no paging) and cached, so further pages are free. Cache: 1 h for periods within the last 3 days, 6 h otherwise; fresh=1 refetches (at most once a minute). Errors are HTTP 4xx/5xx with a code: bad_date, bad_period, bad_url, missing_url, post_not_found (400/404), sitekit_inactive, ga_not_connected, sc_not_connected (424), ga_error, sc_error (502). Only aggregates, no personal data.

1. Install and connect Site Kit by Google with Analytics.
2. Activate Readrank; open MCG Plugins → Readrank and click «Refresh now».
3. Add the «Readrank: Most read» widget, or sort theme blocks by the weekly meta field.

1.4.0 (2026-10-17)

• Reports API for external dashboards (cDash): /readrank/v1/report/pages, /report/totals, /report/queries — GA4 and Search Console for any period through the Site Kit connection Readrank already uses, merged by page, cached, with data_until and clear error codes. Access: edit_posts or the capability readrank_api.
• Filter readrank_pre_sitekit_data to supply data without Site Kit (tests).

1.3.2 (2026-10-16)

• «Most read» widget: the photo fills its frame also when Imagify or another WebP plugin wraps it in <picture> (the class rr-img moves to <picture>); before, the photo dropped to the bottom under a grey strip. Hover zoom works in both cases.

1.3.1 (2026-10-15)

• The «MCG Plugins» menu is now at the top of the admin menu, right under the Dashboard.