=== Farsisanj ===
Contributors: ameridev
Donate link: https://rezaameri.com/
Tags: persian, seo, content analysis, eeat, سئو
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv3

Farsisanj is a WordPress plugin for analyzing the quality of Persian content and evaluating E-E-A-T criteria with the help of artificial intelligence.

== Description ==

**Farsisanj**
Farsisanj is a tool for reviewing and improving the quality of Persian content in WordPress. Using artificial intelligence, it analyzes selected content and provides a report along with practical suggestions for improving content quality.
This plugin is designed for site administrators, content creators, SEO specialists, and website owners who want to review the quality of their Persian content before publishing or during the update process.

= Features =
* Analysis of Persian content quality
* Evaluation of criteria related to E-E-A-T
* Scoring and analytical reporting
* Content improvement suggestions
* Connection to an AI service via API
* Persian user interface
* Ability to manage AI service connection settings

= Functionality =
The user selects the content they want to analyze. The plugin sends the analysis request to the configured AI service and displays the analysis result in the WordPress dashboard.
Farsisanj requires a corresponding API service to perform AI analyses. The cost and terms of use of the AI service, if any, are determined by the API service provider and are not set by Farsisanj.

= Privacy =
To perform AI analysis, the content selected by the user for analysis may be sent to the configured API service.
Farsisanj must not send any information outside the scope required for the analysis process without the user's knowledge.
The type of data sent and how it is processed depend on the AI service and the settings chosen by the user. Users should review the terms and privacy policy of the relevant API service provider before using the API service.
Farsisanj connects to external services to function. Details of the services used and the data sent must be specified in the plugin documentation and the relevant settings page.

== Installation ==

1. Install the plugin from the WordPress repository or upload the plugin ZIP file.
2. Activate the plugin from the **Plugins** section in your WordPress dashboard.
3. Go to **Settings → FarsiSanj** in your WordPress dashboard to configure the plugin.
4. Enter the required AI service, API key, model, and connection settings, then save your settings.
5. To analyze the content of a post or page, open the **Edit Post** or **Edit Page** screen in WordPress.
6. Scroll down below the main content editor to find the **FarsiSanj** analysis box.
7. Click **Analyze Content** to analyze the post or page and view the E-E-A-T analysis results.

== Frequently Asked Questions ==

= Does Farsisanj work without an AI API? =
No. A connection to the API service is required.

= Is Farsisanj designed only for Persian content? =
Farsisanj is designed with a focus on analyzing Persian content.

= Is site information sent to an external server? =
When using AI-based features, the data required to perform the analysis is sent to the configured API service. Details of the data sent should be reviewed in the settings and documentation of the relevant service.

= Do I have to pay to use the API? =
This depends on the API service provider. Farsisanj does not determine the cost of external services used for AI analysis.

= Is Farsisanj a substitute for an SEO specialist? =
No. Farsisanj is an auxiliary tool for content analysis and improvement, and its results should not be considered a substitute for expert judgment.

= Why does Farsisanj connect to AI providers directly instead of the WordPress core AI Client? =
Farsisanj lets the site administrator choose from several providers, including regional providers used by Persian-language sites (such as GapGPT) that are not part of the WordPress core AI Client's built-in provider list, as well as a custom endpoint option. Direct integration keeps this provider flexibility for now; this may be revisited as the core AI Client's provider coverage grows.

== External services ==

Farsisanj connects to an AI service to analyze the Persian content selected by the site administrator or content editor and to return a quality/E-E-A-T report with improvement suggestions. No content is sent automatically; a request is only made when a user explicitly runs the analysis from the plugin's metabox or settings page, and only the content selected for analysis (plus the configured instructions) is transmitted. The site administrator chooses one of the following providers in the plugin settings and supplies their own API key for that provider; Farsisanj does not operate its own server and does not store the content sent.

This plugin supports the following third-party AI providers. Only the provider selected and configured by the site administrator is contacted; the others are inactive unless chosen.

* **GapGPT** — used to run the Persian content analysis when GapGPT is selected as the provider. The post/page content selected by the user is sent to GapGPT's chat completion API together with the analysis instructions. [Terms of Service](https://gapgpt.app/rules) | [Privacy Policy](https://gapgpt.app/privacy)
* **Google Gemini (Generative Language API)** — used to run the Persian content analysis when Google Gemini is selected as the provider, and to validate the API key when the "Test connection" button is used. The post/page content selected by the user is sent to Google's Generative Language API together with the analysis instructions. [Terms of Service](https://ai.google.dev/gemini-api/terms) | [Privacy Policy](https://policies.google.com/privacy)
* **OpenAI (or an OpenAI-compatible endpoint)** — used to run the Persian content analysis when the "ChatGPT (OpenAI Compatible)" provider is selected. The post/page content selected by the user is sent to the OpenAI chat completions API together with the analysis instructions. [Terms of Service](https://openai.com/policies/business-terms/) | [Privacy Policy](https://openai.com/policies/row-privacy-policy/)
* **Anthropic** — used to run the Persian content analysis when Anthropic is selected as the provider. The post/page content selected by the user is sent to the Anthropic Messages API together with the analysis instructions. [Terms of Service](https://www.anthropic.com/legal/commercial-terms) | [Privacy Policy](https://www.anthropic.com/legal/privacy)
* **OpenRouter** — used to run the Persian content analysis when OpenRouter is selected as the provider. The post/page content selected by the user is sent to the OpenRouter chat completions API together with the analysis instructions. [Terms of Service](https://openrouter.ai/terms) | [Privacy Policy](https://openrouter.ai/privacy)
* **Custom endpoint** — if the site administrator selects "Custom" and enters their own OpenAI-compatible endpoint and API key, the same post/page content is sent to that self-specified endpoint instead. The administrator is responsible for reviewing the terms and privacy policy of any custom endpoint they configure.

== Screenshots ==
1. AI service connection settings page
2. Persian content analysis page
3. Analysis report and score
4. Content improvement suggestions

== Changelog ==

= 1.0.0 =
* Initial release

== Upgrade Notice ==

= 1.0.0 =
* First release of Farsisanj for analyzing the quality of Persian content and evaluating E-E-A-T criteria with the help of artificial intelligence.
