=== BazSite AI Tools ===
Contributors: bazsite
Tags: ai, calculator, trip planner, lead generation, chatbot alternative
Requires at least: 6.2
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 0.2.24
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

AI advisors, trip planners and calculators for your visitors, answering from your own content. Free calculators, credits for AI tools.

== Description ==

**BazSite AI Tools** puts ready-made, interactive AI tools on your WordPress pages. A visitor answers a short form and gets a real, personal answer: a marketing plan, a trip itinerary on a map, a gift idea from your shop, or an exact mortgage calculation. Every answer can link to your own pages and products, and every visitor who leaves an email becomes a lead.

Unlike a chatbot, each tool asks the right questions, gives a structured answer and never wanders off topic. Unlike a form builder, it actually answers.

= What your visitors get =

* **Advisors and plans**: a business plan, a marketing plan, a Google Ads plan, an event plan, "what fits me?" and more. The visitor picks a goal, answers only the questions that fit it, and gets a clear plan with steps and tables.
* **A trip planner with a map**: a day-by-day route built only from the places on your site, with times, travel times and a map. Distances are calculated, never guessed.
* **Calculators**: mortgage, loan, savings, calories and BMI. Worked out exactly by formula, not by AI, instantly.
* **Product finders**: recommendations from your posts, pages and WooCommerce products, with links to them.
* **"My plans"**: every answer is kept in the visitor's account on your site, ready to read again, print or save as PDF.

= What you get =

* **Leads**: visitors may leave their email to get the answer by email. You get each lead by email and in the plugin's Leads screen, with their answers.
* **Your content, your rules**: choose exactly what the tools may read (everything, some post types, some categories or single posts). Drafts, private pages, users and orders are never sent.
* **Your look**: tools take your theme's colors and fonts, and fit any layout on desktop and mobile.
* **Easy to place**: a block for the block editor, an Elementor widget and a shortcode (`[bazsite_tool id="..."]`).
* **A growing library**: pick tools from BazSite's library and add them with one click. New tools are added to the library over time.
* **Languages**: English and Hebrew included, and the tools answer in your site's language. Works with WPML and Polylang.

= Free and paid =

The plugin is free, and opening a BazSite account is free.

* **Free**: the calculators (mortgage, loan, savings, calories and BMI) and the plugin's features: the block, the widget, the shortcode, "My plans" and the Leads screen.
* **Paid (AI tools)**: advisors, trip planners and product finders run on BazSite's AI and use credits. Each answer uses a few credits, by its real size. Take a plan, monthly or yearly, which includes credits every month or every year, and buy credit packs on top when you need more (packs never expire). Prices are shown in the plugin's Settings before you buy.

You only pay for answers that reached your visitors. There is no separate "pro" version of the plugin: every site gets the same plugin, and the AI answers are a service.

= How it works =

The plugin is a light client. The AI, BazSite's tool library and the credits live on BazSite's servers (see "External services" below). Your WordPress server talks to BazSite with the site's own key, never from a visitor's browser, so the key is never exposed. The tool's script and styles load only on pages that show a tool.

== Installation ==

1. In your WordPress admin, go to **Plugins → Add New**, search for "BazSite AI Tools", then install and activate it. (Or upload the zip in **Plugins → Add New → Upload Plugin**.)
2. Open **BazSite AI** in the admin menu and click **Connect to BazSite**. Sign in to BazSite, or open a free account, and approve the connection.
3. In the **Tools** tab, add tools from the library.
4. In **Settings → What the tools may read**, choose the content the tools may use (or "Nothing for now").
5. Put a tool on a page: add the **BazSite AI tool** block, Elementor's **BazSite AI tool** widget, or paste the tool's shortcode from the Tools tab.
6. Optional: to keep visitors' answers in their account, turn on WordPress's **Settings → General → Anyone can register** (the plugin offers a button for it) and add the "My plans" page to your menu.

== Frequently Asked Questions ==

= Do I need a BazSite account? =

Yes. The account is free and opens in a minute from the plugin's Connect button. It holds your credits and your site's tools.

= What is free and what costs money? =

