=== Pointwise Summary ===
Contributors:      theaminuldev, iqbal1hossain
Tags:              tldr, ai, text-summary, summarize, article-summary, 
Requires at least: 6.1
Tested up to:      6.9
Requires PHP:      7.4
Stable tag:        0.5.0
License:           GPL-2.0-or-later
License URI:       https://www.gnu.org/licenses/gpl-2.0.html

Create instant TL;DR summaries with AI-powered buttons. Add “Summarize” and “Get TL;DR” buttons to help readers quickly grasp content.

== Description ==

**Too Long; Didn't Read (TL;DR)?** Help your readers save time with Pointwise Summary - the ultimate tool for adding intelligent summarization buttons to your WordPress content!

= What is Pointwise Summary? =

Pointwise Summary is a powerful Gutenberg block plugin that enables you to create professional "Summarize" and "TL;DR" button groups on your posts and pages. Perfect for long-form content, research articles, blog posts, and documentation, this plugin helps readers quickly identify if your content is worth their time.

= Why Your Site Needs Summary Buttons =

📚 **Reader-Friendly**: Modern web users scan content before reading. Give them quick access to summaries
⚡ **Reduce Bounce Rate**: Help visitors find relevant content faster, keeping them engaged longer  
🎯 **Better UX**: Provide "TL;DR" sections that respect your readers' time
🔧 **Easy Integration**: Works seamlessly with any WordPress theme using Gutenberg blocks
💡 **Professional Design**: Fully customizable buttons that match your brand

= Key Features =

✅ **Flexible Button Layouts** - Create horizontal or vertical summarize button arrangements
✅ **Gutenberg Native** - Built with WordPress Block Editor standards for seamless integration
✅ **Fully Customizable Styling**
   • Custom colors, gradients, and backgrounds
   • Typography controls (font size, weight, line height)
   • Border radius, spacing, and padding options
   • Hover effects and transitions
✅ **Responsive & Mobile-Optimized** - Perfect display on all devices
✅ **Accessibility Compliant** - WCAG 2.1 AA standards with keyboard navigation
✅ **Block Transformations** - Convert paragraphs or existing buttons into summary button groups
✅ **Chrome AI Ready** - Prepared for integration with Chrome's built-in Summarizer API (Gemini Nano)
✅ **Developer Friendly** - Clean code following WordPress coding standards

= Use Cases =

📝 **Long-Form Articles** - Add "Get Summary" buttons to lengthy blog posts
📖 **Research Papers** - Provide "TL;DR" access to key findings  
📄 **Documentation** - Help users navigate technical content quickly
📰 **News Websites** - Offer article summaries before the full story
🎓 **Educational Content** - Give students quick access to lesson summaries
💼 **Business Reports** - Executive summary buttons for detailed reports
📱 **Content Heavy Sites** - Improve content consumption and user engagement

= What is TL;DR? =

"TL;DR" stands for "Too Long; Didn't Read" - a popular internet acronym used to provide quick summaries of lengthy text. It acknowledges that modern readers often scan content before committing to read the full article. Adding TL;DR buttons shows you respect your readers' time.

= How It Works =

1. Add the "Summarize Button" block to any post or page
2. Customize button text ("Summarize", "Get TL;DR", "Quick Summary", etc.)
3. Link buttons to your summary sections or trigger AI summarization
4. Style buttons to match your website design
5. Publish and help readers navigate your content efficiently


== Installation ==

**From WordPress Dashboard:**

1. Navigate to Plugins > Add New
2. Search for "Pointwise Summary"
3. Click "Install Now" and then "Activate"
4. The block will be available in the block editor under the Design category

**Manual Installation:**

1. Download the plugin zip file
2. Upload the plugin files to the `/wp-content/plugins/pointwise-summary` directory
3. Activate the plugin through the 'Plugins' screen in WordPress
4. Start using the Pointwise Summary block in your posts and pages


== Frequently Asked Questions ==

= What is TL;DR and why do I need it? =

