## 入门
最简单的一个WordPress插件是一个带有WordPress插件标题注释的PHP文件。 强烈建议您创建一个目录来保存您的插件,以便您的所有插件的文件整齐地组织在一个地方。
要开始创建一个新的插件,请按照以下步骤操作。
- 浏览到您的WordPress安装的wp-content目录。
- 打开plugins目录。
- 创建一个新的目录,并在您的插件(例如plugin-name)之后命名它。
- 打开你的新插件的目录。
- 创建一个新的PHP文件(在您的插件后面命名此文件也很好,例如plugin-name.php)。
以下是Unix命令行上的进程:
```
wordpress$ cd wp-content
wp-content$ cd plugins
plugins$ mkdir plugin-name
plugins$ cd plugin-name
plugin-name$ vi plugin-name.php
```
在上面的例子中,“vi”是文本编辑器的名称。 使用适合您的编辑器。
现在您正在编辑您的新插件的PHP文件,您需要添加插件标题注释。 这是一个特别格式的PHP块注释,其中包含有关您的插件的元数据,例如其名称和作者。 至少,插件标题注释必须包含插件的名称。 插件文件夹中只有一个文件应该有标题注释 - 如果您的插件有多个PHP文件,那么这些文件中只有一个应该有注释。
```
<?php
/*
Plugin Name: YOUR PLUGIN NAME
*/
```
保存文件后,您应该能够看到您的WordPress站点中列出的插件。 登录您的WordPress站点,然后单击WordPress管理员左侧导航窗格中的插件。 此页面显示您的WordPress网站所有插件的列表。 您的新插件现在应该在该列表中!
## Hooks: Actions 和 Filters
WordPress钩子允许您在特定点点击WordPress,以更改WordPress的行为,而无需编辑任何核心文件。
WordPress中有两种类型的钩子:动作和过滤器。 操作允许您添加或更改WordPress功能,而过滤器允许您更改内容,因为它被加载并显示给网站用户。
钩子不只是插件开发人员; 钩子广泛用于通过WordPress核心本身提供默认功能。 其他挂钩是未使用的占位符,当您需要更改WordPress的工作原理时,您可以直接使用它们。 这就是WordPress如此灵活。
## 基本hook
创建插件时需要的3个基本钩子是`register_activation_hook()`,`register_deactivation_hook()`和`register_uninstall_hook()`。
- 激活插件时,激活钩子就会运行。 您将使用它来提供设置插件的功能 - 例如,在选项表中创建一些默认设置。
- 当您停用插件时,会停用停用挂钩。 您将使用它来提供一个功能,可以通过插件清除任何临时数据存储。
- 使用WordPress Admin删除插件后,这些卸载方法将被用来清理。 您可以使用它来删除插件创建的所有数据,例如添加到选项表中的任何选项。
## 添加 Hooks
您可以添加自己的自定义钩子与do_action(),这将允许开发人员通过传递函数通过你的钩子来扩展你的插件。
## 删除 Hooks
您还可以使用invoke remove_action()来删除之前定义的函数。 例如,如果您的插件是另一个插件的插件,则可以使用与之前插件使用add_action()添加的相同函数回调的remove_action()。 在这些情况下,动作的优先级很重要,因为remove_action()将需要在初始add_action()之后运行。
从钩子中删除操作时,以及更改优先级时,您应该小心,因为这些更改可能难以看到这些更改将如何影响与同一个钩子的其他交互。 我们强烈建议经常进行测试。
您可以在本手册的“钩子”部分中了解更多关于创建钩子和与之互动的信息。
## WordPress APIs
您是否知道WordPress提供了一些应用程序编程接口(API)? 这些API可以大大简化您在插件中编写的代码。 你不想重新发明,特别是当这么多人为你做了大量的工作和测试时。
最常见的是选项API,它可以轻松地将数据存储在数据库中,用于插件。 如果您正在考虑在插件中使用cURL,那么您可能会感兴趣的是HTTP API。
由于我们在谈论插件,您需要学习插件API。 它具有多种功能,可帮助您开发插件。
## WordPress如何加载插件
当WordPress在WordPress管理员的插件页面上加载安装的插件列表时,它将通过plugins文件夹(及其子文件夹)来搜索带有WordPress插件头注释的PHP文件。 如果您的整个插件只包含一个单一的PHP文件,如Hello Dolly,该文件可以直接位于plugins文件夹的根目录下。 但更常见的是,插件文件将驻留在自己的文件夹中,以插件命名。
## 共享您的插件
有时您创建的插件仅适用于您的网站。 但是很多人喜欢与WordPress其他社区分享他们的插件。 在分享您的插件之前,您需要做的一件事是选择许可证。 这样可以让您的插件的用户知道如何使用您的代码。 为了保持与WordPress核心的兼容性,建议您选择使用GNU通用公共许可证(GPLv2 +)的许可证。
- 简介
- 主题开发
- WordPress许可证
- 什么是主题
- 开发环境
- 主题开发示例
- 主题基础
- 模板文件
- 主样式表(style.css)
- 文章类型
- 规划主题文件
- 模板层级
- 模板标签
- 循环
- 主题函数
- 连接主题文件和目录
- 使用CSS和JavaScript
- 条件标签
- 类别,标签和自定义分类
- 模板文件
- 内容模板文件
- 页面模板文件
- 附件模板文件
- 自定义内容类型
- 部分和其他模板文件
- 评论模板
- 分类模板
- 404页面
- 主题功能
- 核心支持的功能
- 管理菜单
- 自定义Headers
- 自定义Logo
- 文章格式
- 置顶文章
- Sidebars
- Widgets
- 导航菜单
- 分页
- 媒体
- Audio
- Images
- Galleries
- Video
- 精选图片和缩略图
- 国际化
- 本地化
- 辅助功能
- 主题选项 – 自定义API
- 定制对象
- 改进用户体验的工具
- 定制JavaScript API
- JavaScript / Underscore.js渲染的自定义控件
- 高级用法
- 主题安全
- 数据消毒/逃避
- 数据验证
- 使用随机数
- 常见漏洞
- 高级主题
- 子主题
- UI最佳实践
- JavaScript最佳做法
- 主题单元测试
- 验证你的主题
- Plugin API Hooks
- 发布你的主题
- 所需的主题文件
- 测试
- 主题评论指南
- 写文档
- 提交你的主题到WordPress.org
- 参考文献
- 模板标签列表
- 条件标签列表
- 编码标准
- HTML编码标准
- CSS编码标准
- JavaScript编码标准
- PHP编码标准
- 插件开发
- 插件开发简介
- 什么是插件
- 插件基础
- 头部要求
- 包括软件许可证
- 启用 / 停用 Hooks
- 卸载方法
- 最佳做法
- 插件安全
- 检查用户功能
- 数据验证
- 保护输入
- 保护输出
- 随机数
- Hooks
- Actions
- Filters
- 自定义Hooks
- 高级主题
- 管理菜单
- 顶级菜单
- 子菜单
- 短代码
- 基本短码
- 封闭短码
- 带参数的短代码
- TinyMCE增强型短码
- 设置
- 设置API
- 使用设置API
- 选项API
- 自定义设置页面
- 元数据
- 管理帖子元数据
- 自定义元数据
- 渲染元数据
- 自定义文章类型
- 注册自定义文章类型
- 使用自定义文章类型
- 分类
- 使用自定义分类
- 在WP 4.2+中使用“split术语”
- 用户
- 创建和管理用户
- 使用用户元数据
- 角色和功能
- HTTP API
- JavaScript
- jQuery
- Ajax
- 服务器端PHP和入队
- Heartbeat API
- 概要
- 计划任务
- 了解WP-Cron计划
- 安排WP-Cron 事件
- 将WP-Cron挂接到系统任务计划程序中
- WP-Cron简单测试
- 国际化
- 本地化
- 如何国际化您的插件
- 国际化安全
- WordPress.org
- 详细插件指南
- 规划您的插件
- 如何使用Subversion
- 插件开发者常见问题
- 开发工具
- Debug Bar 和附加组件
- 辅助插件
- REST API手册
- 资源
- 文章
- 文章修订
- 文章类型
- 文章状态
- 类别
- 标签
- 页面
- 评论
- 分类
- 媒体
- 用户
- 设置
- 使用REST API
- 全局参数
- 分页
- 链接和嵌入
- 发现
- 认证
- 经常问的问题
- 骨干JavaScript客户端
- 客户端库
- 扩展REST API
- 添加自定义端点
- 自定义内容类型
- 修改回应
- 模式
- 词汇表
- 路由和端点
- 控制器类