在正确的工具区域内显示你创建的WordPress小工具

如果你相信一件事,就去相信,不用等别人来告诉你行或者不行!早安!你不能改变过去,但你可以改变未来。早安!争气永远比生气漂亮。
本文是《一步步创建你的第一个 WordPress 小工具》专题的第 5 篇,共 5 篇:
  • 创建你的第一个WordPress小工具
  • 编写和注册你的 WordPress 小工具
  • 为你的 WordPress 小工具创建表单
  • 构建你的 WordPress 小工具
  • 在正确的工具区域内显示你创建的WordPress小工具

创建你的WordPress小工具的最后一步是在网站上显示其输出结果。要做到这一点,你需要进一步编写WP_Widget 类。

你需要做的是

跟随本好代码教程,你需要

  • 安装一个WordPress开发环境
  • 一个代码编辑器
  • 来自前期好代码教程“为你的 WordPress 小工具创建表单”中的相关代码
  • 来自我之前的好代码教程“在WordPress中创建上下文相关的侧栏导航”中的相关代码

编辑小工具的输出结果

这个过程分两步:一,在WordPress小工具之外添加一个函数,确认初始页面有效;二,在 WP_Widget 类中编辑 widget 函数。

添加“初始函数”

这个函数是从我之前创建一个“上下文相关的侧栏导航”插件的课程中直接引入的。

在你的 WP_Widget 类上,将以下函数添加到你的插件文件中。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
<?php
function tutsplus_check_for_page_tree() {

    //首先检测当前访问的是否是一个页面
    if( is_page() ) {

        global $post;

        // 接着检测该页面是否有父级页面
        if ( $post->post_parent ){

            // 获取父级页面名单
            $parents = array_reverse( get_post_ancestors( $post->ID ) );

            // 获取最顶级页面
            return $parents[0];

        }

        // 返回ID  - 如果存在父级页面,就返回最顶级的页面ID,否则返回当前页面ID, or the current page if not
        return $post->ID;

    }

}
?>

