WordPress 如何将窗口小工具字段数据存储为数组？

问题描述

我正在创建一个小工具，它需要存储大约 10 个 ID 。现在我使用以下字段方法将每个 ID 存储在单独的字段中。它将每个字段的数据存储在 wordpress 中。使用数组可以将 wordpress 中所有字段的数据存储在 wordpress 中一行吗？

<input
    class="widefat"
    id="<?php echo $this->get_field_id('item1_id'); ?>"
    name="<?php echo $this->get_field_name('item1_id'); ?>"
    value="<?php echo $instance['item1_id']; ?>"
    />

<input
    class="widefat"
    id="<?php echo $this->get_field_id('item2_id'); ?>"
    name="<?php echo $this->get_field_name('item2_id'); ?>"
    value="<?php echo $instance['item2_id']; ?>"
    />

最佳解决方案

你必须收集与这个名称相同的多个字段…

name="collect[1]"
name="collect[2]"

… 并调整您的窗口小工具的逻辑。

这是一个非常简单的演示小工具：

<?php  # -*- coding: utf-8 -*-
/* Plugin Name: Store Options as array */

add_action( 'widgets_init', array ( 'T5_Array_Options_Widget', 'register' ) );

class T5_Array_Options_Widget extends WP_Widget
{
    /**
     * Constructor.
     */
    public function __construct()
    {
        parent::__construct( strtolower( __CLASS__ ), 'Array Demo' );
    }

    /**
     * Echo the settings update form
     *
     * @param array $instance Current settings
     */
    public function form( $instance )
    {
        $title = isset ( $instance['title'] ) ? $instance['title'] : '';
        $title = esc_attr( $title );

        printf(
            '<p><label for="%1$s">%2$s</label><br />
            <input type="text" name="%3$s" id="%1$s" value="%4$s" class="widefat"></p>',
            $this->get_field_id( 'title' ),
            'Title',
            $this->get_field_name( 'title' ),
            $title
        );

        $fields = isset ( $instance['fields'] ) ? $instance['fields'] : array();
        $field_num = count( $fields );
        $fields[ $field_num + 1 ] = '';
        $fields_html = array();
        $fields_counter = 0;

        foreach ( $fields as $name => $value )
        {
            $fields_html[] = sprintf(
                '<input type="text" name="%1$s[%2$s]" value="%3$s" class="widefat">',
                $this->get_field_name( 'fields' ),
                $fields_counter,
                esc_attr( $value )
            );
            $fields_counter += 1;
        }

        print 'Fields<br />' . join( '<br />', $fields_html );
    }

    /**
     * Renders the output.
     *
     * @see WP_Widget::widget()
     */
    public function widget( $args, $instance )
    {
        print $args['before_widget']
        . $args['before_title']
        . apply_filters( 'widget_title', $instance['title'] )
        . $args['after_title']
        . join( '<br />', $instance['fields'] )
        . $args['after_widget'];
    }

    /**
     * Prepares the content. Not.
     *
     * @param  array $new_instance New content
     * @param  array $old_instance Old content
     * @return array New content
     */
    public function update( $new_instance, $old_instance )
    {
        $instance          = $old_instance;
        $instance['title'] = esc_html( $new_instance['title'] );

        $instance['fields'] = array();

        if ( isset ( $new_instance['fields'] ) )
        {
            foreach ( $new_instance['fields'] as $value )
            {
                if ( '' !== trim( $value ) )
                    $instance['fields'][] = $value;
            }
        }

        return $instance;
    }

    /**
     * Tell WP we want to use this widget.
     *
     * @wp-hook widgets_init
     * @return void
     */
    public static function register()
    {
        register_widget( __CLASS__ );
    }
}

Backend

Frontend

次佳解决方案

如果您需要编号的字段，上述答案是很好的。在我的情况下，我没有。我有一个包含选项的窗口小工具，允许用户选择要在窗口小工具中使用的任何数量的类别。

这是我的小工具 form 。 – 这里有三件重要的事情

如果未设置窗口小工具的值，请确保将值默认为空 array()
以<label> name 的形式，请注意我最后附加了一个 []。这告诉 PHP 我正在提交一个这个键值的数组
将标签中的复选框作为<label><input type="checkbox" ...></label> 。 – 我们的每个复选框将不具有唯一的 id 属性，因此<label> for 属性将不起作用。我们可以生成唯一的 ID，但这是一个麻烦。如果您只是将标签包围在输入周围，则标签可以正确关联，无需连接 for + id 的麻烦

现在的代码

public function form($instance) {
  $title = isset($instance['title']) ? $instance['title'] : '';
  $categories = isset($instance['categories']) ? $instance['categories'] : array();
  ?>

  <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') ?>"
           value="<?php echo $title ?>" />
  </p>

  <p>Categories</p>
  <ul>
  <?php foreach (get_categories() as $category): ?>
    <li>
      <label>
        <input type="checkbox"
             class="checkbox"
             name="<?php echo $this->get_field_name('categories') ?>[]"
             value="<?php echo $category->cat_ID ?>"
             <?php checked(in_array($category->cat_ID, $categories)) ?> />
        <?php echo $category->name ?>
      </label>
    </li>
  <?php endforeach ?>
  </ul>
  <?php
}

这是我的更新功能

我有兴趣将数组中的类别 ID 保存为数字，所以我使用 array_map 与 intval 来确保所有提交的数据都是有效整数。此外，我使用 array_filter 删除任何无效的提交。

// @param array $a - the new instance options
// @param arram $b - the old instance options
public function update($a, $b) {
  return array(
    'title'      => isset($a['title']) ? strip_tags($a['title']) : $b['title'],
    'categories' => isset($a['categories']) ? array_filter(array_map(function($id) { return intval($id); }, (array) $a['categories'])) : (array) $b['title']
  );
}

描述这个 WordPress 的东西是特别有挑战性的。如果你有任何问题，我会很乐意详细说明。

参考文献

How to store widget fields data as an array?

注：本文内容整合自 Google/Baidu/Bing 辅助翻译的英文资料结果。如果您对结果不满意，可以加入我们改善翻译效果：薇晓朵技术论坛。

WordPress 如何将窗口小工具字段数据存储为数组？