WordPress Form Email Encoding Lỗi – Nguyên Nhân Và Cách Sửa Toàn Diện

WordPress form email encoding lỗi là tình trạng thông báo gửi từ form liên hệ, đăng ký hoặc đặt hàng hiển thị ký tự lạ, dấu hỏi, hoặc mất hoàn toàn dấu tiếng Việt khi đến hộp thư người nhận. Vấn đề này xảy ra phổ biến trên các trang web sử dụng Contact Form 7, WPForms, Elementor Pro hoặc Gravity Forms. Encoding sai khiến email không đọc được, làm giảm uy tín thương hiệu và mất khách hàng tiềm năng. Bài viết này phân tích sâu nguyên nhân, hướng dẫn khắc phục từ cơ bản đến nâng cao, giúp bạn chấm dứt lỗi email encoding vĩnh viễn.

Dấu Hiệu Nhận Biết WordPress Form Email Encoding Lỗi

Người dùng thường gặp các biểu hiện sau khi email gửi từ form WordPress bị lỗi encoding:

• Tiêu đề hoặc nội dung email xuất hiện dấu hỏi liên tiếp: “Chào bạn, đơn hàng c?a b?n đã đ?t thành công”
• Ký tự lạ như “á”, “ẹ” thay vì “á”, “ẹ”
• Nội dung tiếng Việt hiển thị dạng mã hex: =E2=80=93 hoặc =C3=A1
• Một số email hoàn toàn trống rỗng hoặc tệp đính kèm bị hỏng

Nguyên Nhân Gây Lỗi Encoding Email Trong Form WordPress

Encoding lỗi bắt nguồn từ việc WordPress gửi email bằng hàm wp_mail() mà không thiết lập đúng charset hoặc mã hóa base64 cho nội dung. Các yếu tố chính:

Charset Mặc Định Không Phải UTF-8

WordPress thường sử dụng charset “UTF-8” cho email, nhưng nhiều plugin form hoặc theme tùy chỉnh ghi đè lên header thành “ISO-8859-1” hoặc không truyền charset. Khi người dùng nhập tiếng Việt, nguồn dữ liệu từ form được gửi bằng UTF-8, nhưng email lại được giải mã theo charset cũ, dẫn đến ký tự hỏng.

Thiếu Header Content-Type Với Encoding Thích Hợp

Hàm wp_mail() mặc định không thêm “Content-Type: text/plain; charset=UTF-8” hoặc “Content-Transfer-Encoding: base64” vào email. Một số máy chủ thư tự động gán encoding mặc định, gây ra xung đột. Đặc biệt với email dạng HTML (tin nhắn từ form có định dạng), thiếu header multipart hoặc base64 khiến trình nhận thư không biết cách giải mã.

Plugin Form Hoặc Plugin Gửi Email Xung Đột

Nhiều plugin form như Contact Form 7, Ninja Forms, Fluent Forms tự động xử lý email, nhưng đôi khi sử dụng hàm gửi thư riêng (PHPMailer) không đồng bộ với cấu hình WordPress. Plugin SMTP (WP Mail SMTP, Easy WP SMTP) cũng có thể thay đổi cách encoding mặc định nếu không được thiết lập charset từ đầu.

Theme Tùy Biến Hook wp_mail

Một số theme chất lượng thấp thêm filter hoặc action vào wp_mail để thay đổi tiêu đề, nhưng quên thiết lập charset. Điều này đặc biệt phổ biến với các theme hỗ trợ đa ngôn ngữ (WPML, Polylang) khi translation không được đồng bộ với email.

Phân Loại Lỗi Encoding Theo Loại Form WordPress



Loại Form	Biểu Hiện Phổ Biến	Nguyên Nhân Chính
Contact Form 7	Dấu hỏi, mã hex trong nội dung	Thiếu charset trong mail template
WPForms	Ký tự “ẹ” thay vì chữ Việt	Encoding mặc định là ISO-8859-1
Elementor Pro Form	Email trống hoặc ký tự lạ	Xung đột với cache plugin
Gravity Forms	Tiêu đề lỗi nhưng nội dung OK	Subject không được mã hóa base64

Hướng Dẫn Sửa Lỗi WordPress Form Email Encoding Chi Tiết

Luôn backup trước khi can thiệp code.

1. Cài Đặt Plugin WP Mail SMTP Và Cấu Hình Charset

