Plugin Overview

Voxfor AI Content Summary is a WordPress plugin that generates accurate, faithful AI-powered summaries of your post content. Built with strict adherence to source material - no external knowledge, interpretation, or fabrication.

Key Features

What Gets Summarized

• ✅ Post title
• ✅ Text paragraphs
• ✅ Headings (H2, H3, etc.)
• ✅ Lists (bullets and numbered)
• ✅ Blockquotes
• ✅ Facts, dates, and names (if present in content)

What Is Excluded

• ❌ HTML/CSS/JavaScript code
• ❌ Buttons and form elements
• ❌ Dynamic content and shortcodes
• ❌ External knowledge or interpretation
• ❌ Marketing wording or generalizations

Installation Guide

System Requirements

Installation Steps

1. Download: Get the plugin from your source location
2. Upload: Go to WordPress Admin → Plugins → Add New → Upload Plugin
3. Install: Select the zip file and click "Install Now"
4. Activate: Click "Activate Plugin" after installation
5. Configure: Navigate to "Voxfor AI" in your WordPress admin sidebar
6. API Key: Add your Claude or ChatGPT API key in Settings
7. Display Settings: Configure where and how to show the summary button

Getting API Keys

Claude API Key (Recommended)

1. Visit https://console.anthropic.com/
2. Sign up for an Anthropic account
3. Navigate to API Keys section
4. Create a new API key
5. Copy the key (starts with sk-ant-)
6. Paste it in Voxfor AI → Settings → Claude API Key

ChatGPT API Key (Alternative)

1. Visit https://platform.openai.com/
2. Sign up for an OpenAI account
3. Navigate to API Keys section
4. Create a new API key
5. Copy the key (starts with sk-)
6. Paste it in Voxfor AI → Settings → ChatGPT API Key

Quick Start Guide

Get Started in 5 Minutes

1. Configure Settings:

   Go to Voxfor AI → Settings

   • Choose your AI provider (Claude or ChatGPT)
   • Enter your API key
   • Select which post types should display the summary button
   • Choose display mode (Auto or Manual)
   • Select button position (Before/After content or Shortcode only)
2. Create or Edit a Post:

   Go to any post editor page

   • Look for the "AI Content Summary" meta box on the right sidebar
   • Write your post content
   • Click "Generate Summary" button in the meta box
3. Review Generated Summary:
   • Summary appears in the meta box after generation
   • View comparison with original content
   • Regenerate if needed
4. Frontend Display:

   If Auto Display is enabled, visitors will see a "Generate Summary" button on your post

   • Button appears before or after content (based on settings)
   • Clicking generates and displays the summary
   • Can be disabled per post using the meta box checkbox

AI Providers

Claude Haiku 4.5 (Recommended)

ChatGPT 5.2 (Alternative)

Switching Providers

You can switch between Claude and ChatGPT at any time:

1. Go to Voxfor AI → Settings
2. Select a different provider from the dropdown
3. Ensure the corresponding API key is entered
4. Save settings
5. Existing summaries remain unchanged; new ones use the selected provider

Content Extraction

How It Works

The plugin uses a sophisticated content extraction system that:

1. Retrieves Post Content: Gets the full post content including title
2. Parses HTML: Uses DOMDocument to parse HTML structure safely
3. Extracts Meaningful Content: Identifies and extracts text-based elements
4. Filters Out Noise: Removes code, buttons, forms, and dynamic content
5. Formats for AI: Structures content in a clean, readable format

Extraction Rules

Content Length Limits

Example Extraction

// Input HTML:
<h2>Introduction</h2>
<p>This is a sample post about WordPress.</p>
<ul>
  <li>Feature 1</li>
  <li>Feature 2</li>
</ul>
<pre><code>// This code is ignored</code></pre>

// Extracted Content:
Title: Sample Post Title

Introduction
This is a sample post about WordPress.
- Feature 1
- Feature 2

