CWeb Product Finder for Gravity Forms
| 开发者 | alexandreminem |
|---|---|
| 更新时间 | 2026年8月13日 23:33 |
| PHP版本: | 8.0 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
CWeb Product Finder for Gravity Forms turns a Gravity Forms questionnaire into a product picker. At the end of the form, the plugin scores each of your products against the visitor's answers and displays the best match (plus a couple of alternatives) as styled cards.
The scoring engine is fully local PHP. No OpenAI, no Claude, no remote service. You define rules in a clear "When → Then" admin UI: when the visitor's answers match certain conditions, boost / penalize / exclude / require specific products.
Highlights
- Two product sources: built-in Recommended Products CPT, or your existing WooCommerce catalog.
- Direct product targeting: rules pick the products they affect by ID, no tag indirection. Auto-completed from your form's actual fields and choices.
- AND / OR conditions: combine multiple form answers in a single rule.
- Four effects: Boost (+N points), Penalize (−N points), Exclude (hard filter), Require (only required products are eligible).
- No external API: all scoring happens on your server. Predictable, free, and private.
- Setup wizard plus dedicated Scoring Rules and Help admin pages.
- Hidden field auto-detection: the plugin scans your form for hidden fields and picks the right one (or asks if there are several).
- Example form included: a small SaaS Plan Picker you can import and start tinkering with right away.
- Theme-friendly CSS: all classes prefixed
.cwebpf-*, with CSS variables for colors and fonts. - AI fallback hook:
cwebpf_ai_fallback_recommendationfilter lets you plug an AI service for ambiguous cases. No built-in API call.
- Web hosting / VPS plan finder
- SaaS pricing wizard ("which plan is right for you?")
- Service quote estimator
- Insurance / financial product recommender
- B2B product configurator
安装:
- Upload the plugin to
/wp-content/plugins/cweb-product-finder-for-gravity-forms/, or install through the Plugins menu in WordPress. - Activate the plugin.
- Go to Recommender → Setup and follow the 5-step wizard.
- Add your products under Recommender → All Products (or use existing WooCommerce products).
- Paste the shortcode generated by the wizard into your Gravity Form confirmation.
屏幕截图:
常见问题:
Does this plugin call any external API?
No. All scoring happens locally in PHP. Your visitors' answers never leave your server.
Does it require Gravity Forms?
Yes. Gravity Forms is the questionnaire engine. The plugin is a companion that hooks into form submissions.
Can I use my existing WooCommerce products?
Yes. In the setup wizard, choose "WooCommerce products" as the source. Reference your existing products by ID in the scoring rules. The rule editor auto-completes from your catalog.
How do I customize the look of the recommendation cards?
All HTML uses classes prefixed .cwebpf-*. Colors and fonts are exposed as CSS custom properties (--cwebpf-primary, --cwebpf-accent, --cwebpf-font-heading, etc.). Override them in your theme stylesheet.
Can I write my own scoring logic in PHP?
Yes. The recommendation result and explanation pass through filters (cwebpf_recommendation_explanation, cwebpf_form_id, cwebpf_field_id, cwebpf_fallback_contact_url, cwebpf_card_disclaimer). Advanced users can also call CWebPF_Recommendation_Engine::recommend() directly.
Where is the data stored?
Recommendation rules: wp_options (cwebpf_scoring_rules, cwebpf_form_config, cwebpf_product_source). Products: the standard wp_posts / wp_postmeta tables (CPT cwebpf_product or WooCommerce products). No custom database tables are created.
更新日志:
3.1.4
- Tested against WordPress 7.1 on PHP 8.3. No code change was required for the 7.1 editor iframe, client-side media processing, jQuery UI 1.14.2 or the persistent toolbar: the plugin registers no block-editor asset, no jQuery dependency and no media hook.
- Fixed a PHP warning ("Undefined array key condition_logic") raised by the scoring engine when a stored rule predates the AND/OR condition logic setting.
- Replaced
file_get_contents()withwp_json_file_decode()when importing the bundled example form, clearing the last Plugin Check warning. - The setup wizard and its admin notice now show the current plugin name. Five strings still carried the pre-3.1.3 name "Product Finder for Gravity Forms".
- Plugin renamed to "CWeb Product Finder for Gravity Forms" with a distinctive
cweb-prefix per WordPress.org naming guidelines. - All internal identifiers (functions, classes, constants, options, post meta, CSS classes, CSS variables, filters, shortcode) renamed from
gr_*/GR_*/.gr-*tocwebpf_*/CWEBPF_*/CWebPF_*/.cwebpf-*to satisfy the 4+ character prefix rule. - All inline
<style>and<script>blocks moved to standalone files inassets/css/admin.css,assets/js/admin-rules.js, andassets/js/admin-onboarding.js, registered viawp_enqueue_style,wp_enqueue_script, and localized withwp_localize_script. Each asset is conditionally loaded only on its own admin screen. - Shortcode renamed:
[gravity_recommender]→[cwebpf_recommender].
- First WordPress.org submission attempt. Plugin renamed to "Product Finder for Gravity Forms".
- Plugin Checker: replaced
(int) wp_unslash(...)withabsint(wp_unslash(...))on$_POST['gr_form_id']and$_GET['step']. Static analyzers don't accept type casts as sanitization. - Filter renamed:
gr_gravityforms_affiliate_url→gr_gravityforms_url. - Fixed self-referencing CSS custom properties in
:root. Default colors and fonts now render even when the theme doesn't override them. - LICENSE and license-string wording uniformized as "GPLv2 or later" across all files.
- Hotfix: critical fatal error on Setup step 3 ("Products"). The CPT product source was calling a method removed in 3.1.0.
- WordPress.org Plugin Checker compliance: removed
load_plugin_textdomain()(auto-loaded since WP 4.6), addedlanguages/folder, fixedtranslators:comment placement, switched to explicit per-fieldwp_unslash() + sanitize_*()chains across all admin pages.
- Scoring engine rewritten: rules target products directly by ID (no more tag indirection).
- New conditions builder with AND / OR logic and four effects per rule (Boost / Penalize / Exclude / Require).
- New dedicated "Scoring Rules" admin page.
- New "Help" admin page (how-it-works, shortcode, filters, credits).
- Hidden field auto-detection in the setup wizard.
- Wizard restructured: products are added before the form is wired.
- Graceful flow when Gravity Forms is missing (install/buy CTA, no broken state).
- Example form replaced with a generic SaaS Plan Picker.
gr_ai_fallback_recommendationfilter for plugging an optional AI fallback.
- First general-purpose release.
- Tag-based scoring engine.
- Custom Post Type for managing recommended products.
- WooCommerce product source support.
- 5-step setup wizard with example form import.
- CSS variables for theming.