Magic Linking – Internal Links

ವಿವರಣೆ

Magic Linking suggests internal links while you write, adds the one you choose without touching anything else, and keeps a history so you can undo it. It also reports which of your entries are orphans, under-linked, over-linked or have broken internal links.

It works entirely on your server, with no account, no key and no limits. Artificial intelligence is optional: it only runs if you have connected an AI provider in WordPress (Settings > Connectors) and press Improve with AI in the panel.

In the editor

• Outbound suggestions: a Magic Linking panel in the block editor (and a box in the classic editor) proposes phrases of the text you are writing that could link to other entries of your site. Each suggestion shows the phrase with the anchor text highlighted in the editor, the destination and the reason.
• One click to link: press Link and the link is added in the editor itself, on that phrase only. It is part of your unsaved changes until you save, and you can undo it with the Undo button of the card or with the editor’s own undo.
• Inbound suggestions: the same panel lists other entries whose text mentions the one you are editing and could link to it. Pressing Link writes the link in that other entry, see “How and when it changes your content”.
• Only the entries and block types where a link can be inserted safely are proposed. Paragraphs and lists are always used; headings, quotes and tables are left alone unless you turn them on in Settings (or a developer allows them with a filter).
• Dismiss: a suggestion you do not want can be dismissed for good, from either side, and restored with Undo.
• Improve with AI (optional): if your site has an AI connector (WordPress 7.0 or later, Settings > Connectors), the Outbound tab shows an Improve with AI button. One click sends the best 20 suggestions to your AI provider in a single request; it puts the best ones first, marks the ones it does not recommend and may propose a better anchor text (always a stretch of the same sentence, and only used if you accept it). It shows what that request cost. See “AI and your privacy”.

How and when it changes your content

• Nothing is changed until you press Link on a suggestion. There are no automatic changes and no background rewriting.
• For the entry you have open, the link is inserted in the editor; saving is up to you.
• For inbound suggestions, the link is written into the other entry on the server. Before saving, Magic Linking checks that the rest of that entry stays exactly as it was: only the link is added. If the check fails, it writes nothing and tells you why. WordPress keeps a revision of the entry as usual.
• Every change is recorded in History, where you can undo it and redo it. Links you add from the editor panel are listed there too once you save the entry; Magic Linking only records them. Undo removes only that link; if the text around it was edited since, it tells you instead of guessing.
• An entry that is open in someone’s editor is never modified from the server.
• Links already written in your content are never removed or rewritten, except to undo a link Magic Linking added or when you fix a broken link from its list.

History

• Every link Magic Linking changes is listed with who did it, when, where and the anchor text: links added from an inbound suggestion, links you add from the editor panel (they appear once you save the entry; Magic Linking only records them, and marks them as undone if you remove them and save) and fixes made from the broken links list.
• Changes are grouped by entry, newest first, with a date on each one. Filter by status, source or title, switch to a view by batch, and undo or redo one change, all the changes of an entry, or a whole batch.
• Undo and redo from the screen or with WP-CLI (wp magic-linking history undo --post=<id>). A large group is undone in the background.
• The history is kept 90 days by default; you can choose 30 days, a year or forever.

Report

• Orphan pages: entries that no other entry links to.
• Under-linked pages: entries with some inbound links, but fewer than you consider enough (2 by default, you can change it).
• Over-linked pages: entries with more internal links than one for every 100 words (you can change that too). A short text may always have one link.
• Broken internal links: links to an entry that is in the trash, is a draft or private, or does not exist. The complete list, with the anchor text and the reason. Fix each one from the list: change its destination to another published entry, or remove the link and keep its text. Magic Linking checks that nothing else in the entry changes, and you can undo it from History.
• Numbers for every entry: inbound, internal outbound, external and broken links.
• Filters, search by title, sorting, pagination and CSV export of the view you are looking at.

Also

• WP-CLI: analyse the site, print reports and manage the history from the terminal.
• Multilingual: the language of each entry comes from WPML, Polylang or, if you use neither, from the site language. Suggestions never link entries of different languages.
• Made for big sites: the analysis and the index of suggestions are built in the background in small batches with Action Scheduler (bundled), and every entry is updated when you save it. Suggestions for an entry are calculated in a few milliseconds even with thousands of entries.
• Light: no scripts, no styles and no database queries from this plugin on your public pages.
• Private: no telemetry, no cookies, no email requests, no notices outside its own screens, and nothing leaves your server unless you press Improve with AI with an AI connector (see “AI and your privacy”).

What it does not do (in this version)

