Skip to content

theaminulai/pointwise-summary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

89 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AI Summarizer - AI-Powered TL;DR & Content Summary & Social Sharing

WordPress Plugin Version WordPress Compatibility License PHP Version AI Models

The Ultimate AI Summarization Plugin for WordPress - Generate TL;DR summaries with ChatGPT, Claude, Gemini, Grok, Perplexity & Google AI Model. Fully customizable buttons you can place anywhere with automatic insertion capabilities.

Complete Solution: AI Summarization + Smart Display + Complete Customization

Pointwise Summary Demo


🎯 What is Pointwise Summary?

The most comprehensive AI summarization plugin for WordPress. This summarizing tool harnesses the power of 6 leading AI models (ChatGPT, Claude, Gemini, Grok, Perplexity, Google AI) with beautiful, customizable Gutenberg blocks and intelligent display options - all in one lightweight plugin.

Perfect for: Content creators, bloggers, news sites, students, researchers, educators, and businesses who want to improve content accessibility and reduce bounce rates with automatic text summarization.

🚀 Build Authority & Trust: Adding TL;DR summaries increases user engagement, improves time-on-page metrics, and reduces bounce rates—key signals that search engines use to establish your site's authority and credibility. Higher engagement translates to better search rankings and increases the likelihood of your content being referenced by AI systems as a trusted source.

What is TL;DR?

TL;DR (also written as TLDR, tl;dr, or TL/DR) stands for "Too Long; Didn't Read" - a popular internet slang term that originated in online forums and Usenet newsgroups in the early 2000s. Added to the Oxford English Dictionary in 2013, it's used in two main ways:

  1. As a dismissive response - "This post is too long, so I didn't read it"
  2. As a summary label - "Here's a short version of the main points"

In today's fast-paced digital world, readers face information overload and typically scan content before committing to reading. 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 Add TL;DR to Your Content:

  • Combat Information Overload - Help readers extract key insights in seconds
  • Respect Your Readers' Time - Let them preview content before full reading
  • Reduce Bounce Rates - Engage visitors who might otherwise leave immediately
  • Improve Accessibility - Make lengthy content more navigable and user-friendly
  • Increase Engagement - Good summaries encourage deeper exploration of full content
  • Boost SEO - Better user metrics (time on page, lower bounce rate) signal quality to search engines

Summary Types Supported

Based on Chrome's Summarizer API and industry standards, the plugin supports:

  • TL;DR - Short and to-the-point overview for busy readers (1-5 sentences)
  • Key Points - Bullet-pointed list of main ideas (3-7 points)
  • Teaser - Engaging summary to draw readers in (1-5 sentences)
  • Headline - Single-sentence capture of main point (12-22 words)

🤖 AI Models Supported

ChatGPT (OpenAI)

  • Models: GPT-4, GPT-3.5 Turbo
  • Best For: Conversational summaries, detailed explanations
  • Strengths: Natural language, context understanding

Claude (Anthropic)

  • Models: Claude 3 Opus, Sonnet, Haiku
  • Best For: Technical content, academic papers
  • Strengths: Safe AI, strong reasoning, analysis

Gemini (Google)

  • Models: Gemini Pro, Ultra
  • Best For: Multi-language content, complex topics
  • Strengths: Advanced comprehension, key point extraction

Grok (xAI)

  • Models: Grok-1
  • Best For: News, trending topics, current events
  • Strengths: Real-time knowledge, conversational

Perplexity

  • Features: AI answer engine with citations
  • Best For: Fact-based summaries, research
  • Strengths: Source citations, web search integration

Google AI Model

  • Features: Direct Google AI integration
  • Best For: Quick summaries, convenience
  • Strengths: Automatic launch, fast processing

🔒 Upcoming: Chrome Built-in AI (Gemini Nano)

  • Features: On-device AI summarization (privacy-friendly)
  • Best For: Summarization without API keys
  • Strengths: Offline capability, no API costs, data stays on your device

✨ Key Features

🎨 Complete Customization & Flexible Placement

