基础的WordPress插件制作教程

发布时间：2020-12-13 02:57:27 所属栏目：PHP教程来源：网络整理

导读：《PHP实例：基础的WordPress插件制作教程》要点：本文介绍了PHP实例：基础的WordPress插件制作教程，希望对您有用。如果有疑问，可以联系我们。插件制作准备工作 PHP学习首先我们在wp-contentplugins目录下添加一个文件夹叫做”My-Mood”,在文件夹中添

《PHP实例：基础的WordPress插件制作教程》要点：
本文介绍了PHP实例：基础的WordPress插件制作教程，希望对您有用。如果有疑问，可以联系我们。

插件制作准备工作PHP学习

首先我们在wp-contentplugins目录下添加一个文件夹叫做”My-Mood”,在文件夹中添加一个叫做index.php的主文件,这个是插件的主文件,文件的开始需要一些命名的格式：如下面的代码

<!--?php <br ?--> /*
Plugin Name: My Mood
Plugin URI: http://www.aips.me
Description: 一个心情发布插件
Version: 1.0
Author: 周良博客
Author URI: http://www.aips.me
License: GPL
*/
?>

Plugin Name 代表了插件的名字.
Plugin URI 代表的是插件的发布地址.
Description 代表的是关于这个插件的描述.
Version 代表了版本好,第一个版本使用1.0,如果你的插件有更新,就依次更改这个版本参数.
Author 代表插件作者的名字.
Author URI 代表作者的主页..
License 代表了插件的License,如果你是开源的就使用GPL,关于License的参数可以百度或者Google查询,这里不再过多的篇幅叙述.

插件的初始化安装

插件不仅仅是样式的改变,通常我们会加入新的表,那么新加的表我就是通过插件的安装函数来完成的,我们继续在index.php中加入如下的代码：

<!--?php <br ?--> //激活动作
register_activation_hook( __FILE__,'my_mood_install');
function my_mood_install() {
// 启用时要做的事情
global $wpdb;
$table_name = $wpdb->prefix . "mood";
$charset_collate = $wpdb->get_charset_collate();
$sql = "CREATE TABLE $table_name (
id mediumint(9) NOT NULL AUTO_INCREMENT,createdon datetime DEFAULT '0000-00-00 00:00:00' NOT NULL,publishedon datetime DEFAULT '0000-00-00 00:00:00' NOT NULL,status int NOT NULL,mood int NOT NULL,text text NOT NULL,address varchar(55) DEFAULT '' NOT NULL,UNIQUE KEY id (id)
) $charset_collate;";
require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
dbDelta( $sql );
}
?>

如上面代码的注释,我们通过register_activation_hook激活动作来完成插件的安装,激活动作通过参数my_mood_install,找到名为my_mood_install的函数执行,这个动作会在插件激活的时候执行.

我们通过my_mood_install函数创建了一张名为”mood”的表,数据库表的创建是通过Wordpress的dbDelta函数来执行sql语句完成的,要想使用此函数需要先引入wp-admin/includes/upgrade.php文件.

通过上面的代码我们就运用Wordpress内置的办法创建了一张给mood插件存储数据的表.

插件卸载

既然Wordpress有安装也一定会有卸载.Wordpress插件的卸载办法是通过一个叫做uninstall.php的固定命名文件来执行的,在插件根目录下建一个名叫uninstall.php的文件,代码内容如下所示：

<!--?php <br ?--> //卸载动作
my_mood_uninstall();
function my_mood_uninstall() {
// 执行内容
global $wpdb;
$table_name = $wpdb->prefix . "mood";
$wpdb->query("DROP TABLE IF EXISTS " . $table_name);
}
?>

通过Wordpress的$wpdb->query来执行sql,删除我们安装时的创建的表,这样就删除一切与该插件相关的内容了.

给插件添加后台管理菜单

如下面的代码：

<!--?php <br ?--> //添加菜单
add_action( 'admin_menu','my_mood_create_menu' );
function my_mood_create_menu() {
global $my_settings;
$my_mood_settings=add_menu_page(
"My Mood","My Mood","manage_options","my-mood","test"
);
}
?>

通过上面的代码我们就可以为插件添加一个菜单.办法通过add_action( ‘admin_menu',‘my_mood_create_menu' )添加一个菜单而菜单具体的页面则是通过参数来绑定的,如上面的办法是传入了叫做”test”的参数,因此当点击这个”My Mood”的菜单的时候就会去寻找叫做”test”的办法进行样式的输出,我们给出test办法

