README 文档

README

Only loads Contact Form 7 scripts and styles on pages that actually contain a form. Zero configuration.

Fixes Contact Form 7 #1278 — CF7 enqueues its JS, CSS, reCAPTCHA, Turnstile, and Stripe scripts on every single page, even pages with no form. This plugin detects whether the current page has a CF7 form and dequeues all CF7 assets when no form is present.

Author: Renzo Johnson

Requirements

PHP 8.4+
WordPress 6.4+
Contact Form 7 5.0+

Installation

Via Composer

composer require renzojohnson/cf7-asset-optimizer

Manual

Download and upload to /wp-content/plugins/cf7-asset-optimizer/, then activate.

As mu-plugin

Copy cf7-asset-optimizer.php to /wp-content/mu-plugins/.

How It Works

The plugin hooks into CF7's own wpcf7_load_js and wpcf7_load_css filters to conditionally disable asset loading. On pages without a form, it also dequeues module scripts (reCAPTCHA, Turnstile, Stripe, SWV).

Detection

The plugin checks for CF7 forms in:

[contact-form-7] shortcode in post content
[contact-form] shortcode (legacy alias)
contact-form-7/contact-form-selector Gutenberg block
CF7 widgets in sidebar areas
CF7 shortcodes inside text widgets
CF7 blocks inside block widgets

Assets Dequeued

When no form is detected, these handles are dequeued:

Handle	Source
`contact-form-7`	Main CF7 JS
`contact-form-7-html5-fallback`	Datepicker fallback
`swv`	Schema-based Validation
`wpcf7-recaptcha`	reCAPTCHA v3 handler
`google-recaptcha`	Google reCAPTCHA API
`cloudflare-turnstile`	Cloudflare Turnstile API
`wpcf7-stripe`	Stripe JS
`contact-form-7` (style)	Main CF7 CSS
`contact-form-7-rtl` (style)	RTL CSS
`jquery-ui-smoothness` (style)	jQuery UI theme
`wpcf7-stripe` (style)	Stripe CSS

Edge Cases

For forms rendered via PHP templates or dynamic shortcodes not in post content:

// Force-load CF7 assets on specific pages
add_filter('cf7ao_has_form', function (?bool $has_form): ?bool {
    if (is_page('custom-form-page')) {
        return true;
    }
    return $has_form;
});

Testing

composer install
vendor/bin/phpunit

Related Project

If you use Contact Form 7 with Mailchimp, check out Chimpmatic — a CF7-to-Mailchimp integration plugin with 50,000+ active installations. Supports merge field mapping, subscriber tags, groups, double opt-in, and GDPR consent. Built by the same developer.

License

renzojohnson/cf7-asset-optimizer 适用场景与选型建议

renzojohnson/cf7-asset-optimizer 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 0 次下载、GitHub Stars 达 0，最近一次更新时间为 2026 年 02 月 24 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「performance」「wordpress」「optimization」「wpcf7」「contact-form-7」「cf7」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 renzojohnson/cf7-asset-optimizer 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

renzojohnson/cf7-asset-optimizer

包简介

关键字：