=== Rankmint – AI Content & SEO Toolkit ===
Contributors: sproutsagesolutions, nitishsharma6, mandeepsingh11
Author: Sprout Sage Solutions
Author URI: https://sproutsagesolutions.com
Tags: seo, alt text, seo audit, accessibility, ai
Requires at least: 6.2
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.3.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

All-in-one AI SEO toolkit for WordPress: bulk image alt text, full SEO audit, FAQ schema, internal links & more — using your own AI key. Free forever.

== Description ==

**Rankmint is the all-in-one AI content & SEO toolkit for WordPress** — six powerful tools inside one lightweight, beautifully designed plugin. Generate SEO-friendly image **alt text** in bulk, run a full **SEO audit** of your entire site, create **FAQ schema** for rich results, add smart **internal links**, auto-write **excerpts**, and generate persuasive **WooCommerce product descriptions** — all from one clean dashboard.

Rankmint is **Bring-Your-Own-Key**: connect your own OpenAI or Google Gemini API key and pay only your provider. There are **no credits, no subscriptions, and no middleman** — Rankmint is **free forever**, with every feature unlocked.

= Why choose Rankmint? =

* **6 AI tools in 1 plugin** — replace a whole stack of single-purpose SEO and AI plugins.
* **Free forever** — no premium upsell, no locked features, no usage caps from us.
* **Your data stays private** — requests go straight from your site to the AI provider you choose; nothing passes through our servers.
* **Built for rankings** — better image SEO, stronger on-page optimization, valid schema, and improved accessibility (WCAG/ADA).
* **Lightweight & modern** — a fast React dashboard; enable only the modules you need.

= What the Alt Text module does =

* **Scan your media library** and instantly see how many images are missing alt text.
* **Bulk-generate** accessible, SEO-friendly alt text for hundreds of images with a live progress bar (cancel any time).
* **Auto-generate on upload** — new images get alt text automatically.
* **Edit and save** any generated alt text before it goes live.
* **Choose a style** — descriptive, SEO-focused, accessibility-first or concise.
* **Any language** — generate alt text in the language of your choice.
* **Skip existing** — never overwrite alt text you already wrote.

= Why alt text matters =

Alt text improves **web accessibility** (helping screen-reader users and supporting WCAG/ADA compliance) and boosts **image SEO** so your images can rank in search. Rankmint makes fixing your entire library a two-minute job.

= What the SEO Audit module does =