The calculators are free, without limit. AI tools (advisors, trip planners, product finders) use credits, from a monthly or yearly plan and from credit packs. You see the prices in the plugin's Settings before you buy.

= How much does one answer cost? =

It depends on the tool and on the answer's length: a short recommendation uses a few credits, a full business plan uses more. The Settings tab shows the credits used this month.

= Can a tool make up facts about my business? =

No. A tool answers from the content you shared and the settings you chose, it links only to your own site's pages, and it never invents reviews, prices or opening hours.

= Does it slow my site down? =

No. The tool's script and style load only on pages that show a tool, answers are prepared on BazSite's servers, and your content is sent in small batches in the background.

= What happens when I change a post or a product? =

The change is sent to BazSite a few seconds later, and once a night the plugin checks that everything matches.

= Does it work with WooCommerce? =

Yes. Products can be shared with their price, categories and attributes, so a tool can recommend them and link to them.

= Does it work with Elementor and page builders? =

Yes: there is an Elementor widget, a block for the block editor, and a shortcode for any other builder.

= Where are visitors' answers kept? =

On your own site, as private posts in the visitor's account ("My plans"), and they are included in WordPress's Export / Erase Personal Data tools. A guest who typed an email gets the answer by email, with a link that keeps it in their account once they sign in. Unclaimed answers are deleted after 30 days.

= Can visitors use a tool without signing in? =

Yes. You choose per tool: open to everyone, or the visitor leaves an email first.

= In which languages does it work? =

The plugin's screens are in English and Hebrew. The tools answer in the site's language, and in each page's language with WPML or Polylang.

= What happens when I disconnect or delete the plugin? =

Disconnecting stops the tools and cancels the site's key on BazSite. Deleting the plugin also removes its settings, its cache and the visitors' answers it kept.

== Screenshots ==

1. An advisor's answer on a page: a personal marketing plan (an example answer).
2. A trip planner on a page: a few questions, then a day-by-day route on a map from your own places.
3. A mortgage calculator's answer: exact, instant and free.
4. BazSite's tool library: add a tool to your site with one click.
5. A tool's settings: who may use it, limits, what it reads and your own notes.
6. Leads: every visitor who left an email, with their answers.
7. Settings: credits, the monthly and yearly plans and credit packs, and what the tools may read.
8. Connecting the site to a free BazSite account.

== External services ==