Place Buttons Anywhere You Want:

  • Drag-and-drop with Gutenberg block editor
  • Automatic insertion before/after title or content
  • Floating action button that follows users
  • Manual shortcode placement in templates
  • Per-post placement overrides
  • Complete design control

Automatic Button Insertion: Set it once, buttons appear everywhere automatically!

  • ✅ Before post title - Grab attention at the top
  • ✅ After post title - Natural reading flow
  • ✅ Before content - Pre-read summary access
  • ✅ After content - Quick recap for reference
  • ✅ Per-post type control - Different rules for posts, pages, custom post types
  • ✅ Individual post overrides - Customize per article

Floating Action Button (FAB):

  • Position: bottom-right, bottom-left, top-right, top-left, center-left, center-right
  • Customizable appearance and colors
  • Mobile-responsive
  • Smooth animations
  • Always accessible without scrolling

📝 Design & Display Options

Gutenberg Block System:

  • Horizontal or vertical button layouts
  • Drag-and-drop interface
  • Live preview in editor
  • Block transformations (paragraphs → buttons)
  • Template system for quick setup

Automatic Inline Insertion:

  • Before title
  • After title
  • Before content
  • After content
  • Both positions
  • Per-post type control

Manual Shortcode:

[pointwise_summary]
[pointwise_summary buttons="chatgpt,claude,gemini"]
[pointwise_summary style="minimal" show_title="false"]
[pointwise_summary style="icons-only" icon_style="circular"]

🎨 Visual Styles

  1. Default - Clean design with white backgrounds
  2. Brand Colors - Platform characteristic colors (ChatGPT green, Claude orange, etc.)
  3. Minimal - Transparent with borders only
  4. Dark - Optimized for dark themes
  5. Icons-Only - Modern minimalist design with circular or square icons

⚙️ Advanced Customization

Per-Model Settings:

  • Custom prompts for each AI model
  • Adjustable summary length (short, medium, detailed)
  • Language preferences
  • Output format (paragraph, bullets, markdown)

Per-Post Overrides: (Upcoming)

  • Custom prompts for individual posts
  • Display position customization
  • Button selection control
  • Style overrides

SEO Options:

  • <a> links with rel="nofollow noopener"
  • <button> elements (not counted as links)
  • Crawl budget optimization
  • Clean link profile management
  • Semantic HTML markup

🎯 Perfect Use Cases

Use Case Best AI Models Display Method Benefits
📝 Long-Form Blog Posts ChatGPT, Claude FAB + Inline buttons Quick TL;DR for busy readers, reduced bounce rate, better engagement
📚 Research Papers & Academic Articles Claude, Perplexity Auto-insert before title Academic summaries with citations for students and researchers
📄 Technical Documentation ChatGPT, Claude Gutenberg blocks Key points extraction for developers using this summarizing tool
📰 News Articles & Journalism Grok, Perplexity FAB bottom-right Current events with real-time context for breaking news
🎯 Educational Content & E-Learning Gemini, ChatGPT Auto-insert after title Student-friendly summaries with this text summarizer
💼 Business Reports & Whitepapers Claude, ChatGPT Inline buttons Executive summaries for stakeholders and decision-makers
📱 Content Heavy Sites & Blogs All 6 Models + Gemini Nano All display methods Maximize accessibility, improve UX with article summarizer

📊 Feature Comparison

Pointwise Summary vs Competitors

Compare this WordPress summarizing tool with other popular text summarizers:

