Overview

Description

Advanced Topic Summaries

📋 Overview

Advanced Topic Summaries is a comprehensive IPS v5 application that automatically generates intelligent summaries of forum topics, combining AI-powered analysis with community-driven content curation. The application helps members quickly understand long discussions, identifies key posts, tracks topic health metrics, and encourages community participation through voting and highlighting systems.

🎯 Core Features

1. Intelligent Summary Generation

Three Summary Types:

• AI-Powered Summaries: Natural language summaries generated by AI that analyze the entire discussion

• Extracted Summaries: Community-driven summaries based on key posts, statistics, and metrics

• Hybrid Summaries: Combines AI-generated text with extracted key posts and statistics

Two AI Provider Options:

• Google Gemini: Support for Gemini 2.5 Flash, Gemini Pro, and other Gemini models

• OpenAI: Support for GPT-4, GPT-4 Turbo, GPT-4o, GPT-3.5 Turbo, and GPT-5 models

  • Extended timeout support for GPT-5 reasoning models (up to 10 minutes)

  • Separate token limits for standard models vs. GPT-5/o1 models

Configurable AI Parameters:

• Custom system prompts for tailored summary generation

• Temperature control (0.0 = focused, 1.0 = creative)

• Max tokens for response length

• Maximum posts to analyze (to avoid API limits)

• Poll data integration (AI can mention poll trends)

• Media metadata integration (AI can reference images/videos/attachments)

Summary Length Options:

• Brief: Short summary with key statistics only

• Standard: Balanced summary with statistics and highlights

• Detailed: Comprehensive summary with all available information (timeline, key posts, contributors, health scores)

Automatic Generation:

• Auto-generate summaries when topics reach minimum post count

• Auto-regenerate when topics receive X new posts (configurable threshold)

• Forum-specific enablement (choose which forums have summaries)

• Minimum post requirement (default: 10 posts)

2. Key Posts Identification System

Automatically identifies and highlights the most important posts based on multiple criteria:

• Best Answer: Posts marked as the solution to question-style topics

• Helpful Posts: Posts manually marked as helpful by moderators/authors

• Staff Highlights: Posts manually highlighted by moderators (with optional approval workflow)

• Community Votes: Posts voted as important by community members

• High Reactions: Posts with the most community reactions

• First Post: Always included in AI summaries (guaranteed inclusion)

Key Posts Display:

• Configurable number of key posts to display (default: 5)

• Two display styles:

  • List View: Compact list layout with content on left, actions on right

  • Grid View: column card grid layout

• Post excerpts with configurable length (default: 200 characters)

• Reason badges showing why each post was selected

• Direct links to view full posts in context

3. Community Voting System

Vote Types:

• Vote to Include: Members vote for posts they think should be in the summary

• Vote to Exclude: Members vote to exclude posts from the summary (requires group permission)

Vote Features:

• Vote counts displayed on posts (optional)

• Vote weight system (different groups can have different vote weights: 1.0x to 5.0x)

• Vote weight badges (show members their vote multiplier)

• Daily vote limits per member (configurable, 0 = unlimited)

• Per-topic vote limits (configurable, 0 = unlimited)

• Members can toggle their votes on/off

• Votes automatically excluded from key posts if score is negative

• Highlighted posts cannot be voted on (staff curation takes precedence)

• First post cannot be voted on (guaranteed inclusion)

Vote Statistics:

• Total voters count

• Total votes cast

• Top voted post with score

• Vote history tracking in member profiles

Vote Management:

• ACP Management: View, and remove all votes

• ModCP Integration: Moderators can manage votes from ModCP

• Member Management: Members can view and remove their own votes

4. Staff Highlights System

Highlight Features:

• Manual post highlighting by moderators/staff (group permissions)

• Optional approval workflow for highlights

• Auto-approve for trusted groups (group permissions)

• Priority levels (1-10) for highlight importance

• Custom reason/notes for each highlight

• Highlight badges on posts (optional)

• Priority display in badge tooltips (optional)

• Daily highlight limits per member (configurable)

• Per-topic highlight limits (configurable)

Highlight Management:

• ACP Management: View, approve, and remove all highlights

• ModCP Integration: Moderators can manage highlights from ModCP

• Member Management: Members can view and remove their own highlights (requires group permission)

• Notifications: Members receive notifications when their posts are highlighted

5. Topic Health Scores & Analytics

Three Health Metrics:

• Overall Health Score: Composite score (0-100%) based on engagement and quality

• Engagement Score: Measures activity, participation, and interaction patterns

