=== Neutrope Quiet Shield ===
Contributors: neutropeinc
Tags: spam, antispam, contact form 7, spam protection, forms
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 0.1.2
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Quietly deflect spam and unsolicited sales messages sent through Contact
Form 7. Lightweight, no external calls, no stored personal data.

== Description ==

Neutrope Quiet Shield adds lightweight spam and unsolicited-sales filtering to
Contact Form 7 submissions. The idea is simple: let spam and cold sales
mail be received quietly without disturbing the people running the site.

Each submission is scored against a small set of checks you control:

* Japanese character ratio: flag messages with too little Japanese text.
* URL limit: flag messages that contain more links than you allow.
* Submission speed: flag forms submitted suspiciously fast after they were
  shown. The timing value is signed so it cannot be tampered with.
* Repeat submissions: flag three or more submissions from the same visitor
  within five minutes.
* NG words: flag messages containing any keyword from your own list.

When a submission is flagged you choose what happens with Quiet Mode:

* Quiet Mode on (default): the visitor sees the normal success message, but
  no mail is sent. The reason is written to the log.
* Quiet Mode off: the submission is stopped with the standard Contact Form
  7 error message.

The plugin is deliberately small. It makes no external network requests,
creates no database tables, and shows no ads or upsells. Configuration is
stored in a single option, and the log keeps only decision metadata plus a
short, salted IP hash. Message bodies, e-mail addresses and names are never
stored.

If Contact Form 7 is not active, the plugin still activates safely and
shows an admin notice instead of causing an error.

This plugin is an independent add-on and is not affiliated with or endorsed
by the authors of Contact Form 7.

== Features ==

* Five independent checks, each configurable from one settings page.
* Quiet Mode to silently drop flagged mail or stop it with an error.
* Dashboard with today's passed and blocked counts and a recent activity
  log.
* Tamper-evident submission-speed measurement using a signed field.
* IP addresses are hashed, never stored in raw form.
* No external requests, no tracking, no database tables, no ads.
* GPL-2.0-or-later. The full license text is bundled in the LICENSE file.

== Installation ==

1. Upload the `neutrope-quiet-shield` folder to the `/wp-content/plugins/`
   directory, or install the plugin through the WordPress Plugins screen.
2. Activate Neutrope Quiet Shield through the Plugins screen.
3. (Recommended) Install and activate Contact Form 7.
4. Open "Quiet Shield" in the admin menu and adjust the checks and Quiet
   Mode on the Settings page.

== Frequently Asked Questions ==

= Does this plugin require Contact Form 7? =

The checks run only on Contact Form 7 submissions. The plugin still
activates without Contact Form 7 and shows a notice instead of failing.

= What happens to a flagged submission? =

With Quiet Mode on (the default), the visitor sees the success message but
no mail is sent and the reason is logged. With Quiet Mode off, the
submission is stopped with the standard Contact Form 7 error message.

= Does it store personal data? =

No message bodies, e-mail addresses or names are stored. The log keeps only
the date and time, the form ID, the reason, a short salted IP hash, a score
and whether Quiet Mode was used.

= Does it make any external network requests? =

No. All checks run locally on your site.

= Can a bot fake the submission-speed check? =

The render time is stored in a signed hidden field. If the value is
altered, the signature no longer matches and the submission is flagged as
tampered. On heavily cached pages the timing field may be stale, in which
case the speed check is simply skipped rather than producing a false
positive.

= What data does it store? =

Three options: `neutqush_settings` (your configuration), `neutqush_logs` (the recent
activity log) and `neutqush_stats` (today's counters). All are removed when the
plugin is deleted.

== Screenshots ==

1. Quiet Shield ダッシュボード。今日の正常送信数・ブロック数と最新ログを確認できます。
2. 基本設定画面。Quiet Mode、日本語率チェック、URL数制限、送信速度判定などを設定できます。
3. NGワード設定。迷惑送信に含まれやすいキーワードを自由に登録できます。
4. Quiet Mode の設定例。送信者には成功表示を返しながら、迷惑送信を静かに処理できます。
5. Contact Form 7 連携ログ。判定理由やフォームIDを確認し、迷惑送信の傾向を把握できます。

== Changelog ==

= 0.1.2 =
* Replace remaining short internal prefixes for WordPress.org review compatibility.

= 0.1.1 =
* Fix plugin prefix naming for WordPress.org review.

= 0.1.0 =
* Initial release.
* Contact Form 7 submission scoring: Japanese ratio, URL limit, submission
  speed, repeat-submission limit and NG words.
* Quiet Mode to silently drop flagged mail or stop it with an error.
* Dashboard with daily counts and a recent activity log.
* Single-option storage, hashed IP handling and uninstall cleanup.

== Upgrade Notice ==

= 0.1.2 =
Replaces remaining short internal prefixes for WordPress.org review compatibility.

= 0.1.1 =
Prefix naming update for WordPress.org review.

= 0.1.0 =
First release. Lightweight spam and sales-mail filtering for Contact Form 7.

== License ==

This plugin is licensed under the GPL-2.0-or-later. The full license text
is included in the bundled LICENSE file.
License URI: https://www.gnu.org/licenses/gpl-2.0.html
