WordPress插件开发实例教程 - 版权插件

时间  2019-11-17
标签 wordpress 插件 开发 实例 教程 版权 栏目 Wordpress 繁體版
原文   原文链接

说明：本教程仅限学习，高手请绕道php

开发程序：WordPress 3.9-RC1html

使用主题：Twenty Fourteen数据库

在开始以前，须要注意三件事情浏览器

I、给插件取一个个性化的名字，越个性化越好，以防和其余插件重名冲突。编辑器

II、代码里面，必定要包含注释，不为本身，也要为想修改你代码的别人想一想。wordpress

III、尽可能用最新版的 WordPress 进行开发和测试。函数

插件名称和插件结构post

通常来讲，都是在 wp-content\plugins 目录下创建一个文件夹，文件夹名就是插件的名称，咱们插件名字为"copyright_plugin"，文件结构以下。学习

 

\wp-content\plugins\copyright_plugin下有copyright_plugin.php和readme.txt测试

这里的 readme.txt 文件中包含了一些插件的介绍，使用说明等信息，主要是提交到 WordPress 官方网站时候用到的，能够参考他们给的模板 http://wordpress.org/extend/plugins/about/readme.txt，另外还有插件截图预览的功能，须要另外添加图片，可是咱们如今是练习，不须要提交到官网，因此暂时先不涉及这些。

插件的核心

总的来讲，插件的核心是两个 function，用来添加 Hooks（中文译为钩子）

add_action ($hookname, $callbackfunction)
add_filter ($hookname,$callbackfunction)

这两个方法至关重要，几乎全部的插件都要用到他们。

Actions，我理解就是 wordpress 核心代码预留的一些特殊的切入点，或者说是在执行一些特定事件时候发生，例如文章发布时，或者访客留言时触发。
Filters，应该就是 wordpress 执行时，对数据传输过程的一种过滤机制，例如当文章保存到数据库的过程，或者文章从事数据库中取出，展示到浏览器中的这个过程。

咱们今天要制做的插件，应该是用 Filters，由于咱们要在文章显示在浏览器以前，在最后面加上一段字符窜，用来显示版权信息，后面添加菜单项的时候，也要用到 Actions。

插件概要信息

用文本编辑器打开 copyright-plugin.php 文件，输入以下信息：

<?php  
/*
Plugin Name: Copyright plugin
Plugin URI: http://www.xxxx.com/plugins/
Description: 此插件将在文章正文最下面，显示一行版权信息
Version: 1.0.0
Author: xcxc
Author URI: http://www.xxxx.com/
License: GPL
*/
?>

保存好文件，而后登陆 WordPress 后台，打开插件菜单，应该就能够看到这个插件，已经显示在插件列表里面了，而且能够启用这个插件试试，不过没有任何效果，由于到目前为止，这个插件尚未实现任何功能。

为插件实现功能

修改copyright_plugin.php

<?php  
/*
Plugin Name: Copyright plugin
Plugin URI: http://www.xxxx.com/plugins/
Description: 此插件将在文章正文最下面，显示一行版权信息
Version: 1.0.0
Author: xcxc
Author URI: http://www.xxxx.com/
License: GPL
*/
 
/* 此插件将在文章正文最下面，显示一行版权信息 */ 
function display_copyright() {  
    return "<p style='color:red'>本站点全部文章均为原创，转载请注明出处！</p>";  
}  
?>

保存好这个文件，而后打开正在用的主题文件夹，打开index.php 文件夹，找到 get_template_part( 'content', get_post_format() ); 并在下面添加以下代码

if(function_exists('display_copyright')) {  
    echo display_copyright();  
}

function_exists 是判断 display_copyright 函数是否存在，由于当插件停用的时候，主题代码里面是找不到这个函数的，因此要判断一下，防止出错。

而后在 wordpress 后台启用该插件，再打开首页看看效果吧！

至此，这段代码，应该能够勉强算是一个插件了。之因此说勉强，是由于这个插件存在一个问题，须要手工去修改主题代码，若是用户换了主题的话，须要在新主题里面再次修改代码，这个很差。

改良插件

还记得咱们前面说过的 Hooks （钩子）吗，咱们要开始用 Filter 钩子了！

代码修改copyright_plugin.php以下：

<?php  
/*
Plugin Name: Copyright plugin
Plugin URI: http://www.xxxx.com/plugins/
Description: 此插件将在文章正文最下面，显示一行版权信息
Version: 1.0.0
Author: xcxc
Author URI: http://www.xxxx.com/
License: GPL
*/
add_filter( 'the_content',  'display_copyright' );  
 
/* 这个函数在日志正文结尾处添加一段版权信息，而且只在 首页 页面才添加 */ 
function display_copyright( $content ) {  
    if( is_home() )  
        $content = $content . "<p style='color:red'>本站点全部文章均为原创，转载请指明出处！</p>";  
 
    return $content;  
}  
?>

参看以上代码，其中 the_content 是钩子的名字，display_copyright 是回调函数名称。这样一来，只要启用插件就能够实现功能，无需去修改主题了，请把刚才在index.php 文件中添加的代码删掉，而后启用插件，看看效果吧，显示效果应该是同样的，不管怎么换主题，仍是会自动显示版权信息。

is_home是判断是否是主页

更进一步

至此一个真正的插件算是完成了。可是此插件将版权信息直接写在代码里，若是用户想自定义版权信息的话，须要修改插件的源代码，仍然不方便，因此此插件仍需改进。其实，咱们能够在 WordPress 后台中为插件单独添加一个菜单和页面，用户能够在这里来自定义设置设置版权信息，信息能够保存在数据库里面。

先附上完整代码，后面会作说明

