我们只是人，作为人的特征之一就是我们会犯错误. 另一方面, 我们也在自我纠正, 这意味着我们倾向于从错误中学习，并希望因此能够避免犯同样的错误两次. 我在WordPress领域所犯的许多错误都源于在执行解决方案时试图节省时间. However, 当这种方法导致问题出现时，他们通常会抬起头来. 犯错是不可避免的. 然而，从别人的疏忽中学习(当然还有你自己的疏忽)!是一条你应该主动走的路.

常见错误No. 1:关闭调试开关

当我的代码运行良好时，为什么要使用调试? 调试是WordPress内置的一个功能，它会导致所有PHP错误, warnings, 并注意(关于已弃用的函数), etc.)显示. 关闭调试时, 可能会生成一些我们从未看到的重要警告或通知, 但如果我们不及时处理，以后可能会产生问题. 我们希望我们的代码与我们网站的所有其他元素很好地配合. So, 添加任何新的自定义代码到WordPress时, 在进行开发工作时，应该始终打开调试开关(但要确保在将站点部署到生产环境之前关闭调试开关)!).

要启用此特性，您需要编辑 wp-config.php 在你的WordPress安装根目录下. 下面是一个典型文件的片段:

//打开调试开关
定义(“WP_DEBUG”,真正的);

//将所有错误记录到/wp-content/debug的文本文件中.log
定义(“WP_DEBUG_LOG”,真正的);

//不显示错误信息，将其写入日志文件/wp-content/debug.log
定义(“WP_DEBUG_DISPLAY”,假);

//确保所有PHP错误被写入日志文件，而不是显示在屏幕上
@ini_set (display_errors, 0);

这不是可以使用的配置选项的详尽列表, 但是这个建议的设置应该足以满足大多数调试需求.

常见错误No. 2:添加脚本和样式使用 wp_head Hook

将脚本添加到我的头模板中有什么问题? WordPress已经包含了大量的 流行的脚本. 但是，许多开发人员将使用 wp_head hook. 这可能导致相同的脚本，但不同的版本，被加载多次.

在这里排队可以解决问题, 在我们的网站上添加脚本和样式的WordPress友好的方式是什么. 我们使用排队来防止插件冲突，并处理脚本可能具有的任何依赖关系. 这是通过使用内置函数实现的 wp_enqueue_script or wp_enqueue_style 分别对脚本和样式进行排队. 这两个函数的主要区别在于 wp_enqueue_script 我们有一个额外的参数，它允许我们将脚本移动到页面的页脚.

Wp_register_script ($handle， $src， $deps = array()， $ver = false， $in_footer = false)
Wp_enqueue_script ($handle， $src = false， $deps = array()， $ver = false， $in_footer = false)

Wp_register_style ($handle， $src， $deps = array()， $ver = false， $media = 'all')
Wp_enqueue_style ($handle， $src = false， $deps = array()， $ver = false， $media = 'all')

如果脚本不需要在页面上方呈现内容, 我们可以安全地将其移动到页脚，以确保折叠上方的内容快速加载. It’s 良好的实践 在对脚本进行排队之前先注册该脚本, 因为这允许其他人通过他们自己插件中的句柄注销你的脚本, 无需修改插件的核心代码. 除此之外, 如果已注册脚本的句柄列在已排队的另一个脚本的依赖项数组中, 该脚本将在加载高亮显示的已排队脚本之前自动加载.

常见错误No. 3:避免子主题和修改WordPress核心文件

总是创建一个子主题，如果你计划 修改主题. 一些开发人员会对父主题文件进行更改，但在升级到主题后才发现他们的更改已被覆盖并永远丢失.

要创建子主题，请放置 style.css 该文件位于子主题文件夹的子目录中，内容如下:

/*
 主题名称:二十六个孩子
 主题URI: http://example.com/twenty-fifteen-child/
 描述:2015儿童主题
 作者:约翰·多伊
 作者URI: http://example.com
 模板:twentysixteen
 版本:1.0.0
 许可证:GNU General Public License v2及以上版本
 许可URI: http://www.gnu.org/licenses/gpl-2.0.html
 标签:浅色，深色，两栏，右侧栏，响应式布局，可访问性准备
 文本域:twenty-sixteen child
*/

上面的例子创建了一个基于默认WordPress主题的子主题， 二千零一十六年. 这段代码中最重要的一行是包含单词“Template”的那一行，它必须与要从中克隆子主题的父主题的目录名相匹配.

