=== LinkBrainly ===
Contributors: linkbrainly
Tags: internal links, broken links, seo, alt text, orphan pages
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Find and fix broken links, orphan pages, missing meta descriptions and alt text. Works alongside Yoast SEO, Rank Math, AIOSEO and SEOPress.

== Description ==

LinkBrainly audits your posts, pages and WooCommerce products, then helps you fix what it finds without leaving WordPress. Every change can be undone.

**Works with the SEO plugin you already use.** LinkBrainly is not another SEO plugin. It never adds sitemaps, schema or its own meta tags when Yoast SEO, Rank Math, All in One SEO, SEOPress or The SEO Framework is active. Titles and meta descriptions you fix in LinkBrainly are saved straight into that plugin's own fields, so you see them there too.

= Free, and unlimited on your own site =

* **Site audit** of every published post, page and product, in small batches so large sites don't time out, plus a weekly background audit.
* **Internal link suggestions**: finds places where your own text already mentions your other pages (using your focus keyword or title) and adds the link inside that sentence in one click, or in bulk.
* **Orphan pages**: pages no other page links to.
* **Broken internal links**: point them to a working page, or remove the link and keep the text.
* **Vague link text** such as "click here" and "read more": replace it with descriptive words.
* **SEO titles and meta descriptions**: too short, too long or missing, edited in bulk.
* **Image alt text**: write missing alt text for content, featured and product gallery images.
* **Heavy images and meaningless file names** (IMG_2031.jpg) are flagged.
* **Activity log with Undo** for every change. Content edits also create normal WordPress revisions.
* WP-CLI: `wp linkbrainly audit`.

= Optional: LinkBrainly Pro and Business =

These features run on LinkBrainly's servers, so they need a free connection (see "External services" below) and a paid plan for higher limits:

* AI-written SEO titles and meta descriptions (20 a month free, 300 on Pro, 1,000 on Business).
* AI alt text that looks at each image.
* One-click image compression and resizing, with the original kept for Undo.

== External services ==

LinkBrainly works fully offline for audits, fixes, link suggestions and undo. It only contacts the LinkBrainly service (https://linkbrainly.com) after you click **Connect** on the Plans screen, and only for these actions:

* **Connect / account**: your site address, site name, the email you enter, WordPress and plugin version, which SEO plugin is active, and whether WooCommerce is installed. Used to create your account and show your plan and credits.
* **AI titles and descriptions** (when you click "Write with AI"): the title, current SEO title and description, focus keyword, URL and the first 1,500 characters of text of the items you selected.
* **AI alt text** (when you click "AI alt text"): a medium-size copy of the selected images, their file names and the page titles.
* **Image compression** (when you click "Compress"): the image file.

Content is processed to return the result and is not used for anything else. Terms: https://linkbrainly.com/terms · Privacy policy: https://linkbrainly.com/privacy-policy

Licences and payments for paid plans are handled by Freemius (https://freemius.com, privacy policy: https://freemius.com/privacy/).

== Installation ==

1. Install and activate the plugin.
2. Open **LinkBrainly** in the admin menu and click **Run first audit**.
3. Work through "What to fix first". Every change is listed under Activity with Undo.

== Frequently Asked Questions ==

= Will it conflict with Yoast SEO or Rank Math? =

No. When an SEO plugin is active, LinkBrainly outputs nothing on the front end. Titles and descriptions are written into that plugin's fields. Only on sites without any SEO plugin does LinkBrainly print the meta description you write.

= Does it slow my site down? =

No. LinkBrainly adds nothing to your pages' front end (unless no SEO plugin is active, when it adds one meta tag). Audits run in the admin or in the background.

= What happens to my changes if I uninstall? =

Links, alt text and SEO fields you fixed stay in your content and in your SEO plugin. Uninstalling removes only LinkBrainly's own audit data and activity log.

= Does it work with page builders? =

Version 1 edits content stored in the standard WordPress editor (block editor and classic editor). Content inside Elementor or Divi layouts is audited in a later version.

== Screenshots ==

1. Overview: SEO health score and what to fix first.
2. Internal link suggestions inside your existing sentences.
3. Bulk editor for meta descriptions, saved into your SEO plugin.
4. Broken links: replace or unlink.
5. Image alt text.
6. Activity log with Undo.

== Changelog ==

= 1.0.0 =
* First release.