Feature Pointwise Summary Grammarly QuillBot TLDR This DeCopy.ai
AI Models ✅ 6 (ChatGPT, Claude, Gemini, Grok, Perplexity, Google AI) ❌ 1 ❌ 1 ❌ 1 ❌ 1-2
Pricing Open Source ⚠️ Limited ⚠️ Limited ⚠️ Limited ⚠️ Limited
WordPress Integration ✅ Native plugin ❌ External tool ❌ External tool ❌ External tool ❌ External tool
Gutenberg Blocks ✅ Native integration ❌ None ❌ None ❌ None ❌ None
Floating Action Button ✅ 6 positions ❌ None ❌ None ❌ None ❌ None
Auto-Insertion ✅ 4 positions + per-post control ❌ Manual only ❌ Manual only ❌ Manual only ❌ Manual only
On-Device AI (Gemini Nano) ✅ Privacy-friendly ❌ None ❌ None ❌ None ❌ None
Visual Styles ✅ 5 professional styles ❌ 1-2 ❌ 1 ❌ 1 ❌ 1-2
Icons-Only Mode ✅ Circular & square ❌ None ❌ None ❌ None ❌ None
Custom Prompts ✅ Per-model + per-post ⚠️ Global only ⚠️ Limited ❌ None ⚠️ Limited
SEO Options ✅ Links or buttons ❌ N/A ❌ N/A ❌ N/A ❌ N/A
Summary Lengths ✅ Short, medium, detailed ⚠️ Fixed ✅ Customizable ⚠️ Limited ⚠️ Limited
Multi-language ✅ 50+ languages ✅ Yes ✅ Yes ⚠️ Limited ⚠️ Limited
Accessibility ✅ WCAG 2.1 AA ⚠️ Basic ⚠️ Basic ⚠️ Basic ⚠️ Basic
API Costs ✅ Optional (or use Gemini Nano) 💰 Subscription 💰 Subscription ⚠️ Limited tier 💰 Pay per use
Data Privacy ✅ On-device option available ⚠️ Cloud-based ⚠️ Cloud-based ⚠️ Cloud-based ⚠️ Cloud-based

Unique Features - Only in Pointwise Summary

What Makes This the Best Summarizing Tool:

  1. Most AI Models - 6 leading AI platforms + Chrome's Gemini Nano in one plugin
  2. True WordPress Integration - Native Gutenberg blocks, not external tools
  3. Triple Display Options - Blocks + FAB + Auto-insertion (competitors have none)
  4. Floating Action Button - Sticky button with 6 position options
  5. On-Device AI - Privacy-friendly Gemini Nano summarization without API costs
  6. Icons-Only Mode - Modern, minimalist design with tooltips
  7. Per-Post Customization - Different AI models and settings per article
  8. SEO Flexibility - Choose <a> links or <button> elements
  9. Open Source Plugin - Community-driven development
  10. WordPress Native - Built with Gutenberg Block API v3 for optimal performance

🚀 Installation

From WordPress.org (Recommended)

  1. Go to Plugins > Add New in your WordPress admin
  2. Search for "Pointwise Summary"
  3. Click Install Now and then Activate
  4. The block will appear in the Design category in the block editor

Manual Installation

  1. Download the plugin from the releases page
  2. Upload the pointwise-summary folder to /wp-content/plugins/
  3. Activate the plugin through the Plugins menu in WordPress

From Source

# Clone the repository
git clone https://github.com/theaminulai/pointwise-summary.git

# Navigate to the plugin directory
cd pointwise-summary

# Install dependencies
npm install

# Build the plugin
npm run build

Development

Requirements

  • WordPress: 6.1 or higher
  • PHP: 7.4 or higher
  • Node.js: 18+ and npm

Build Commands

# Start development mode with hot reload
npm run start

# Build for production
npm run build

# Format code (WordPress standards)
npm run format

# Lint JavaScript
npm run lint:js

# Lint CSS
npm run lint:css

# Create plugin zip for distribution
npm run plugin-zip

Project Structure

