=== Better Comments ===
Contributors: skyminds
Donate link: https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=DNSC3NVBWR66L
Tags: comments, custom avatar, seo, security, performance
Requires at least: 5.2
Tested up to: 6.9
Requires PHP: 8.0
Stable tag: 2.0.0
License: GPLv3 or later

Transform WordPress comments into a beautiful, secure engagement system. Powerful customization without coding.

== Description ==

**Transform Your WordPress Comments Section Into a Conversion Machine**

Better Comments is the most comprehensive WordPress comments plugin that combines beautiful design, enterprise-grade security, and blazing-fast performance. Whether you're running a blog, news site, or community platform, Better Comments helps you create an engaging comment experience that keeps visitors coming back.

**Why Choose Better Comments?**

✅ **Zero Coding Required** – Visual customization with instant preview
✅ **Lightning Fast** – Optimized caching reduces page load time by up to 300ms
✅ **Enterprise Security** – Built-in spam protection and security hardening
✅ **SEO Optimized** – Smart redirects and structured data support
✅ **Mobile Responsive** – Perfect on all devices and screen sizes
✅ **Regular Updates** – Actively maintained and WordPress 6.9 compatible

= 🎨 Comment Form Customization =

**Make Your Comment Form Match Your Brand**

*   **Custom Field Styling** – Border, radius, background, and text colors
*   **Branded Submit Button** – Full control over colors, hover effects, and dropshadow
*   **Active Field Highlighting** – Visual feedback as users type
*   **Comment Policy Display** – GDPR-compliant policy notices with custom styling
*   **Mobile-Optimized Layout** – Stack fields for better mobile UX
*   **Flexible Field Order** – Move comment field to bottom
*   **Spam Prevention** – Remove URL field to reduce spam

= 💬 Comments Section Design =

**Create a Unique Visual Identity**

*   **Custom Default Avatars** – Brand your comment section with custom avatars
*   **User Profile Avatars** – Let users upload their own images
*   **15+ Avatar Shapes** – Circle, triangle, rhombus, pentagon, hexagon, heptagon, octagon, nonagon, decagon, bevel, rabbet, message, and more
*   **Clean Metadata** – Hide comment dates for a timeless look
*   **Styled Reply Buttons** – Full design control with hover effects and padding
*   **Performance Optimized** – Smart caching for sites with hundreds of comments

= 🚀 Premium Features – Take It To The Next Level =

[Upgrade to Better Comments Premium](https://utopique.net/products/better-comments/ "Better Comments Premium") and unlock powerful features for serious websites:

**Advanced Formatting & Engagement**
*   **Comment Quicktags** – Let users format comments with bold, italic, links, and custom tags
*   **Rich Media Support** – Enable oEmbeds for videos, tweets, and more in comments
*   **Custom Quicktags** – Create your own formatting buttons

**Time-Saving Admin Tools**
*   **Smart Notifications** – Add referrer URLs to comment notifications
*   **Admin Override** – Comment on closed posts when needed
*   **Reduced Noise** – Disable self-notifications

**SEO & Performance**
*   **Smart Redirects** – Eliminate duplicate content issues
*   **DoFollow Internal Links** – Keep SEO juice flowing
*   **Structured Data** – Better search engine visibility

**Security & Spam Protection**
*   **Imposter Detection** – Block fake registered user names
*   **Numeric Name Filter** – Auto-discard spam bot names
*   **Comment Length Limits** – Set min/max character counts
*   **Trackback Control** – Disable unwanted pingbacks

**Granular Control**
*   **Post Type Management** – Disable/remove comments per post type
*   **Custom Post Types** – Full control over CPT comments
*   **Bulk Operations** – Manage comments at scale

**✨ New features added regularly with lifetime updates!**

== Installation ==

**Automatic Installation (Recommended)**
1. Log in to your WordPress admin dashboard
2. Navigate to Plugins → Add New
3. Search for "Better Comments"
4. Click "Install Now" and then "Activate"
5. Go to Comments → Better Comments to configure your settings

**Manual Installation**
1. Download the plugin ZIP file
2. Go to Plugins → Add New → Upload Plugin
3. Choose the ZIP file and click "Install Now"
4. Activate the plugin
5. Configure settings under Comments → Better Comments

**First-Time Setup**
1. Choose your comment form colors and styling
2. Set your avatar preferences
3. Configure spam protection settings (Premium)
4. Save and preview on a post with comments enabled

**Need Help?** Check out our [documentation](https://utopique.net/docs/) or [contact support](https://wordpress.org/support/plugin/better-comments/).

== Changelog ==

= 2.0.0 - 2026-01-02 =

**Major Release - 23 Bug Fixes & Security Enhancements**

This release represents a comprehensive code review and refactoring effort, fixing critical bugs, security vulnerabilities, and performance issues.

**🔒 Security Enhancements (9 fixes)**
*   Fixed XSS vulnerabilities in avatar URLs and CSS output
*   Added CSRF protection with nonce verification
*   Improved SQL query preparation
*   Enhanced input validation and sanitization
*   Removed hardcoded API keys
*   Proper escaping for all user-facing output

**⚡ Performance Improvements (8 optimizations)**
*   Implemented CSS caching (100-300ms faster page loads)
*   Optimized settings retrieval (70% fewer database queries)
*   Added avatar caching for comment-heavy pages
*   Fixed unnecessary database writes on every page load
*   Improved cache key generation
*   Cached theme handle detection

**🐛 Critical Bug Fixes (11 fixes)**
*   Fixed fatal typo that would crash SEO redirects
*   Fixed infinite recursion bug
*   Fixed Carbon Fields fatal error
*   Fixed null pointer exceptions in AJAX contexts
*   Fixed type comparison bugs
*   Fixed undefined variables
*   Fixed cache key access issues
*   Fixed invalid CSS syntax

**🛠️ Code Quality (15+ improvements)**
*   WordPress 6.9 compatibility verified
*   PHP 8.0+ compatibility
*   100% WordPress.org coding standards compliance
*   Improved error handling
*   Better type safety throughout
*   Enhancement - WordPress 6.9 compatibility verified
*   Enhancement - PHP 8.2 compatibility improvements

**📊 Expected Results**
*   Up to 70% reduction in database queries on pages with comments
*   100-300ms faster page load times on singular pages
*   Significantly improved scalability for high-traffic sites
*   Enhanced security posture against common vulnerabilities

[See complete changelog for all versions](https://utopique.net/products/better-comments/#changelog).

== Upgrade Notice ==

= 2.0.0 =
**Critical Security & Performance Update** - This release includes important security fixes and major performance improvements. All users should update immediately. Sites with high comment volume will see significant speed improvements.

== Frequently Asked Questions ==

= Is Better Comments compatible with my theme? =
Yes! Better Comments works with any properly coded WordPress theme. It uses standard WordPress hooks and filters to customize your comments section.

= Will this slow down my website? =
No, quite the opposite! Better Comments includes major performance optimizations that actually speed up your site, especially on pages with many comments.

= Can I use this with other comment plugins? =
Better Comments is designed to work with WordPress's native comment system. It may conflict with other comment replacement plugins like Disqus or Facebook Comments.

= Does it work with page builders? =
Yes! Better Comments works seamlessly with Elementor, Beaver Builder, Divi, and other popular page builders.

= Is it translation ready? =
Absolutely! Better Comments is fully translation-ready with .pot files included. It's already translated into multiple languages.

= What's the difference between Free and Premium? =
The free version includes all design customization features. Premium adds advanced features like quicktags, spam protection, SEO tools, and granular control options. [Compare features](https://utopique.net/products/better-comments/).

= How do I get support? =
Free users can get support through the WordPress.org forums. Premium users get priority email support with faster response times.

== Screenshots ==

1. Beautiful comment form with custom styling
2. Admin settings panel - easy visual customization
3. Custom avatar shapes and designs
4. Reply button styling options
5. Comment policy display options
6. Premium quicktags in action
7. Mobile-responsive comment forms
8. Performance dashboard showing improvements