This plugin connects to BazSite (https://bazsite.com), a service run by the plugin's authors, to run the AI tools. Without it the tools cannot work.

What is sent, and when:

* **Connecting** (when an administrator clicks "Connect to BazSite"): the site's address, name and language are sent, and the administrator signs in to BazSite in their own browser to approve. BazSite returns a key that is stored in this site's options.
* **Content you choose to share** (only after an administrator picks content in "Settings → What the tools may read", then on every change to that content and once a night): for each published item of those types, its title, address, a short plain text, region, price and map location. Drafts, private and password-protected content, users, comments and orders are never sent. A developer can keep any other post out with the `bazsite_ai_share_post` filter.
* **A visitor's run of a tool** (when a visitor submits a tool's form): their answers, the email they typed if the tool asks for one, the page language, and a one-way hash in place of their IP address. This is sent from your WordPress server, never from the visitor's browser.
* **Buying credits or a plan** (when an administrator clicks a buy button in Settings): the chosen pack or plan and the admin's language are sent to BazSite, which opens its payment page in a new tab. Payments in dollars are handled by Paddle (https://www.paddle.com, terms: https://www.paddle.com/legal/terms, privacy: https://www.paddle.com/legal/privacy), payments in shekels by SUMIT (https://www.sumit.co.il). The card is typed only on their page.
* **Checking for updates** (only in the copy downloaded from bazsite.com; the WordPress.org copy is updated by WordPress itself): twice a day the plugin asks BazSite which version is the newest. Only the site's address and the plugin's version are sent.
* **Tool settings** (when an administrator adds, changes or removes a tool) and the tool library and leads lists (when the plugin's screens are opened).

Disconnecting in the plugin, or deleting the plugin, cancels the site's key on BazSite.

What is kept on your own site: when "My plans" is on, a tool's answer is saved on this site as a private post for the signed-in visitor, or, for a guest who typed an email, with that email until they claim it from the link in their email (unclaimed answers are deleted after 30 days). These are covered by WordPress's own "Export / Erase Personal Data" tools. Visitors' emails with an answer go out from this site through wp_mail, in the site's name.

BazSite terms of use: https://bazsite.com/en/terms
BazSite privacy policy: https://bazsite.com/en/privacy

== Changelog ==

= 0.2.24 =
* The plugin's screens show tool names and texts in the WordPress admin's own language.
* Sites in several languages (WPML, Polylang): each tool's name and intro can be set for every language of the site, with a "Translate into all the site's languages" button.
* WPML's "all languages" view no longer sets the site's language to English on BazSite.

= 0.2.23 =
* A new look for the plugin's screens: a header with the logo, pill tabs, cards, clearer buttons, a designed leads table and tidier settings.
* A tool's box opens and closes with a short slide, and shows at a glance whether the tool is on and whether it collects leads.
* The header shows the installed version beside the latest one. When a newer version is out: "Update now" (one click) or a download of the zip, with what's new. The plugin learns of a new version as soon as Settings is opened, and the update button works at once.

= 0.2.22 =
* The AI tools plan paid in shekels renews by itself now, like the dollar plan. Settings shows its renewal date and a button to manage or cancel it in your BazSite account.

= 0.2.21 =
* My plans: on a WooCommerce site, the visitor's AI answers are added by themselves at the end of the "My account" page. No code to paste.

= 0.2.20 =
* Tools: on a site in more than one language (Polylang, WPML), the answer comes in the language of the page the tool is on, like its form. A page in a language the tool doesn't have yet gets it translated.

= 0.2.19 =
* Tools: "Explain it to me" shows its message under the answer (it showed nothing when the explanation couldn't be written).
* Tools: the site's admin, signed in, sees plainly when the AI credits ran out or the tool can't run, with a link to the settings. Visitors never see it.
* Tools: a choice made in a form drawn before the tool's translation was ready is still understood (it came back as "please answer the marked questions").

= 0.2.18 =
* Settings: credit packs open only after the AI tools plan (yearly or monthly); until then they are shown off with a note.
* Settings: prices always with a dot and only the digits needed (7, 7.5, 59.9), and the plan buttons read "Yearly $59 a year · 500 credits".
* Settings: the free credits the account got to start are shown next to the balance.
* Content: a site that connects starts with "Everything on the site" for the tools to read (only public text; can be changed or turned off).
* My plans: the visitors' "My plans" page is made by itself when the plugin is turned on. On a WooCommerce site the code is shown to paste into its "My account" page instead.

= 0.2.17 =
* Connect: "Connect to BazSite" opens in a new tab, and this screen refreshes by itself when you come back.

= 0.2.16 =
* Tools: "Design your own AI tool" for accounts with the AI tools plan: describe the tool in your words, BazSite's AI builds it, then change it with notes as often as you like. Each design or change is paid from your credits.
* Library: every tool shows whether it is free to run or about how many credits a run takes.
* Credits: a new account gets welcome credits to try the AI tools. When credits run low or run out, the owner gets an email, and visitors see a short note with a way to leave their email instead of an error.

= 0.2.15 =
* Settings: credit prices follow the site's language: shekels (paid through SUMIT) on a site in Hebrew, dollars (paid through Paddle) on any other.
* Admin: the "not connected" notice on the Dashboard and Plugins screens can be closed.
* Settings: the AI tools plan comes monthly or yearly, each with its credits. A site in Hebrew pays in shekels (one payment for the period), any other in dollars (renews by itself).
* Readme: a full description, installation steps, FAQ and screenshots, ready for WordPress.org.

= 0.2.14 =
* Updates: "Check again" on the Updates screen asks BazSite at once.
* Answers: a visitor who isn't signed in gets a "Save to my account" button under the answer (sign in or open an account, and the answer is kept there), next to the same link in the mail.
* Mails: the plugin's mails go out in the site's name instead of "WordPress" (a sender name set by an SMTP plugin is kept).
* My plans: the sign-in and create-account buttons are the same size and readable on every theme.

= 0.2.13 =
* My plans: a signed-in visitor sees "Hello", can change their name and password and can sign out, on sites without WooCommerce's account page.
* Updates: when a new version is out, the plugin's screen and the Dashboard say so with an "Update now" button, and WordPress's Plugins screen offers the update like any other.

= 0.2.12 =
* Settings: the yearly plan (AI tools for a year, credits included; calculators are always free) and credit packs in dollars, once BazSite opens payments in dollars. Paid through Paddle, who sends the invoice.

= 0.2.11 =
* Settings: a credit pack goes straight to its payment page, with no BazSite log-in on the way. Back from paying, the page says the credits were added.

= 0.2.10 =
* Not connected yet: the notice shows once, only on the Dashboard and Plugins screens; the connect card says which tools are free and which use credits.

= 0.2.9 =
* Leads: "Show all" opens and closes with a short animation.
* Content: the "choose by kind of content" option has no "(for site builders)" note.

= 0.2.8 =
* Settings: buy credits from the plugin. Each pack opens BazSite's payment page for that pack.

= 0.2.7 =
* The tool keeps one width when chapters open and close, also inside an Elementor widget set to "center".
* The admin screen: the BazSite logo, three tabs: tools, leads and settings (account, content shared, look); a clear notice when no account is connected.
* Tools: "How to put a tool on a page" and "Tool codes" open on a click; a line for sites with Elementor.
* Content: a simple choice (everything, all posts, posts from categories, some posts), one Save button, no map fields.
* Leads: search, filter by tool, sort, rows per page, long answers open on a click, and "Show the answer" for an answer kept on the site.
* A clear notice, with a one-click fix, when visitors cannot open an account on the site.
* "Add credits" opens a page for buying AI tool credits.

= 0.2.6 =
* A trip planner can ask for several hotels, each with its check-in and check-out dates, with an "add hotel" button.

= 0.2.5 =
* The form keeps one width whatever is open or chosen. A choice with long answers takes its whole row, a chapter with nothing to ask is hidden, a question alone in its row takes the row, and the required mark never wraps to a line of its own.

= 0.2.4 =
* On a phone the form uses the full width. One chapter is open at a time, with a short slide to it. Fields in a row line up even when a label takes two lines.
* A question can follow several answers of another one (a plan's goal question picks the questions that fit).

= 0.2.3 =
* Long answers (a full business plan) are written in the background and the page asks for them every few seconds, so a host's 2-minute limit never cuts them off.

= 0.2.2 =
* The plugin tells BazSite its version, so outdated sites can be told to update.

= 0.2.1 =
* Security: connecting uses a one-time proof (PKCE), and returns only to this plugin's own screen.
* A guest's answer is saved to their account only from the link in their email.
* Limits on runs per site and on emails to visitors.
* The answer replaces the form; no "change my answers" button (a new run costs credits).
* Password-protected content is never sent; new filter bazsite_ai_share_post.

= 0.2.0 =
* "My plans": every answer is kept in the visitor's WordPress account.
* Elementor widget.
* The visitor gets the answer by email; designed emails.
* Chapters open and close smoothly.

= 0.1.0 =
* First version.

== Upgrade Notice ==

= 0.2.22 =
The shekel plan renews by itself; manage or cancel it in BazSite.

= 0.2.21 =
On WooCommerce sites, visitors' AI answers show at the end of "My account" by themselves.

= 0.2.20 =
Answers follow the page's language on multilingual sites.

= 0.2.19 =
Fixes "Explain it to me" showing nothing and choices read as unanswered; tells the site's admin when credits run out.

= 0.2.18 =
Credit packs after the plan, clearer prices, the welcome credits shown, everything on the site read by default and the "My plans" page made by itself.

= 0.2.17 =
Connecting opens BazSite in a new tab; also includes 0.2.16's own-tool designer and credit notes.

= 0.2.16 =
Design your own AI tools (with the AI tools plan), cost per run on every library tool, and a clear note for visitors when credits run out.

= 0.2.15 =
The AI tools plan comes monthly or yearly; prices follow the site's language (shekels in Hebrew, dollars in any other); the "not connected" notice can be closed.

