本教程将指导您如何在wordpress中为文章（或产品）标题字段添加必填验证，确保用户在发布内容前必须填写标题。我们将采用不修改wordpress核心文件的最佳实践方法，通过自定义javascript和php代码实现客户端验证，同时提供友好的错误提示，从而提升内容发布的规范性和用户体验。
在WordPress内容管理中，确保某些关键字段（如文章标题）不为空是提升数据质量和用户体验的重要一环。虽然WordPress核心功能默认允许发布无标题内容，但通过前端验证可以有效引导用户填写必要信息。本教程将详细介绍如何通过自定义代码实现这一功能，同时强调遵循WordPress开发规范的重要性。
避免直接修改WordPress核心文件
在开始之前，我们必须明确一个核心原则：绝不直接修改WordPress核心文件。直接修改核心文件会带来以下严重问题：
- 更新覆盖： WordPress每次更新都会覆盖核心文件，您的修改将丢失。
- 维护困难： 每次更新后都需要重新应用修改，耗费大量时间和精力。
- 安全风险： 不当的修改可能引入安全漏洞。
- 兼容性问题： 可能与未来的WordPress版本或插件产生冲突。
正确的做法是利用WordPress提供的钩子（Hooks）机制，通过主题的 functions.php 文件或自定义插件来添加功能。
实现方案：JavaScript客户端验证与PHP加载
我们将采用客户端JavaScript验证的方式，为文章标题输入框添加 required 属性，并在用户点击发布按钮时进行额外的验证和提示。同时，通过PHP代码将此JavaScript文件加载到WordPress管理后台。
步骤一：创建自定义JavaScript文件
首先，创建一个名为 required-title.js 的JavaScript文件。建议将其放置在当前主题目录下的 js 子目录中（例如：your-theme/js/required-title.js）。
// your-theme/js/required-title.js
document.addEventListener('DOMContentLoaded', function() {
const titleField = document.getElementById('title'); // 获取标题输入框元素
const publishButton = document.getElementById('publish'); // 获取发布按钮元素
if (titleField) {
// 为标题输入框添加HTML5的'required'属性，实现浏览器层面的基本验证
titleField.setAttribute('required', 'required');
if (publishButton) {
// 监听发布按钮的点击事件
publishButton.addEventListener('click', function(event) {
// 检查标题字段是否为空（去除首尾空格）
if (titleField.value.trim() === '') {
event.preventDefault(); // 阻止表单提交（即阻止文章发布）
// 针对古腾堡编辑器，为发布按钮添加一个类以提供视觉反馈
// 注意：此处的类名可能随WordPress版本更新而变化，可能需要调整
const gutenbergPublishButton = document.querySelector('.editor-post-publish-button');
if (gutenbergPublishButton) {
gutenbergPublishButton.classList.add('gutenberg-editor__publish-button--error'); // 示例类名，可自定义CSS样式
}
// 弹出警告框提示用户
alert('请填写文章标题才能发布！');
// 将焦点设置回标题输入框，方便用户直接输入
titleField.focus();
}
});
}
}
});代码解释：
- DOMContentLoaded：确保在DOM完全加载和解析后执行脚本，避免操作不存在的元素。
- titleField.setAttribute('required', 'required');：为标题输入框添加HTML5 required 属性，现代浏览器会自动提供基本的必填提示。
- publishButton.addEventListener('click', ...)：在用户点击发布按钮时触发自定义验证逻辑。
- event.preventDefault();：如果标题为空，阻止默认的表单提交行为，即阻止文章发布。
- alert('请填写文章标题才能发布！');：通过弹窗向用户提供明确的错误提示。
- titleField.focus();：将光标定位到标题输入框，方便用户快速填写。
- 兼容性：代码考虑了经典编辑器和古腾堡编辑器两种情况，通过 document.getElementById('title') 和 document.getElementById('publish') 获取元素，并尝试为古腾堡的发布按钮添加视觉反馈类。
步骤二：通过PHP在WordPress后台加载JavaScript文件
接下来，您需要将JavaScript文件加载到WordPress的管理后台。将以下PHP代码添加到当前主题的 functions.php 文件中，或者封装成一个自定义插件。
<?php
/**
* 在WordPress管理后台加载自定义脚本，使文章标题必填。
*/
function my_admin_enqueue_required_title_script() {
// 获取当前屏幕对象，确保只在编辑文章/页面/产品时加载脚本
$screen = get_current_screen();
// 检查当前屏幕是否为文章、页面或产品编辑界面
// 'post' 对应文章和自定义文章类型编辑界面
// 'product' 特别针对WooCommerce产品编辑界面
if ( $screen && ( $screen->base === 'post' || $screen->base === 'product' ) ) {
wp_enqueue_script(
'required-title-script', // 脚本句柄，必须是唯一的
get_template_directory_uri() . '/js/required-title.js', // 脚本文件路径
array('jquery'), // 依赖项，此脚本不强制依赖jQuery，但可作为通用依赖
null, // 版本号，null表示WordPress会自动添加文件修改时间戳
true // 将脚本加载到页脚，提高页面加载性能
);
}
}
add_action('admin_enqueue_scripts', 'my_admin_enqueue_required_title_script');
/*
// 备选方案：使用 admin_head 钩子直接输出脚本标签 (不推荐，但可作为理解参考)
function my_admin_head_required_title_script() {
$screen = get_current_screen();
if ( $screen && ( $screen->base === 'post' || $screen->base === 'product' ) ) {
echo '<script type="text/javascript" src="' . get_template_directory_uri() . '/js/required-title.js"></script>';
}
}
add_action('admin_head', 'my_admin_head_required_title_script');
*/
?>代码解释：
- admin_enqueue_scripts 钩子：这是在WordPress管理后台正确加载脚本和样式表的推荐方式。它确保脚本在正确的时间点被加载，并允许WordPress管理依赖关系。
- get_current_screen()：获取当前管理页面的屏幕对象，通过 screen->base 可以判断当前页面类型。我们在这里检查 post（适用于文章、页面及其他自定义文章类型）和 product（适用于WooCommerce产品）。
- wp_enqueue_script()：WordPress用于注册和加载JavaScript文件的函数。
- 第一个参数是脚本的唯一句柄。
- 第二个参数是脚本的URL路径。get_template_directory_uri() 用于获取当前主题的URI。
- 第三个参数是一个数组，声明此脚本依赖的其他脚本（例如jQuery）。
- 第四个参数是脚本版本号，有助于浏览器缓存管理。
- 第五个参数（true）表示将脚本加载到HTML页面的 </body> 标签之前，而不是 <head> 中，有助于提高页面渲染速度。
注意事项
-
文件路径： 确保PHP代码中 get_template_directory_uri() . '/js/required-title.js' 的路径与您实际存放JavaScript文件的位置相符。
- 如果您的JavaScript文件位于子主题中，应使用 get_stylesheet_directory_uri()。
- 如果将此功能封装为插件，则应使用 plugins_url('js/required-title.js', __FILE__) 来获取插件目录中的文件路径。
- 客户端验证的局限性： 这种方法是客户端（浏览器端）验证，主要用于提升用户体验和减少无效提交。恶意用户或技术娴熟的用户仍可能绕过前端验证。因此，对于关键数据或安全性要求高的场景，始终建议在服务器端进行额外的后端验证。
- 兼容性： 随着WordPress版本更新，特别是古腾堡编辑器（块编辑器）的不断演进，前端DOM结构、CSS类名或JavaScript事件处理方式可能会发生变化。如果遇到脚本失效的情况，请检查WordPress官方文档或通过浏览器开发者工具检查相关元素的ID和类名是否有所改变。
- 用户体验优化： 除了简单的 alert() 弹窗，您还可以考虑使用更现代、更友好的方式来提示用户，例如在标题输入框下方显示红色的错误信息，或者在发布按钮上添加禁用状态，直到标题被填写。
总结
通过上述方法，您可以在不触及WordPress核心文件的情况下，为文章（或产品）标题字段添加有效的必填验证。这不仅保证了网站的健壮性和可维护性，也通过清晰的提示改善了内容编辑者的使用体验。遵循WordPress的开发规范，利用其强大的钩子系统，是实现功能扩展的最佳途径。这种做法不仅专业，也为未来的网站升级和维护奠定了坚实的基础。
