=== RankX SEO ===
Contributors: rankxseo
Tags: woocommerce, seo, ai, product description, schema
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.25.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI SEO for WooCommerce: product descriptions, meta, FAQs, tags and image ALT, reviewed before anything is written. Arabic and English.

== Description ==

RankX SEO helps WooCommerce stores rank on Google and get quoted in AI answers. It writes product descriptions, meta titles and meta descriptions, FAQs, tags and image ALT text, shows you a before/after preview, and only writes to your store when you approve (or when you turn on Auto mode yourself).

It was built first for stores in Saudi Arabia and the Gulf, so it is fully bilingual: the interface follows each admin's WordPress language (Arabic or English), and generated content follows your site's language.

= What it does =

* **Product optimization** — description, meta title, meta description, FAQs and tags in one click, optionally for a target keyword (using live Google data for it) or written to be quoted by AI answers (AEO). Every change is backed up and can be undone.
* **Categories and brands** — descriptions, meta and FAQs for category and brand pages.
* **Image ALT text** — for every product image that is missing it.
* **Blog writer** — full articles for keywords people search, with a featured image and links to your products.
* **SEO impact** — connect Google Search Console and Analytics to see clicks, impressions and position before and after every optimization.
* **Auto mode** — improves new and incomplete products in the background, within a daily limit and run window you set, with a first-batch review.
* **Insights** — keyword research, competitor gap, AI visibility checks and rank tracking.
* **Store chatbot** (optional, off by default) — answers your shoppers about your products, stock and your own shipping/returns policies.

= Free local features =

These run on your own hosting and never contact our servers: SEO status of every product, product and category schema, redirects (301/302/410) and 404 monitoring, broken-link checks, orphan products, llms.txt and AI-crawler rules, noindex for system pages, Open Graph and canonical tags, the SKU generator preview, image compression preview and backups. Works alongside Yoast SEO and Rank Math, or on its own.

= How pricing works =

AI features run on the RankX service and use credits. Connecting your store gives you 10 free optimizations. More credits can be bought from inside the plugin; payment is completed on rankxseo.com by secure online payment. Some local batch features (applying product URL changes, compressing images, writing SKUs, importing FAQs) also use a small number of credits per batch.

= بالعربية =

إضافة RankX SEO تحسّن متجر ووكومرس لجوجل ولإجابات الذكاء الاصطناعي: تكتب وصف المنتجات وعنوان الميتا ووصفها والأسئلة الشائعة والوسوم ونص ALT للصور، وتعرض لك النتيجة قبل/بعد، ولا تكتب شيئاً في متجرك إلا باعتمادك (أو حين تفعّل الوضع التلقائي بنفسك).

الواجهة بلغة لوحة كل مستخدم (عربي أو إنجليزي)، والمحتوى المولَّد بلغة متجرك. ميزات الذكاء الاصطناعي تعمل على خدمة RankX وتستهلك نقاطاً، ومع الربط تحصل على 10 تحسينات مجانية.

== Installation ==

1. Install and activate WooCommerce.
2. Upload the `rankx-seo` folder to `/wp-content/plugins/` (or install the zip from Plugins → Add New), then activate it.
3. Open the "RankX SEO" menu and click "Connect your store". Nothing is sent to the RankX service before this step.
4. Optimize a product, review the before/after, and approve it.

== External services ==

This plugin connects to the following services. No request is made to any of them before you take the action described.

= RankX API (rankxseo.com) =

The RankX service generates the content and runs the analyses behind the AI features.