* **Whole-site health score** — audit every post and page and get a single SEO health score (0–100).
* **12+ on-page checks per page** — SEO title, meta description, H1 usage, content length, readability (Flesch), subheadings, image alt text, image weight, internal & external links, indexability and URL slug.
* **Site-wide checks** — HTTPS, XML sitemap, search-engine visibility, duplicate titles and duplicate meta descriptions.
* **Fix meta descriptions with AI** — generate a perfect meta description for any page and apply it in one click (writes to Yoast, Rank Math, or Rankmint's own output).
* **Bulk fix** — auto-write meta descriptions for every page that is missing one.
* **Issues report** — group every issue by type and see exactly which pages are affected.
* **Broken link checker** — crawl every link on your site and find the broken ones (with the pages they appear on).
* **CSV export** — download the full audit for reporting.

= Modular by design =

Enable only the tools you need from the **Modules** screen. New AI modules are added regularly — always free.

== External services ==

This plugin connects to third-party AI services to generate content. **No data is sent anywhere until you add an API key and trigger a generation.** You choose which provider to use, and you use your own account and API key.

Depending on the provider you configure, the plugin sends a **downscaled copy of the image** you are generating alt text for (and a short text instruction) to that provider's API, and receives the generated text in response. No image or content is sent to any Rankmint-operated server — requests go directly from your site to the provider you chose.

Supported providers:

* **OpenAI** — used only if you select it and add an OpenAI API key.
  * Terms: https://openai.com/policies/row-terms-of-use/
  * Privacy: https://openai.com/policies/row-privacy-policy/
* **Google Gemini** — used only if you select it and add a Gemini API key.
  * Terms: https://ai.google.dev/gemini-api/terms
  * Privacy: https://policies.google.com/privacy

== Installation ==

1. Upload the plugin to `/wp-content/plugins/` or install it from the Plugins screen.
2. Activate the plugin.
3. Open **Rankmint** in the admin menu.
4. Go to **Settings**, choose a provider (OpenAI or Gemini) and paste your API key.
5. Open **AI Alt Text** and click **Bulk generate missing**.

== Frequently Asked Questions ==

= Is it really free? =
Yes. The plugin is free forever. You only pay your AI provider for the API usage on your own account.

= Do I need an API key? =
Yes. Rankmint uses your own OpenAI or Google Gemini API key so you stay in control of usage and cost.

= Does the plugin send my images to your servers? =
No. Requests go directly from your website to the AI provider you choose. There is no Rankmint-operated server in between.

= Will it overwrite my existing alt text? =
Only if you want it to. By default, "Skip existing" is on, so bulk runs leave your existing alt text untouched.

= Does it work with large media libraries? =
Yes. Bulk generation processes images one by one with a live progress bar, and you can stop and resume any time.

== Screenshots ==

1. AI SEO Audit — your whole-site health score and site-wide technical checks.
2. Every post and page scored, with one-click AI fixes for meta descriptions.
3. Issues grouped by type, so you can fix the biggest SEO wins first.
4. Six AI tools in one plugin — turn on only the modules you need.
5. The Rankmint dashboard — one AI toolkit, powered by your own key.
6. Bring your own OpenAI or Google Gemini API key. Free forever.

== Development ==

Rankmint is fully open source (GPLv2+). The complete, human-readable source is included in this plugin:

* The admin interface is a React app; its source lives in the `/src` folder and is compiled to `/build` with [@wordpress/scripts](https://www.npmjs.com/package/@wordpress/scripts) (webpack under the hood).
* All PHP is unminified and included as-is under `/includes`.

To rebuild the compiled assets from source:

`npm install`
`npm run build`

(`npm start` runs the development watch build.) The build configuration is the default provided by @wordpress/scripts; the exact dependency versions are pinned in the bundled `package.json` and `package-lock.json`.

== Changelog ==

= 1.3.0 =
* New **AI FAQ + Schema** module: generate FAQ sections from your content and output valid FAQPage schema for rich results.
* New **AI Internal Linking** module: find smart internal-link opportunities between your pages and insert them in one click (no API key needed).
* New **AI Excerpts** module: auto-write clean post and page excerpts in bulk.

= 1.2.0 =
* New **AI Product Descriptions** module (WooCommerce): write persuasive product descriptions from your product data, one at a time or in bulk.
* SEO Audit now outputs **Open Graph, Twitter card and JSON-LD schema** on your pages when no other SEO plugin is active, plus a new "Social & schema" check.

= 1.1.0 =
* New **AI SEO Audit** module: whole-site health score, 12+ on-page checks per page, site-wide checks, readability scoring, thematic issues report, broken link checker, one-click and bulk AI meta-description fixes, and CSV export.
* Added text generation to the OpenAI and Gemini providers.
* Added an `aimpact_provider` filter so add-ons can register custom AI providers.

= 1.0.0 =
* Initial release: AI Alt Text module (scan, single + bulk generation, auto-on-upload, multi-language, styles), modular dashboard, OpenAI & Gemini support.

== Upgrade Notice ==

= 1.3.0 =
Adds three new modules: AI FAQ + Schema, AI Internal Linking, and AI Excerpts.

= 1.2.0 =
Adds AI Product Descriptions for WooCommerce, plus Open Graph & schema output.

= 1.1.0 =
Adds the AI SEO Audit module — a full on-page SEO audit with one-click AI fixes.

= 1.0.0 =
First public release.
