Title: YomuForm
Author: haraikawa
Published: <strong>ମଇ 21, 2026</strong>
Last modified: ମଇ 21, 2026

---

Search plugins

![](https://ps.w.org/yomuform/assets/banner-772x250.png?rev=3541957)

![](https://ps.w.org/yomuform/assets/icon-256x256.png?rev=3541957)

# YomuForm

 By [haraikawa](https://profiles.wordpress.org/haraikawa/)

[Download](https://downloads.wordpress.org/plugin/yomuform.0.1.3.zip)

 * [Details](https://ory.wordpress.org/plugins/yomuform/#description)
 * [Reviews](https://ory.wordpress.org/plugins/yomuform/#reviews)
 *  [Installation](https://ory.wordpress.org/plugins/yomuform/#installation)
 * [Development](https://ory.wordpress.org/plugins/yomuform/#developers)

 [Support](https://wordpress.org/support/plugin/yomuform/)

## Description

YomuForm is a plugin for Contact Form 7 that uses AI to classify each form submission
as either a real customer inquiry or a sales solicitation. Cold sales outreach, 
recruiting pitches, business development proposals, scams, and competitor research
are detected and labeled, so site owners can:

 * Declutter the inbox by filtering out cold sales outreach
 * Restore the accuracy of Google Analytics conversion tracking by excluding fake
   conversions

Before Contact Form 7 sends the email, YomuForm injects the classification result
into the subject and body, making it easy to route messages with mail-client filters
or GA4 rules.

#### Features

 * Seamless Contact Form 7 integration via the wpcf7_before_send_mail hook. No template
   edits required.
 * Bring Your Own Key (BYOK): use your own API key for Anthropic Claude, OpenAI,
   or Google Gemini. Classification traffic does not pass through the plugin author’s
   servers.
 * Ready-to-use prompt out of the box. Optional “additional guidance” textarea lets
   you tune the classifier to your industry and policy.
 * Test panel: try classifications with sample inputs without touching the production
   flow. Ships with 10 sample submissions.
 * Judgment log: last 100 classifications stored in the dashboard, including timestamp,
   category, confidence, reason, and a 500-character excerpt of the submission.
 * Single-recipient email notification for “real inquiry” submissions, so the noise
   of sales spam is filtered out of your alert channel.
 * CF7 receipt mail augmentation: a “flag: 1/0” + confidence stamp is injected at
   the top of the standard CF7 email so client-side filters can route reliably.
 * API keys stored encrypted with AES-256 (key material derived from wp_salt(‘auth’)).
 * Verify button to test API connectivity before saving.
 * Category management: full CRUD (add / remove / rename / edit description / toggle
   sales flag) on all classification categories, including the 6 defaults.

### External services

This plugin sends form submission content to whichever AI provider you configure.
To use the plugin you must obtain and enter your own API key from one of the supported
providers. The plugin author does not proxy, store, or otherwise handle this classification
traffic.

#### Anthropic Claude

Used when “Anthropic” is selected as the provider in the settings. The plugin sends
a single POST request to `https://api.anthropic.com/v1/messages` with the user’s
prompt (which contains the Contact Form 7 submission content) and the user’s API
key in the `x-api-key` header. This happens once per Contact Form 7 submission, 
only when the API key is set.

 * Site: https://www.anthropic.com/
 * Terms of service: https://www.anthropic.com/legal/consumer-terms
 * Privacy policy: https://www.anthropic.com/legal/privacy

#### OpenAI

Used when “OpenAI” is selected as the provider. The plugin sends a single POST request
to `https://api.openai.com/v1/chat/completions` with the user’s prompt and Bearer
token authorization. This happens once per Contact Form 7 submission, only when 
the API key is set.

 * Site: https://openai.com/
 * Terms of use: https://openai.com/policies/terms-of-use
 * Privacy policy: https://openai.com/policies/privacy-policy

#### Google Gemini

Used when “Gemini” is selected as the provider. The plugin sends a single POST request
to `https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent`(
with the model name selected by the user) and the user’s API key in the query string.
This happens once per Contact Form 7 submission, only when the API key is set.

 * Site: https://ai.google.dev/
 * Gemini API terms: https://ai.google.dev/gemini-api/terms
 * Privacy policy: https://policies.google.com/privacy

### Privacy Notice

This plugin handles the following data:

 * **Form submission content** – Contact Form 7 submission content is sent to the
   AI provider you configure (Anthropic, OpenAI, or Google) for classification. 
   The plugin author neither proxies nor stores this traffic.
 * **Judgment log** – A 500-character excerpt of the submission, plus its SHA-256
   hash, plus the classification result, confidence, reason, model name, and token
   count, are stored in the WordPress database. The log is capped at 100 entries(
   ring buffer); older entries are deleted automatically.
 * **API key** – Your AI provider API key is encrypted with AES-256-CBC before storage.
   It is deleted when the plugin is uninstalled.

All data is removed on uninstall (see uninstall.php).

## Screenshots

 * [[
 * Judgment Log – last 100 classifications with sales/inquiry badge, category, confidence,
   and reason.
 * [[
 * Categories – full CRUD on classification categories with editable key, label,
   description, and sales flag.
 * [[
 * Prompt Editor – additional guidance textarea and read-only preview of the final
   system prompt.

## Installation

 1. Upload the plugin and activate it.
 2. Obtain an API key from one of the supported AI providers:
 3.  * Anthropic: https://console.anthropic.com/
     * OpenAI: https://platform.openai.com/api-keys
     * Google: https://aistudio.google.com/apikey
 4. In the WordPress admin, open YomuForm -> Settings, paste the API key, and click“
    Verify” to confirm connectivity.
 5. Use Contact Form 7 as you normally would. Submissions will be classified, logged,
    and (optionally) routed automatically.

## FAQ

### What do I need to run this plugin?

WordPress 6.0+, PHP 7.4+, Contact Form 7 5.7+, and an API key from Anthropic, OpenAI,
or Google.

### Is there a monthly fee?

YomuForm itself is free. You pay the AI provider directly for API usage. Rough cost
per classification: about 0.001 yen with Claude Haiku, 0.002 yen with GPT-4o-mini,
0.001 yen with Gemini Flash.

### What happens if the AI API fails?

The CF7 form still submits normally. Classification is wrapped in a try/catch so
a failed or timed-out API call never blocks form submission. Only the classification
metadata is skipped.

### What happens to submissions classified as sales?

A “[Sales]” prefix is added to the email subject, and a stamp (flag: 0, confidence)
is injected at the top of the email body. Client-side filters can route these wherever
you like. The form submission itself completes normally.

### How is personal data handled?

The judgment log stores only the first 500 characters of the submission, plus a 
SHA-256 hash for duplicate detection. Uninstalling the plugin deletes all stored
data (see uninstall.php). Classification traffic is sent directly from your WordPress
server to the AI provider you chose; the plugin author’s servers never see it.

### Is the API key stored securely?

Yes. AES-256-CBC encryption is applied before storage, with the key material derived
from WordPress’s wp_salt(‘auth’). The encrypted key can only be decrypted on the
same WordPress installation.

### Can I customize the prompt to my industry?

Yes. In YomuForm -> Categories, you can add, remove, rename, or change the sales
flag of categories. The 6 default categories can be edited or removed freely. In
YomuForm -> Prompt, you can also add overall guidance that applies to every classification.

### What if my notification emails are not arriving?

YomuForm uses WordPress’s standard wp_mail() function. On shared hosts, the PHP 
mail() backend is often unreliable or gets flagged as spam. We strongly recommend
pairing the plugin with an SMTP plugin that routes through a reliable delivery service:

 * [WP Mail SMTP](https://wordpress.org/plugins/wp-mail-smtp/) – supports SendGrid,
   Postmark, Amazon SES, Mailgun, Gmail SMTP, and more
 * [Post SMTP](https://wordpress.org/plugins/post-smtp/) – similar feature set
 * [FluentSMTP](https://wordpress.org/plugins/fluent-smtp/) – lightweight, free,
   multi-service support

Email delivery is the lifeline of inquiry notifications. Use one of these to make
sure you don’t miss important leads.

## Reviews

There are no reviews for this plugin.

## Contributors & Developers

“YomuForm” is open source software. The following people have contributed to this
plugin.

Contributors

 *   [ haraikawa ](https://profiles.wordpress.org/haraikawa/)

[Translate “YomuForm” into your language.](https://translate.wordpress.org/projects/wp-plugins/yomuform)

### Interested in development?

[Browse the code](https://plugins.trac.wordpress.org/browser/yomuform/), check out
the [SVN repository](https://plugins.svn.wordpress.org/yomuform/), or subscribe 
to the [development log](https://plugins.trac.wordpress.org/log/yomuform/) by [RSS](https://plugins.trac.wordpress.org/log/yomuform/?limit=100&mode=stop_on_copy&format=rss).

## Changelog

#### 0.1.3

 * Categories admin screen now supports full CRUD: add, remove, rename keys, and
   toggle the sales flag for every category (including the 6 defaults).
 * Removed the previously-introduced `yomuform_log_max_entries` filter. Log retention
   is a straightforward 100-entry ring buffer with no extension hook.
 * Removed internal notes that framed certain features as restricted in this distribution.

#### 0.1.2

 * Added a single, dismissible admin notice asking active users for feedback. Shown
   only on YomuForm admin pages, only after 14 days of use and at least 10 classifications.
   Dismissible permanently per user. No star-rating coercion or rewards involved.

#### 0.1.1

 * Added `yomuform_after_classify` action hook so other plugins can subscribe to
   classification events.

#### 0.1.0

 * Initial release.
 * Contact Form 7 integration via wpcf7_before_send_mail hook.
 * Multi-provider AI classification: Anthropic Claude, OpenAI GPT, Google Gemini.
 * AES-256 encryption for API key storage.
 * API key connection verification button.
 * Category label/description editing.
 * Prompt editor with additional-guidance textarea and final-prompt preview.
 * Test execution UI with 10 bundled sample submissions.
 * Judgment log (last 100 entries).
 * Email notification for inquiries.
 * Automatic injection of classification stamp into CF7 receipt mail.

## Meta

 *  Version **0.1.3**
 *  Last updated **3 days ago**
 *  Active installations **Fewer than 10**
 *  WordPress version ** 6.0 or higher **
 *  Tested up to **6.9.4**
 *  PHP version ** 7.4 or higher **
 *  Language
 * [English (US)](https://wordpress.org/plugins/yomuform/)
 * Tags
 * [AI](https://ory.wordpress.org/plugins/tags/ai/)[classifier](https://ory.wordpress.org/plugins/tags/classifier/)
   [contact form](https://ory.wordpress.org/plugins/tags/contact-form/)[lead quality](https://ory.wordpress.org/plugins/tags/lead-quality/)
   [spam](https://ory.wordpress.org/plugins/tags/spam/)
 *  [Advanced View](https://ory.wordpress.org/plugins/yomuform/advanced/)

## Ratings

No reviews have been submitted yet.

[Your review](https://wordpress.org/support/plugin/yomuform/reviews/#new-post)

[See all reviews](https://wordpress.org/support/plugin/yomuform/reviews/)

## Contributors

 *   [ haraikawa ](https://profiles.wordpress.org/haraikawa/)

## Support

Got something to say? Need help?

 [View support forum](https://wordpress.org/support/plugin/yomuform/)