WordPress插件制作教程(五): 创建新的数据表

上一篇讲解了怎样将数据保存到数据库，今天为大家讲解创建新的数据表，也就是说当我们激活插件的时候，会在该数据库下面创建一个新的数据表出来。原理很简单，激活插件的时候运行创建数据库的代码。看下面代码：

<?php
/**
 * @package 创建数据表
 * @version 1.0
 */
/*
Plugin Name: 创建数据表
Plugin URI: http://www.cnblogs.com/fxmbz/p/4060296.html
Description: 这是一款简单的插件样例，激活插件的时候，会在该数据库下面创建一个新的数据表
Author: myname
Version: 1.0
Author URI: http://www.cnblogs.com/fxmbz
*/

// 声明常量来存储插件版本号 和 该插件最低要求WordPress的版本
define('MY_PLUGIN_VERSION_NUM', '1.0');
define('MY_PLUGIN_MINIMUM_WP_VERSION', '4.0');

// 声明全局变量$wpdb 和 数据表名常量
global $wpdb;
define('MY_NEW_TABLE', $wpdb->prefix . 'mynewtable');


// 插件激活时，运行回调方法创建数据表, 在WP原有的options表中插入插件版本号
register_activation_hook(__FILE__, 'plugin_activation_cretable');
function plugin_activation_cretable() {
    global $wpdb;
    /*
     * We'll set the default character set and collation for this table.
     * If we don't do this, some characters could end up being converted 
     * to just ?'s when saved in our table.
     */
    $charset_collate = '';

    if (!empty($wpdb->charset)) {
      $charset_collate = "DEFAULT CHARACTER SET {$wpdb->charset}";
    }

    if (!empty( $wpdb->collate)) {
      $charset_collate .= " COLLATE {$wpdb->collate}";
    }

    $sql = "CREATE TABLE " . MY_NEW_TABLE . " (
        id mediumint(9) NOT NULL AUTO_INCREMENT,
        time timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP,
        name tinytext NOT NULL,
        text text NOT NULL,
        url varchar(55) DEFAULT '' NOT NULL,
        UNIQUE KEY id (id)
    ) $charset_collate;";

    require_once( ABSPATH . 'wp-admin/includes/upgrade.php' );
    dbDelta( $sql );

    // update_option()方法，在options表里如果不存在更新字段，则会创建该字段,存在则更新该字段
    update_option('my_plugin_version_num', MY_PLUGIN_VERSION_NUM);
}

// 插件激活时，运行回调方法在数据表中插入数据, 
register_activation_hook(__FILE__, 'plugin_activation_insertdate');
function plugin_activation_insertdate() {
    global $wpdb;
    
    $data['name'] = '我的博客';
    $data['text'] = '欢迎来到我的博客！';
    $data['url']  = 'http://www.cnblogs.com/fxmbz';

    $wpdb->insert(MY_NEW_TABLE, $data);
}

// 当加载插件时，运行回调方法检查插件版本是否有更新,
add_action('plugins_loaded', 'myplugin_update_db_check');
function myplugin_update_db_check() {
    // 获取到options表里的插件版本号 不等于 当前插件版本号时，运行创建表方法，更新数据库表
    if (get_option('my_plugin_version_num') != MY_PLUGIN_VERSION_NUM) {
        plugin_activation_cretable();
    }
}

// 插件停用时，运行回调方法删除数据表，删除options表中的插件版本号
register_deactivation_hook(__FILE__, 'plugin_deactivation_deltable');
function plugin_deactivation_deltable() {
    global $wpdb;

    $wpdb->query("DROP TABLE IF EXISTS " . MY_NEW_TABLE);
    delete_option('my_plugin_version_num');
}

 

基本都是使用的WordPress数据库相关函数来操作的，这个需要大家熟悉一下。官方文档：http://codex.wordpress.org/Creating_Tables_with_Plugins