同样的原则也适用于WordPress核心文件:不要简单地修改核心文件. 通过使用WordPress可插拔功能和过滤器来防止WordPress升级后您的更改被覆盖，从而付出额外的努力. 可插拔函数允许您覆盖一些核心函数, 但这种方法正在慢慢被淘汰，取而代之的是过滤器. 过滤器实现了相同的最终结果，并且被插入到WordPress函数的末尾，以允许修改它们的输出. 一个技巧就是用 if ( !function_exists ()) 当使用pluggable函数时，因为多个插件试图在没有此包装的情况下覆盖同一个pluggable函数将产生致命错误.

常见错误No. 4: Hardcoding Values

通常，在代码的某个地方硬编码一个值(比如URL)看起来更快, 但是在调试和纠正由此产生的问题上花费的时间要多得多. 通过使用相应的函数动态生成所需的输出, 我们极大地简化了代码的后续维护和调试. 例如, 如果您使用硬编码的url将站点从测试环境迁移到生产环境, 突然间，你会发现你的网站不工作了. 这就是为什么我们应该使用函数, 就像下面列出的那样, 用于生成文件路径和链接:

//获取子主题目录的uri
stylesheet_directory_uri ();
//获取父主题目录
get_template_directory_uri ();
//获取当前站点的url
 site_url ();

另一个硬编码的坏例子是在编写自定义查询时. 例如，作为一种安全措施，我们将默认的WordPress数据表前缀从 wp_ 去做一些更独特的事，比如 wp743_. 如果我们移动WordPress安装，我们的查询将失败, 因为表前缀可以在不同的环境中更改. 为了防止这种情况发生，我们可以参考 表属性 of the wpdb class:

全球wpdb美元;
$user_count = $wpdb->get_var( "SELECT COUNT(*) FROM $wpdb->users" );

注意我没有使用这个值 wp_users 为表名，但我让WordPress解决它. 使用这些属性生成表名将有助于确保我们返回正确的结果.

常见错误No. 5:不要阻止你的网站被索引

我为什么不希望搜索引擎索引我的网站呢? 索引很好，对吧? Well, 在建立网站时, 你不希望搜索引擎索引你的网站，直到你已经完成了建设，并建立了永久链接结构. 此外, 如果您有一个用于测试站点升级的登台服务器, 你不希望像谷歌这样的搜索引擎索引这些重复的页面. 当有多个无法区分的内容时, 搜索引擎很难决定哪个版本与搜索查询更相关. 在这种情况下，搜索引擎会惩罚内容重复的网站, 因此，你的网站将在搜索排名中受到影响.

如下所示: WordPress阅读设置 有一个复选框，上面写着“阻止搜索引擎索引此站点”。, 尽管下面确实有一个重要的注意事项，说明“这取决于搜索引擎是否尊重此请求”。.

请记住，搜索引擎经常会这样做 not 尊重这个请求. 因此，如果你想 reliably 防止搜索引擎索引你的网站，编辑你的 .htaccess 文件并插入以下行:

标题集X-Robots-Tag "noindex, nofollow"

常见错误No. 6:不检查插件是否激活

如果我的插件总是打开，为什么我要检查插件函数是否存在? 可以肯定的是，99%的时间你的插件都是活跃的. 然而，由于某种原因它被停用的那1%的时间呢? 如果发生这种情况，您的网站可能会显示一些丑陋的PHP错误. 为了防止这种情况，我们可以在调用插件函数之前检查插件是否处于活动状态. 如果插件函数是通过前端调用的，我们需要包含 plugin.php 以调用该函数 is_plugin_active ():

