=== DeepFA AI ===
Contributors: arminhsa11
Tags: ai, content writer, seo, persian, woocommerce
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 2.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI for WordPress and WooCommerce: articles, a Persian editor, smart search, SEO on publish, internal links, Telegram and Bale posts, product photos.

== Description ==

DeepFA AI brings the DeepFA models into the WordPress dashboard, in Persian or English, and takes over the jobs that eat a site owner's time. Much of it can run on its own: automatic jobs only fill what is empty and never replace what a person wrote.

= In the block editor =

* Write a whole article from a topic and keywords: the outline, each section, questions and answers and a conclusion, written step by step so a long article never times out.
* Title ideas, the excerpt, an SEO title and meta description, and tags.
* Questions and answers written from the post, added to its end with the FAQ structured data search engines read.
* Internal links: related posts suggested on words already in the text, added with one click.
* A featured image made from the post, and an audio version with a player shown on the post.
* Translate a post into English or Persian as a new draft.
* A DeepFA AI menu on every paragraph, heading and list item: improve, shorten, expand, fix spelling and grammar, simplify, change the tone, translate or continue writing.
* The Persian editor: half spaces, the Persian letters ی and ک, Persian punctuation and quotation marks tidied by rules, for free; or the whole post proofread by AI for spelling and grammar too. Also for many posts at once from the post list, or on every save.
* Key takeaways: three to five short points in a box at the top of a post, so readers and search engines see at once what it says.

The classic editor gets the same jobs in a box under the editor.

= In Elementor =

* On the Heading, Text Editor and Button widgets: describe what the text should say and it is written, or improve, shorten, expand, correct, simplify, change the tone or translate the text that is there.

= On its own =

* SEO on publish: when something is published, its excerpt, SEO title and meta description, tags and image alt text are filled in if they are empty, and questions and answers and internal links can be added.
* Content calendar: a month of article topics planned from what your site is about, avoiding what it already covers, then written on their dates. It can plan and schedule every month by itself.
* Content health: a report of what each published post is missing, filled in for the posts you tick; a few of the oldest posts can be refreshed every week.
* Internal links for the whole site: every published post linked to the posts most related to it, in the background, and all of it can be taken out again.
* Comments: each new comment or product review labelled as a question, praise, a complaint, spam or abuse; spam moved to the spam folder, and replies suggested or posted to questions and praise.
* Articles from podcasts and videos: open an audio or video file in the media library and get an article from it as a draft.
* Telegram and Bale: each new post sent to your channels a couple of minutes after it is published, with its featured image, title, a short teaser and the link.
* Smart search: the site's own search finds posts by meaning as well as by words, and can show a short answer written from your pages, linking to them, above the results.

= WooCommerce =

* Product descriptions, short descriptions, SEO titles and product images, one product at a time, in bulk, or on their own for every new product.
* Product photos put on a clean white background or a styled scene.
* A short video made from the product photo, shown under the product images.
* A summary of what buyers say, shown above the reviews.
* Advert photos: the product photo set in a scene - a studio backdrop, marble, a wooden table, a kitchen, nature, the beach and more.
* Buying guides, comparisons and lists of the best that recommend products from your own store and link to them.

= Cost and control =

* The DeepFA balance in the admin bar, an email before the credit runs out, and a monthly ceiling for automatic jobs.
* Each model's price shown beside it in Settings, and an estimate before every bulk job.
* Which roles may use which tools: writing, SEO, images and audio, the store, and comments.
* A dashboard of the credit used this month, by job and by who started it.
* A step-by-step guide with pictures inside the plugin, also as a PDF in Persian and English.
* Dates in the plugin's pages follow the site's Persian date plugin, Parsi Date or WP-Jalali.

SEO titles and meta descriptions go into Yoast SEO, Rank Math or SEOPress when one of them is active.

The plugin is free. It uses the DeepFA API and is paid for from your DeepFA credit; the cost of each job is shown as it is done and kept in the usage log. Every automatic job is off until you switch it on.

== Installation ==

1. In WordPress, go to Plugins → Add New, search for "DeepFA AI", then install and activate it. Or download the zip from deepfa.ir and use Upload Plugin on the same screen.
2. Make an API key in your DeepFA panel: https://deepfa.ir/app/user/api-platform
3. Enter the key in DeepFA AI → Settings → Connection, save, and press "Check the key".
4. Switch on the jobs you want to run on their own in DeepFA AI → Settings → Automatic, Comments and Store, and set a monthly ceiling in Budget.