<?php function tutsplus_check_for_page_tree() { //首先检测当前访问的是否是一个页面 if( is_page() ) { global $post; // 接着检测该页面是否有父级页面 if ( $post->post_parent ){ // 获取父级页面名单 $parents = array_reverse( get_post_ancestors( $post->ID ) ); // 获取最顶级页面 return $parents[0]; } // 返回ID - 如果存在父级页面,就返回最顶级的页面ID,否则返回当前页面ID, or the current page if not return $post->ID; } } ?>

稍后当定义在小工具上运行的查询功能时,这个函数也会用到。

编辑widget函数

下一步你需要做的便是在你的插件文件中编辑你之前就建立的但还未填充的widget 函数。从定义基于表单输入的变量开始:

1
2
3
4
5
6
7
function widget( $args, $instance ) {

    extract( $args );
    echo $before_widget;        
    echo $before_title . 'In this section:' . $after_title; 

}

function widget( $args, $instance ) { extract( $args ); echo $before_widget; echo $before_title . 'In this section:' . $after_title; }

下一步,添加查询和输出,函数编辑如下:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
function widget( $args, $instance ) {

    // kick things off
    extract( $args );
    echo $before_widget;        
    echo $before_title . 'In this section:' . $after_title;     

    // run a query if on a page
    if ( is_page() ) {

        // run the tutsplus_check_for_page_tree function to fetch top level page
        $ancestor = tutsplus_check_for_page_tree();

        // set the arguments for children of the ancestor page
        $args = array(
            'child_of' => $ancestor,
            'depth' => $instance[ 'depth' ],
            'title_li' => '',
        );

        // set a value for get_pages to check if it's empty
        $list_pages = get_pages( $args );

        // check if $list_pages has values
        if( $list_pages ) {

            // open a list with the ancestor page at the top
            ?>
            <ul class="page-tree">
                <?php // list ancestor page ?>
                <li class="ancestor">
                    <a href="<?php echo get_permalink( $ancestor ); ?>"><?php echo get_the_title( $ancestor ); ?></a>
                </li>

                <?php
                // use wp_list_pages to list subpages of ancestor or current page
                wp_list_pages( $args );;


            // close the page-tree list
            ?>
            </ul>

        <?php
        }
    }


}

function widget( $args, $instance ) { // kick things off extract( $args ); echo $before_widget; echo $before_title . 'In this section:' . $after_title; // run a query if on a page if ( is_page() ) { // run the tutsplus_check_for_page_tree function to fetch top level page $ancestor = tutsplus_check_for_page_tree(); // set the arguments for children of the ancestor page $args = array( 'child_of' => $ancestor, 'depth' => $instance[ 'depth' ], 'title_li' => '', ); // set a value for get_pages to check if it's empty $list_pages = get_pages( $args ); // check if $list_pages has values if( $list_pages ) { // open a list with the ancestor page at the top ?> <ul class="page-tree"> <?php // list ancestor page ?> <li class="ancestor"> <a rel="nofollow noopener noreferrer" href="<?php echo get_permalink( $ancestor ); ?>"><?php echo get_the_title( $ancestor ); ?></a> </li> <?php // use wp_list_pages to list subpages of ancestor or current page wp_list_pages( $args );; // close the page-tree list ?> </ul> <?php } } }

首先这会检查我们是否在当前页面上,然后根据之前相关函数的输出和 $depth变量的值(在WordPress小工具表单中已设置好),定义list_pages()函数的参数。

现在保存你的小工具并检查你的网址。无论是否添加小工具,你的目录应该会在网页上显示出来。

最终的插件

现在你终于拥有一个完整的WordPress小工具插件了!

回顾你在5个好代码教程中所涉及到的内容,插件代码全文应如下所示:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
<?php 
/*Plugin Name: List Subpages Widget
Description: This widget checks if the current page has parent or child pages and if so, outputs a list of the highest ancestor page and its descendants. This file supports part 5 of the series to create the widget and doesn't give you a functioning widget.
Version: 0.5
Author: Rachel McCollin
Author URI: http://rachelmccollin.com
License: GPLv2
*/
?>
<?php
?>
<?php
/*******************************************************************************
function tutsplus_check_for_page_tree() - checks if the current page is in a page tree.
*******************************************************************************/
?>
<?php
function tutsplus_check_for_page_tree() {

    //start by checking if we're on a page
    if( is_page() ) {

        global $post;

        // next check if the page has parents
        if ( $post->post_parent ){

            // fetch the list of ancestors
            $parents = array_reverse( get_post_ancestors( $post->ID ) );

            // get the top level ancestor
            return $parents[0];

        }

        // return the id  - this will be the topmost ancestor if there is one, or the current page if not
        return $post->ID;

    }

}
?>
<?php
class Tutsplus_List_Pages_Widget extends WP_Widget {

    function __construct() {

        parent::__construct(

            // base ID of the widget
            'tutsplus_list_pages_widget',

            // name of the widget
            __('List Related Pages', 'tutsplus' ),

            // widget options
            array (
                'description' => __( 'Identifies where the current page is in the site structure and displays a list of pages in the same section of the site. Only works on Pages.', 'tutsplus' )
            )

        );

    }

    function form( $instance ) {

        $defaults = array(
            'depth' => '-1'
        );
        $depth = $instance[ 'depth' ];

        // markup for form ?>
        <p>
            <label for="<?php echo $this->get_field_id( 'depth' ); ?>">Depth of list:</label>
            <input class="widefat" type="text" id="<?php echo $this->get_field_id( 'depth' ); ?>" name="<?php echo $this->get_field_name( 'depth' ); ?>" value="<?php echo esc_attr( $depth ); ?>">
        </p>

    <?php
    }

    function update( $new_instance, $old_instance ) {

        $instance = $old_instance;
        $instance[ 'depth' ] = strip_tags( $new_instance[ 'depth' ] );
        return $instance;

    }

    function widget( $args, $instance ) {

        // kick things off
        extract( $args );
        echo $before_widget;        
        echo $before_title . 'In this section:' . $after_title;     

        // run a query if on a page
        if ( is_page() ) {

            // run the tutsplus_check_for_page_tree function to fetch top level page
            $ancestor = tutsplus_check_for_page_tree();

            // set the arguments for children of the ancestor page
            $args = array(
                'child_of' => $ancestor,
                'depth' => $instance[ 'depth' ],
                'title_li' => '',
            );

            // set a value for get_pages to check if it's empty
            $list_pages = get_pages( $args );

            // check if $list_pages has values
            if( $list_pages ) {

                // open a list with the ancestor page at the top
                ?>
                <ul class="page-tree">
                    <?php // list ancestor page ?>
                    <li class="ancestor">
                        <a href="<?php echo get_permalink( $ancestor ); ?>"><?php echo get_the_title( $ancestor ); ?></a>
                    </li>

                    <?php
                    // use wp_list_pages to list subpages of ancestor or current page
                    wp_list_pages( $args );;


                // close the page-tree list
                ?>
                </ul>

            <?php
            }
        }


    }

}
?>
<?php
/*******************************************************************************
function tutsplus_register_list_pages_widget() - registers the widget.
*******************************************************************************/
?>
<?php
function tutsplus_register_list_pages_widget() {

    register_widget( 'Tutsplus_List_Pages_Widget' );

}
add_action( 'widgets_init', 'tutsplus_register_list_pages_widget' );
?>

<?php /*Plugin Name: List Subpages Widget Description: This widget checks if the current page has parent or child pages and if so, outputs a list of the highest ancestor page and its descendants. This file supports part 5 of the series to create the widget and doesn't give you a functioning widget. Version: 0.5 Author: Rachel McCollin Author URI: http://rachelmccollin.com License: GPLv2 */ ?> <?php ?> <?php /******************************************************************************* function tutsplus_check_for_page_tree() - checks if the current page is in a page tree. *******************************************************************************/ ?> <?php function tutsplus_check_for_page_tree() { //start by checking if we're on a page if( is_page() ) { global $post; // next check if the page has parents if ( $post->post_parent ){ // fetch the list of ancestors $parents = array_reverse( get_post_ancestors( $post->ID ) ); // get the top level ancestor return $parents[0]; } // return the id - this will be the topmost ancestor if there is one, or the current page if not return $post->ID; } } ?> <?php class Tutsplus_List_Pages_Widget extends WP_Widget { function __construct() { parent::__construct( // base ID of the widget 'tutsplus_list_pages_widget', // name of the widget __('List Related Pages', 'tutsplus' ), // widget options array ( 'description' => __( 'Identifies where the current page is in the site structure and displays a list of pages in the same section of the site. Only works on Pages.', 'tutsplus' ) ) ); } function form( $instance ) { $defaults = array( 'depth' => '-1' ); $depth = $instance[ 'depth' ]; // markup for form ?> <p> <label for="<?php echo $this->get_field_id( 'depth' ); ?>">Depth of list:</label> <input class="widefat" type="text" id="<?php echo $this->get_field_id( 'depth' ); ?>" name="<?php echo $this->get_field_name( 'depth' ); ?>" value="<?php echo esc_attr( $depth ); ?>"> </p> <?php } function update( $new_instance, $old_instance ) { $instance = $old_instance; $instance[ 'depth' ] = strip_tags( $new_instance[ 'depth' ] ); return $instance; } function widget( $args, $instance ) { // kick things off extract( $args ); echo $before_widget; echo $before_title . 'In this section:' . $after_title; // run a query if on a page if ( is_page() ) { // run the tutsplus_check_for_page_tree function to fetch top level page $ancestor = tutsplus_check_for_page_tree(); // set the arguments for children of the ancestor page $args = array( 'child_of' => $ancestor, 'depth' => $instance[ 'depth' ], 'title_li' => '', ); // set a value for get_pages to check if it's empty $list_pages = get_pages( $args ); // check if $list_pages has values if( $list_pages ) { // open a list with the ancestor page at the top ?> <ul class="page-tree"> <?php // list ancestor page ?> <li class="ancestor"> <a rel="nofollow noopener noreferrer" href="<?php echo get_permalink( $ancestor ); ?>"><?php echo get_the_title( $ancestor ); ?></a> </li> <?php // use wp_list_pages to list subpages of ancestor or current page wp_list_pages( $args );; // close the page-tree list ?> </ul> <?php } } } } ?> <?php /******************************************************************************* function tutsplus_register_list_pages_widget() - registers the widget. *******************************************************************************/ ?> <?php function tutsplus_register_list_pages_widget() { register_widget( 'Tutsplus_List_Pages_Widget' ); } add_action( 'widgets_init', 'tutsplus_register_list_pages_widget' ); ?>

小结

创建一个WordPress小工具应该包含以下几个步骤:

  • 注册你的小工具
  • 创建类来保存widget函数
  • 编写一个construct函数来构建你的小工具
  • 为小工具界面上的表单编写一个form函数
  • 编写一个update函数以便小工具能够在表单中及时更新
  • 编写一个定义输出的 widget函数

一旦你完成了以上步骤,你就创建了一个可以正常运行的WordPress小工具,并且你还可以根据自己的需要加以改编哦。

原文出自:http://code.tutsplus.com/tutorials/displaying-your-wordpress-widget-on-the-site--cms-22407

由 stonetan@WordPress大学 原创翻译,未经允许,禁止转载和采用本译文。

以上就是在正确的工具区域内显示你创建的WordPress小工具。下棋找高手。更多关于在正确的工具区域内显示你创建的WordPress小工具请关注haodaima.com其它相关文章!

您可能有感兴趣的文章
如何修改WordPress自带标签云小工具的标签数量?

WordPress如何禁用前台搜索功能和隐藏搜索小工具?

WordPress侧边栏小工具无法保存怎么办?

如何去除WordPress自带的小工具?

在WordPress分类目录小工具中显示空的分类