=== WP Tracklink ===
Contributors: Jules81
Donate link: https://ispire.me/donate/
Tags: referrer, backlinks, widget, inbound links, block
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.5.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Records inbound referrers that link to your site, checks them in the background, and shows them in a widget or block.

== Description ==

WP Tracklink watches the HTTP referrer on normal front end visits. New hosts go into a small queue. A cron job fetches the remote page, checks that it links to you, then stores the host and click counts.

**Features**

* Background verify so page loads stay light
* Optional strict mode that requires a real anchor to your domain
* Classic widget and a block editor block
* Sort by clicks, last seen, or score
* Free Tranco ranking download (no API key) or a local click based score
* Privacy options: host only or anonymized paths
* Retention cleanup on a daily cron
* CSV export and a small click chart in settings
* Per host rel attribute (nofollow, sponsored, ugc)

**Score without paid APIs**

Tranco publishes a free top sites CSV. Once a week the plugin can download that zip and keep ranks only for hosts already in your table. No signup and no API key. You can also use a local score derived from clicks and recency, or turn scoring off.

Plugin page: https://ispire.me/wp-tracklink/

== Installation ==

1. Upload the plugin or install the zip.
2. Activate it under Plugins.
3. Open Settings > Tracklink.
4. Add the WP Tracklink widget or the Tracklink block.

== Frequently Asked Questions ==

= Does uninstall remove data? =

Yes. The table and options are dropped.

= Why is a referrer not listed yet? =

New hosts wait in the verify queue (about every five minutes). Search engines and many bots are ignored. Strict mode needs a real link to your hostname.

= Is Tranco required? =

No. It is optional. Local score or "Off" also work.

= Privacy? =

Referrer hosts and counts live in your database. Mention that in your privacy policy if you need to.

= What does this plugin connect to? =

Two optional outbound requests, both from your server:

* When verifying a new referrer, it fetches that page once (size capped) to check for a link to your site.
* If Tranco scoring is enabled, it downloads the public Tranco top list zip about once a week. No API key and no account.

Nothing is sent to the plugin author.

== Changelog ==

= 0.5.0 =
* PHP 8 compatibility
* Drop dead Alexa rank lookups; keep the score column via Tranco (free, no API key) or a local click based score
* Async verify queue and cron maintenance
* Strict anchor verify, privacy options, retention days
* Classic widget refresh, block editor block, default title fallback
* Sort by clicks, last seen, or score
* CSV export, click chart, per link rel controls
* Class rename under WP_Tracklink_* and sidebar id migrate from older installs
* Object cache click buffering when available, verify/Tranco response size limits, queue lock
* Outbound network behaviour documented in FAQ

= 0.4.9 =
* Last release on wordpress.org before this refresh

== Upgrade Notice ==

= 0.5.0 =
Background verification, Tranco/local scoring, block support, and privacy controls. Open Settings > Tracklink after updating.
