=== SummarAIze - Generate Key Takeaways with AI === Contributors: jwilson529 Donate link: https://oneclickcontent.com/donate/ Tags: ai, summary, content-enhancement Requires at least: 5.0 Tested up to: 6.6.1 Stable tag: 1.1.13 Requires PHP: 7.2 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html # SummarAIze - Generate Key Takeaways with AI. Distill your posts into 5 key takeaways, enhancing engagement and readability. ## Description SummarAIze leverages AI to instantly distill your posts into 5 essential takeaways, boosting reader engagement and making your content more digestible at a glance. Whether you're a blogger looking to highlight essential points, a marketer wanting to ensure your audience gets the most out of your content, or a news site aiming to provide quick summaries, SummarAIze enhances user engagement and retention by providing concise, easily digestible summaries. ### Important Information SummarAIze relies on the OpenAI API to generate key takeaways. This means that data from your site will be sent to OpenAI's servers for processing, and results will be returned to your site. By using this plugin, you agree to OpenAI's [Terms of Use](https://openai.com/terms) and [Privacy Policy](https://openai.com/privacy). ### API Endpoints Used - **https://api.openai.com/v1/threads/{thread_id}/messages**: Used to manage messages within the AI assistant. - **https://api.openai.com/v1/threads/{thread_id}/runs**: Used to manage execution runs for generating content. - **https://api.openai.com/v1/threads/{thread_id}/runs/{run_id}/submit_tool_outputs**: Used to submit and manage tool outputs related to the assistant. - **https://api.openai.com/v1/models**: Used to retrieve available models for the assistant and verify the API key. ### Features - **AI-Powered Content Summarization**: Automatically generate top 5 key points from post content using AI. - **Customizable Display Options**: Display key points in various styles and positions to suit your theme. - **Ordered or Unordered Lists**: Choose between an ordered list (numbered) or an unordered list (bulleted) for displaying key points. - **User-Friendly Interface**: Easily manage and customize key points for each post or page. - **Flexible API Integration**: Integrate with your own OpenAI API key, allowing for control over usage and billing. - **Assistant Configuration**: Use the default Assistant ID or configure your own in the OpenAI Playground. - **Enhance SEO and Readability**: Improve your content's SEO by providing search engines with structured summaries, and enhance readability for your audience. ## Drag-and-Drop Feature You can now easily reorder your points using the drag-and-drop functionality. Here's how: 1. Hover over the point you want to reorder. 2. Click and hold the "menu" icon (represented by the three lines) to the left of the point. 3. Drag the point to your desired position in the list. 4. The new order is automatically updated and saved when you publish or update the post. Empty points will be removed from the front-end display automatically, ensuring only meaningful points are shown to your users. ## Shortcode Documentation The Summaraize shortcode is used to display the top 5 key points for a post. You can customize the display with several attributes, such as the view mode, color, and button style. ### Basic Shortcode Usage: `[summaraize]` ### Available Attributes: **id (optional):** The post ID for which to display the key points. If not provided, the shortcode will use the current post's ID. Example: `[summaraize id="123"]` **view (optional):** Defines where the output should be positioned relative to the post content. Possible values are: – `popup`: Renders a popup button that displays the key points in a modal when clicked. Default: `above` Example: `[summaraize view="popup"]` **mode (optional):** Sets the display mode for light or dark theme. Possible values: – `light`: Light theme. – `dark`: Dark theme. Default: `light` Example: `[summaraize mode="dark"]` **title (optional):** Sets a custom title for the key points widget or popup. If no custom title is provided, the default "Key Takeaways" will be used. Example: `[summaraize title="Quick Summary"]` **button_style (optional):** Defines the button style when using the popup view. Possible values: `flat`, `rounded`, etc. Default: `flat` Example: `[summaraize view="popup" button_style="rounded"]` **button_color (optional):** Sets the background color of the popup button. Use any valid hex color code. Default: `#0073aa` Example: `[summaraize view="popup" button_color="#ff0000"]` **list_type (optional):** Specifies how the key points list is displayed. Possible values: – `ordered`: Displays an ordered list (`
    `). – `unordered`: Displays an unordered list (`