• It does not need artificial intelligence. Everything works without it. When you use it, it is only through the AI client and the Connectors screen that WordPress itself provides, never with keys or credit of its own.
• It does not check links over the network: a link is “broken” when it points to an address on your own site that leads nowhere, according to WordPress. Links to other sites are counted, not checked.
• It does not suggest or add links automatically while you are away. Every link is a click of yours.

How links are counted

• Only the links written inside the content of each entry are counted. Links in menus, widgets, theme templates or blocks that are pulled from somewhere else are not, so your home page or a page that is only linked from the menu can appear as an orphan.
• Content that a page builder keeps outside the normal post content is not read. If your builder saves rendered HTML in the post content, it is read.
• Inbound = how many different entries link to this one, counting only links that work. Outbound = internal links to other pages of your site; every appearance counts. A link to the same entry, to a file (uploads, PDF, images) or to mailto: and tel: addresses is not counted.
• Category, tag, author, date and search pages, the home page and feeds are valid destinations and are never reported as broken.
• Tracking parameters (utm_*, gclid, fbclid…) and anchors (#…) are ignored when matching a link to an entry.

AI and your privacy

• Magic Linking has no AI of its own and asks for no key. It uses the AI client and the Connectors screen of WordPress 7.0 or later. On WordPress 6.9 the AI options are turned off and the plugin works as usual.
• Nothing is sent until you press Improve with AI. Finding out whether a connector exists does not call any model.
• What is sent, in that one request: the sentence of the entry you are editing with the anchor text marked, and for each of the 20 suggestions the title and a short summary (about 200 tokens) of the destination, made of its title, headings and the beginning of its text. Only clean text: no metadata, authors, email addresses or comments. Private, password-protected and draft entries are never sent as destinations.
• Where it goes: to the AI provider you configured in Settings > Connectors. If your connector is a local model (for example Ollama), the text does not leave your server.
• You set a daily limit of tokens (2,000,000 by default; 0 turns AI off). When it is reached, AI pauses until the next day and the suggestions use the built-in engine. Settings > AI shows the connector, the limit and what was used in the last 30 days. Costs are estimates with public list prices; your provider is the one that charges you.

Roadmap

Next: several phrases per destination and adjustable anchor text, automatic rules and, with the AI connectors that WordPress already provides, suggestions by meaning (when WordPress offers embeddings).

Support and documentation

Documentation and news: https://magiclinking.com

Questions and bug reports: use the support forum of this plugin on WordPress.org.

External services

Magic Linking does not connect to any external service by itself and has no servers of its own. It has no API keys, no accounts and no telemetry.

The only exception is the optional Improve with AI button, which exists only if you have connected an AI provider to WordPress yourself. Magic Linking does not call any provider directly: it uses the AI client that WordPress 7.0 and later provide (wp_ai_client_prompt()), which sends the request to the provider you configured on the Settings > Connectors screen of your site (wp-admin/options-connectors.php), for example OpenAI, Google, Anthropic or a local Ollama.

• What is sent: the sentence of the entry you are editing, with the anchor text marked, and, for each of the best 20 suggestions, the title and a summary of about 200 tokens of the destination entry (its title, headings and the start of its text). Only clean text. No metadata, authors, email addresses, comments or private fields. Private, password-protected and draft entries are never sent as destinations. The entry you are editing is sent only because you pressed the button.
• When: only when you press Improve with AI, once per press. Never in the background, never on page load and never on the public side of your site.
• To whom: to the provider you configured in Settings > Connectors. Their terms and privacy policy apply to that request, for example OpenAI (https://openai.com/policies), Google (https://policies.google.com) or Anthropic (https://www.anthropic.com/legal). If you use a local model, nothing leaves your server.
• Control: you choose the provider, you can set a daily token limit (0 turns it off) in Magic Linking > Settings > AI, and a site can veto requests with the wp_ai_client_prevent_prompt filter.

Magic Linking stores the number of tokens used, the provider and the model of each request (not the text) to show your usage in Settings > AI.

Privacy

Magic Linking does not collect personal data and sends nothing anywhere on its own. It stores, in your database, the addresses and anchor texts of the internal links found in your own content, a word index of your entries used for suggestions, counts per entry and a history of the links it has added or fixed, including those you add from the editor panel (which user, when, which entry and the text of the paragraph that changed, so it can be undone). The pairs (entry, target) of the suggestions you dismiss, with the user and the date, so they are not proposed again. It does not set cookies. For the optional AI button it also stores, for each request, the date, the user, the provider, the model, the tokens used and an estimated cost, never the text that was sent; and, for an hour, the result of checking what your AI connector can do. See “External services” for what is sent when you press that button.

Third-party libraries

• Action Scheduler (WooCommerce) 4.2.x, GPL-3.0-or-later, bundled in vendor/woocommerce/action-scheduler/. Used to run the analysis and the index in the background.