<?php  
/*
Plugin Name: Copyright plugin
Plugin URI: http://www.xxxx.com/plugins/
Description: 此插件将在文章正文最下面，显示一行版权信息
Version: 1.0.0
Author: xcxc
Author URI: http://www.xxxx.com/
License: GPL
*/

/* 注册激活插件时要调用的函数 */ 
register_activation_hook( __FILE__, 'display_copyright_install');   

/* 注册停用插件时要调用的函数 */ 
register_deactivation_hook( __FILE__, 'display_copyright_remove' );  

function display_copyright_install() {  
    /* 在数据库的 wp_options 表中添加一条记录，第二个参数为默认值 */ 
    add_option("display_copyright_text", "<p style='color:red'>本站点全部文章均为原创，转载请注明出处！</p>", '', 'yes');  
}

function display_copyright_remove() {  
    /* 删除 wp_options 表中的对应记录 */ 
    delete_option('display_copyright_text');  
}

if( is_admin() ) {
    /*  利用 admin_menu 钩子，添加菜单 */
    add_action('admin_menu', 'display_copyright_menu');
}

function display_copyright_menu() {
    /* add_options_page( $page_title, $menu_title, $capability, $menu_slug, $function);  */
    /* 页名称，菜单名称，访问级别，菜单别名，点击该菜单时的回调函数（用以显示设置页面） */
    add_options_page('Set Copyright', 'Copyright Menu', 'administrator','display_copyright', 'display_copyright_html_page');
}

function display_copyright_html_page() {
    ?>
    <div>  
        <h2>Set Copyright</h2>  
        <form method="post" action="options.php">  
            <?php /* 下面这行代码用来保存表单中内容到数据库 */ ?>  
            <?php wp_nonce_field('update-options'); ?>  
 
            <p>  
                <textarea  
                    name="display_copyright_text" 
                    id="display_copyright_text" 
                    cols="40" 
                    rows="6"><?php echo get_option('display_copyright_text'); ?></textarea>  
            </p>  
 
            <p>  
                <input type="hidden" name="action" value="update" />  
                <input type="hidden" name="page_options" value="display_copyright_text" />  
 
                <input type="submit" value="Save" class="button-primary" />  
            </p>  
        </form>  
    </div>  
<?php  
}  

add_filter( 'the_content',  'display_copyright' );  
 
/* 这个函数在日志正文结尾处添加一段版权信息，而且只在 首页 页面才添加 */ 
function display_copyright( $content ) {  
    if( is_home() )  
        $content = $content . get_option('display_copyright_text'); 
 
    return $content;  
}  
?>

说明：

如下代码本身要是在启用插件时和停用插件时调用，注释中已经写得很详细了。

/* 注册激活插件时要调用的函数 */ 
register_activation_hook( __FILE__, 'display_copyright_install');   

/* 注册停用插件时要调用的函数 */ 
register_deactivation_hook( __FILE__, 'display_copyright_remove' );  

function display_copyright_install() {  
    /* 在数据库的 wp_options 表中添加一条记录，第二个参数为默认值 */ 
    add_option("display_copyright_text", "<p style='color:red'>本站点全部文章均为原创，转载请注明出处！</p>", '', 'yes');  
}

function display_copyright_remove() {  
    /* 删除 wp_options 表中的对应记录 */ 
    delete_option('display_copyright_text');  
}

 

添加菜单和页面的代码以下：

if( is_admin() ) {
    /*  利用 admin_menu 钩子，添加菜单 */
    add_action('admin_menu', 'display_copyright_menu');
}

function display_copyright_menu() {
    /* add_options_page( $page_title, $menu_title, $capability, $menu_slug, $function);  */
    /* 页名称，菜单名称，访问级别，菜单别名，点击该菜单时的回调函数（用以显示设置页面） */
    add_options_page('Set Copyright', 'Copyright Menu', 'administrator','display_copyright', 'display_copyright_html_page');
}

至此，已经能够在后台看到菜单项了，可是点击的话，还会出错，由于尚未添加对应的页面（如何自定义添加后台菜单位置）

下面开始添加页面，主要代码以下：

function display_copyright_html_page() {
    ?>
    <div>  
        <h2>Set Copyright</h2>  
        <form method="post" action="options.php">  
            <?php /* 下面这行代码用来保存表单中内容到数据库 */ ?>  
            <?php wp_nonce_field('update-options'); ?>  
 
            <p>  
                <textarea  
                    name="display_copyright_text" 
                    id="display_copyright_text" 
                    cols="40" 
                    rows="6"><?php echo get_option('display_copyright_text'); ?></textarea>  
            </p>  
 
            <p>  
                <input type="hidden" name="action" value="update" />  
                <input type="hidden" name="page_options" value="display_copyright_text" />  
 
                <input type="submit" value="Save" class="button-primary" />  
            </p>  
        </form>  
    </div>  
<?php  
}

如今再去点击刚才新加的菜单，能够显示出来一个页面了，咱们能够在这里设置版权信息文本。

另外还有以下代码要修改

/* 这个函数在日志正文结尾处添加一段版权信息，而且只在 首页 页面才添加 */ 
function display_copyright( $content ) {  
    if( is_home() )  
        $content = $content . get_option('display_copyright_text'); 
 
    return $content;  
}

将原来的静态化文本，改为动态的，之因此要这么改，是由于咱们已经将数据存到数据库里面了，这里要从数据库里面取出数据。

相关文章
相关标签/搜索
每日一句
    每一个你不满意的现在，都有一个你没有努力的曾经。
本站公众号
   欢迎关注本站公众号,获取更多信息
联系我们 最近搜索 最新文章 沪ICP备13005482号-10 MyBatis教程 SQL 教程 MySQL教程 Java 教程 Thymeleaf 教程 Hibernate教程 Spring教程 Redis教程