Skip to content

FlatironSoftwareCorp/chronoton

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Chronoton - AI-Powered WordPress Summary Generator

Generate AI-powered summaries for your WordPress posts using multiple AI providers including ChatGPT, Claude, Gemini, and AWS Bedrock.

Description

Chronoton is a powerful WordPress plugin that adds AI-powered content summarization to your posts through a custom Gutenberg block. Create engaging, SEO-friendly summaries of your content using state-of-the-art AI models from multiple providers.

Key Features

  • πŸ€– Multiple AI Providers: Support for ChatGPT (OpenAI), Claude (Anthropic), Gemini (Google), and AWS Bedrock
  • πŸ“ Customizable Templates: Create multiple prompt templates with custom tone, format, and word limits
  • βš™οΈ Flexible Configuration: Set global defaults or override settings per post
  • 🎨 Gutenberg Block: Easy-to-use "Summary Generator" block for the WordPress editor
  • πŸ’Ύ Metadata Persistence: All generation settings are saved with each post for reference
  • πŸ” SEO Optimized: Optional raw HTML output for enhanced SEO benefits
  • πŸ“Š Analytics Integration: Track summary interactions with Google Analytics
  • 🎭 Expandable/Collapsible: Choose default display state for summaries
  • βœ… Approval System: Review and approve AI-generated summaries before publishing

User Roles & Permissions

  • Administrators: Full access to plugin settings, API key configuration, and template management
  • Editors: Can use the Summary Generator block in posts and customize per-post settings (does not have access to API keys or global settings)

How It Works

  1. Configure AI Providers: Add API keys for your preferred AI services (ChatGPT, Claude, Gemini, or Bedrock)
  2. Create Templates: Define prompt templates with specific tone, format, and length requirements
  3. Add Summary Block: Insert the "Summary Generator" block into any post
  4. Generate Summary: The AI analyzes your entire post content and creates a summary
  5. Review & Approve: Review the generated summary and approve it for public display
  6. Customize Per Post: Override global settings on individual posts if needed

Post-Specific Settings

For each post, you can customize:

  • AI Model Selection: Choose which provider and model to use
  • Template Selection: Pick from your predefined templates or create custom ones
  • Tone: Adjust the writing style (professional, casual, technical, etc.)
  • Format: Choose output format (paragraph, bullet points, etc.)
  • Max Words: Set the desired summary length

All settings used to generate a summary are automatically saved as post metadata, allowing you to see exactly which configuration was used for each summary.

Post Metadata

After generating a summary, Chronoton stores metadata with each post accessible via the WordPress REST API:

  • chronoton_summary - The AI-generated summary (HTML)
  • chronoton_approved - Whether the summary is approved for display (boolean)
  • chronoton_generation_settings - Generation parameters (object)

Example chronoton_generation_settings:

{
  "prompt_template": "You are an AI trained to write concise...",
  "tone": "Journalistic Neutral",
  "format": "Short Paragraph",
  "max_words": 100,
  "selected_model": "claude-3-7-sonnet-20250219",
  "prompt_index": 0,
  "prompt_label": "Default Prompt",
  "generated_at": "2026-02-10T23:06:30.454Z"
}

Access via REST API: GET /wp-json/wp/v2/posts/123

Global Settings

Configure plugin-wide defaults including:

  • Enable/Disable Plugin: Turn the Summary Generator functionality on or off
  • Default Provider & Model: Set your preferred AI service
  • SEO Append: Include raw HTML of summaries for SEO purposes (hidden from view)
  • Collapse by Default: Control whether summaries start collapsed or expanded
  • Analytics: Enable Google Analytics event tracking for summary interactions

Screenshots

Summary Generator Block

Summary Generator Block

Block Settings Panel

Block Settings

General Settings

General Settings

LLM Provider Configuration

LLM Providers

Prompt Template Management

Prompt Templates

Installation

Manual Installation

  1. Download the plugin zip file
  2. Extract to wp-content/plugins/chronoton/
  3. Navigate to Plugins in your WordPress admin
  4. Activate the Chronoton plugin

After Installation

  1. Go to Settings β†’ Chronoton
  2. Add API keys for your preferred AI provider(s)
  3. Configure your default settings
  4. Create prompt templates
  5. Start adding Summary Generator blocks to your posts!

Local Development with Docker

# Start WordPress environment
docker-compose up -d

# Access WordPress at http://localhost:8080
# Admin at http://localhost:8080/wp-admin

# Access phpMyAdmin at http://localhost:8081

Local Development

Prerequisites

  • Node.js 18+
  • PHP 8.0+
  • Composer
  • npm
  • WordPress 5.0+

Setup

# Clone the repository
git clone https://github.com/FlatironSoftwareCorp/chronoton.git
cd chronoton

# Install PHP dependencies
composer install

# Install Node.js dependencies
npm install

# Build for development (watch mode)
npm run dev

# Build for production
npm run build

Code Quality

# PHP Code Standards
composer run-script check-cs    # Check standards
composer run-script fix-cs      # Auto-fix issues

# JavaScript/CSS
npm run lint:js                 # Lint JavaScript
npm run lint:css                # Lint CSS
npm run format                  # Format code

Project Structure

chronoton/
β”œβ”€β”€ chronoton.php              # Main plugin file
β”œβ”€β”€ composer.json              # PHP dependencies
β”œβ”€β”€ package.json               # Node.js dependencies
β”œβ”€β”€ docker-compose.yml         # Local development environment
β”œβ”€β”€ src/                       # PHP source code
β”‚   β”œβ”€β”€ Chronoton.php         # Main plugin class
β”‚   β”œβ”€β”€ PostMeta.php          # Post metadata handler
β”‚   β”œβ”€β”€ Admin.php             # Admin interface
β”‚   └── RestAPI.php           # REST API endpoints
β”œβ”€β”€ src/react/                 # React components
β”œβ”€β”€ build/                     # Compiled assets
└── languages/                 # Translation files

Security

API keys are encrypted using AES-256-CBC before database storage. Encryption keys are derived from WordPress salts.

Data Privacy

Chronoton sends post content to third-party AI services for summary generation. Please review the privacy policies of your chosen AI provider:

License

Chronoton is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License v2 or later.

Releases

No releases published

Packages

 
 
 

Contributors