== External services ==

This plugin uses the DeepFA API at https://deepfa.ir/api/v1 to write text, make images, speech and videos, describe and edit images, turn audio into text and compare texts. It sends only what the job in hand needs:

* the topic, keywords and notes you type, and what you wrote about your site for the content calendar;
* the title and content of the post or product being worked on, and, for internal links, the text of your published posts;
* the image, for alt text and for putting a product photo on a new background; for a product video, the address of the product photo, which DeepFA fetches from your site;
* the text of a comment or product review, to label it and write a reply, and the approved reviews of a product, for their summary;
* the audio or video file you choose, to write an article from it;
* for smart search, what a visitor types into the site's search, and for its short answer, the text of the pages found;
* for a channel post written by AI, the title and content of the post.

It is sent when you use one of the plugin's features, and also when an automatic job you switched on runs: when something is published, when a comment arrives, once a week for content refresh, once a month for the content calendar, or for alt text on new uploads. While the admin bar shows the balance, the plugin asks the API for it at most every fifteen minutes. Each request also carries the plugin's version and your site's address, so DeepFA can show you which of your sites used your credit. If you set a chatbot ID, the chatbot script is loaded from https://deepfa.ir on the pages of your site. Nothing is sent before you enter an API key.

If you enter a bot token and a channel in Settings → Channels, each new post of the types you choose is sent, a couple of minutes after it is first published, to that channel through the messenger's official bot API: its title, a short teaser, its address and, if you ask for it, its featured image. Nothing is sent to a messenger you have not set up.

* Telegram Bot API, https://api.telegram.org - Terms of service: https://telegram.org/tos, bot developer terms: https://telegram.org/tos/bot-developers, privacy policy: https://telegram.org/privacy
* Bale bot API, https://tapi.bale.ai - Terms of use, privacy included: https://bale.ai/terms

* Terms of use: https://deepfa.ir/terms-and-conditions
* Privacy policy: https://deepfa.ir/privacy-policy

== Frequently Asked Questions ==

= Is the plugin free? =

Yes. The plugin is free; the text, images and audio it makes are paid for from your DeepFA credit, and the cost of each job is shown as it is done.

= Do I need an account? =

Yes. Make a DeepFA account, then an API key in the DeepFA panel, and enter the key in DeepFA AI → Settings.

= Will it spend credit without me knowing? =

Only on what you switch on. Every automatic job is off until you turn it on, a monthly ceiling stops automatic jobs once they reach it, and you are emailed when the credit falls below the warning line you set.

= Does it write in Persian? =

Yes. Articles, rewriting, SEO text and product descriptions can be written in Persian or English, and the plugin itself is translated into Persian.

= Does it work with a Persian date plugin? =

Yes. The dates in the plugin's pages, such as the content calendar, follow Parsi Date or WP-Jalali, so a Persian site sees them in the Jalali calendar.

= Does it work with Elementor? =

Yes. When Elementor is active, the Heading, Text Editor and Button widgets get a DeepFA AI box at the top of their panel. It can be switched off in Settings → Features.

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

Yes. The SEO title and meta description are written into Yoast SEO, Rank Math or SEOPress when one of them is active.

= Do I need WooCommerce? =

No. The WooCommerce tools appear only when WooCommerce is active; everything else works on any WordPress site.

= Automatic jobs do not run. Why? =

They run on WordPress's scheduler, which is started by visits to the site (and on Action Scheduler when WooCommerce is active). If DISABLE_WP_CRON is set in wp-config.php, add a real cron job for wp-cron.php on the server.

== Screenshots ==

