=== Postology ===  
Description: Retain Readers with AI Summaries
Contributors: postology, 0harshit0
Tags: engagement, blog, summary, AI, post 
Requires at least: 5.0  
Tested up to: 6.7  
Requires PHP: 7.2  
Stable tag: 1.3 
License: GPL-2.0-or-later  
License URI: http://www.gnu.org/licenses/gpl-2.0.html  

== Screenshots ==
1. Enhance your blog posts with an interactive AI summary box that appears at the top. When readers click, they get a quick summary of your content.
2. Make the summary box match your blog's style. Choose colors, fonts, and layout that reflect your brand and aesthetic
3. Control how the AI presents your content. Adjust the tone, length, and focus of the summaries to align with your blog's voice.

== Description ==  
Transform your blog with AI-powered post summaries that capture your readers' attention, reduce bounce rates, and increase engagement. Postology automatically creates concise, compelling summaries of your content that keep visitors on your site longer.

**Key Features**  

✅ **AI-Powered Summaries**

- Automatically generate concise bullet point summaries of your posts
- Save your readers' time while keeping them engaged
- Help visitors quickly understand your content value

🧩 **Flexible Content Control**

- Choose exactly where summaries appear throughout your site
- Easy to implement on all blog posts
- Exclude specific posts when needed

🎨 **Seamless Design Integration**

- Match colors and fonts to your theme's design
- Responsive layout works on all devices
- Customizable positioning options

📊 **Pro Features**

- **Enhanced Summaries**: Up to 10 bullet points (vs. 2 in Free)
- **Customize Style**: Adjust tone (casual, formal) and length of summaries
- **Unlimited Usage**: Connect your OpenAI API key for unlimited summaries
- **Analytics Dashboard**: Track visitor engagement with your summaries

**🚀 Get Started in 2 Minutes**

1. **Install Free**: Upload the plugin → Activate → Summaries appear instantly.
2. **Customize**: Adjust settings to fit your style.
3. **Engage**: Watch readers stay longer and convert more.

**📚 Learn More**

- [Documentation](https://postology-pro.tawk.help/) | [Support](mailto:contact@postology-pro.com)

**🎯 Perfect For:**

- Bloggers | Content Marketers | News Sites | Educational Platforms | Anyone Who Wants Readers to Stay Longer

**🔗 Need More?**

- *Agencies*: Contact us for multi-site licensing.
- *Developers*: Extend Postology via hooks and filters.

== Installation ==  

**WordPress Admin Method**

1. Log into your WordPress dashboard and navigate to `Plugins > Add New`
2. Search for `Postology` in the search field
3. Click `Install Now` and then `Activate` to enable the plugin

**Manual Installation**

1. Download the Postology ZIP file from [wordpress.org/plugins/postology](https://wordpress.org/plugins/postology)
2. Navigate to your WordPress dashboard and go to `Plugins > Add New`
3. Click the `Upload Plugin` button, select the Postology ZIP file, and click `Install Now`
4. After installation completes, click `Activate`

**After Activation**

1. The Postology widget will automatically appear on all your blog posts
2. Access the plugin settings by clicking on the `Postology` menu in your dashboard
3. Customize summary length, appearance, and other options to match your site's needs

**Documentation & Support**

For detailed tutorials and customization options, visit our documentation: [postology-pro.tawk.help](https://postology-pro.tawk.help/)

Need assistance? Contact us at [support@postology.com](mailto:support@postology.com)

== Usage ==  

After activating the plugin, simply visit the **Postology** menu in your WordPress dashboard to customize settings. The summary widget will automatically appear on your posts.

== External services ==

This WordPress plugin connects to an external service at postology-pro.com via REST API calls. It primarily does two things:

1. Manage User Credits: When a new user signs up or requests free credits, the plugin sends an HTTP POST request to the endpoint /wp-json/credit-manager/create-free-user. This helps the external service register the user and allocate free credits.
2. Generate Summaries/Chat: When a user requests a summary or uses a chat-like feature, the plugin makes another HTTP POST call to /wp-json/credit-manager/chat, passing the necessary data to the external service, which then processes the request. The plugin uses wp_remote_post with JSON-encoded data and a 60-second timeout to ensure the communication is reliable. This setup offloads the credit management and summary generation tasks to the external service rather than handling them entirely on your WordPress site.

✨ **Turn Visitors into Readers. No Coding Required.** ✨

== Frequently Asked Questions ==  

= How do credits work?  
Postology credits are used each time a user generates a summary of your post. Readers can generate a summary only once per visit, and this will reset each time they leave the page.  

- **Free Version**: Includes 100 credits in total (1 credit = 1 summary generation).  
- **Pro Version**: Comes with 10,000 credits and the option to use your OpenAI key to generate unlimited summaries.  
- *Note*: If you run out of credits on the free version, you can purchase more or upgrade to Pro.  

= Can I use my own OpenAI API key?  
Yes! Pro users can input their own API key, allowing unlimited summaries without consuming credits.  

= How accurate is Postology?  
Summaries are based **100% on your original text** with no extra information added. Adjust accuracy via tone, style, and length settings.  

= Can I customize the summaries?  
Yes! Pro users can:  
- Adjust **tone** (casual, formal, etc.).  
- Set **bullet point length** (short/medium/long).  
- Choose the number of bullets (up to 10).  

= What if I run out of credits on the free version?  
Purchase more credits or upgrade to Pro (includes 10,000 credits + OpenAI API access).  

= Is there customer support?  
Yes! Contact us at [support@postology.com](mailto:support@postology.com) for help.  


== Changelog ==  
= 1.0 (2024-03-02) =  
- Initial release.