TL;DR stands for "Too Long; Didn't Read." It's an internet acronym used to provide quick summaries of lengthy content. Adding TL;DR buttons helps readers decide if your content is relevant to them, reducing bounce rates and improving user experience.

= How do I add summarize buttons to my content? =

Edit any post or page in the Gutenberg editor, click the "+" button, and search for "Summarize Button" or find it under the Design category. The block will be inserted with default buttons that you can customize.

= Does this plugin actually summarize content with AI? =

Currently, the plugin provides customizable buttons that you can link to summary sections. We're actively developing AI-powered automatic summarization using Chrome's Built-in AI (Gemini Nano) and other AI services. Stay tuned for updates!

= Can I customize the button appearance? =

Absolutely! You have full control over:
• Button colors, gradients, and backgrounds
• Text size, font family, and weight
• Border styles, radius, and shadows
• Spacing, padding, and margins
• Hover effects and animations

= How do I create vertical button layouts? =

Select your Summarize Button block, then in the block settings sidebar (right panel), look for Layout Options and change the orientation from "Horizontal" to "Vertical."

= Is this compatible with my WordPress theme? =

Yes! The plugin is built using native WordPress Gutenberg components and follows all WordPress coding standards. It works perfectly with any properly coded WordPress theme, including FSE (Full Site Editing) themes.

= Does it work on mobile devices? =

Yes, the buttons are fully responsive and automatically adapt to different screen sizes. They look great on phones, tablets, and desktops.

= Can I use multiple summarize button blocks on one page? =

Yes! You can add as many Summarize Button blocks as you need throughout your content. Each block can be styled independently.

= Is it accessible for users with disabilities? =

Yes, the plugin follows WCAG 2.1 Level AA accessibility standards with full keyboard navigation support, proper ARIA labels, and screen reader compatibility.

= Will this slow down my website? =

No. The plugin is lightweight with minimal JavaScript and CSS. It uses native WordPress components and follows performance best practices.

= Can I translate the button text? =

Yes, all button text is fully customizable and supports WordPress translation functions. The plugin is translation-ready for multi-language websites.

= How do I connect buttons to AI summarization? =

AI integration is in development. Currently, you can link buttons to summary sections on your page using anchor links (#summary), or to separate summary pages. Automatic AI summarization will be available in a future update.

== Changelog ==

= 0.5.0 - 2026-01-20 =
* Fixed: readme.txt short description to improve clarity and conciseness
* Fixed: Removed 'summarizer' and 'etc' tags from the plugin's readme.txt to streamline tag list
* Added: Add development section with build instructions

= 0.4.0 - 2025-12-21 =
* Enhanced: Improved block performance and registration system
* Enhanced: Better compatibility with WordPress 6.8
* Updated: Documentation and usage examples
* Fixed: Minor styling inconsistencies across themes
* Improved: Accessibility features and keyboard navigation

= 0.3.0 - 2025-02-15 =
* Added: Support for WordPress 6.7 block manifest system
* Enhanced: Faster block loading with optimized registration
* Improved: Mobile responsiveness and touch interactions
* Fixed: Button group spacing issues on some themes

= 0.2.0 - 2025-01-09 =
* Updated: Text domain changed to pointwise-summary for proper internationalization
* Improved: Enhanced documentation with TL;DR explanations
* Enhanced: Better SEO optimization for plugin directory

= 0.1.0 - 2024-06-15 =
* Initial release 🎉
* Added: Horizontal and vertical button layout options
* Added: Full integration with WordPress core button blocks
* Added: Comprehensive styling controls (colors, typography, spacing, borders)
* Added: Block transformations from paragraphs and existing buttons
* Added: WCAG 2.1 AA accessibility compliance
* Added: Fully responsive design for all devices
* Added: Gutenberg Block API v3 support

== Development ==

Source code: https://github.com/theaminulai/pointwise-summary/

**Build steps:**
1. `npm install`
2. `npm run build`

== Support ==

For support, please visit the plugin's support forum on WordPress.org or contact the author directly.
