LinkAdmiral

By Matt Biscay

0+ active installationsVersion 0.2.0

Keep every link on course: affiliate library, automatic links, HTTP monitoring and reversible corrections.

Description

LinkAdmiral helps you manage affiliate links, add internal links automatically and repair broken links without losing your article text.

  • Central link library, keyword rules, priorities, exclusions and bounded insertion.
  • Unicode-aware matching, longest phrases at equal priority; existing links, headings and code are protected.
  • Generated links never overwrite stored article content.
  • Optional tracked links use local 302 redirects, daily aggregate click counts and per-link period filters.
  • HTTP inspection distinguishes 404/410, redirects, access restrictions, temporary failures and unknown responses.
  • Each destination is checked once, with separate occurrences to find every source article.
  • Inspect native links, images/srcset, video/audio sources, posters and iframe source URLs.
  • Locate an occurrence in the editor or on an authenticated public article view.
  • Remove one anchor while preserving text, replace its URL, or exclude an automatic rule from an article.
  • Audit receipts and undo with stale-content protection.
  • Manual scans continue in bounded background batches through WP-Cron.
  • CSV import/export, no bundled application framework, no public CSS, no visitor cookies.

Scope and limitations

This release indexes saved, published public post content. It does not execute arbitrary shortcodes or page-builder fields, render JavaScript pages, inspect all theme navigation, or verify playback on external video providers. An HTTP 200 does not prove that a product exists or that a video is playable. Local/private network URLs are deliberately not fetched. Automatic links are injected in the main singular content loop only, not feeds or archives. Matching across text nodes/entities is not supported yet.

WP-Cron depends on site activity; use a server cron for reliable schedules. Manual scans also advance while the administration page is open. Page caching/CDNs may require an explicit purge after rule, exclusion or settings changes. Use the linkadmiral_rules_changed and linkadmiral_post_corrected hooks to connect your cache system.

Click counts are redirect requests with basic known-bot exclusion. They are not confirmed visits, unique visitors, conversions or revenue. Affiliate-network redirect policies must be checked before enabling tracking. No affiliate-network-specific integration is included.

PHP 8.3+ with mbstring is required. Network-wide activation is not supported; activate per site. HPOS compatibility is declared because the plugin never reads or writes orders. WooCommerce order storage is independent of LinkAdmiral; see the compatibility notes for the tested scope. Passing coding standards does not mean WordPress VIP certification.

Privacy

There is no telemetry, external font or third-party runtime. HTTP checking sends requests to the destinations you inspect; the remote host sees your server address and the LinkAdmiral user agent. Click aggregates store rule IDs, UTC dates and counts, without visitor IPs or identifiers. Corrected article snapshots are retained locally for undo. Click/check history is pruned in bounded batches after scans according to Settings.

Deactivation retains data. Uninstall retains tables by default. Enable the explicit uninstall option to remove plugin tables/settings. Articles are never deleted. Tracked URLs stop working when the plugin is unavailable.

Installation

  1. Upload the installable linkadmiral ZIP through Plugins > Add New.
  2. Activate LinkAdmiral on an individual site.
  3. Add a library link. Add optional keywords, preview your article and adjust the limits.
  4. Run a site scan. Use the Inspector to review each occurrence.
  5. Review retention and uninstall settings; purge your external page cache after link-rule changes.

Keep Sky Link Inspector deactivated while evaluating LinkAdmiral to avoid duplicate editor checks. No existing plugin is disabled automatically.

FAQ

Does LinkAdmiral require an account or license?

No. The Free package works locally without a commercial account, license or SDK.

Does a manual scan continue after I close the page?

Yes. WP-Cron continues the requested scan in bounded batches. Reliable background progress depends on site traffic or a server cron.

Does removing a link delete its text?

No. Removing a saved anchor keeps its text. Removing a generated link excludes its automatic rule from that article. Corrections have undo receipts and reject stale content.

Does it send scheduled scans or email reports?

No. Recurring monitoring and email reporting are outside this Free package.

Changelog

0.2.0

  • Independent Free package: manual scans, library, linking rules, corrections, basic statistics and CSV.
  • Remove recurring scan scheduling and email reports from the distributed package.

0.1.2

  • Protect unsaved classic editor text and post settings, including edits made during correction requests.
  • Locate repeated links in TinyMCE and resolve relative links against the article URL.
  • Resolve inspector deep links using actual pagination after indexing automatic occurrences.
  • Avoid repeated token-array copies when extracting large articles.

0.1.1

  • Original SVG sail monogram, nautical banners and custom monochrome administration menu icon.

0.1.0

  • Initial development release: link library, automation, monitoring, correction, statistics and reports.