=== Linktrue – Find & Fix Broken Links Locally, No Account ===
Contributors: lrlr
Tags: broken links, link checker, dead links, redirects, 404
Requires at least: 6.4
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find broken links in your posts and pages. Runs on your own site: no account, no credit card, no external service. Gentle on your database.

== Description ==

Linktrue scans your posts and pages for links and images that no longer work, and lets you fix them from one screen.

**Why another link checker?** Existing link checkers tend to fall into one of three groups: they need a cloud account (often with a credit card, even for the free plan), they run heavy scans that strain the database on large sites, or they report many false "broken" links. This plugin is built around those three problems:

1. **100% local, no sign-up.** No account, no API key, no credit card, no remote scanning service. Your content and link lists are never sent to the plugin author or to a third-party scanning service.
2. **Measured on a 10,000-post site.** It indexed 50,000 links in under 30 seconds of background work spread over short runs, with two small tables (about 6–9 MB) and no query slower than 50 ms.
3. **Two-strike verification.** A link is only called broken after failing twice, at least an hour apart. Sites that block automated checkers are shown as "Could not verify" rather than broken.

**Everything runs on your own WordPress site.** You don't sign up, you don't enter a card, and your content is never sent to a third-party scanning service.

**Built to avoid false alarms**

* A link is only marked **Broken** after it fails twice, at least an hour apart. Temporary outages don't fill your list.
* If a server rejects a quick HEAD request, the link is checked again with a real GET request before anything is reported.
* Sites that block automated checkers (Amazon, LinkedIn, Instagram and others) show up as **Could not verify** instead of Broken.
* Changes like http→https or an added trailing slash are not reported as redirects.

**Gentle on your server**

* Two small database tables, with indexes. No giant log tables.
* Work happens in short, time-limited batches every few minutes, and never two at once.
* There's a per-site request limit, so no external site gets hammered.
* An optional pause when server load is high (Linux hosts).

**Fix links in bulk**

* **Remove link (keep text):** unlink everywhere a broken URL appears.
* **Edit URL:** replace a URL in every post that uses it.
* **Update to final URL:** point redirected links straight at their destination.
* **Not broken:** dismiss a false alarm so it stays out of your list.
* Every change goes through the normal WordPress editor, so a revision is saved and you can undo it.

While you have the Link Checker screen open, checking speeds up, so small sites with little traffic don't wait for WP-Cron.

= Privacy and outgoing requests =

The plugin sends no data to the plugin author or to any third-party service. To check a link, your site sends a normal HTTP request (HEAD, and if needed a small GET) directly to that link's own address, as a browser would. Like any web request, this means the server hosting each linked page can see your site's IP address, the URL being checked and a browser-like user agent. No other information is sent. You can exclude sites under Settings → "Never check these sites". The plugin doesn't collect visitor data or set cookies.

== Installation ==

1. Install and activate the plugin.
2. Go to **Tools → Link Checker**. The first scan starts automatically in the background.
3. Optional: under **Settings**, choose post types, batch size and sites to skip.

== Frequently Asked Questions ==

= Do I need an account or an API key? =

No. There's nothing to sign up for. The plugin only makes outgoing requests to the links that are in your own content.

= Why is a link listed as "Could not verify"? =

Some sites refuse automated requests (HTTP 401, 403, 429 or 999). The link probably works in a browser, so the plugin doesn't call it broken. Click it to check by hand, then dismiss it if it's fine.

= Will it slow down my site? =

Checks run in the background, in batches of 10 links (adjustable) for at most 20 seconds, every 5 minutes. Visitors never wait for a check.

= What happens when I uninstall? =

The plugin's two tables and its settings are deleted. Your posts are not touched.

== Changelog ==

= 0.1.0 =
* First release.