pointwise-summary/
├── pointwise-summary.php                 # Main plugin file (entry point)
├── includes/                              # Core plugin classes
│   ├── plugin.php                        # Bootstrap and initialization
│   ├── class-pointwise-summary-*.php     # Admin UI classes
│   ├── api/                              # REST API endpoints (6 endpoints)
│   │   ├── class-pointwise-summary-ai-settings-api.php
│   │   ├── class-pointwise-summary-display-settings-api.php
│   │   ├── class-pointwise-summary-social-sharing-api.php
│   │   ├── class-pointwise-summary-advanced-settings-api.php
│   │   ├── class-pointwise-summary-shortcode-api.php
│   │   └── class-pointwise-summary-system-info-api.php
│   ├── frontend/                         # Frontend rendering classes
│   │   ├── class-pointwise-summary-buttons.php
│   │   ├── class-pointwise-summary-frontend.php
│   │   ├── class-pointwise-summary-inline.php
│   │   ├── class-pointwise-summary-fab.php
│   │   └── ... (other frontend helpers)
│   └── helpers/                          # Utility classes and traits
├── src/                                  # React admin UI source (uncompiled)
│   ├── admin/                            # Admin React application
│   │   ├── store/                        # Redux state management
│   │   ├── components/                   # React settings components
│   │   ├── hooks/                        # Custom React hooks
│   │   ├── services/                     # REST API client
│   │   └── index.tsx                     # App entry point
│   └── frontend/                         # Frontend React (if any)
├── build/                                # Compiled assets (generated)
│   ├── admin.js                          # Compiled admin UI
│   ├── admin.css                         # Admin styles
│   └── ...
├── package.json                          # Node.js dependencies
├── webpack.config.js                     # Webpack configuration
├── README.md                             # This file
├── ARCHITECTURE.md                       # Detailed architecture docs
├── AGENTS.md                             # AI agent guidelines
└── .github/
    ├── PULL_REQUEST_TEMPLATE.md
    └── copilot-instructions.md

🔮 Comprehensive Roadmap

✅ Phase 1: Foundation (COMPLETED)

  • Gutenberg block system with horizontal/vertical layouts
  • Full styling customization (colors, typography, spacing)
  • Responsive design for all devices
  • WCAG 2.1 AA accessibility compliance
  • Block transformations
  • WordPress 6.7+ block manifest system
  • Research Chrome Summarizer API (Gemini Nano)
  • Design plugin architecture for AI integration
  • Implement on-device summarization
  • Add summary type selection (TL;DR, key-points, headline, teaser)
  • Length controls (short, medium, long)

🚀 Phase 2: AI Integration (IN PROGRESS - v0.5.0)

  • 6 AI Models Integration
    • ChatGPT (GPT-4, GPT-3.5 Turbo)
    • Claude (Opus, Sonnet, Haiku)
    • Gemini (Pro, Ultra)
    • Grok (via xAI API)
    • Perplexity (with citations)
    • Google AI Mode (direct integration)
  • Summary Generation Features
    • One-click automatic summarization
    • Custom prompts per AI model
    • Summary length controls (short, medium, detailed)
    • Multiple summary types (TL;DR, key-points, headlines, teasers)
    • Multi-language support (50+ languages)
    • Streaming summaries (real-time generation)
  • Multiple Summary Styles
    • TL;DR (quick 1-sentence overview)
    • Key Points (bullet list of main ideas)
    • Headlines (article title suggestions)
    • Teasers (engaging preview text)
  • Customizable Summary Length
    • Short (1-3 sentences / 3 bullets)
    • Medium (3-5 sentences / 5 bullets)
    • Long (5+ sentences / 7 bullets)
  • Format Control
    • Paragraph format
    • Bullet point lists
    • Numbered lists
    • Markdown output
  • Display Options
    • Floating Action Button (FAB) with 6 positions
    • Automatic inline insertion (before/after title/content)
    • Per-post display customization
    • Content type targeting (choose post types)

🎨 Phase 3: Advanced UI & Styles (v0.6.0)

  • Visual Enhancements
    • 5 professional styles (default, brand, minimal, dark, icons-only)
    • Icons-only mode (circular & square)
    • Custom icon system with SVG support
    • Button ordering options (AI models first, random, etc.)
    • Button alignment (left, center, right)
    • Smart tooltips for icons-only mode
  • [] Admin Dashboard
    • Settings page with visual preview
    • Per-model configuration panel
    • API key management interface
    • Usage statistics dashboard
    • Style customizer with live preview

🧠 Phase 4: Smart Features (v0.7.0)

  • Chrome Built-in AI
    • On-device summarization with Gemini Nano
    • No API costs, privacy-friendly
    • Offline capability
  • Advanced Summarization
    • URL summarization (external articles)
    • File upload support (PDF, DOCX, TXT)
    • Batch summarization (multiple posts)
    • Summary history & library
    • Edit and regenerate summaries
  • Summary Templates - Pre-designed summary formats
  • Content Analysis
    • Automatic content detection
    • Reading time estimation
    • Summary quality scoring
    • Sentiment analysis
    • Topic extraction and tagging