Plugin WP Mail SMTP buộc WordPress gửi email qua SMTP và cho phép chỉnh sửa header. Sau khi kích hoạt, bạn vào Settings > WP Mail SMTP, tab “Email Test” và bật “Force From Email”. Ở tab “Advanced”, đảm bảo “Charset” là UTF-8. Plugin này cũng tự động thêm Content-Transfer-Encoding: base64, khắc phục lỗi encoding cơ bản.

2. Thêm Filter Vào functions.php

Đối với người dùng quen code, thêm đoạn sau vào file functions.php của theme (child theme) để ép WordPress gửi email với charset UTF-8 và base64.

// Sửa encoding email từ form WordPress

add_filter( 'wp_mail_content_type', 'fix_wp_mail_content_type' );

function fix_wp_mail_content_type() {
 return 'text/plain; charset=UTF-8';

}



add_filter( 'wp_mail_charset', 'fix_wp_mail_charset' );

function fix_wp_mail_charset() {
 return 'UTF-8';

}



add_action( 'phpmailer_init', 'fix_phpmailer_encoding' );

function fix_phpmailer_encoding( $phpmailer ) {
 $phpmailer->CharSet = 'UTF-8';
 $phpmailer->Encoding = 'base64';

}

Lưu ý: Nếu form gửi email định dạng HTML, bạn cần thay ‘text/plain’ thành ‘text/html’. Code này buộc PHPMailer dùng base64, giải quyết triệt để lỗi ký tự.

3. Sửa File wp-includes/pluggable.php (Không Khuyến Nghị)

Một số hướng dẫn cũ đề nghị sửa trực tiếp file lõi WordPress, nhưng điều này bị ghi đè khi cập nhật. Chỉ áp dụng nếu bạn muốn can thiệp sâu và có cơ chế quản lý code (VCS). Thay vào đó, dùng filter trong functions.php an toàn hơn.

4. Chỉnh Encoding Trực Tiếp Trong Plugin Form

Contact Form 7

Vào Contact > Contact Forms, chọn form cần sửa. Trong tab “Mail”, ở phần cấu hình email, thêm dòng dưới đây vào đầu “Message body”: Content-Type: text/plain; charset=UTF-8. Nếu dùng nội dung HTML, sửa thành “text/html”. Thêm dòng “Content-Transfer-Encoding: base64” ở dòng tiếp theo. Lưu Form và gửi thử.

WPForms

Vào WPForms > Settings > Email. Cuộn xuống “Advanced Options”, bật “Use UTF-8 Encoding”. Nếu vẫn lỗi, thêm đoạn code sau vào functions.php của theme:

add_filter( 'wpforms_wp_mail_from_email', 'fix_wpforms_encoding' );

function fix_wpforms_encoding() {
 add_filter( 'wp_mail_charset', function() { return 'UTF-8'; } );
 add_filter( 'phpmailer_init', function( $phpmailer ) {
 $phpmailer->Encoding = 'base64';
 } );

}

Elementor Pro Form

Elementor Pro không có cài đặt encoding riêng. Giải pháp tốt nhất là thêm filter wp_mail_content_type trong functions.php như mục 2. Nếu vẫn lỗi, kiểm tra xem plugin cache (W3 Total Cache, WP Rocket) có nén email không – tắt tính năng “Eliminate render-blocking CSS” hoặc “Combine JavaScript” cho trang có form.

5. Xử Lý Lỗi Encoding Subject (Tiêu Đề Email)

Tiêu đề email thường bị lỗi hơn nội dung. Để sửa, thêm đoạn code mã hóa base64 cho subject:

add_filter( 'wp_mail', 'fix_wp_mail_subject_encoding' );

function fix_wp_mail_subject_encoding( $args ) {
 if (! empty( $args['subject'] ) ) {
 $args['subject'] = '=?UTF-8?B?'. base64_encode( $args['subject'] ). '?=';
 }
 return $args;

}

Code này tự động mã hóa subject, đảm bảo dấu tiếng Việt hiển thị chuẩn trên mọi client mail (Outlook, Gmail, Yahoo).

So Sánh Các Phương Pháp Sửa Lỗi Encoding Email



Phương Pháp	Độ Phức Tạp	Hiệu Quả	Rủi Ro
Plugin WP Mail SMTP	Thấp	Cao (với cấu hình chuẩn)	Phải trả phí nếu dùng SMTP server
Filter functions.php	Trung bình	Rất Cao	Phải backup, dễ nhầm code
Sửa hook trong plugin form	Thấp	Trung bình (tùy plugin)	Mất tác dụng sau cập nhật plugin
Sửa file lõi	Cao	Cao tạm thời	Mất khi update WordPress

