===  Ask Pro – AI Product Q&A for WooCommerce ===
Contributors: ebizon1
Tags: woocommerce, ai, product questions, q&a, gemini, google ai, analytics, chat, support, product information
Donate link: https://wordpress.org/plugins/askpro-product-widget/
Requires at least: 5.0
Requires PHP: 7.4
Stable tag: 1.0.1
Tested up to: 6.8
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

== Description ==
Boost your WooCommerce store with Ask Pro, the AI-powered Product Q&A plugin that delivers instant, accurate answers to customer questions. Improve engagement, reduce returns, and increase conversions effortlessly.

== Key Features ==
* **Instant AI Answers:** Leverages Google Gemini AI to provide quick, concise responses to customer questions.
* **Comprehensive Product Context:** AI responses are based on detailed product information, including name, price, description, attributes, and customer reviews.
* **Customizable Widget:** Easily embed the Q&A widget on any product page using a shortcode or action hook.
* **API Key Management:** Securely manage your Gemini AI API Key directly from the WordPress admin settings.
* **Visibility Toggle:** Convenient buttons to show/hide the API key in settings.
* **Query Analytics:** Track weekly data on total unique products queried and overall query counts, visible in your WordPress admin.
* **WooCommerce Integration:** Seamlessly integrates with WooCommerce, requiring it to be active for full functionality.

Boost customer satisfaction and reduce support inquiries by providing instant, AI-driven answers!

== Installation ==
1. **Upload the Plugin:**
    * Download the plugin ZIP file.
    * Go to your WordPress admin dashboard.
    * Navigate to `Plugins > Add New > Upload Plugin`.
    * Choose the downloaded ZIP file and click `Install Now`.
2. **Activate the Plugin:**
    * After installation, click `Activate Plugin`.
    * **Important:** Ensure WooCommerce is installed and active on your WordPress site, as this plugin depends on it.
3. **Configure API Key:**
    * Go to `Settings > AskPro Product Widget` in your WordPress admin.
    * Enter your **Google Gemini AI API Key** in the designated field. (You can generate one from the Google Cloud Console or Google AI Studio.)
    * Click `Save Changes`.
4. **View Analytics:**
    * Go to `Settings > AskPro Analytics` to see weekly reports on product queries.
5. **Add Widget to Product Pages:**
    * **Option A (Recommended for Automatic Placement):** Add the following code snippet to your theme's `functions.php` file (or a custom plugin for better update safety):
        ```php
        function askpro_add_product_widget() {
            if (is_product() && shortcode_exists('askpro_product_widget')) {
                echo do_shortcode('[askpro_product_widget]');
            }
        }
        add_action('woocommerce_single_product_summary', 'askpro_add_product_widget', 15);
        ```
        This will automatically display the AskPro Product Widget within the product summary section (typically before the short description) on all single product pages. Adjust the priority (`15`) to change its position if needed.
    * **Option B (Manual Placement):** Place the shortcode `[askpro_product_widget]` directly into any WooCommerce product's description or content area using the WordPress editor.

== Frequently Asked Questions ==

= Does this plugin work without WooCommerce? =
No, this plugin is designed to work exclusively with WooCommerce. It relies on WooCommerce's product data, functions, and page structure. If WooCommerce is not active, the plugin will display an admin notice and its core features will not function.

= What AI model does this plugin use? =
This plugin is configured to use the Google Gemini AI API (specifically, the `gemini-2.5-flash` model). You will need to obtain an API key from Google.

= How do I get a Google Gemini AI API Key? =
You can obtain an API key from the Google Cloud Console or Google AI Studio, depending on your project setup. Refer to Google's official documentation for the latest instructions on generating API keys.

= What data does the plugin log? =
The plugin logs the `product_id`, `user_id` (0 if not logged in), the `query_text` submitted by the user, and the `response_text` received from the AI, along with the `log_time`. This data is stored in a custom database table (`wp_ai_logs` by default).

= Does the plugin clean up its data upon uninstallation? =
Yes, upon uninstallation, the plugin deletes its custom database table (`wp_ai_logs`) and removes the stored API key from your WordPress options.

== External Services ==

This plugin connects to Google's Gemini AI API to generate intelligent responses to customer questions about WooCommerce products.

**Service Details:**
- **Service Provider:** Google (Alphabet Inc.)
- **API Used:** Gemini AI API (generativelanguage.googleapis.com)
- **Purpose:** To generate AI-powered answers to customer product questions
- **Data Sent:** Product information (name, description, attributes, reviews) and customer questions
- **When Data is Sent:** Every time a customer submits a question through the product widget
- **API Key Required:** Yes, you must obtain your own API key from Google

**Important Links:**
- Google AI Terms of Service: https://ai.google.dev/terms
- Google Privacy Policy: https://policies.google.com/privacy
- Google Cloud Privacy Policy: https://cloud.google.com/privacy
- Gemini API Documentation: https://ai.google.dev/docs

**Data Privacy:** The plugin sends product data and customer questions to Google's servers for AI processing. No personal customer data (like email addresses or names) is transmitted unless explicitly included in the question text by the customer.

== Changelog ==

= 1.0 =
* Initial release of the AskPro Product Widget.
* Implemented AI-powered Q&A functionality on WooCommerce product pages using Google Gemini AI.
* Added robust logging of user queries and AI responses to a custom database table (`wp_ai_logs`).
* Introduced an admin settings page for configuring the Gemini AI API Key, with visibility toggle, copy, and clear features.
* Developed a dedicated Analytics page to display weekly reports on unique products queried and total query counts.
* Added a WooCommerce dependency check to ensure proper plugin operation.
* Incorporated internationalization support for all user-facing strings with the `askpro-product-widget` text domain.
* Added deactivation and uninstallation hooks for proper cleanup.

== Upgrade Notice ==

= 1.0 =
Initial release. No upgrades available yet.