[![WordPress Plugin Version](https://img.shields.io/wordpress/plugin/v/yoast-comment-hacks.svg)](https://wordpress.org/plugins/yoast-comment-hacks/)
![WordPress Plugin: Tested WP Version](https://img.shields.io/wordpress/plugin/tested/yoast-comment-hacks.svg)
[![WordPress Plugin Active Installs](https://img.shields.io/wordpress/plugin/installs/yoast-comment-hacks.svg)](https://wordpress.org/plugins/yoast-comment-hacks/advanced/)
[![WordPress Plugin Downloads](https://img.shields.io/wordpress/plugin/dt/yoast-comment-hacks.svg)](https://wordpress.org/plugins/yoast-comment-hacks/advanced/)
[![WordPress Plugin Rating](https://img.shields.io/wordpress/plugin/stars/yoast-comment-hacks.svg)](https://wordpress.org/support/plugin/yoast-comment-hacks/reviews/)
[![GPL License](https://img.shields.io/github/license/ProgressPlanner/comment-hacks.svg)](https://github.com/ProgressPlanner/comment-hacks/blob/main/LICENSE)

[![CS](https://github.com/ProgressPlanner/comment-hacks/actions/workflows/cs.yml/badge.svg)](https://github.com/ProgressPlanner/comment-hacks/actions/workflows/cs.yml)
[![Lint](https://github.com/ProgressPlanner/comment-hacks/actions/workflows/lint.yml/badge.svg)](https://github.com/ProgressPlanner/comment-hacks/actions/workflows/lint.yml)
[![Test](https://github.com/ProgressPlanner/comment-hacks/actions/workflows/test.yml/badge.svg)](https://github.com/ProgressPlanner/comment-hacks/actions/workflows/test.yml)

![Comment Experience banner](.wordpress-org/github_banner_comment_experience_pp.png)

# Comment Experience

Make WordPress comments easier to manage with cleaner moderation emails, better routing, comment policy controls, length limits, and tools for following up with commenters.

## Why this plugin exists

Core WordPress comments work, but moderation and follow-up can feel clunky. Comment Experience adds practical improvements for site owners and editors who want a cleaner, more manageable comment workflow without replacing the native comments system.

## What it helps you do

- Clean up comment notification emails so moderation is easier.
- Require acceptance of a comment policy before submission.
- Forward comments to another email address and optionally trash them.
- Set minimum and maximum comment lengths.
- Redirect first-time commenters to a thank-you page.
- Change a comment's parent ID from the comment edit screen.
- Email an individual commenter from the comments screen.
- Email all commenters on a post from the admin bar.
- Route comment emails to another user from a post's discussion settings.

## Installation

### From WordPress admin

1. In your WordPress dashboard, go to **Plugins → Add New**.
2. Search for **Comment Experience** or **comment hacks**.
3. Install and activate the plugin.
4. Go to **Settings → Comment Experience** to configure the available options.

### Manual installation

1. Download the plugin zip.
2. Upload the `comment-hacks` folder to `/wp-content/plugins/`.
3. Activate the plugin in **Plugins**.
4. Go to **Settings → Comment Experience** to configure the available options.

## Screenshots

### Cleaner comment notification emails
![Cleaner comment notification emails](.wordpress-org/screenshot-1.png)

### Edit a comment's parent directly from the comment screen
![Edit a comment's parent directly from the comment screen](.wordpress-org/screenshot-2.png)

### Configure comment length, policy, redirects, email links, and forwarding from one settings screen
![Configure comment settings](.wordpress-org/screenshot-3.png)

### Email all commenters on a post from the WordPress admin bar
![Email all commenters on a post from the WordPress admin bar](.wordpress-org/screenshot-4.png)

### Contact an individual commenter from the comments list table
![Contact an individual commenter from the comments list table](.wordpress-org/screenshot-5.png)

## Support, issues, and security

- Questions or support: [WordPress.org support forum](https://wordpress.org/support/plugin/yoast-comment-hacks/)
- Bug reports and feature requests: [GitHub issues](https://github.com/ProgressPlanner/comment-hacks/issues)
- Security reports: [Patchstack VDP](https://patchstack.com/database/vdp/comment-hacks)

## Contributing

Contributions are welcome. Please read [`.github/CONTRIBUTING.md`](.github/CONTRIBUTING.md) before opening an issue or pull request.

## Links

- [Plugin page on WordPress.org](https://wordpress.org/plugins/yoast-comment-hacks/)
- [Progress Planner](https://progressplanner.com/)
