月度归档： 2025 年 8 月

发布于

剖析 WordPress `wp_enqueue_script()` 函数在 Gutenberg 中的源码：如何处理编辑器和前端的脚本依赖。

Gutenberg 时代的 wp_enqueue_script() 讲座：前端老炮的新挑战 大家好，我是你们今天的讲师，叫我老码农就好。今天咱们聊聊 WordPress 里一个古老而又重要的函数：wp_enqueue_script()。 这玩意儿在 Gutenberg 时代，可不仅仅是加载 JavaScript 那么简单了，它关系到你的编辑器体验，也影响着前端页面的性能。所以，今天咱们就来好好剖析一下，看看它在 Gutenberg 里是怎么玩的。 一、wp_enqueue_script()：老朋友，新任务 首先，我们回顾一下 wp_enqueue_script() 的基本用法。这函数的作用很简单，就是告诉 WordPress，我们需要加载一个 JavaScript 文件，并且可以指定它依赖的其他脚本。 基本语法如下： wp_enqueue_script( string $handle, // 脚本的唯一标识符 string $src = ”, // 脚本的 URL array $deps = array(), // 脚本依赖的其他脚本的句柄数组 string $ver = false …

继续阅读“剖析 WordPress `wp_enqueue_script()` 函数在 Gutenberg 中的源码：如何处理编辑器和前端的脚本依赖。”

发布于

深入理解 WordPress `block_editor_settings` 过滤器源码：如何禁用特定的区块或修改编辑器配置。

各位观众老爷们，大家好！ 今天咱们聊聊 WordPress 里一个非常重要，但又常常被忽略的过滤器：block_editor_settings。 这玩意儿就像 WordPress 古堡的秘密通道，允许你深入到区块编辑器的核心，调整它的行为，甚至完全禁用某些区块。 一、什么是 block_editor_settings？ 简单来说，block_editor_settings 是 WordPress 提供的一个过滤器（filter），允许你修改传递给区块编辑器的配置信息。 这些配置信息包括： 可用区块列表： 决定了哪些区块可以在编辑器中使用。 区块样式： 影响区块的默认样式和可用样式选项。 编辑器设置： 诸如是否启用全屏模式、是否显示欢迎引导等。 国际化字符串： 用于翻译区块编辑器界面。 你可以把它想象成区块编辑器启动前的一道检查关卡，你可以拦截并修改送给区块编辑器的“指令”。 二、block_editor_settings 过滤器在哪里？ 这个过滤器主要在 wp-includes/block-editor.php 文件中的 get_block_editor_settings() 函数里被 …

继续阅读“深入理解 WordPress `block_editor_settings` 过滤器源码：如何禁用特定的区块或修改编辑器配置。”

发布于

阐述 WordPress `wp_kses_allowed_html` 过滤器在 Gutenberg 中的源码：如何自定义允许的 HTML 标签。

各位老铁，大家好！今天咱们来聊聊WordPress里一个既重要又有点“闷骚”的家伙：wp_kses_allowed_html 过滤器，以及它在Gutenberg时代如何大放异彩，允许咱们自定义HTML标签。 想象一下，WordPress就像一个兢兢业业的门卫，wp_kses_allowed_html 就是他手里的通行证清单。只有清单上的HTML标签和属性，才能顺利进入WordPress的世界，否则就会被无情地“净化”掉。 在Gutenberg出现之前，我们修改这个清单的方式比较“粗暴”，直接全局修改，影响整个网站。但Gutenberg的出现，让我们可以更精细地控制，针对特定的区块，允许特定的HTML标签。这就像门卫可以根据不同的访客，给出不同的通行权限。 一、wp_kses：HTML卫士的核心 在深入wp_kses_allowed_html 之前，咱们先简单了解一下wp_kses，它是整个HTML净化机制的核心。wp_kses函数负责过滤掉不安全的HTML标签和属性，防止XSS攻击。它依赖于wp_kses_allowed_html 提供的允许标签列表。 wp_kses的基本用法如下： …

继续阅读“阐述 WordPress `wp_kses_allowed_html` 过滤器在 Gutenberg 中的源码：如何自定义允许的 HTML 标签。”

发布于

分析 WordPress `gutenberg_render_block_core_image()` 函数的源码：它是如何处理图片区块的？

各位听众朋友们，大家好！今天老衲就来跟大家聊聊 WordPress 里那个负责把图片区块变漂亮的小家伙——gutenberg_render_block_core_image() 函数。这玩意儿藏在 WordPress 的核心代码里，专门负责把古腾堡编辑器里的图片区块渲染成咱们在网页上看到的实际图片。 咱们的目标是扒开它的源码，看看它到底做了些什么，怎么把各种图片属性，比如大小、对齐方式、链接等等，都巧妙地塞到 HTML 代码里去的。准备好了吗？咱们这就开始！ 一、找到目标，锁定函数 首先，我们要找到这个gutenberg_render_block_core_image()函数。它藏身于 WordPress 核心代码的 wp-includes/blocks/image.php 文件里。打开这个文件，找到这个函数，我们就锁定了今天的目标。 二、代码剖析，逐行解读 接下来，咱们就要像解剖青蛙一样，把这个函数的源码一行一行地剖析开来，看看它到底有哪些组成部分。 <?php /** * Registers the core/image block. * * @since 5.0.0 */ …

继续阅读“分析 WordPress `gutenberg_render_block_core_image()` 函数的源码：它是如何处理图片区块的？”

发布于

解析 WordPress `is_gutenberg_page()` 函数的源码：如何判断当前页面是否为 Gutenberg 编辑器。

各位观众，晚上好！今天咱们来聊聊 WordPress 里一个挺重要的函数，is_gutenberg_page()。这玩意儿关乎你 WordPress 站点编辑体验，以及插件、主题对 Gutenberg 编辑器的兼容性。 别看名字挺长，理解了它背后的逻辑，就能让你在自定义 WordPress 时少走很多弯路。 一、Gutenberg 编辑器是啥？ 首先，咱们得先搞清楚 Gutenberg 是个啥。简单来说，Gutenberg 是 WordPress 5.0 版本引入的块编辑器，它彻底改变了 WordPress 的内容编辑方式。以前咱们用的是经典编辑器（TinyMCE），就像用 Word 写文章一样。但 Gutenberg 把文章内容拆分成一个个独立的“块”，比如段落块、图片块、标题块等等。你可以像搭积木一样，自由组合这些块来创建页面和文章。 二、is_gutenberg_page() 函数的作用 is_gutenberg_page() 的作用，就是判断当前页面是否正在使用 Gutenberg 编辑器。这个判断对于插件开发者尤其重要。比如，你的插件可能需要根据用户使用的编辑器类型，加载不同 …

继续阅读“解析 WordPress `is_gutenberg_page()` 函数的源码：如何判断当前页面是否为 Gutenberg 编辑器。”

发布于

探究 WordPress `register_meta()` 函数的源码：如何使自定义元数据可被 Gutenberg 编辑和 REST API 访问。

各位观众老爷们，大家好！今天咱们来聊聊 WordPress 里一个非常重要的函数 register_meta()，看看它怎么让你的自定义字段在古腾堡编辑器（Gutenberg）里溜达，还能被 REST API 抓取。这玩意儿，说白了，就是让你辛辛苦苦定义的元数据，不光能存起来，还能方便地用起来。准备好了吗？咱们发车啦！ 开场白：元数据，你家的“私房钱” 想象一下，你是个作家，写了一篇小说。除了文章内容，你可能还想记录一些额外的信息，比如： 小说状态： 草稿、已发布、已废弃 关键词： 科幻、爱情、冒险 预计字数： 10万字 这些额外的信息，就是元数据。WordPress 默认的文章、页面都有一些元数据（比如作者、发布时间），但有时候我们需要更多。这时，register_meta() 就派上用场了。它能让你定义自己的“私房钱”，而且还能让 WordPress 知道这些“私房钱”的存在，方便你管理和使用。 register_meta()： 注册你的“私房钱” register_meta() 函数的作用，简单来说，就是告诉 WordPress：“嘿，伙计，我这里有一些新的元数据，你得记住它们， …

继续阅读“探究 WordPress `register_meta()` 函数的源码：如何使自定义元数据可被 Gutenberg 编辑和 REST API 访问。”

发布于

详解 WordPress `the_content` 过滤器在 Gutenberg 中的源码实现：如何将区块对象转换为前端 HTML。

各位观众老爷，晚上好！今儿咱们唠唠 WordPress 里一个相当关键，又有点儿神秘的家伙——the_content 过滤器在古登堡（Gutenberg）编辑器里的实现。这玩意儿就像个魔术师，能把你在后台编辑器里拖来拽去的那些花花绿绿的区块，变成最终呈现在用户面前的 HTML 代码。 准备好，咱们这就开始揭秘！ 一、the_content：老朋友，新任务 the_content 过滤器在 WordPress 已经存在很久了，早在古登堡出现之前，它就负责在文章内容显示之前对内容进行处理。比如，你可以用它来实现自动链接、表情符号转换等等。 但古登堡横空出世之后，the_content 的任务就变得更加复杂了。它不仅要处理传统的文本内容，还要处理那些由区块组成的复杂结构。简单来说，它要负责把区块对象翻译成最终的 HTML。 二、区块是什么？ 在深入 the_content 之前，咱们得先搞清楚“区块”到底是个什么玩意儿。你可以把区块想象成一个个独立的、可重复使用的内容单元。比如，一个段落、一张图片、一个标题、一个按钮，甚至一个嵌入的 YouTube 视频，都可以是一个区块。 每个区块都有自己 …

继续阅读“详解 WordPress `the_content` 过滤器在 Gutenberg 中的源码实现：如何将区块对象转换为前端 HTML。”

发布于

分析 WordPress `render_block()` 函数的源码：如何根据区块名和属性调用渲染回调函数。

各位观众老爷，大家好！我是你们的老朋友，今天咱们来聊聊 WordPress 里面一个挺关键的函数，叫做 render_block()。这哥们儿负责把 WordPress 区块变成真刀真枪的 HTML 代码，让你的网页看起来有模有样。 咱们不搞虚的，直接上干货，看看 render_block() 这货是怎么运作的，特别是它怎么根据区块的名字和属性找到正确的渲染回调函数。 一、render_block() 函数的庐山真面目 首先，咱得知道 render_block() 这函数长啥样。虽然 WordPress 核心代码里咱不能直接“偷”出来，但我们可以用 PHP 的反射机制来窥探一下它的结构。当然，更常见的方式是直接去看 WordPress 源码，通常在 /wp-includes/blocks.php 文件里。 render_block() 函数接收两个参数： $block: 这是一个数组，包含了区块的所有信息，比如区块名（blockName）、属性（attrs）等等。 $content: 这是区块的内容，通常用于动态区块，但有些静态区块也会用到。 它的主要任务就是： 找到对应区块的渲染回调 …

继续阅读“分析 WordPress `render_block()` 函数的源码：如何根据区块名和属性调用渲染回调函数。”

发布于

剖析 WordPress `WP_Block_Parser` 类的源码：它如何将文章的 HTML 内容解析成区块对象数组。

各位观众老爷，大家好！今天咱们来聊聊 WordPress 里面一个相当重要的家伙，它就是 WP_Block_Parser 类。这家伙的任务可不轻，得把文章那堆乱七八糟的 HTML 内容，像剥洋葱一样一层层扒开，最终变成一个个区块对象，方便 WordPress 后续处理。 准备好了吗？咱们这就开始“解剖”它，看看它到底是怎么工作的。 1. 什么是区块？为什么要解析？ 首先，得明确一下，什么是 WordPress 的“区块”。简单来说，区块就是 WordPress 古腾堡编辑器（Gutenberg）的核心。它把文章内容拆分成独立的、可重复使用的单元，比如段落、标题、图片、列表等等。 为什么要解析呢？因为 WordPress 需要理解文章的内容结构，才能进行渲染、保存、搜索等操作。直接操作原始 HTML 字符串效率太低，而且容易出错。把 HTML 转换成结构化的区块对象，就方便多了。 2. WP_Block_Parser 类的概览 WP_Block_Parser 类位于 wp-includes/class-wp-block-parser.php 文件中。它的主要职责是将一段 HTML 字符串 …

继续阅读“剖析 WordPress `WP_Block_Parser` 类的源码：它如何将文章的 HTML 内容解析成区块对象数组。”

发布于

深入理解 WordPress `save_post` 钩子在 Gutenberg 中的源码：如何处理区块数据的保存流程。

大家好，我是老码农，今天咱们聊聊 WordPress 里一个非常关键的钩子：save_post，特别是它在古腾堡编辑器（Gutenberg）中是如何玩转区块数据的保存流程的。这玩意儿，说白了，就是把你在编辑器里辛辛苦苦堆砌的各种区块，变成数据库里能识别、能还原的数据。 咱们先从最基础的概念入手，然后一步步深入源码，最后再来点实际案例，让大家彻底明白这其中的奥秘。准备好了吗？Let’s roll! 第一幕：钩子是个啥？为啥要用它？ 想象一下，WordPress 是一个大舞台，各种事件都在这里上演。save_post 钩子就像一个侦听器，它时刻监听着“文章要保存了！”这个事件。一旦这个事件发生，它就会触发你预先注册好的函数，让你有机会在文章真正保存到数据库之前，做一些手脚，比如修改文章内容、更新自定义字段等等。 为什么要用钩子呢？因为 WordPress 本身的代码已经写死了，但我们总有各种各样的定制需求。钩子就提供了一个“官方”的扩展点，让我们可以在不修改 WordPress 核心代码的前提下，实现各种各样的功能。这就像盖房子，主体结构已经完成了，但你可以通过预留的接口，往里 …

继续阅读“深入理解 WordPress `save_post` 钩子在 Gutenberg 中的源码：如何处理区块数据的保存流程。”