小部件API

关于小部件API的技术文章和开发文档。

小工具

【WordPress主题开发手册】小工具

本文详细介绍 WordPress 小部件(Widget)的创建与使用方法。文章涵盖侧边栏区域配置、内置与独立小部件的区别、数据保存机制以及嵌入主题或插件的优势。同时提供完整的 PHP 代码示例,包括类结构、构造函数、注册方式及 HTML 输出逻辑,帮助用户从零开始开发自定义小部件并实现前台展示与后台设置。

2026-10-05 7 后端开发

【WordPress区块编辑器手册】关于旧版小部件区块

本文介绍如何管理旧版小部件区块,包括添加、编辑和预览由插件注册的第三方小部件。文章详细说明了“遗留小部件”块的兼容性处理、事件触发机制以及自动显示“无预览可用”的逻辑。此外,还讲解了如何通过REST API安全展示小实例、定义块转换以实现向新块的逐步迁移,以及如何隐藏特定小部件并允许在其他编辑器中使用该区块的高级配置方法。

2026-10-17 1 后端开发

【WordPress区块编辑器手册】小部件区块编辑器概述

小部件区块编辑器是 WordPress 推出的新功能,将传统小部件区域升级为支持区块编辑。用户可通过外观菜单访问新编辑器,灵活插入区块与小部件。该功能兼容经典小部件及第三方插件,支持实时预览与自定义程序器操作,确保主题与数据无缝衔接,提供现代化的小部件管理体验。

2026-10-17 2 后端开发

【WordPress主题开发手册】侧边栏

本文详细介绍 WordPress 中侧边栏的创建与使用方法。涵盖在 functions.php 中使用 register_sidebar 和 dynamic_sidebar 函数注册及显示侧边栏的步骤,包括命名规范、HTML 包装代码配置以及如何在 sidebar.php 模板中加载内容。同时提供默认小部件设置与条件判断技巧,帮助用户灵活自定义主题布局。

2026-10-05 7 后端开发
模板部分

【WordPress主题开发手册】模板部分

本文详细介绍如何在 WordPress 主题中注册和管理模板部件。通过 theme.json 文件配置 area、name 和 title 元数据,将 header 或 footer 等部件关联到特定区域。教程涵盖在 parts 文件夹创建文件、编写区块代码以及在顶级模板中使用 template-part 块包含部件的完整步骤,旨在优化站点编辑体验并实现代码复用。

2026-10-05 6 后端开发

【WordPress区块编辑器手册】@wordpress/widget-primitives

本文介绍 WordPress 实验性软件包@wordpress/widget-primitives,提供与宿主无关的小部件工具包。它定义契约类型、运行时解析模块及公共 API,支持 React 应用集成。涵盖操作声明、链接处理、图标注册及字段辅助等核心功能,适用于构建灵活的小部件系统。

2026-10-17 1 后端开发

【WordPress区块编辑器手册】复合

本文介绍基于 WAI-ARIA 复合角色的 React 复合组件,支持方向键导航与焦点循环。涵盖 activeId、focusLoop、virtualFocus 等属性配置,提供 Group、Item、Row 等子组件及 Typeahead 类型提示功能,适用于构建高可访问性的组合小部件与网格界面。

2026-10-17 2 后端开发
仪表盘小工具系统

【WordPress区块编辑器手册】仪表盘小工具系统

本文档详解 WordPress 仪表盘小工具系统的架构与开发流程。涵盖从文件夹约定、构建清单生成到服务端注册表填充的完整流水线,阐述 REST 记录与客户端契约的交互机制。介绍 Widget Primitives 包如何作为作者与宿主间的稳定接口,实现元数据标注、组件渲染及动态依赖管理,确保系统各阶段独立演进。

2026-10-17 3 后端开发

【WordPress区块编辑器手册】恢复经典小工具编辑器

本文介绍多种方法禁用 WordPress 新的 Widgets Block Editor(小部件区块编辑器)。包括使用 remove_theme_support 函数、安装 Classic Widgets 插件以及通过 mu-plugin 添加过滤器代码。管理员可针对特定用户或全局禁用编辑器,灵活切换启用状态,恢复经典小工具编辑体验。

2026-10-17 2 后端开发