get_field_id()是WordPress Widget API中表单字段的必要条件吗?

时间:2012-09-22 12:01:38

标签: php wordpress-plugin wordpress-theming wordpress

我正在尝试为我的插件创建一个自定义窗口小部件并跟随the codex

这是我到目前为止所拥有的。它正在工作并保存并显示保存的选项值。

<?php
/**
 * Plugin Name: Sample Widget
 */

$colors = array('red', 'blue', 'yellow');
update_option('sample_widget', $colors);

add_action( 'widgets_init', create_function( '', 'register_widget( "Sample_Widget" );' ) );
class Sample_Widget extends WP_Widget {

    public function __construct() {
        parent::__construct(
            'foo_widget', 
            'Sample Widget', 
            array( 'description' => __( 'This is a description of the sample widget', 'text_domain' ), ) // Args
        );
    }

    public function widget( $args, $instance ) {
        extract( $args );
        $title = apply_filters( 'widget_title', $instance['title'] );
        $color = apply_filters( 'widget_title', $instance['color'] );

        echo $before_widget;
        if ( ! empty( $title ) )
            echo $before_title . $title . $after_title;
        echo 'the selected color is ' . $color . '<br />';
        echo $after_widget;
    }

    public function update( $new_instance, $old_instance ) {
        $instance = array();
        $instance['title'] = strip_tags( $new_instance['title'] );
        $instance['color'] = $new_instance['color'];
        return $instance;
    }

    public function form( $instance ) {
        if ( isset( $instance[ 'title' ] ) ) {
            $title = $instance[ 'title' ];
        }
        else {
            $title = __( 'New title', 'text_domain' );
        }
        if ( isset( $instance[ 'color' ] ) ) {
            $selected_color = $instance[ 'color' ];
        }
        $colors = get_option('sample_widget');
        ?>
        <p>
            <label for="<?php echo $this->get_field_id( 'title' ); ?>"><?php _e( 'Title:' ); ?></label> 
            <input class="widefat" id="<?php echo $this->get_field_id( 'title' ); ?>" name="<?php echo $this->get_field_name( 'title' ); ?>" type="text" value="<?php echo esc_attr( $title ); ?>" />
        </p>
        <p>
            <select name="<?php echo $this->get_field_name( 'color' ); ?>" id="<?php echo $this->get_field_id( 'color' ); ?>">
                <option value="">Select...</option>
                <?php foreach($colors as $color) echo '<option value="' . esc_attr( $color ) . '" ' . ($color == $selected_color ? 'selected="Selected"' : '') .  '>'. $color .'</option>'; ?>
            </select>
        </p>
        <?php 
    }
} 

我有两个问题:

  1. 什么是id="<?php echo $this->get_field_id( 'color' ); ?>"?我删除了这部分线,似乎工作正常。我把它放在只是复制codex工作代码。
  2. 在构造函数中,parent::__construct()中的第一个参数是基本ID。这可能是任何字符串值吗?我将它从foo_widget更改为其他内容,似乎可以正常工作。
  3. 感谢您提供的信息。

1 个答案:

答案 0 :(得分:4)

  1. id="<?php echo $this->get_field_id( 'color' ); ?>"是为此选项生成唯一的'id'值。通常情况下,可以通过JS操作对象。

  2. id_base foo_widget是此类型所有小部件的根ID。它是小部件的可选基本ID,小写,如果保留为空,则将使用小部件类名的一部分。它必须是独一无二的。这将附加到单个小部件的ID号,即foo_widget-001

  3. 希望这能帮到你!