Sai Lầm Thường Gặp Khi Xử Lý Encoding Lỗi

• Chỉ fix content mà quên subject: Nhiều người sửa nội dung email, nhưng subject vẫn lỗi nên tin nhắn bị đánh dấu spam hoặc khó đọc trên mobile.
• Dùng plugin email caching: Một số plugin WP Mail SMTP cũ, khi bật “Email Log”, có thể lưu email với encoding sai. Xóa log và tắt tính năng này để thử.
• Sai thứ tự filter: Khi thêm cả wp_mail_content_type và phpmailer_init, cần đảm bảo phpmailer_init chạy sau cùng. Thứ tự add_action và add_filter thường không quan trọng, nhưng nếu dùng theme có sẵn filter, có thể bị ghi đè.
• Không kiểm tra mail client: Lỗi encoding có thể chỉ xuất hiện trên Gmail hoặc Outlook Web. Luôn test trên ít nhất 2 client khác nhau (Gmail App, Outlook Desktop, Yahoo).

Lưu Ý Quan Trọng Khi Gửi Email Từ Form Có Tiếng Việt


• Database và form field: Đảm bảo bảng trong database sử dụng collation utf8mb4_unicode_ci, không phải latin1 vì latin1 không hỗ trợ full tiếng Việt có dấu.
• Plugin bảo mật: Một số plugin bảo mật (Wordfence, Sucuri) có thể chặn email chứa ký tự đặc biệt. Tạm thời vô hiệu hóa để kiểm tra nếu nghi ngờ.
• Server PHP: Một số host sử dụng PHP 7.4 trở xuống có lỗi liên quan đến mb_send_mail. Nâng cấp lên PHP 8.0 trở lên hoặc yêu cầu host bật mbstring extension.
• Email HTML vs Plain: Form nên gửi email dạng plain text (text/plain) để đơn giản hóa encoding. Nếu bắt buộc dùng HTML, hãy đảm bảo thẻ meta charset UTF-8 có trong đầu email.

FAQ Về Lỗi WordPress Form Email Encoding

Why does WordPress form email show question marks?

Question marks appear when the email charset is not UTF-8 or the content-transfer-encoding is missing. The server sends email with default ISO-8859-1 while the text contains UTF-8 characters (like Vietnamese diacritics). Adding a filter to force UTF-8 and base64 encoding resolves this.

How to fix Vietnamese encoding in Contact Form 7 email?

Go to Contact Form 7 > Mail tab. In the “Message body”, add two lines at the top: Content-Type: text/plain; charset=UTF-8 and Content-Transfer-Encoding: base64. Save and test. If still broken, add the functions.php filter for wp_mail_content_type and phpmailer_init.

Does WP Mail SMTP fix encoding issues?

WP Mail SMTP can fix encoding only if configured correctly. In the plugin settings, under “Advanced”, set “Charset” to UTF-8 and ensure “Content Type” is “text/plain” or “text/html” with proper headers. The plugin by itself does not override subject encoding; you may still need a subject filter function.

Can I use a plugin to automatically correct encoding?

Yes, plugins like “Add From Email” or “UTF-8 Emails” exist, but they are often outdated. The most reliable solution is a small code snippet in functions.php because it works regardless of plugin updates or theme changes.

Why do some email clients show encoding errors while others don’t?

Different email clients have different fallback handling. Gmail Web is very tolerant and may auto-detect UTF-8, while Outlook Desktop strictly follows the charset declared in headers. If you don’t declare charset explicitly, Outlook will assume Windows-1252 and display corrupted characters.

Kết Luận

WordPress form email encoding lỗi gây mất trải nghiệm người dùng và ảnh hưởng trực tiếp đến chuyển đổi. Nguyên nhân chính là thiếu charset UTF-8 và base64 encoding trong header email. Cách khắc phục hiệu quả nhất là thêm filter vào functions.php để buộc PHPMailer dùng UTF-8 và base64, kết hợp với cấu hình plugin SMTP. Đối với người dùng không muốn can thiệp code, plugin WP Mail SMTP với cài đặt charset chuẩn là lựa chọn ổn. Dù chọn phương pháp nào, luôn kiểm tra encoding trên nhiều client mail và backup trang trước khi thay đổi. Khi tiếng Việt hiển thị đúng, form WordPress của bạn sẽ gửi thông tin chuyên nghiệp và đáng tin cậy đến khách hàng.