📈 Phase 5: Advanced AI Features (v0.7.5)

  • Contextual Summaries - Understand article context and audience
  • Smart Content Detection - Auto-detect when articles need summaries
  • Summary Quality Scoring - Rate and improve summary quality
  • Multi-document Summarization - Combine multiple sources
  • Question-Based Summaries - Answer specific questions about content
  • Summary Translations - Translate summaries to different languages

📊 Phase 6: Analytics & SEO (v0.8.0)

  • Analytics Dashboard
    • Summary button click tracking
    • AI model usage statistics
    • Engagement metrics (time saved, bounce rate)
    • Popular content insights
    • A/B testing for summary styles

🔌 Phase 7: Integrations (v0.9.0)

  • Third-Party Integrations
    • WooCommerce (product summaries)
    • LearnDash / Tutor LMS (course summaries)
    • BuddyPress (social summaries)
    • bbPress (forum thread summaries)
    • Elementor Pro (design builder)
    • Beaver Builder (page builder)
  • Service Integrations
    • Email subscriptions (daily summary digests)
    • RSS feeds with summaries
    • Zapier/Make.com webhooks
    • API access for developers

🚀 Phase 8: Professional Features (v1.0.0+)

  • Premium Capabilities
    • White-label options
    • Custom AI model integration (own API)
    • Advanced caching system
    • CDN integration for assets
    • Multisite network support
    • Priority support & updates
  • Advanced AI Features
    • Visual summaries (mind maps, infographics)
    • Audio summaries (text-to-speech)
    • Video content summarization
    • Question-answering about content
    • Multi-document summarization
    • Summary translations (50+ languages)

🎯 Target Dates

Phase Version Target Date Status
Phase 1 v0.4.0 ✅ Complete Released
Phase 2 v0.5.0 Q1 2026 In Progress
Phase 3 v0.6.0 Q2 2026 Planned
Phase 4 v0.7.0 Q3 2026 Planned
Phase 5 v0.7.5 Q3 2026 Planned
Phase 6 v0.8.0 Q4 2026 Planned
Phase 7 v0.9.0 Q1 2027 Planned
Phase 8 v1.0.0+ 2027+ Future

🤝 Contributing

Contributions are welcome! Here's how you can help:

Ways to Contribute

  1. Report Bugs - Found a bug? Open an issue
  2. Suggest Features - Have an idea? Submit a feature request
  3. Submit Pull Requests - Fix bugs or add features
  4. Improve Documentation - Help make docs clearer
  5. Translations - Translate the plugin to your language
  6. Spread the Word - Share with others who might benefit

Development Workflow

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/AmazingFeature)
  3. Make your changes following WordPress Coding Standards
  4. Test thoroughly in WordPress 6.1+
  5. Run linters: npm run lint:js && npm run lint:css
  6. Format code: npm run format
  7. Commit your changes (git commit -m 'Add some AmazingFeature')
  8. Push to the branch (git push origin feature/AmazingFeature)
  9. Open a Pull Request

Coding Standards

📄 License

This plugin is licensed under the GPL-3.0-or-later license. See the LICENSE file for details.

💬 Support & Community

Get Help

Stay Updated

🙏 Credits

Special Thanks

  • All contributors who help improve this plugin
  • The WordPress community for continued support

📝 Changelog

[0.1.0] - 2024-06-15

Added

  • Initial release 🎉
  • Horizontal and vertical button layouts
  • Full Gutenberg integration
  • Comprehensive styling controls
  • Block transformations
  • WCAG 2.1 AA accessibility
  • Responsive design for all devices

View full changelog →


⬆ Back to Top

Made with ❤️ for the WordPress Community

WebsiteGitHubWordPress.org

About

The Ultimate AI Summarization Plugin for WordPress - Generate TL;DR summaries with ChatGPT, Claude, Gemini, Grok, Perplexity & Google AI Model. Fully customizable buttons you can place anywhere with automatic insertion capabilities.

Resources

License

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors