=== Some Plus Report Post === Contributors: someplus Donate link: https://buymeacoffee.com/yavuzyildirim Tags: report, content moderation, spam, inappropriate content, user reports Requires at least: 5.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 1.5.0 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Allow users to report inappropriate content on your WordPress site. Admins can review, filter, and manage reports from a dedicated dashboard. == Description == Some Plus Report Post is a powerful and easy-to-use plugin that allows your website visitors to report inappropriate, spam, or policy-violating content — including individual comments. Site administrators can review reports, receive email notifications, and automatically take action when reports exceed a threshold. = Key Features = * **User Reporting**: Visitors can report content with customizable reasons * **Comment Reporting**: Visitors can report individual comments, not just posts * **Admin Dashboard**: Comprehensive reports management interface with stats * **Admin Notifications**: Receive an email every time a new report is submitted * **Threshold Actions**: Automatically unpublish or trash a post when report count exceeds a limit * **Customizable Reasons**: Define your own report reasons * **Post Type Support**: Enable reporting for any public post type * **Rate Limiting**: Prevent spam reports with built-in rate limiting * **Guest Reporting**: Optionally allow non-logged-in users to report * **Spam Protection**: Built-in honeypot blocks automated form submissions * **Privacy Notice**: Show a GDPR-friendly notice inside the report modal * **Data Retention**: Automatically delete old reports after a configurable number of days * **CSV Export**: Download all reports as a spreadsheet * **Shortcode Support**: Place report buttons anywhere with `[sprp_report]` * **Auto-Append**: Automatically add report buttons to post content * **Advanced Filtering**: Filter reports by post type, status, item type, reason, and date range * **AJAX Submission**: Smooth, no-refresh reporting experience * **Accessible**: WCAG 2.1 compliant modal with focus trap and keyboard navigation * **Translation Ready**: Fully internationalized = How It Works = 1. Install and activate the plugin 2. Configure settings under **Reports → Settings** 3. Choose which post types should have reporting enabled 4. Customize report reasons (or use the built-in defaults) 5. Visitors can now report content and comments using the report button 6. Review and filter reports under **Reports** 7. Take action: delete, unpublish, dismiss, or let the threshold automation handle it = Shortcode Usage = Display the report button anywhere: `[sprp_report]` Target a specific post: `[sprp_report post_id="123"]` Add a custom CSS class to the button: `[sprp_report class="my-custom-class"]` = For Developers = Some Plus Report Post is built with extensibility in mind: * Action hook: `sprp_report_submitted( $report_id, $post_id, $reason_id, $reason_text )` — fires after a report is saved * Clean, well-documented code following WordPress Coding Standards * Namespace `SomePlusReportPost\` with SPL autoloader * All queries use `$wpdb->prepare()` == Installation == = Automatic Installation = 1. Go to **Plugins → Add New** in your WordPress admin 2. Search for "Some Plus Report Post" 3. Click "Install Now" and then "Activate" = Manual Installation = 1. Download the plugin zip file 2. Go to **Plugins → Add New → Upload Plugin** 3. Upload the zip file and click "Install Now" 4. Activate the plugin = Configuration = 1. Go to **Reports → Settings** 2. Select which post types should have reporting enabled 3. Optionally enable **Auto Append Report Button** so the button appears automatically 4. Customize report reasons as needed 5. Set up email notifications and threshold actions under **Notifications & Automation** 6. Save your settings == Frequently Asked Questions == = Can guests report content? = Yes, you can enable guest reporting in the settings. Guest reports are tracked by IP address for rate limiting purposes. = Can visitors report comments? = Yes. When comment reporting is active, a Report button appears below each approved comment automatically. Reports are tracked separately for posts and comments. = How do I customize the report reasons? = Go to **Reports → Settings** and scroll to the "Report Reasons" section. Add, edit, or remove reasons as needed. If you save custom reasons, the default reasons are replaced entirely. = Can I use this with custom post types? = Yes. Any public post type registered on your site appears in the settings, and you can enable reporting for any of them. = How do I receive email notifications for new reports? = Go to **Reports → Settings → Notifications & Automation**, enable **Admin Email Notification**, and enter the email address you want to notify. = What is the Threshold Action? = When the number of pending reports for a post reaches the configured count, the plugin can automatically: move the post to draft (Unpublish), send it to trash, or just send you an urgent email without touching the post. Each post only triggers this once. = How do I reset the threshold for a post? = Delete the `_sprp_threshold_triggered` post meta from the post. You can do this under the post editor's Custom Fields panel, or via WP-CLI: `wp post meta delete _sprp_threshold_triggered` = Is the plugin GDPR compliant? = The plugin stores IP addresses (for guest rate limiting) and report details. You should mention this in your privacy policy. Use the **Data Retention** setting to automatically delete old reports after a set number of days. All data is permanently removed when the plugin is uninstalled. You can also enable a **Privacy Notice** in settings to display a note inside the report form. = Can I export reports? = Yes. Click the **Export CSV** button on the Reports page to download a spreadsheet of all reports. The export respects the filters currently applied, so you can export only pending reports, or only reports from the last 30 days, etc. = Can I style the report button? = Yes. The button uses the class `sprp-button` and the wrapper uses `sprp-wrapper`. Add CSS to your theme's stylesheet or via **Appearance → Customize → Additional CSS**. = How do I prevent spam reports? = The plugin includes built-in rate limiting (configurable maximum reports per user or IP per 24 hours) and a honeypot field that silently blocks automated form submissions. = What happens when I deactivate the plugin? = Reports and settings are preserved. Only scheduled cleanup events and transient caches are cleared. Data is removed only when you permanently delete (uninstall) the plugin. = What happens when I uninstall the plugin? = The reports database table, all plugin options, and the admin capability are permanently removed. This cannot be undone. == Screenshots == 1. Report button displayed after post content 2. Report modal with reason selection 3. Admin reports list with statistics and filters 4. Plugin settings page — General Settings 5. Plugin settings page — Notifications & Automation 6. Customizable report reasons 7. Report detail modal == Changelog == = 1.5.0 = * Added comment reporting — visitors can now report individual comments * Added admin email notifications on new report submission * Added threshold actions — automatically unpublish, trash, or get alerted when a post exceeds a report count * Added data retention — automatically delete reports older than a configurable number of days * Added privacy notice — optionally display a GDPR notice inside the report form * Added CSV export — download all reports (with active filters applied) as a spreadsheet * Added honeypot spam protection to the report form * Added five report filters: Post Type, Report Status, Item Type, Reason, and Date Range * Added "Reported" column to admin list (Post / Comment / Post + Comment) * Added Notifications & Automation settings section with eight new options * Improved admin list table column layout and added white-space: nowrap to narrow columns * Database table extended with item_type and comment_id columns (existing installs upgraded automatically) = 1.1.2 = * Minor internal fixes = 1.1.0 = * Internal update = 1.0.0 = * Initial release * User content reporting with customizable reasons * Admin dashboard for managing reports * Shortcode support * Auto-append option for post types * Rate limiting and spam protection * Guest reporting option * Full internationalization support == Upgrade Notice == = 1.5.0 = Major update. Adds comment reporting, email notifications, threshold automation, CSV export, honeypot protection, and advanced filtering. The database table is updated automatically on first load — no manual action required. = 1.0.0 = Initial release of Some Plus Report Post plugin. == Privacy Policy == Some Plus Report Post stores the following data: * **For logged-in users**: User ID and report details (post ID, reason, additional note, date) * **For guests**: IP address (for rate limiting) and report details No data is sent to external servers. To limit how long data is stored, use the **Data Retention** setting under Notifications & Automation to automatically delete reports after a set number of days. All stored data is permanently deleted when the plugin is uninstalled. == Credits == * Developed by [Some Plus](https://someplus.work) * Built with WordPress Coding Standards * Icons from Feather Icons (MIT License)