Plugin Directory

Changeset 3305965


Ignore:
Timestamp:
06/03/2025 05:46:33 PM (7 months ago)
Author:
webcava
Message:

New improvements

File:
1 edited

Legend:

Unmodified
Added
Removed
  • suggester/trunk/readme.txt

    r3305884 r3305965  
    11=== Suggester ===
    22Contributors: webcava
    3 Tags: suggestions, search, gemini, ai, content suggestions
     3Tags: ai, suggestions, content generator, gemini, openrouter
    44Requires at least: 5.0
    55Tested up to: 6.8
    6 Stable tag: 1.0.0
    7 Requires PHP: 7.2
     6Stable tag: 1.0.1
     7Requires PHP: 8.0
    88License: GPLv2 or later
    99License URI: https://www.gnu.org/licenses/gpl-2.0.html
    1010
    11 Suggester helps your website visitors find what they're looking for with AI-powered content suggestions.
     11An intelligent suggestion generator based on keywords using Google Gemini and OpenRouter APIs.
    1212
    1313== Description ==
    1414
    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.
     15Suggester 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.
    1616
    1717= Key Features =
    1818
    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
     27This 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)
    2431
    2532= How It Works =
    2633
    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.
     341. The site owner creates a custom tool with a specific prompt template
     352. The tool is embedded on any page using a shortcode (e.g., [suggester id='1'])
     363. Visitors enter keywords in the tool's input field
     374. The plugin sends the keywords and prompt to the AI service
     385. Results are displayed instantly on the page
    6139
    6240== Installation ==
     
    64421. Upload the `suggester` folder to the `/wp-content/plugins/` directory
    65432. Activate the plugin through the 'Plugins' menu in WordPress
    66 3. Go to Suggestor > Settings to configure your Google Gemini API key
    67 4. Create your first widget through Suggestor > Widgets
    68 5. Add the widget to your site using the provided shortcode
     443. Go to the Suggester dashboard to configure your API keys
     454. Create your first suggestion tool
     465. Use the provided shortcode to add the tool to any page
    6947
    7048== Frequently Asked Questions ==
    7149
    72 = Do I need an API key to use Suggester? =
     50= How many tools can I create? =
    7351
    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.
     52The free version allows you to create up to 3 tools, each with its own unique shortcode.
    7553
    76 = How do I add a Suggester widget to my page? =
     54= Do I need to have API keys to use this plugin? =
    7755
    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']`
     56Yes, you need to have either a Google Gemini API key or an OpenRouter API key (or both) to use this plugin.
    7957
    80 = Can I customize the appearance of the widget? =
     58= What information is sent to the external APIs? =
    8159
    82 Yes, you can customize colors, text, layout, and more through the widget settings.
     60The 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.
    8361
    84 = How many widgets can I create? =
     62= Is this plugin compatible with multilingual sites? =
    8563
    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.
     64Yes, the plugin fully supports translation, including right-to-left (RTL) languages like Arabic.
    9565
    9666== Screenshots ==
    9767
    98 1. Suggester widget on a website
    99 2. Admin dashboard with statistics
    100 3. Widget customization options
    101 4. Suggestion history page
     681. Dashboard Overview
     692. Creating a new suggestion tool
     703. Frontend tool display
     714. Settings page
    10272
    10373== Changelog ==
     74
     75= 1.0.1 =
     76* New improvements
    10477
    10578= 1.0.0 =
     
    10780
    10881== Upgrade Notice ==
     82Please update to the latest version 1.0.1 to get more new features.
    10983
    110 = 1.0.0 =
    111 Initial release of Suggester plugin.
     84= 1.0.1 =
     85New improvements
    11286
    11387== Privacy Policy ==
    11488
    115 Suggester respects your privacy and the privacy of your website visitors. Here's how we handle data:
     89Suggester 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.
    11690
    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.
     91For 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.