<!--?php <br ?--> function test(){
global $wpdb;
$table_name = $wpdb->prefix . "mood";
$fivesdrafts = $wpdb->get_results(
"
SELECT id,createdon,publishedon,status,mood,text,address
FROM $table_name
ORDER BY createdon DESC
"
);
?>
<div id="my-mood">foreach ( $fivesdrafts as $fivesdraft )
{
?> }
?>
<table class="widefat">
<thead>
<tr>
<th>发布内容</th>
<th>现在所在的</th>
<th>心情</th>
<th>创建日期</th>
<th>操作</th>
</tr>
</thead>
<tfoot>
<tr>
<th>发布内容</th>
<th>现在所在的</th>
<th>心情</th>
<th>创建日期</th>
<th>操作</th>
</tr>
</tfoot>
<tbody>
<tr>
<td><input name="text" type="text" value="" placeholder="输入你的心情" /></td>
<td><input name="address" type="text" value="" placeholder="输入现在所在地" /></td>
<td><label>高兴：<input class="mood" checked="checked" name="mood" type="radio" value="0" /></label>
<label>一般：<input class="mood" name="mood" type="radio" value="1" /></label>
<label>悲伤：<input class="mood" name="mood" type="radio" value="2" /></label>
<label>忧虑：<input class="mood" name="mood" type="radio" value="3" /></label>
<label>其他：<input class="mood" name="mood" type="radio" value="4" /></label></td>
<td></td>
<td><a class="add">添加</a></td>
</tr>
<!--?php <br ?-->
<tr>
<td><input name="text" type="text" value="'<?php" />text; ?>'/></td>
<td><input name="address" type="text" value="'<?php" />address; ?>'/></td>
<td><label>高兴：<input class="mood" name="mood<?php echo $fivesdraft->id; ?>" type="radio" />mood==0?'checked=checked':''; ?> value="0"></label>
<label>一般：<input class="mood" name="mood<?php echo $fivesdraft->id; ?>" type="radio" />mood=='1'?'checked=checked':''; ?> value="1"></label>
<label>悲伤：<input class="mood" name="mood<?php echo $fivesdraft->id; ?>" type="radio" />mood==2?'checked=checked':''; ?> value="2"></label>
<label>忧虑：<input class="mood" name="mood<?php echo $fivesdraft->id; ?>" type="radio" />mood==3?'checked=checked':''; ?> value="3"></label>
<label>其他：<input class="mood" name="mood<?php echo $fivesdraft->id; ?>" type="radio" />mood==4?'checked=checked':''; ?> value="4"></label></td>
<td></td>
<td><a class="edit">保存</a><a class="delete">删除</a></td>
</tr>
<!--?php <br ?--></tbody>
</table>
</div>
<!--?php <br ?--> }
?>

test办法是php与html代码混编的样式,其中HTMl部分主要负责样式的输出,而PHP的代码则是负责执行取数据的逻辑.主要从数据库读取数据的部分,通过Wordpress的$wpdb->get_results办法就可以从数据库中取出我们第一步中创建的表中的数据,返回的是一个数据集合,包含了多条数据.最后通过foreach循环将数据输出.

我们把数据的界面显示出来了,那么怎样才能将数据保留呢?同样根据上一篇心情插件的例子,先看下面的代码