1. The block editor sidebar: a whole article, the SEO title and meta, and tags.
2. The rewrite menu on any paragraph.
3. Write an article: from a topic to a finished post, with the total cost.
4. Bulk articles: the background queue and scheduled publishing.
5. Dashboard: the balance, the credit used this month, the monthly ceiling, and every job with who started it.
6. The audio version on the post itself.
7. Settings: the key, and each model with its price.
8. WooCommerce: a product image made and set as the main image.
9. WooCommerce: bulk writing from the product list, with each product's status.
10. Content calendar: a month of topics with their keywords and dates, and what writing them will cost.
11. Automatic: what is filled in when something is published, weekly refresh and the monthly calendar.
12. Internal links for the whole site, and the links added lately.
13. Content health: what each post is missing, filled in for the posts you tick.
14. Comments labelled by AI, with a suggested reply to edit and post.
15. WooCommerce: the product box writing a description, with a clean photo background and a short video a click away.
16. Questions and answers and internal links in the editor sidebar.
17. The Persian editor and key takeaways in the editor sidebar.
18. Elementor: a heading written from the widget's panel.
19. Smart search: a short answer from the site's own pages above the results.
20. WooCommerce: an advert photo of the product in a scene.
21. A buying guide that recommends products from the store.
22. Channels: new posts sent to Telegram and Bale.

== Changelog ==

= 2.2.0 =
* The Persian editor: half spaces, ی and ک, Persian punctuation and quotation marks tidied for free by rules, or proofread by AI; in the editor, for many posts at once, or on every save.
* Key takeaways at the top of a post, from the editor or on publish.
* Elementor: write or rewrite the text of Heading, Text Editor and Button widgets from their panel.
* Smart search: the site's search finds posts by meaning, with an optional short answer above the results.
* Telegram and Bale: new posts sent to your channels with their featured image, title, teaser and link.
* WooCommerce: advert photos of a product in ten scenes.
* Write an article: buying guides, comparisons and lists of the best that recommend and link your own products.
* Dates in the plugin's pages now follow WP-Jalali as well as Parsi Date.

= 2.1.1 =
* Content calendar: on sites that show dates in another calendar, such as the Persian (Jalali) calendar through a date plugin, the planned dates no longer go wrong, and each date is chosen from the month's days as the site shows them.

= 2.1.0 =
* SEO on publish: the excerpt, SEO title and meta description, tags and alt text are filled in when something is published, only where they are empty; questions and answers and internal links can be added too.
* Questions and answers with FAQ structured data, in the editor and on publish.
* Internal links: suggested in the editor, or added to the whole site in the background, and removable in one go.
* Content calendar: a month of topics planned from what the site is about, written on their dates, and optionally planned every month by itself.
* Content health: a report of what each post is missing, with fill-in and weekly refresh of old posts.
* Comments: labels for new comments and reviews, spam to the spam folder, and suggested or automatic replies to questions and praise.
* Articles from podcasts and videos in the media library.
* WooCommerce: product text written on its own for new products, photos on a clean background, short product videos from the photo, and a summary of the reviews.
* Budget: the balance in the admin bar, a low-credit email, a monthly ceiling for automatic jobs, and cost estimates before bulk jobs.
* Each model's price shown beside it in Settings, with the least expensive one recommended.
* Access: choose which roles may use which tools.
* A guide with pictures inside the plugin, also as a PDF in Persian and English.
* Bulk articles: scheduled dates now follow the site's time zone.
* Requests to DeepFA keep their time limit when another plugin or the host shortens outgoing requests, so a long answer is no longer lost after it was made.
* Model and voice names now read correctly in Persian in Settings.

= 2.0.1 =
* With the text model on Automatic, the plugin now writes with the least expensive text model your key allows, rather than the first one on the list.
* Settings: "Buy API credit" opens the DeepFA API credit packs, which give the plugin more credit for the same money than a prepaid pack.

= 2.0.0 =
* A complete WordPress plugin: articles, rewriting, SEO, tags, featured images, alt text, audio versions, translation, bulk articles, the chatbot and a usage dashboard, alongside the WooCommerce tools.

= 1.0.0 =
* First release, for WooCommerce products.

== Upgrade Notice ==

= 2.2.0 =
A Persian editor, key takeaways, Elementor, smart search, Telegram and Bale posts, advert photos and buying guides. Every new automatic job stays off until you switch it on.

= 2.1.1 =
Fixes the content calendar's dates on sites that show the Persian (Jalali) calendar.

= 2.1.0 =
SEO on publish, FAQ schema, internal links, a content calendar, content health, comment replies, product photos and videos, and budget controls. Every automatic job stays off until you switch it on.

= 2.0.1 =
Automatic now picks the least expensive text model, so a store that never chose one stops paying for the dearest.