• Quality Score: Evaluates content quality based on reactions, helpful posts, and best answers

Engagement Scoring:

• New Topics (< threshold age): Scored based on posts per day (rewards active discussions)

• Old Topics (> threshold age): Scored based on total posts (rewards comprehensive guides)

• Evergreen Bonus: Topics that continue receiving views long after creation get bonus points

• Configurable thresholds:

  • Old topic threshold (default: 365 days)

  • Comprehensive posts target (default: 100 posts)

  • Evergreen age requirement (default: 90 days)

  • Evergreen views per month (default: 10)

Quality Scoring:

• Post length analysis (longer, detailed posts score higher)

• Reaction counts (community appreciation)

• Best answers and helpful posts

• Featured/pinned status

• Community voting activity (optional)

• Approved highlights count (optional)

Visual Display:

• Native IPS progress bars showing each metric

• Percentage scores displayed prominently

• Color-coded indicators (blue primary color)

• Responsive design for all screen sizes

6. Statistics & Analytics

Topic Statistics:

• Total posts count

• Total views count

• Topic age (days since creation)

• Posts per day average

• Reading time estimates:

  • Summary reading time

  • Full topic reading time

  • Time saved by reading summary

Voting Statistics:

• Total voters

• Total votes cast

• Top voted post with score and link

Activity Timeline:

• Visual timeline showing topic activity over time

• Posts grouped by time periods

• Identify when discussions were most active

• Only shown in detailed summary length

7. Top Contributors

Features:

• Identifies members who contributed most to the topic

• Configurable number of contributors to display (default: 10)

• Two display styles:

  • Inline List: Horizontal list with names and post counts

  • Small Avatars: Avatar grid with post count badges

• Member preference for display style

• Clickable member profiles

8. Display Options & Customization

Three Display Locations:

• Sidebar: Compact widget in topic sidebar (similar to Clubs app)

• Topic Title Header: Summary displayed in topic header

• Below Topic Action Buttons/Poll: Summary displayed after topic action buttons/poll

Admin Controls:

• Enable/disable each display location

• Set default display location

• Set default collapsed state for guests and new members

Member Preferences:

• Choose preferred display location (from admin-enabled options)

• Choose summary length (brief, standard, detailed)

• Start summaries collapsed or expanded

• Choose contributors display style

• Choose key posts display style

Collapsible Summaries:

• IPS-style +/- toggle button (matches forum category toggles)

• Smooth slide animations

• Persistent collapsed state (saved per member)

9. Permissions & Group Settings

Member Group Permissions:

• Can highlight posts: Allow group to highlight posts for summaries

• Highlights auto-approve: Skip approval workflow for trusted groups

• Can remove own highlights: Allow members to remove their highlights

• Highlight daily limit: Max highlights per day (0 = unlimited)

• Highlight per-topic limit: Max highlights per topic (0 = unlimited)

• Can vote on posts: Allow group to vote on posts

• Can vote to exclude: Allow voting to exclude posts from summaries

• Vote weight: Multiplier for vote value (1.0 to 5.0)

• Show vote weight: Display vote weight badge to members

• Can remove own votes: Allow toggling votes on/off

• Voting daily limit: Max votes per day (0 = unlimited)

• Voting per-topic limit: Max votes per topic (0 = unlimited)

Moderator Permissions:

• Can approve highlights: Approve pending highlights

• Can remove any highlights: Remove any member's highlights

• Can manage votes: Manage/remove any member's votes

• Can regenerate summaries: Manually regenerate summaries

• Can edit summaries: Edit summary content

• Can delete summaries: Delete summaries

10. Member Integration

Account Settings Tabs:

• Summaries Tab: Configure display preferences, location, length, collapsed state, display styles

• Highlights Tab: View and manage own highlights with filtering and sorting

• Votes Tab: View and manage own votes with filtering and sorting

Member ACP Profile Blocks:

• Summary Preferences: View member's summary display settings

• Highlight History: View all highlights created by or received by member

• Vote History: View all votes cast by member

• Activity Log: Track member's summary-related actions

Member Profile Tab:

• Topics Highlighted: Public tab showing topics where member has highlighted posts

Member History Tracking:

• Highlights created

• Highlights received

• Highlights removed

• Votes cast (include/exclude)

• Votes removed

• Summaries regenerated

• Full history with dates, actions, and context

11. Notifications System

Notification Types:

• Highlight Approved: Notify when your post is highlighted by staff

• Highlight Pending: Notify moderators when highlights need approval

• Summary Generated: Notify topic author when summary is generated (optional)

