• 售前

  • 售后

热门帖子
入门百科

wordpress开发之插件开发初识(wordpress插件开发根本)

[复制链接]
芊芊551 显示全部楼层 发表于 2021-8-15 19:56:54 |阅读模式 打印 上一主题 下一主题

首先,你要在wp-content/plugins/下创建一个文件夹,文件夹的名字最好只由字母、数字、“-”和下滑构成。同时,还要在这个文件夹下创建一个同名的php文件。比如你的文件夹名字为my-plugin,则php的名字就是my-plugin.php,这个文件做为你plugin的主文件,像主题文件的sytle.css文件一样,它的头部包罗了对这个插件的形貌信息。下面是一个简朴的例子:

复制代码代码如下:
< ?php
/*
Plugin Name: 插件名称
Plugin URI: http://URI_Of_Page_Describing_Plugin_and_Updates
Description: 插件的简朴形貌
Version: 插件版本号, 比方: 1.0
Author: 插件作者
Author URI: http://URI_Of_The_Plugin_Author作者地址
*/
?>

另外如果你想要把你的插件提交到wordpress.org上,你还要在文件夹中添加一个readme.txt文件。就像主题中的style.css文件一样。类似的,readme.txt的头部包罗了对这个插件的基本形貌信息。关于readme.txt的格式,可以参考WordPress的官方示例。由于这里只是简朴的写一个可用的Plugin,就不先容reaadme.txt了。
WordPress的插件着实就是一堆php的方法。这些方法通过调用体系自带的钩子来为博客增长新的功能。下面我们就来看一下什么是体系的钩子。
插件钩子
WordPress界说了许多不同用途的钩子,在Wordpress运行的不同阶段,它会检测当前阶段是否注册了钩子函数,如果有,则优先执行这些函数。添加filter的方法如下:

复制代码代码如下:add_filter('filter_name', 'filter_callback_function_name', $priority=10, $accepted_args=1);
add_fitler的四个参数分别是:要挂载的钩子的名称,钩子的回调函数,回调函数的优先级,回调函数的参数个数。一个例子如下:

复制代码代码如下:
add_fitler('the_title', 'my_title', 10, 2);
function my_title($title, $id) {
return News:$title;
}

这个例子中,我们在the_title钩子上挂载了一个my_title的函数,这个函数接受两个参数,每别是文章的标题和ID,当Wordpress要把文章post给欣赏器之前,会首先调用到这个函数,在这里,我们在每个文章的标题前加了一个“News:”。
关于Wordpress所提供的全部钩子,可以参考Wordpress的官网文档:Filter Reference。
另外你大概会在某些文章中看到令一个添加钩子的函数add_action。我们来看一下wordpress的内核你大概就明白了:

复制代码代码如下:
function add_action($tag, $function_to_add, $priority = 10, $accept_args = 1) {
return add_filter($tag, $function_to_add, $priority, $accept_args);
}

所以add_action和add_filter本质上没有任何区别。
之前说过,Wordpress会在体系的不同阶段调用不同的钩子,着实,如果必要,你也可以在你的代码里手动调用这些钩子。方法如下:

复制代码代码如下:
$return_values = apply_filtere('filter_name', $args ... );

有了这些filter,你就可以在wordpress处置惩罚流程中的任意地方修改数据内容,实现插件所必要的功能。
Option机制
仅仅有了filter还不敷,许多插件还必要保存一些信息,比方插件的属性设置之类,这个时间你就要用到Wordpress的Option机制了。
WordPress的Option机制通过add_option,get_option, update_option三个函数来实现,三个函数的界说如下:

复制代码代码如下:
add_option($name, $value, $deprecated, $autoload);
get_option($name);
update_option($option_name, $newvalue);

add_option有4个参数,功能分别如下:
$name:必选,变量名
$value:可选,变量值,默以为空字符
$deprecated:没用的参数,纯粹是历史遗留问题。留着它只是为了兼容以有的插件。固然如果你要调用到反面的$autoload,你必要为它传入一个空字符或null。
$autoload: “yes” or “no”,默认是”yes”,当设为”yes”时,该属性会在wp_load_alloptions调用时获取到。
get_option用来获取你添加的参数,同时体系中已经默认界说了一些参数,你可以参考Wordpress的官方列表:Option Refernce。
而update_option则是用来更新option。
三个方法都比力好理解,我也不多说了。通过这三个方法你可以把你必要长久保存的数据放在数据库中。
设置页面
有了filter和option,我们已经完成了一个插件的焦点工作。不外做为一个插件,它经常还必要为用户提供一个设置页面,也就是在Wordpress后台插件列表中所看到的settings链接,如下图:
settings
这里我们用一个最简朴的例子还说明怎样添加一个设置页面:

复制代码代码如下:
<?php class wctest{
public function __construct(){
if(is_admin()){
add_action('admin_menu', array($this, 'add_plugin_page'));
add_action('admin_init', array($this, 'page_init'));
}
}
public function add_plugin_page(){
// This page will be under "Settings"
add_options_page('Settings Admin', 'Settings', 'manage_options', 'test-setting-admin', array($this, 'create_admin_page'));
}
public function create_admin_page(){
?>
<div>
< ?php screen_icon(); ?>
<h2>Settings</h2>
<form method=”post” action=”options.php”>
< ?php
// This prints out all hidden setting fields
settings_fields(‘test_option_group’);
do_settings_sections(‘test-setting-admin’);
?>
< ?php submit_button(); ?>
</form>
</div>
< ?php
}
public function page_init(){
register_setting(‘test_option_group’, ‘array_key’, array($this, ‘check_ID’));
add_settings_section(
‘setting_section_id’,
‘Setting’,
array($this, ‘print_section_info’),
‘test-setting-admin’
);
add_settings_field(
‘some_id’,
‘Some ID(Title)’,
array($this, ‘create_an_id_field’),
‘test-setting-admin’,
‘setting_section_id’
);
}
public function check_ID($input){
if(is_numeric($input['some_id'])){
$mid = $input['some_id'];
if(get_option(‘test_some_id’) === FALSE){
add_option(‘test_some_id’, $mid);
}else{
update_option(‘test_some_id’, $mid);
}
}else{
$mid = ”;
}
return $mid;
}
public function print_section_info(){
print ‘Enter your setting below:’;
}
public function create_an_id_field(){
?><input type=”text” id=”input_whatever_unique_id_I_want” name=”array_key[some_id]” value=”<?=get_option(‘test_some_id’);?/>” />< ?php
}
}
$wctest = new wctest();

上面创建的类会在你的Wordpress后台添加一个新页面,同时它答应用户保存一个id值。
到这里,我们一个简朴的Wordpress插件就完成了。虽然这个插件本身没有什么用途。谢谢各人。

本帖子中包含更多资源

您需要 登录 才可以下载或查看,没有帐号?立即注册

x

帖子地址: 

回复

使用道具 举报

分享
推广
火星云矿 | 预约S19Pro,享500抵1000!
您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

草根技术分享(草根吧)是全球知名中文IT技术交流平台,创建于2021年,包含原创博客、精品问答、职业培训、技术社区、资源下载等产品服务,提供原创、优质、完整内容的专业IT技术开发社区。
  • 官方手机版

  • 微信公众号

  • 商务合作