<!--?php <br ?--> function aad_load_scripts($hook) {
global $my_settings;
if( $hook != $my_settings )
return;
/*载入ajax的js文件,也可以载入其他的javascript和/或css等*/
wp_enqueue_script('my-ajax',plugins_url( 'my-mood/js/index.js',__FILE ),array('jquery'));
wp_register_style( 'my-style',plugins_url( 'my-mood/css/style.css',array(),'','all' );
wp_enqueue_style( 'my-style' );
/*
创建验证nonce
它会输出类似于：
<![CDATA[
var aad_vars = {"aad_nonce":"5c18514d34"};
]]>
之类的被注释掉的js到HTML.
*/
wp_localize_script('my-js','my_vars',array(
'my_nonce' => wp_create_nonce('aad-nonce')
)
);
}
add_action('admin_enqueue_scripts','aad_load_scripts');
?>

其中index.js的代码如下

jQuery(document).ready(function(){
jQuery("input").blur(function(){
var value=jQuery(this).val();
jQuery.ajax({
type:"POST",url:"/wp-admin/admin-ajax.php",dataType: 'json',data:{action:"say",value:value},success:function(data){
}
});
})
jQuery(".add").click(function(){
var parent=jQuery(this).closest("tr");
var text=jQuery(parent).find("input[name='text']").val();
var address=jQuery(parent).find("input[name='address']").val();
var mood=jQuery(parent).find("input[type='radio']:checked").val();
jQuery.ajax({
type:"POST",data:{action:"add_mood",text:text,address:address,mood:mood},success:function(data){
window.location.href=window.location;
}
});
})
jQuery(".delete").click(function(){
var parent=jQuery(this).closest("tr");
var id=jQuery(parent).attr('data');
jQuery.ajax({
type:"POST",data:{action:"delete_mood",id:id},success:function(data){
window.location.href=window.location;
}
});
})
jQuery(".edit").click(function(){
var parent=jQuery(this).closest("tr");
var id=jQuery(parent).attr('data');
var text=jQuery(parent).find("input[name='text']").val();
var address=jQuery(parent).find("input[name='address']").val();
var mood=jQuery(parent).find("input[type='radio']:checked").val();
jQuery.ajax({
type:"POST",data:{action:"edit_mood",id:id,success:function(data){
window.location.href=window.location;
}
});
})
});

在上面的代码中我们通过Hook插入我们需要js代码和css代码,这样我们插件的js和css就会因为插件的启用而插入到页面代码中.
我们实现异步加载数据,要根据下面的代码：

<!--?php <br ?--> function say(){
$return=array();
$return['success'] = '1';
$return['msg']=$_POST['value']."test-ajax";
echo json_encode($return);
die();
}
add_action('wp_ajax_say','say');
?>

这段代码的意思是要使用ajax提交数据,add_action(‘wp_ajax_函数名',函数名)的格式就是注册一个say路由,它对应的js代码是

jQuery("input").blur(function(){
var value=jQuery(this).val();
jQuery.ajax({
type:"POST",success:function(data){
}
});
})

因此可以看到js代码的action为say

同样的道理数据要进行添加,注册一个add_mood的路由

<!--?php <br ?--> function add_mood(){
$text=$_POST['text'];
$address=$_POST['address'];
$mood=$_POST['mood'];
add($text,$address,$mood);
$return=array();
$return['success'] = '1';
echo json_encode($return);
die();
}
add_action('wp_ajax_add_mood','add_mood');
?>

数据要进行删除,注册一个delete_mood的路由

<!--?php <br ?--> function delete_mood(){
$id=$_POST['id'];
delete($id);
$return=array();
$return['success'] = '1';
echo json_encode($return);
die();
}
add_action('wp_ajax_delete_mood','delete_mood');
?>

数据要进行编辑,注册一个edit_mood的路由

<!--?php <br ?--> function edit_mood(){
$id=$_POST['id'];
$text=$_POST['text'];
$address=$_POST['address'];
$mood=$_POST['mood'];
edit($id,$text,$mood);
$return=array();
$return['success'] = '1';
echo json_encode($return);
die();
}
add_action('wp_ajax_edit_mood','edit_mood');
?>

对应上面增删改的php函数如下所示

<!--?php <br ?--> function add($text,$mood){
global $wpdb;
$table_name = $wpdb->prefix . "mood";
$wpdb->insert(
$table_name,array(
'createdon' => current_time( 'mysql' ),'publishedon' => current_time( 'mysql' ),'status' => 1,'mood' => $mood,'text'=>$text,'address'=>$address,)
);
}
?>
<!--?php <br ?--> function delete($id){
global $wpdb;
$table_name = $wpdb->prefix . "mood";
$wpdb->delete(
$table_name,array(
'id'=>$id
)
);
}
?>
<!--?php <br ?--> function edit($id,$mood){
global $wpdb;
$table_name = $wpdb->prefix . "mood";
$wpdb->update(
$table_name,array(
'mood' => $mood,),array(
'id' => $id
)
);
}
?>

现在插件的后台数据和界面都已经处理完了,那么怎样把我们的心情插件在前台引用呢?我们需要添加下面的代码

<!--?php <br ?--> function mood_dispaly(){
global $wpdb;
$table_name = $wpdb->prefix . "mood";
$fivesdrafts = $wpdb->get_results(
"
SELECT text
FROM $table_name
ORDER BY createdon DESC
LIMIT 10
"
);
?>
<!--?php <br ?--> }
?>

这段代码就把数据库中存储的心情数据通过HTML显示在前台,那么样子哪里控制的呢?还记得第一步我们添加的js和css吗,是的,样式就是通过第一步插入的样式来控制的.

到此一个完整的心情插件就完成了,照着例子你就可以制作一个属于本身的心情插件了.

欢迎参与《PHP实例：基础的WordPress插件制作教程》讨论，分享您的想法，编程之家 52php.cn为您提供专业教程。

（编辑：李大同）

【声明】本站内容均来自网络，其相关言论仅代表作者个人观点，不代表本站立场。若无意侵犯到您的权利，请及时与联系站长删除相关内容!