Notification Channels:

• Inline notifications (in-app)

• Email notifications (optional)

• Push notifications (optional)

12. Dashboard & Statistics

ACP Dashboard Widgets:

• Summaries Overview: Total summaries, AI vs. extracted breakdown, recent activity

• Most Highlighted Posts: Topics with the most staff highlights

• Most Voted Posts: Topics with the most community votes

Statistics Dashboard:

• Summary generation statistics

• AI usage and cost tracking

• Highlight statistics

• Voting statistics

• Health score distributions

• Topic engagement metrics

13. ModCP Integration

ModCP Tabs:

• Highlights: View and manage pending/approved highlights

• Votes: View and manage community votes

Moderator Actions:

• Approve/reject highlights

• Remove highlights

• Remove votes

• Regenerate summaries

• View highlight/vote history

14. Admin Management

ACP Controllers:

• Manage Summaries: View, edit, delete, and regenerate summaries

• Settings: Comprehensive settings with multiple tabs

• Manage Highlights: View, approve, and remove all highlights

• Manage Votes: View and manage all votes

• Statistics Dashboard: View application-wide statistics

• Activity Logs: View all summary-related actions

Settings Tabs:

1. General Settings:

   • Enable/disable summaries

   • Auto-generation settings

   • Minimum posts requirement

   • Forum selection

   • Auto-update threshold

   • Display location options

   • Default collapsed state

   • Enable user preferences

2. Display Settings:

   • Show/hide statistics

   • Show/hide timeline

   • Show/hide key posts

   • Key posts count

   • Max key posts

   • Show/hide top contributors

   • Contributors count

   • Max contributors

   • Show/hide health scores

   • Include best answers

   • Include helpful posts

   • Excerpt length

3. Voting Settings:

   • Enable/disable voting

   • Show vote counts

   • Voting groups

4. Highlights Settings:

   • Enable/disable highlights

   • Highlight groups

   • Show highlight badges

   • Show priority in badges

5. AI Settings:

   • Enable/disable AI

   • AI provider selection (Gemini or OpenAI)

   • Gemini API key

   • OpenAI API key

   • Model selection (provider-specific)

   • Temperature control

   • Max tokens (standard models)

   • Max completion tokens (GPT-5/o1 models)

   • Custom system prompt

   • Max posts to analyze

   • Include poll data

   • Include media metadata

6. Health Score Settings:

   • Old topic threshold (days)

   • Comprehensive posts target

   • Evergreen age requirement (days)

   • Evergreen views per month

   • Include voting in quality score

   • Include highlights in quality score

7. History Settings:

   • Enable/disable version history

   • Number of versions to keep (0 = unlimited)

8. Performance Settings:

   • Cache TTL (time-to-live in seconds)

15. Version History

• Keep history of summary versions

• Track changes over time

• Configurable retention (number of versions to keep)

• View previous versions

• Compare versions

16. Background Processing

• Queue System: Summary generation runs in background queues

• Batch Processing: Efficient handling of multiple summaries

• Timeout Protection: Long-running AI requests handled gracefully

• Error Recovery: Automatic fallback to extracted summaries on AI failures

• Logging: Comprehensive error logging for debugging

💡 Use Cases

• Support Forums: Help members quickly understand support topics and find solutions

• Discussion Forums: Summarize long debates and highlight key arguments

• Community Engagement: Encourage participation through voting and highlighting

• Content Curation: Staff can highlight the best content for new members

• Time Savings: Members can quickly scan summaries instead of reading hundreds of posts

• Quality Control: Health scores help identify high-quality discussions

• Knowledge Base: Evergreen content identification for reference material

• Moderation: Moderators can quickly assess topic quality and importance

📋 Requirements

• IPS Community Suite: v5.0.0 or higher

• AI Provider (choose one):

  • Google Gemini API key, OR

  • OpenAI API key

🎉 Why Choose Advanced Topic Summaries?

This application transforms how your community interacts with long topics by:

✅ Saving Time: Members can quickly understand discussions without reading every post
✅ Encouraging Quality: Health scores and voting systems reward high-quality content
✅ Empowering Community: Members participate in content curation through voting
✅ Supporting Moderators: Tools to highlight important content and manage summaries
✅ Leveraging AI: Optional AI integration for natural language summaries
✅ Providing Flexibility: Extensive customization options for admins and members
✅ Maintaining Performance: Background processing and caching for optimal speed
✅ Ensuring Compatibility: Native IPS v5 integration with no core modifications

Transform your forum into an intelligent, community-driven knowledge platform! 🚀