include_once (ABSPATH . “wp-admin /包括/插件.php' );
is_plugin_active('plugin-folder/plugin-main-file . '.php' ) ) {
//运行插件代码
}

这种技术通常是相当可靠的. 但是，也有可能是作者更改了主插件目录名的情况. 一个更健壮的方法是检查插件中是否存在一个类:

if(class_exists(' WooCommerce ')) {
	//打开WooCommerce插件
}

作者不太可能更改插件类的名称, 所以我通常推荐使用这种方法.

常见错误No. 7:加载太多资源

为什么我们应该选择加载插件资源的页面? 如果用户导航到的页面上没有使用插件，那么就没有理由加载插件的样式和脚本. 只在必要时加载插件文件, 我们可以减少页面加载时间, 这将导致最终用户体验的改善. Take, 例如, WooCommerce网站, 我们只希望插件加载在我们的购物页面. 在这种情况下, 我们可以有选择地删除所有其他网站页面上加载的文件，以减少臃肿. 我们可以将以下代码添加到主题或插件中 functions.php file:

函数load_woo_scripts_styles () {
	
If (function_exists('is_woocommerce')){
    //只加载Woocommerce页面上的样式/脚本   
	if(! is_woocommerce () && ! is_cart() && ! Is_checkout ()) { 		
		
		//取消脚本队列.
		wp_dequeue_script(“woocommerce”); 
		wp_dequeue_script(“wc-add-to-cart”); 
		wp_dequeue_script(“wc-cart-fragments”);
		
		//取消队列样式.	
		wp_dequeue_style(“woocommerce-general”); 
		wp_dequeue_style(“woocommerce-layout”); 
		wp_dequeue_style(“woocommerce-smallscreen”); 
			
		}
	}	
}

Add_action ('wp_enqueue_scripts'， 'load_woo_scripts_styles');

可以使用该函数删除脚本 wp_dequeue_script(处理) 通过他们注册的句柄. Similarly, wp_dequeue_style(处理) 会阻止样式表被加载吗. 但是，如果这对您来说太难实现，您可以安装 插件的组织者 这提供了基于特定标准选择性加载插件的能力, 例如帖子类型或页面名称. 最好禁用任何缓存插件，比如 W3Cache, 您可能已经打开，以防止您必须不断刷新缓存以反映您所做的任何更改.

常见错误No. 8 .保留管理栏

难道我不能让WordPress管理栏对每个人都可见吗? 是的，您可以允许用户访问管理页面. However, 这些页面通常不能在视觉上与您选择的主题集成，也不能提供无缝集成. 如果你想让你的网站看起来专业, 你应该禁用管理栏，并提供自己的前端帐户管理页面:

add_action(“after_setup_theme”、“remove_admin_bar”);

函数remove_admin_bar() {
if (!current_user_can(“管理人”) && !is_admin ()) {
  show_admin_bar(假);
}
}

上面的代码，当复制到您的主题的 functions.php 文件将只显示管理员栏的网站管理员. 你可以添加任何WordPress user roles 或者能力 current_user_can(能力) 将用户排除在管理栏之外的功能.

常见错误No. 9:没有使用GetText过滤器

我可以使用CSS或JavaScript来更改按钮的标签，这有什么问题? 嗯，是的，你可以. However, 您添加了多余的代码和额外的时间来呈现按钮, 当你可以使用WordPress中最方便的过滤器之一时, called gettext. 结合一个插件的 textdomain, 一个唯一的标识符，确保WordPress可以区分所有加载的翻译, 我们可以使用 gettext 筛选器以在呈现页面之前修改文本. 如果您搜索该函数的源代码 load_plugin_textdomain(域)，它会给你的域名，我们需要覆盖有问题的文本. 任何有信誉的插件都会确保 textdomain For是在插件初始化时设置的. 如果是要更改的主题中的某些文本，请搜索 load_theme_textdomain(域) 代码行数. 再次以WooCommerce为例, 我们可以更改出现在“相关产品”标题的文本. 将以下代码插入您的主题 functions.php file:

函数translate_string($translated_text， $untranslated_text， $domain) {
	if ($translated_text == '相关产品'){
			$translated_text = __('其他伟大的产品'，'woocommerce');
	}
	返回translated_text美元;
}

Add_filter ('gettext'， 'translate_string'， 15,3);

这个过滤器钩子由国际化函数应用于翻译后的文本 __() and _e()，只要 textdomain 是通过上述函数设置的吗.

_e(“相关产品”、“woocommerce”);

在插件中搜索这些国际化函数，以查看还可以自定义哪些字符串.

常见错误No. 10:保留默认的永久链接

默认情况下，WordPress使用带有帖子ID的查询字符串来返回指定的内容. 但是，这不是用户友好的，用户在复制URL时可能会删除URL的相关部分. 更重要的是，这些默认永久链接没有使用搜索引擎友好的结构. 启用我们所谓的“漂亮”永久链接将确保我们的url包含文章标题的相关关键字，以提高搜索引擎排名的性能. 回顾性地修改您的永久链接可能是一项相当艰巨的任务, 特别是如果您的站点已经运行了很长一段时间, 你已经有数百篇文章被搜索引擎索引了. 所以在你安装WordPress之后，确保你 promptly 将您的永久链接结构更改为更适合搜索引擎的东西，而不仅仅是帖子ID. 我通常对我构建的大多数站点使用帖子名称, 但是您可以使用可用的自定义永久链接为您喜欢的任何格式 永久链接结构标签.

Conclusion

这篇文章绝不是一个详尽的错误清单 WordPress的开发者. 如果有一件事你应该从这篇文章中带走, though, 那就是你永远不应该走捷径(在任何开发平台上都是如此), 不仅仅是WordPress!). 现在由于糟糕的编程实践而节省的时间以后会回来困扰您. 欢迎在下面留言，与我们分享你过去犯过的错误，更重要的是你学到的经验教训.