{"id":399141,"date":"2026-11-14T13:30:22","date_gmt":"2026-11-14T13:30:22","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/bestquest-live-visitors\/"},"modified":"2026-11-14T13:29:55","modified_gmt":"2026-11-14T13:29:55","slug":"bestquest-live-visitors","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/bestquest-live-visitors\/","author":23599563,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.5.4","stable_tag":"1.5.4","tested":"7.1.4","requires":"6.5","requires_php":"8.0","requires_plugins":null,"header_name":"BestQuest Live Visitors","header_author":"BestQuest","header_description":"Lightweight real-time visitor and affiliate-click dashboard for WordPress.","last_updated":"2026-11-14 13:29:55","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/bestquest.net\/bestquest-live-visitors-wordpress-plugin\/","header_author_uri":"https:\/\/bestquest.net\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":65,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.5.4":{"tag":"1.5.4","author":"bestquest","date":"2026-11-14 13:29:55","revision":3801970}},"upgrade_notice":{"1.5.4":"<p>Hardens anonymous tracking endpoints, adds privacy controls and uninstall cleanup. Existing visitor\/session data and settings are preserved. IP storage remains enabled by default unless the administrator turns it off.<\/p>","1.5.3":"<p>Keeps expanded Action histories open while the live dashboard refreshes. No database migration is required.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3802002,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3802002,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3802002,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3802002,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.5.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3802002,"resolution":"1","location":"assets","locale":"","width":2048,"height":1280}},"screenshots":[]},"plugin_section":[],"plugin_tags":[232,21331,866,292753,2497],"plugin_category":[36],"plugin_contributors":[292754],"plugin_business_model":[],"class_list":["post-399141","plugin","type-plugin","status-publish","hentry","plugin_tags-analytics","plugin_tags-live-visitors","plugin_tags-real-time","plugin_tags-visitor-history","plugin_tags-visitor-tracking","plugin_category-analytics","plugin_contributors-bestquest","plugin_committers-bestquest"],"banners":{"banner":"https:\/\/ps.w.org\/bestquest-live-visitors\/assets\/banner-772x250.png?rev=3802002","banner_2x":"https:\/\/ps.w.org\/bestquest-live-visitors\/assets\/banner-1544x500.png?rev=3802002","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/bestquest-live-visitors\/assets\/icon-128x128.png?rev=3802002","icon_2x":"https:\/\/ps.w.org\/bestquest-live-visitors\/assets\/icon-256x256.png?rev=3802002","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/bestquest-live-visitors\/assets\/screenshot-1.png?rev=3802002","caption":""}],"raw_content":"<!--section=description-->\n<p>BestQuest Live Visitors provides a lightweight WordPress admin dashboard showing:<\/p>\n\n<ul>\n<li>Approximate live visitors and visitors active in the last 15 minutes.<\/li>\n<li>Approximate distinct browser identifiers observed today.<\/li>\n<li>Current\/last page, while page-journey data remains stored internally for session tracking.<\/li>\n<li>Tracked article-link clicks, including link text, destination URL, source page, and click time.<\/li>\n<li>Action column for live and recent visitor sessions.<\/li>\n<li>Referrer origin, browser\/device family, and browser-reported timezone.<\/li>\n<li>Recent sessions after their last heartbeat falls outside the live window.<\/li>\n<li>Configurable heartbeat interval, live timeout, data retention, frontend tracking, and IP storage.<\/li>\n<li>Exclusion of administrator traffic and optional exclusion by a locally hashed IP address.<\/li>\n<li>Optional automatic removal of plugin tables\/settings when the plugin is deleted.<\/li>\n<\/ul>\n\n<p>No external analytics service or API key is required. The optional public BestQuest footer credit is disabled by default and is shown only after an administrator explicitly enables it in the plugin settings. By default, click tracking applies to links inside article content (<code>.entry-content<\/code>), links using the BestQuest affiliate class <code>bq-affiliate-text-link<\/code>, links inside <code>bq-affiliate-cta<\/code>, links with <code>rel=\"sponsored\"<\/code>, links using <code>bq-track-click<\/code>, and links marked with <code>data-bqlv-track=\"click\"<\/code>. Header, menu, footer, and WordPress admin navigation are not tracked unless explicitly marked.<\/p>\n\n<p>The tracker stores data in the site's own WordPress database. Session duration is elapsed first-to-last recorded heartbeat, not verified time spent reading. An inactive session is not proof that a user disconnected. Cookie blocking, ad blockers, browser privacy features, stale full-page caches, and bots can affect counts.<\/p>\n\n<p>Version 1.5.4 hardens the anonymous tracking endpoints with a WordPress frontend nonce, same-site Origin\/Referer validation, per-session throttles, higher shared-IP ceilings, a new-session creation cap, and a 500-event per-session ceiling. These measures reduce forged traffic and database-bloat risk but do not make anonymous analytics impossible to spoof.<\/p>\n\n<p>Developed by BestQuest: https:\/\/bestquest.net\/<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>bestquest-live-visitors<\/code> folder to <code>\/wp-content\/plugins\/<\/code>, or install the plugin ZIP using Plugins &gt; Add New &gt; Upload Plugin.<\/li>\n<li>Activate BestQuest Live Visitors.<\/li>\n<li>Open Live Visitors in the WordPress admin dashboard.<\/li>\n<li>Optionally exclude your current IP and adjust heartbeat, live window, retention, tracking, IP storage, and uninstall cleanup settings.<\/li>\n<li>If you use full-page caching, verify the frontend script and REST heartbeat work on cached pages. The frontend nonce is time-limited, so unusually long cache lifetimes should be tested.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"is%20a%20visitor%20count%20the%20same%20as%20the%20number%20of%20people%3F\"><h3>Is a visitor count the same as the number of people?<\/h3><\/dt>\n<dd><p>No. Unique visitors are approximate distinct browser identifiers. Shared browsers, privacy settings, deleted local storage, and multiple devices affect accuracy.<\/p><\/dd>\n<dt id=\"does%20this%20plugin%20send%20analytics%20data%20to%20bestquest%3F\"><h3>Does this plugin send analytics data to BestQuest?<\/h3><\/dt>\n<dd><p>No. Visitor activity is submitted to your own WordPress REST endpoint and stored in your site's database. The external links in documentation and plugin metadata are informational.<\/p><\/dd>\n<dt id=\"does%20it%20store%20raw%20ip%20addresses%3F\"><h3>Does it store raw IP addresses?<\/h3><\/dt>\n<dd><p>IP storage is enabled by default because the administrator dashboard can use it to distinguish visits from probes and abusive traffic. Administrators can disable IP storage under Live Visitors &gt; Settings. Turning it off immediately clears IP addresses already stored by this plugin, while hashed visitor\/session identifiers and activity history remain until normal retention cleanup. Ignored-IP entries are stored as salted one-way hashes.<\/p><\/dd>\n<dt id=\"can%20i%20integrate%20consent%20or%20privacy%20logic%3F\"><h3>Can I integrate consent or privacy logic?<\/h3><\/dt>\n<dd><p>Yes. Frontend tracking can be disabled in Settings. Developers can also use the <code>bqlv_tracking_enabled<\/code> and <code>bqlv_should_track_request<\/code> filters to gate tracking, <code>bqlv_store_ip_address<\/code> to control IP retention, and <code>bqlv_client_ip<\/code> to supply an address from a trusted proxy\/CDN integration. Do not trust forwarding headers unless the proxy itself is trusted.<\/p>\n\n<p>The plugin uses browser localStorage and sessionStorage identifiers. Your site's legal obligations depend on your jurisdiction and configuration; assess consent and update your privacy notice before enabling behavioral analytics.<\/p><\/dd>\n<dt id=\"what%20happens%20on%20deactivation%20or%20removal%3F\"><h3>What happens on deactivation or removal?<\/h3><\/dt>\n<dd><p>Deactivation stops tracking and the scheduled cleanup task but preserves data for reactivation. When the plugin is deleted, its tables and settings are removed by default. Administrators can disable that deletion behavior in Settings if they intentionally want to preserve the data for a later reinstall.<\/p><\/dd>\n<dt id=\"how%20long%20is%20data%20kept%3F\"><h3>How long is data kept?<\/h3><\/dt>\n<dd><p>The default retention is 7 days; the dashboard allows changing this between 1 and 30 days. Cleanup is performed by WordPress cron, which depends on site traffic or an external cron setup.<\/p><\/dd>\n<dt id=\"how%20are%20the%20public%20rest%20endpoints%20protected%3F\"><h3>How are the public REST endpoints protected?<\/h3><\/dt>\n<dd><p>Anonymous visitors must be able to send heartbeats and click events, so the endpoints are public by design. Version 1.5.4 requires a frontend nonce and same-site request evidence, applies per-session and per-IP throttles, limits new-session creation per IP, and caps stored events per session. These are abuse-reduction measures, not authentication of anonymous visitors.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.5.4<\/h4>\n\n<ul>\n<li>Restored the optional BestQuest public footer credit as an explicit opt-in setting; it is disabled by default.<\/li>\n<li>Hardened heartbeat and action endpoints with a frontend WordPress nonce and same-site Origin\/Referer validation.<\/li>\n<li>Added per-session rate limits and raised the shared-IP ceiling to reduce false 429 responses for visitors behind NAT.<\/li>\n<li>Added a separate cap of 60 new sessions per IP per minute to reduce forged-session database bloat.<\/li>\n<li>Added a hard ceiling of 500 stored events per session.<\/li>\n<li>Added a <code>bqlv_client_ip<\/code> filter for carefully configured trusted proxy\/CDN integrations; forwarding headers are not trusted automatically.<\/li>\n<li>Added Settings controls to enable\/disable frontend tracking and raw IP storage.<\/li>\n<li>Turning IP storage off now clears previously stored plugin IP addresses immediately.<\/li>\n<li>Added <code>bqlv_tracking_enabled<\/code>, <code>bqlv_should_track_request<\/code>, and <code>bqlv_store_ip_address<\/code> privacy\/consent integration filters.<\/li>\n<li>Added <code>uninstall.php<\/code>; plugin tables and settings are deleted on plugin deletion by default, with an administrator setting to preserve them if desired.<\/li>\n<li>Security review credit: BlueSA \u2014 Thembelani Mthethwa.<\/li>\n<\/ul>\n\n<h4>1.5.3<\/h4>\n\n<ul>\n<li>Action click-history dropdowns now remain open across the automatic Live visitors refresh.<\/li>\n<li>Closing a dropdown keeps it closed on the next refresh.<\/li>\n<li>Live refresh interval and tracking behavior are unchanged.<\/li>\n<li>No database schema change; existing data is preserved.<\/li>\n<\/ul>\n\n<h4>1.5.2<\/h4>\n\n<ul>\n<li>Removed the visible Session path column from Live visitors and Recent visitors.<\/li>\n<li>Page-journey events continue to be recorded internally; no tracking data is deleted.<\/li>\n<li>Gives the Action column more room and reduces dashboard clutter.<\/li>\n<li>No database schema change; existing data is preserved.<\/li>\n<\/ul>\n\n<h4>1.5.1<\/h4>\n\n<ul>\n<li>Track ordinary links inside article content, not only affiliate\/sponsored links.<\/li>\n<li>Keep header, menu, footer, and WordPress admin navigation out of Action unless explicitly marked.<\/li>\n<li>Ignore non-HTTP link schemes for click-event storage.<\/li>\n<li>No database schema change; existing v1.5.0 data is preserved.<\/li>\n<\/ul>\n\n<h4>1.5.0<\/h4>\n\n<ul>\n<li>Added affiliate\/sponsored link click tracking.<\/li>\n<li>Added an Action column to live and recent visitor tables.<\/li>\n<li>Click events record link text, destination URL, source page, and click time in the local events table.<\/li>\n<li>Added explicit <code>bq-track-click<\/code> and <code>data-bqlv-track=\"click\"<\/code> hooks for tracking additional links without tracking all site navigation.<\/li>\n<li>Existing page\/session history is preserved during the database upgrade.<\/li>\n<\/ul>\n\n<h4>1.4.0<\/h4>\n\n<ul>\n<li>Added administrator-only IP address display for live and recent sessions.<\/li>\n<li>Recent-history view now shows First seen + Recorded span instead of redundant Last seen.<\/li>\n<li>Front-end tracker no longer loads on WordPress 404 pages, reducing scanner noise.<\/li>\n<li>Existing session rows from earlier versions cannot recover past IP addresses and will show blank IPs.<\/li>\n<\/ul>\n\n<h4>1.3.4<\/h4>\n\n<ul>\n<li>Packaging and documentation release: GPL license text, WordPress.org readme, privacy policy guidance, and security notes.<\/li>\n<li>No intentional visitor-tracking behavior changes from 1.3.2.<\/li>\n<\/ul>\n\n<h4>1.3.2<\/h4>\n\n<ul>\n<li>Added BestQuest attribution metadata and source comments.<\/li>\n<\/ul>\n\n<h4>1.3.1<\/h4>\n\n<ul>\n<li>Improved iOS Chrome, Firefox, Edge, and Opera identification.<\/li>\n<\/ul>\n\n<h4>1.3.0<\/h4>\n\n<ul>\n<li>Added recent visitor session history view with show\/hide control.<\/li>\n<\/ul>\n\n<h4>1.2.1<\/h4>\n\n<ul>\n<li>Refined session expiration and visitor\/session consistency checks.<\/li>\n<\/ul>\n\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>Reduced referrer retention and added basic bot and traffic limiting safeguards.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Improved visitor counting and dashboard summary counters.<\/li>\n<\/ul>","raw_excerpt":"A self-hosted WordPress dashboard showing approximate live visitor activity, article-link clicks, referrers, and recent sessions.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/399141","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=399141"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/bestquest"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=399141"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=399141"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=399141"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=399141"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=399141"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=399141"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}