Changeset 3305965
- Timestamp:
- 06/03/2025 05:46:33 PM (7 months ago)
- File:
-
- 1 edited
-
suggester/trunk/readme.txt (modified) (3 diffs)
Legend:
- Unmodified
- Added
- Removed
-
suggester/trunk/readme.txt
r3305884 r3305965 1 1 === Suggester === 2 2 Contributors: webcava 3 Tags: suggestions, search, gemini, ai, content suggestions3 Tags: ai, suggestions, content generator, gemini, openrouter 4 4 Requires at least: 5.0 5 5 Tested up to: 6.8 6 Stable tag: 1.0. 07 Requires PHP: 7.26 Stable tag: 1.0.1 7 Requires PHP: 8.0 8 8 License: GPLv2 or later 9 9 License URI: https://www.gnu.org/licenses/gpl-2.0.html 10 10 11 Suggester helps your website visitors find what they're looking for with AI-powered content suggestions.11 An intelligent suggestion generator based on keywords using Google Gemini and OpenRouter APIs. 12 12 13 13 == Description == 14 14 15 Suggester is a powerful WordPress plugin that enhances user experience by providing intelligent content suggestions. Using Google's Gemini AI technology, Suggester analyzes user queries and delivers relevant content recommendations, helping visitors find exactly what they're looking for.15 Suggester is a powerful WordPress plugin that allows site owners to create intelligent suggestion tools powered by AI. Using Google Gemini and OpenRouter APIs, the plugin generates content suggestions based on user-entered keywords. 16 16 17 17 = Key Features = 18 18 19 * **Easy Integration**: Add suggestion widgets to any page or post using simple shortcodes 20 * **Customizable Design**: Adjust colors, layout, and text to match your website's design 21 * **Detailed Statistics**: Track usage and see how visitors interact with your suggestions 22 * **Multiple Widgets**: Create up to 3 different suggestion widgets (unlimited in PRO version) 23 * **Google Gemini AI**: Powered by Google's advanced AI technology for intelligent suggestions 19 * Create up to 3 custom suggestion tools 20 * Each tool has its own shortcode for easy embedding 21 * Customizable prompts and output format 22 * Statistics tracking for usage 23 * Advanced API key management 24 25 = External Services = 26 27 This plugin connects to the following external services: 28 29 * Google Gemini API: Used to generate AI-powered suggestions. [Terms of Use](https://policies.google.com/terms), [Privacy Policy](https://policies.google.com/privacy) 30 * OpenRouter API: Provides access to multiple AI models. [Terms of Use](https://openrouter.ai/terms), [Privacy Policy](https://openrouter.ai/privacy) 24 31 25 32 = How It Works = 26 33 27 1. Add a Suggester widget to your pages using the provided shortcode 28 2. Visitors enter their search queries in the widget 29 3. Suggester processes the query using Google Gemini AI and displays relevant suggestions 30 4. Visitors can save their favorite suggestions for later reference 31 32 = Use Cases = 33 34 * **E-commerce**: Help shoppers find products they're interested in 35 * **Content Sites**: Guide readers to relevant articles and resources 36 * **Documentation**: Assist users in finding the right help documentation 37 * **Support**: Direct users to appropriate support resources 38 39 = Privacy Notice = 40 41 The free version of Suggester tracks basic usage statistics to help us improve the plugin. No personal data is collected. Our privacy policy is available in the plugin's admin area. 42 43 == External Services == 44 45 This plugin connects to Google's Gemini AI API to generate intelligent content suggestions based on user input. 46 47 **Service:** Google Gemini AI API 48 **Purpose:** Generate AI-powered content suggestions and recommendations based on user search queries 49 **Data Sent:** User search terms/keywords and custom prompts (if configured by the site administrator) 50 **When:** Every time a visitor requests suggestions through the widget by entering a search term and clicking the suggestion button 51 **API Endpoint:** https://generativelanguage.googleapis.com/v1beta/models/gemini-2.0-flash:generateContent 52 53 **Requirements:** You need a Google API key to use this service. By using this plugin, you acknowledge that user search data will be transmitted to Google's servers for processing. 54 55 **Important Links:** 56 * Google AI Terms of Service: https://ai.google.dev/terms 57 * Google Privacy Policy: https://policies.google.com/privacy 58 * Google AI Studio (to get API key): https://aistudio.google.com/ 59 60 **Data Privacy:** Search terms entered by your website visitors are sent to Google's API for processing. Please ensure you comply with applicable privacy laws and inform your users about this data transmission in your privacy policy. 34 1. The site owner creates a custom tool with a specific prompt template 35 2. The tool is embedded on any page using a shortcode (e.g., [suggester id='1']) 36 3. Visitors enter keywords in the tool's input field 37 4. The plugin sends the keywords and prompt to the AI service 38 5. Results are displayed instantly on the page 61 39 62 40 == Installation == … … 64 42 1. Upload the `suggester` folder to the `/wp-content/plugins/` directory 65 43 2. Activate the plugin through the 'Plugins' menu in WordPress 66 3. Go to Suggestor > Settings to configure your Google Gemini API key67 4. Create your first widget through Suggestor > Widgets68 5. Add the widget to your site using the provided shortcode44 3. Go to the Suggester dashboard to configure your API keys 45 4. Create your first suggestion tool 46 5. Use the provided shortcode to add the tool to any page 69 47 70 48 == Frequently Asked Questions == 71 49 72 = Do I need an API key to use Suggester? =50 = How many tools can I create? = 73 51 74 Yes, Suggester uses Google's Gemini AI API which requires an API key. You can get a free API key from Google AI Studio.52 The free version allows you to create up to 3 tools, each with its own unique shortcode. 75 53 76 = How do I add a Suggester widget to my page? =54 = Do I need to have API keys to use this plugin? = 77 55 78 After creating a widget in the Suggester > Widgets section, you can add it to any page or post using the shortcode provided. For example: `[suggestor id='1']` 56 Yes, you need to have either a Google Gemini API key or an OpenRouter API key (or both) to use this plugin. 79 57 80 = Can I customize the appearance of the widget? =58 = What information is sent to the external APIs? = 81 59 82 Yes, you can customize colors, text, layout, and more through the widget settings.60 The plugin sends the keyword entered by the user, along with the prompt template you've configured. No personal user data is sent to the APIs. 83 61 84 = How many widgets can I create? =62 = Is this plugin compatible with multilingual sites? = 85 63 86 The free version allows you to create up to 3 widgets. The PRO version offers unlimited widgets. 87 88 = What data does Suggester collect? = 89 90 The free version only collects anonymous usage statistics to help us improve the plugin. No personal data is collected or stored. 91 92 = Is Suggester compatible with my theme? = 93 94 Suggester is designed to be compatible with most WordPress themes. The widgets use responsive design and adapt to your site's layout. 64 Yes, the plugin fully supports translation, including right-to-left (RTL) languages like Arabic. 95 65 96 66 == Screenshots == 97 67 98 1. Suggester widget on a website99 2. Admin dashboard with statistics100 3. Widget customization options101 4. S uggestion historypage68 1. Dashboard Overview 69 2. Creating a new suggestion tool 70 3. Frontend tool display 71 4. Settings page 102 72 103 73 == Changelog == 74 75 = 1.0.1 = 76 * New improvements 104 77 105 78 = 1.0.0 = … … 107 80 108 81 == Upgrade Notice == 82 Please update to the latest version 1.0.1 to get more new features. 109 83 110 = 1.0. 0=111 Initial release of Suggester plugin. 84 = 1.0.1 = 85 New improvements 112 86 113 87 == Privacy Policy == 114 88 115 Suggester respects your privacy and the privacy of your website visitors. Here's how we handle data:89 Suggester uses external AI services to generate suggestions. When a user enters a keyword, that keyword along with your configured prompt template is sent to either the Google Gemini API or OpenRouter API (depending on your settings). We do not collect or store personal information about your users, but the external services may have their own privacy policies regarding how they handle the data sent to them. 116 90 117 = Data Collection = 118 119 * **Usage Statistics**: The free version only collects anonymous usage statistics (counts and timestamps) to help us improve the plugin. 120 * **Search Terms**: The free version does NOT store the actual search terms entered by your users in your WordPress database. 121 * **User IDs**: We store a reference to the WordPress user ID (if logged in) for statistical purposes only. 122 123 = External API Usage = 124 125 * **Google Gemini API**: Suggester uses Google's Gemini API to generate content suggestions. 126 * **Data Transmission**: When a user enters a search term, it is sent to Google's Gemini API using your API key. 127 * **Google's Data Handling**: Google may store and process this data according to their terms of service. 128 * **Your Responsibility**: As the website owner, you are responsible for ensuring your use of the Google Gemini API complies with their terms of service and that you have informed your users about how their data is processed. 129 130 = Data Removal = 131 132 * All plugin data is automatically removed when you uninstall the plugin. 133 * No data is retained on our servers as all processing happens on your WordPress site and Google's servers. 134 135 For more information about our privacy policy and Google's terms of service, please refer to the plugin's admin area. 91 For more information about how these services handle data, please refer to their respective privacy policies: 92 * Google Gemini: https://policies.google.com/privacy 93 * OpenRouter: https://openrouter.ai/privacy
Note: See TracChangeset
for help on using the changeset viewer.