* **When:** only after you connect your store ("Connect your store"), and then only when you use a feature that needs it (optimize, research, audit, blog writer, insights, SEO impact, assistant) or when you turn on a scheduled job yourself (Auto mode, weekly rank tracking, the weekly report's balance check).
* **What is sent:** when connecting — your site URL, site name and the email you enter. For each feature — the content it works on: product names, descriptions, short descriptions, categories, tags, regular prices, attributes and image URLs; category/brand names and descriptions; the keyword and market country you choose; your site URL and public page URLs for audits; the site language and the admin's interface language. The store chatbot sends the shopper's question, the short conversation history and matching product data. Your connection key is sent with every request.
* Terms of use: https://rankxseo.com/en/terms
* Privacy policy: https://rankxseo.com/en/privacy

= Google (Search Console, Analytics) =

Used by "SEO impact" to show clicks, impressions, position and organic sales before and after each optimization.

* **When:** only if you click "Connect Search Console and Analytics". You sign in with Google and grant read-only access; the connection is handled by the RankX service, and you can disconnect at any time.
* **What is read:** Search Console performance data and Analytics reports for the property you select, for the pages RankX optimized.
* Google Terms of Service: https://policies.google.com/terms
* Google Privacy Policy: https://policies.google.com/privacy

= IndexNow (api.indexnow.org) =

Tells search engines that support IndexNow (such as Bing) when a product, category or post is published or updated.

* **When:** only if you turn on "IndexNow" in RankX SEO → Technical settings (off by default), and not when Rank Math already does it.
* **What is sent:** the public URLs that changed, your site's host name and the IndexNow key file URL.
* Terms and documentation: https://www.indexnow.org/terms

= Your own links (broken-link check) =

The daily broken-link check (can be turned off in Technical settings) sends a HEAD request to the links found inside your product descriptions and posts, to see whether they still work. No site data is sent.

= Payments =

Buying credits or chatbot packs opens a checkout page on rankxseo.com; the plugin itself never talks to a payment provider. See the RankX terms and privacy policy above.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes, WooCommerce must be installed and active.

= Is it free? =

The local features listed above are free and run on your own hosting. AI features (writing and research) run on the RankX service and use credits; connecting your store gives you 10 free optimizations to start.

= Does it work in English? =

Yes. The interface follows each admin's WordPress profile language (Arabic or English), and generated content follows your site's language, so an English-speaking admin on an Arabic store still gets Arabic content.

= What happens to my previous product content? =

Before writing new content, the plugin backs up the previous description and meta fields to post meta (`_rankx_backup`) so it can be restored with one click. The backups are kept if you uninstall the plugin.

= Does it work with Yoast SEO or Rank Math? =

Yes. If either plugin is active, RankX SEO writes the meta title/description and focus keyword into that plugin's own fields and steps aside where they already output schema or redirects. If neither is active, RankX SEO outputs the meta tags itself.

= Is anything written to my store without my approval? =

No. Manual optimization always shows a before/after preview first. Auto mode only runs if you turn it on, and its first batch waits for your review.

== Screenshots ==

1. Overview — your store's SEO score, the issues found and the top three steps.
2. Products — before/after preview of an optimized product.
3. Auto mode — operations, limits and the live activity log.
4. SEO impact — Google clicks and position before and after each optimization.
5. Technical audit — findings by section with how to fix them.
6. Image compression — sizes, estimated savings and one-click restore.
7. Blog writer — keyword, supporting keywords and related products.
8. Store chatbot — settings and the shopper preview.

== Changelog ==

= 0.25.6 =
* Auto mode: once credits run out it really stops — no paid call on each tick until the balance is back (a top-up resumes it on the next tick), an item refused for credits keeps its turn instead of waiting a week, a blog keyword is no longer lost, and every "Skipped" row in the log says why.

= 0.25.5 =
* Products table: a "✨ Optimized … ago" stamp under the SEO status tells apart the products RankX wrote (hover for the date and count); the Optimize button stays for a second pass.

= 0.25.4 =
* Bulk optimize: the batch is driven from the open admin page instead of waiting for WP-Cron (one product every ~15-20 seconds instead of one per minute), a reply lost in transit is fetched again at no cost, and a product whose background action was killed is retried once.

= 0.25.3 =
* Content language: a dropdown in the header lets you pin generated content to Arabic or English (default: the site language). The FAQ heading written into descriptions follows it.

= 0.25.2 =
* Auto mode history now shows actual image compression credit charges and before/after sizes, with clearer skip reasons. Activity and IndexNow histories show ten entries per page.

= 0.25.1 =
* Directory readiness: no request to the RankX service before the store is connected, IndexNow is now opt-in, safer file handling, input sanitization, and a complete readme with the external services disclosure.

= 0.25.0 =
* Full English interface; Arabic is now a bundled translation. The admin language follows each user's WordPress profile language, and generated content keeps following the site language.

= 0.24.0 – 0.24.3 =
* Pay-as-you-go credits for local batch features, a working product/category schema switch, one FAQPage per page, and rank tracking with a free weekly check.

= 0.19.0 – 0.23.1 =
* Market country for all research, keyword volume in the blog writer, one visual identity across sections, a motivating overview, rank tracking as its own section, tags/FAQs/AEO as Auto mode operations, store chatbot conversation packs, and a clearer Auto mode switch.

= 0.14.0 – 0.18.6 =
* "Ask the SEO expert" assistant, Reports & alerts with a weekly email, store chatbot for shoppers, sold-out product alternatives, pro services, removing images from descriptions, and many chatbot fixes.

= 0.9.0 – 0.13.1 =
* SEO insights (Google position, competitor gap, keyword radar, AI visibility, rank tracking), tags, clearer product names, optimization modes, AEO optimization, SKU generator, and product table filters.

= 0.5.0 – 0.7.1 =
* SEO impact verdicts and recommendations, optimization for a target keyword, and FAQs written into the visible description with schema read from it.

= 0.4.0 – 0.4.3 =
* Full SEO overview report, Auto mode with gradual trust mode, first-run wizard, ten free local technical features, PNG to WebP conversion, and orphan products.

= 0.3.0 =
* SEO impact with Google Search Console and Analytics, free local image compression with backups, the technical audit, and credit packs.

= 0.2.0 =
* Categories, brands, image ALT text, keyword research and the blog writer; background bulk optimization; FAQPage and article schema.

= 0.1.0 =
* Initial release.

== Upgrade Notice ==

= 0.25.2 =
Shows compression credit charges and size savings, and adds pagination to activity and IndexNow histories.

= 0.25.1 =
Adds an English interface, makes IndexNow opt-in and hardens security for the WordPress.org directory.
