=== Quick Excerpt Generator ===
Contributors: spp
Tags: excerpt, summary, truncate, ai, content
Requires at least: 5.8
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Automatically generate clean, customizable post excerpts with smart sentence clipping and optional AI summaries.

== Description ==

Quick Excerpt Generator replaces WordPress's default mid-sentence text chopping with a configurable excerpt engine. Set exact word or character limits, add custom suffixes, target specific post types, and optionally generate AI-powered summaries with OpenAI or Google Gemini.

= Features =

* **Standard truncation** — Strips shortcodes and HTML, then slices text to your chosen word or character limit.
* **Smart sentence clipping** — Ends excerpts at the nearest period, exclamation mark, or question mark for complete thoughts.
* **AI summaries (optional)** — Connect OpenAI or Gemini to generate contextual TL;DR summaries instead of simple truncation.
* **Flexible execution** — Apply excerpts on-the-fly via filters, save them to the database on publish/update, or both.
* **Post type targeting** — Enable the generator for posts, pages, and any public custom post type.
* **Bulk generator** — Scan existing content and generate excerpts for all posts that lack a manual excerpt.

= Settings =

Go to **Settings → Quick Excerpt** to configure length, suffix, post types, execution mode, and AI options.

== Installation ==

1. Upload the `spp-excerpt-generator` folder to the `/wp-content/plugins/` directory, or install through the WordPress plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Visit **Settings → Quick Excerpt** to configure your preferences.

== Frequently Asked Questions ==

= Does this modify my post content? =

No. The plugin only reads post content and writes to the excerpt field (when using save or bulk modes). Your post content is never changed.

= Will it overwrite excerpts I wrote manually? =

Not by default. Enable **Overwrite Manual Excerpts** in settings if you want generated excerpts to replace existing ones.

= Do I need an AI API key? =

No. AI summaries are optional. Without an API key, the plugin uses standard truncation with optional smart sentence clipping.

= Which AI providers are supported? =

OpenAI (ChatGPT) and Google Gemini. Enter your API key and model name in the AI settings section.

== Screenshots ==

1. Settings page with general and AI options.
2. Bulk excerpt generator with progress bar.

== Changelog ==

= 1.0.0 =
* Initial release.
* Standard and smart truncation engine.
* Settings page with post type targeting.
* On-the-fly filter, on-save, and bulk generation modes.
* Optional OpenAI and Gemini AI summaries.

== Upgrade Notice ==

= 1.0.0 =
Initial release of Quick Excerpt Generator.
