对于大多说网站来说,联系表单是必备功能之一。倡萌之前分享过 为你的 WordPress 主题创建内置的联系表单,而今天这篇教程,你将学习如何创建使用Ajax提交表单数据的联系表单。我们将使用jQuery来帮助简化JavaScript代码和一个简单的PHP邮件脚本来处理通过电子邮件发送表单数据。下面就开始吧。
创建 HTML 表单
首先我们要创建联系表单的基本 HTML 内容,给 <form> 元素添加ID ajax-contact,设置 method 属性为 post,action 属性为 mailer.php(注意,要填写 mailer.php 文件的真实路径)。
- <form id="ajax-contact" method="post" action="mailer.php">
- <div class="field">
- <label for="name">名字:</label>
- <input type="text" id="name" name="name" required>
- </div>
-
- <div class="field">
- <label for="email">邮箱:</label>
- <input type="email" id="email" name="email" required>
- </div>
-
- <div class="field">
- <label for="message">信息:</label>
- <textarea id="message" name="message" required></textarea>
- </div>
-
- <div class="field">
- <button type="submit">发送</button>
- </div>
- </form>
现在已经创建了一个表单来收集名字、邮箱和信息,而且每个表单都添加了一个 required 属性,这个可以让那些支持 HTML5 表单验证的浏览器,来验证这些表单必须已经填写内容才可以提交。
接下来创建一个 <div> 元素来显示成功或错误信息给用户,在上面的 <form> 的上方添加一个 ID 为 form-messages 的<div>:
- <div id="form-messages"></div>
现在下载所需的代码文件,在你的项目中创建一个 contact 文件夹,将解压出来的文件复制到这个文件夹中 ,然后引用这些文件:
- <link rel="stylesheet" href="/contact/style.css">
- <script src="/contact/jquery-2.1.0.min.js"></script>
- <script src="/contact/app.js"></script>
请注意根据自己的实际修改上面文件的引用地址。app.js 需要 jquery 库的支持,所以这里引入 jquery-2.1.0.min.js,如果你的项目中已经早就引入了,就没必要重复。到这里基本的 HTML 代码已经完成,下面我们要接着弄 JavaScript。
使用 AJAX 提交表单数据
创建一个 app.js 文件,添加下面的代码,请注意看下面的代码注释(下载的文件包的 app.js 已经包含):
- $(function() {
-
- // 获取表单
- var form = $('#ajax-contact');
-
- // 获取显示消息的div
- var formMessages = $('#form-messages');
-
- // 为联系表单创建事件监听
- $(form).submit(function(e) {
- // 阻止浏览器直接提交表单
- e.preventDefault();
-
- // 序列化表单数据
- var formData = $(form).serialize();
-
- // 使用AJAX提交表单
- $.ajax({
- type: 'POST',
- url: $(form).attr('action'),
- data: formData
- })
- .done(function(response) {
- // 确保formMessages的div有“success”这个类
- $(formMessages).removeClass('error');
- $(formMessages).addClass('success');
-
- // 设置消息文本
- $(formMessages).text(response);
-
- // 清除表单
- $('#name').val('');
- $('#email').val('');
- $('#message').val('');
- })
- .fail(function(data) {
- // 确保formMessages的div有“error”这个类
- $(formMessages).removeClass('success');
- $(formMessages).addClass('error');
-
- // 设置消息文本
- if (data.responseText !== '') {
- $(formMessages).text(data.responseText);
- } else {
- $(formMessages).text('糟糕!发生错误,无法发送邮件。');
- }
- });
-
- });
-
- });
这样就完成了构建一个AJAX的联系表单所需的HTML和JavaScript代码。在下一节中,你将了解邮件的脚本,它负责处理表单数据并发送了一封电子邮件。
创建PHP邮件脚本
现在是时候来写PHP邮件脚本,用来处理表单数据。这个简单的脚本是负责检查表单数据是有效的,然后发送邮件。如果发生错误,该邮件脚本会回应一个适当的状态代码,以提供给之前写的 JavaScript fail
回调中执行。
创建一个 mailer.php 文件,添加下面的代码(下载的代码文件中 mailer.php 已经包含):
- <?php
-
- // 只处理 POST 请求
- if ($_SERVER["REQUEST_METHOD"] == "POST") {
- // 获取表单字段并删除空白
- $name = trim($_POST["name"]);
- $email = trim($_POST["email"]);
- $message = trim($_POST["message"]);
-
- // 检查要发送邮件的数据
- if ($name == "" OR $email == "" OR $message == "") {
- // 设置一个400(错误请求)响应代码并退出
- http_response_code(400);
- echo "糟糕!您提交数据时出现了一个问题。请填完表格,然后再试一次。";
- exit;
- }
-
- // 设置收件人的电子邮件地址
- // 请修改为你自己的接受邮件地址
- $recipient = "text@example.com";
-
- // 设置电子邮件的主题
- $subject = "来自 $name 的新信息";
-
- // 建立电子邮件内容
- $email_content = "名字: $name\n";
- $email_content .= "邮箱: $email\n\n";
- $email_content .= "信息:\n$message\n";
-
- // 建立电子邮件标头
- $email_headers = "来自: $name <$email>";
-
- // 发送邮件
- if (mail($recipient, $subject, $email_content, $email_headers)) {
- // 设置200(成功)响应代码
- http_response_code(200);
- echo "谢谢您!您的消息已发送。";
- } else {
- // 设置500(内部服务器错误)响应代码
- http_response_code(500);
- echo "糟糕!出事了,我们无法发送邮件。";
- }
-
- } else {
- // 不是一个POST请求,设置一个403(禁止)响应代码
- http_response_code(403);
- echo "您提交的过程出现了一个错误,请重试。";
- }
-
- ?>
这个脚本首先检查该请求是通过POST方法发送。如果不是,该脚本将返回一个403(禁止)HTTP状态代码和错误消息。
接着创建变量获取发件人的名字、邮箱和信息,并使用 trim() 函数除去这些字段的空白字符,然后检查这些字段是否都已经填写完整,如果没有,返回 400 响应代码,同时提示错误。
接着创建变量获取邮件所需的其他信息,比如收件人的邮箱、邮件主题、标头等等,接下来,将尝试使用PHP的mail函数发送电子邮件。如果成功,将返回成功的消息。如果不是的话,你需要的响应代码为500(内部服务器错误),并返回一个错误消息。
需要注意一下,发送邮件需要主机的支持,也就要确保PHP开启了 mail() 函数。
好了,到这里所有的工作都完成了。
参考自:http://blog.teamtreehouse.com/create-ajax-contact-form,如果要看更详细的解说,请查看这篇文章。
萌哥,测试了下,发现前台提示发送成功,可邮箱没接收到邮件,不知道是什么原因!
萌哥,不知道这个方法在4.0的wordpress里还有没有效果?这两天试了很久也没有成功,总是提示信息不完整,失败。但上面的信息都已经按照要求填好了。(用twentyfourteen主题测试还是一样的问题。)
不知道萌哥可否帮忙测试下。我记得以前用这个方法是有用的。多谢啦!
不明觉厉