性价比最高的香港ASP、PHP主机提供商
做网站,就上凡科建站

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

Loading
0
Comodo SLL证书促销 - 免费ssl证书申请_ssl证书购买_ev ssl证书_https证书购买 - GDCA_数安时代
本文是《一步步创建你的第一个 WordPress 小工具》系列教程的第 5 部分,该系列共包含以下 5 个部分:
  1. 创建你的第一个WordPress小工具
  2. 编写和注册你的 WordPress 小工具
  3. 构建你的 WordPress 小工具
  4. 为你的 WordPress 小工具创建表单
  5. 在正确的工具区域内显示你创建的WordPress小工具

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

你需要做的是

跟随本教程,你需要

编辑小工具的输出结果

这个过程分两步:一,在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;
 
    }
 
}
?>

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

编辑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; 
 
}

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

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
        }
    }
 
 
}

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

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

 creating-a-WordPress-widget-final

最终的插件

现在你终于拥有一个完整的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' );
?>

小结

创建一个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建站服务平台

关于 stonetan

该用户很懒,还没有介绍自己。

发表评论