Summary Generation

The Supreme Rule

Generation Process

1. Content Extraction: Clean extraction of post content
2. Hash Calculation: Generate MD5 hash of extracted content
3. Cache Check: Check if summary exists for this content hash
4. API Request: If not cached, send to selected AI provider
5. Summary Receipt: Receive generated summary
6. Database Storage: Save summary with metadata to database
7. Display/Return: Show summary to user or return to frontend

AI Prompt Structure

System Instruction:
"You are a precise, accurate content summarizer. Your only job is 
to create faithful summaries of content. SUPREME RULE: Only 
summarize information that actually appears in the text. Every 
word in your summary must be verifiable from the original content."

User Request:
"Summarize the following content: [EXTRACTED CONTENT]"

Output:
- Concise, faithful summary
- 2-3 paragraphs typically
- Only facts from source material
- No external knowledge added

Summary Storage

Each summary is stored in the database with:

Automatic Regeneration

The plugin automatically detects when summaries need updating:

• Compares current content hash with stored hash
• If content changed, shows "Content Changed - Regenerate" message in meta box
• Regeneration is manual to give you control
• Old summary preserved until you regenerate

Display Options

Display Modes

Button Positions

Post Type Selection

Choose which post types can display the summary button:

• ✅ Posts (default)
• ✅ Pages
• ✅ Custom Post Types (Products, Portfolio, etc.)

Configure in Voxfor AI → Settings → Display Button On

Per-Post Control

Every post has individual controls in the AI Content Summary meta box:

• Enable/Disable Button: Checkbox to show/hide button on this post
• Generate Summary: Create summary for admin preview
• Regenerate: Update summary if content changed

Shortcodes & Functions

Shortcode Usage

Basic Shortcode

[voxfor_summary]

Place this shortcode anywhere in your post content to display the summary button at that exact location.

Use Cases

• Custom button placement within content
• Multiple summary buttons on same page
• Sidebar widgets with summary access
• Custom page templates

Theme Integration

For theme developers, you can programmatically display summaries:

Display Button

<?php
// In your theme template
if ( function_exists( 'voxfor_display_summary_button' ) ) {
    voxfor_display_summary_button( get_the_ID() );
}
?>

Get Summary Directly

<?php
// Retrieve existing summary
global $wpdb;
$table_name = $wpdb->prefix . 'voxfor_ai_summaries';
$summary = $wpdb->get_row( $wpdb->prepare(
    "SELECT * FROM $table_name WHERE post_id = %d",
    get_the_ID()
) );

if ( $summary ) {
    echo '<div class="ai-summary">';
    echo '<h3>AI Summary</h3>';
    echo wp_kses_post( $summary->summary );
    echo '</div>';
}
?>

Check if Summary Exists

<?php
// Check before displaying
$has_summary = Voxfor_Database_Handler::get_summary( get_the_ID() );

if ( $has_summary ) {
    // Display summary button or content
}
?>

Meta Box Usage

Location

The "AI Content Summary" meta box appears on the right sidebar of the post editor for all enabled post types.

Features

Status Messages

Best Practices

• Generate summaries after finalizing post content
• Review summaries before publishing posts
• Regenerate if you make significant content changes
• Use comparison view to verify accuracy
• Disable button for posts that don't benefit from summaries

Troubleshooting

Common Issues & Solutions

Debug Information

To gather debug information for support:

1. Check browser console (F12) for JavaScript errors
2. Enable WordPress debug mode in wp-config.php:

   define( 'WP_DEBUG', true );
   define( 'WP_DEBUG_LOG', true );

3. Check wp-content/debug.log for errors
4. Note the exact error message received
5. Record which AI provider is selected

Frequently Asked Questions

Technical Requirements

Plugin Statistics

View summary statistics in Voxfor AI → Settings at the bottom of the page:

• Total summaries generated
• Current AI provider
• Summaries per post type