用外行语言来说,WordPress插件是一个简单的程序,可帮助您自定义和增强WordPress网站,而无需编辑核心程序。当你掌握 WordPress插件开发, 您将能够立即将各种功能添加到WordPress博客中。但是在成为专业人士之前,您必须学习绳索.
WordPress插件是用PHP脚本语言编写的程序或一个或多个功能集,可为WordPress网站日志添加一组特定的功能或服务,可使用访问点和方法将其与网站日志无缝集成。由WordPress插件应用程序接口(API)提供。 –编写插件,WordPress Codex
在今天的帖子中,我们将指导您完成创建第一个WordPress插件的过程。我们将使该教程简单易行,以迎合几乎不了解或不了解的第一次开发人员。 的PHP (WordPress背后的脚本语言).
但是,在开始实际编码之前,我们将介绍一些有关WordPress插件开发的知识。.
Contents
创建WordPress插件之前要了解的基本知识
在本节中,我们将揭示 前几个步骤 创建WordPress插件时需要遵循。另外,在编写插件时,我们将提到您需要考虑的所有各种事项。大。让我们从基础开始.
如何命名一个WordPress插件
首先,您需要为WordPress插件命名一个唯一的名称。确定合适名称的最好方法之一就是考虑您的插件会做什么。因此,例如,如果您的插件将帮助人们通过社交媒体共享内容,则可以在名称中包含“社交媒体共享”一词。另一件事,插件名称可以是几个字,所以请不要破坏创造力.
您的插件名称必须唯一,以避免与其他插件冲突。为了确保您的姓名唯一,您可以对姓名进行Google搜索。此外,您可以搜索各种插件目录,包括 WordPress插件存储库.
要命名任何插件,我们必须至少创建一个插件文件(主PHP文件),这将向我们介绍下一部分.
如何创建插件文件
一个插件可以由一个PHP文件或多个文件组成,具体取决于设计目的。最重要的文件是主 PHP文件, 这分别相当于WordPress主题和HTML设计中的index.php和index.html.
建议WordPress开发人员按照约定在其插件之后命名其主插件文件。例如,名为WP Renym插件的插件的主插件文件将是 wp-renym.php. 如果在名称中添加分隔符,请仅在单词之间使用连字符(-)而非下划线(_).
如上所述,插件可以由单个或多个文件(图像,JavaScript,语言,CSS文件等)组成。无论哪种方式,您的插件文件都必须位于单个目录中。因此对于名为WP Renym的插件 wp-renym.php 文件将被放置在 wp-renym 夹。可以在主插件文件夹内添加其他子文件夹以包含和组织其他文件.
放置完插件的所有代码后,然后将您的主文件夹压缩为一个zip文件(在本例中为wp-renym.zip存档)以上传并安装在WordPress网站上.
在主PHP文件中添加文件头
命名您的插件时,您应该添加其他详细信息,例如描述,版本,许可证,作者姓名-基本上,所有出现在插件下方和旁边的内容 WordPress插件屏幕 -插件头。为此,您必须使用 标准插件信息标题 在您的主要PHP文件的顶部。这是典型标头的外观:
/ *
插件名称:您的插件名称
插件URI:http://链接到插件首页
说明:用几句话描述您的插件的全部含义
版本:1.0
作者:您的名字(是的!成名...)
作者URI:http://链接到您的网站
许可:GPL2等
许可证URI:http://链接到您的插件许可证
* /
上方标头中的每个参数都是自解释性的,因此我不再赘述。只要确保您包括相关 http:// 要么 https:// 编写插件和作者URI时,否则链接将不起作用.
如果您要使用的是 GPL2许可证 或许可证 与GPL2兼容:
/ *版权所有YEAR PLUGIN_AUTHOR_NAME(电子邮件:您的电子邮件地址)
(插件名称)是免费软件:您可以重新分发和/或修改
根据GNU发布的GNU通用公共许可的条款进行
自由软件基金会(许可的版本2),或
任何更高版本.
(插件名称)被分发,希望它会有用,
但没有任何保证;甚至没有默示担保
特定目的的适销性或适用性。见
GNU通用公共许可证以获取更多详细信息.
您应该已经收到了GNU通用公共许可证的副本
以及(插件名称)。如果没有,请参阅(http://链接到您的插件许可证).
* /
本教程的范围不允许我们超出这些基本步骤。您将需要检查 写一个插件 食典中的指南以了解有关WordPress插件挂钩,模板标签,将插件数据保存到数据库,插件选项机制以及更新插件等更多信息。该法典还包括大量 插件资源 包含视频指南,高级主题等的集合.
现在,我们已经介绍了基础知识,让我们编写一个简单的WordPress插件,该插件将执行两个基本(但很漂亮)功能:
- 用您自己选择的单词替换内容中的单词
- 在每篇博客文章的末尾添加“感谢您阅读本教程……”注释.
如何编写一个简单的WordPress插件– WP Renym
在本节中,我们将为我一直提到的WP Renym插件编写代码.
您需要什么:
- 您最喜欢的代码编辑器(例如. 记事本++ 和 SublimeText)
- 浏览器以查看您的插件在工作(例如. 铬)
- 工作中 WordPress的 安装
命名我们的插件
首先,我们检查了WordPress插件存储库,并对我们的名字进行了Google搜索; WP Renym免费。我最初的选择是WP Rename,但是它已经被使用了.
继续…在您的代码编辑器中打开一个新文件,并使用以下代码打开您的插件后在顶部添加以下代码 :
/ *
插件名称:WP Renym
插件URI:http://链接到插件首页
说明:此插件用您自己选择的单词替换单词.
版本:1.0
作者:弗雷迪·穆里基(Freddy Muriuki)
作者URI:http://链接到您的网站
许可:GPL2等
许可证URI:https://链接到插件许可证
版权所有YEAR PLUGIN_AUTHOR_NAME(电子邮件:您的电子邮件地址)
(插件名称)是免费软件:您可以重新分发和/或修改
根据GNU发布的GNU通用公共许可的条款进行
自由软件基金会(许可的版本2),或
任何更高版本.
(插件名称)被分发,希望它会有用,
但没有任何保证;甚至没有默示担保
特定目的的适销性或适用性。见
GNU通用公共许可证以获取更多详细信息.
您应该已经收到了GNU通用公共许可证的副本
以及(插件名称)。如果没有,请参阅(http://链接到您的插件许可证).
* /
将文件另存为 wp-renym.php 在wp-renym文件夹中。如果您还没有文件夹,请创建它. wp-renym.php 将是您的主要PHP文件.
增加功能
现在将实际功能添加到插件中。在上面的代码下面,添加以下函数来更正以下内容的拼写错误: WordPress的 至 WordPress的:
函数renym_wordpress_typo_fix($ text){
return str_replace('wordpress','WordPress',$ text);
}
add_filter('the_content','renym_wordpress_typo_fix');
renym_wordpress_typo_fix 是我们赋予功能的唯一名称。添加新功能时,切勿以它们开头 wp_ –这是为了防止将来与所有都使用前缀的WordPress代码功能不兼容 wp_.
我们的PHP函数以($ text)作为参数,并返回第一个字符串“wordpress”替换为第二个字符串“WordPress”.
我们已在插件中添加了一个过滤器(add_filter)来告知我们的功能( renym_wordpress_typo_fix )以处理我们选择的文本,在这种情况下,即为整个帖子内容(the_content).
要替换多个单词(也许您想在整个博客中编辑多个单词,或者将插件用作简单的亵渎过滤器),请使用以下代码替换上面的代码:
函数renym_content_replace($ content){
$ search = array('wordpress','goat','Easter','70','sensational');
$ replace = array('WordPress','coffee','Easter holiday','seventy','extraordinary');
返回str_replace($ search,$ replace,$ content);
}
add_filter('the_content','renym_content_replace');
在上面的代码中,我们已经选择了要替换的单词,例如wordpress,山羊,复活节等。我们还选择了替换词,例如WordPress,咖啡,复活节假期等。希望代码可以自我解释:
- 的 renym_content_replace 函数以($ content)作为参数,替换$ search数组中包含的所有单词,并将现在修改的单词返回给WordPress.
- $ search包含所有要替换的单词
- $ replace包含替换词
- str_replace发挥最大作用,用新单词替换单词
注意我们如何添加前缀 雷尼姆 每个功能。这样可以防止与可能安装的其他插件发生冲突。无论您是开发插件,主题还是小部件,都应该养成在函数中添加前缀的习惯.
完成上述步骤后,您的插件即可有效替换您选择的所有单词。现在,我们将添加“感谢您阅读本教程…”注释,该注释将出现在每篇文章的底部。将以下代码添加到您的主插件文件中( renym_content_replace ),然后放在封闭的PHP括号( ?> )位于最后一行:
函数renym_content_footer_note($ content){
$ content。='';
返回$ content;
}
add_filter('the_content','renym_content_footer_note');
保存更改。的 renym_content_footer_note 函数将HTML标记添加到$ content参数,并将新值返回给WordPress。我们还在文本中添加了页脚类,以便以后可以轻松设置样式.
我们包含了一个过滤器(́add_filter),该过滤器告诉我们函数对所选文本进行操作,即以the_content表示的帖子内容.
压缩文件夹
至此,您的最终 wp-renym.php 文件应如下所示:
感谢您阅读本教程。也许下次我会让你给我买杯咖啡!有关更多WordPress教程,请访问我们的博客';
返回$ content;
}
add_filter('the_content','renym_content_footer_note');
?>
保存所有更改。将WP Renym文件夹压缩为 wp-renym.zip 存档(在Mac上就像单击鼠标右键,压缩文件一样简单,而在PC上我相信它非常相似)。只要确保您的文件另存为.ZIP扩展名或插件就不会安装.
使用您的插件
通过上载并激活新的WP Renym插件 WordPress插件屏幕. 恭喜您编写了第一个插件!
资源资源
要了解有关WordPress插件开发的更多信息,请查看以下资源:
结论
我希望本教程就了解插件方面向您指明了正确的方向。这篇文章应该作为开发复杂的WordPress插件的垫脚石,该插件可以完成您的所有工作。不要在这里停下来,请查看我上面推荐的资源,以增加您对WordPress插件开发的了解.
如果您觉得本教程很有帮助,或者还有其他需要补充的信息,我们非常希望知道。请在下面的评论部分中分享您的想法。 around再见